Core Function PixelChecksum - Revision history

UberFoX: 1 revision

2015-06-14T12:38:32Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:35Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* Example */

2011-12-11T20:40:34Z

Example

← Older revision		Revision as of 20:40, 11 December 2011
Line 57:		Line 57:
	println("Checksum is $coord");		println("Checksum is $coord");
	</syntaxhighlight>		</syntaxhighlight>
		+

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
Line 63:		Line 64:
	println("Checksum is $coord");		println("Checksum is $coord");
	</syntaxhighlight>		</syntaxhighlight>
		+

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">

UberFoX at 20:40, 11 December 2011

2011-12-11T20:40:27Z

← Older revision		Revision as of 20:40, 11 December 2011
Line 60:		Line 60:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	$hWnd = WinGetHandle("Calc", "");		$hWnd = WinGetHandle("Calc", "");
−	$coord = PixelChecksum( ~~200~~, ~~200~~, ~~220~~, ~~220~~, $hWnd );	+	$coord = PixelChecksum( 0, 0, 30, 30, $hWnd );
	println("Checksum is $coord");		println("Checksum is $coord");
	</syntaxhighlight>		</syntaxhighlight>

UberFoX at 20:40, 11 December 2011

2011-12-11T20:40:17Z

← Older revision		Revision as of 20:40, 11 December 2011
Line 58:		Line 58:
	</syntaxhighlight>		</syntaxhighlight>

		+	<syntaxhighlight lang="sputnik">
		+	$hWnd = WinGetHandle("Calc", "");
		+	$coord = PixelChecksum( 200, 200, 220, 220, $hWnd );
		+	println("Checksum is $coord");
		+	</syntaxhighlight>

	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">

UberFoX at 20:15, 11 December 2011

2011-12-11T20:15:30Z

← Older revision		Revision as of 20:15, 11 December 2011
Line 1:		Line 1:
	<pre>		<pre>
−	PixelChecksum ( <left>, <top>, <right>, <bottom>, <step> )	+	PixelChecksum ( <left>, <top>, <right>, <bottom>, <step>, <hwnd> )
	</pre>		</pre>

Line 30:		Line 30:

	Default is 1.		Default is 1.
		+
		+	==== hwnd ====
		+
		+	Optional; Window handle to be used.

	=== Return Value ===		=== Return Value ===

UberFoX: /* Return Value */

2011-11-28T06:09:39Z

Return Value

← Older revision		Revision as of 06:09, 28 November 2011
Line 34:		Line 34:

	Success: Returns the checksum value of the region.		Success: Returns the checksum value of the region.
−	Failure: Returns -1 if anything goes wrong.	+
		+	Failure: Returns -1 if anything goes wrong.

	=== Remarks ===		=== Remarks ===

UberFoX: Created page with "

 PixelChecksum ( , , , ,  )

=== Description === Generates a checksum for a region of pixels. === Parameters === ==== left ==== le..."

2011-11-28T05:57:49Z

Created page with "<pre> PixelChecksum ( <left>, <top>, <right>, <bottom>, <step> ) </pre> === Description === Generates a checksum for a region of pixels. === Parameters === ==== left ==== le..."

New page

<pre>
PixelChecksum ( <left>, <top>, <right>, <bottom>, <step> )
</pre>

=== Description ===

Generates a checksum for a region of pixels.

=== Parameters ===

==== left ====

left coordinate of rectangle.

==== top ====

top coordinate of rectangle.

==== right ====

right coordinate of rectangle.

==== bottom ====

bottom coordinate of rectangle.

==== step ====

Optional; Instead of searching each pixel use a value larger than 1 to skip pixels (for speed). E.g. A value of 2 will only check every other pixel.

Default is 1.

=== Return Value ===

Success: Returns the checksum value of the region.
Failure: Returns -1 if anything goes wrong.

=== Remarks ===

Performing a checksum of a region is very time consuming, so use the smallest region you are able to reduce CPU load. On some machines a checksum of the whole screen could take many seconds!

A checksum only allows you to see if "something" has changed in a region - it does not tell you exactly what has changed.

When using a step value greater than 1 you must bear in mind that the checksumming becomes less reliable for small changes as not every pixel is checked.

See "PixelCoordMode" in [[Core Function Opt|Opt]]

=== Example ===

<syntaxhighlight lang="sputnik">
$coord = PixelChecksum( 200, 200, 220, 220 );
println("Checksum is $coord");
</syntaxhighlight>

<syntaxhighlight lang="sputnik">
// Wait until something changes in the region 0,0 to 50,50

// Get initial checksum
$checksum = PixelChecksum(0,0, 50,50);

// Wait for the region to change, the region is checked every 100ms to reduce CPU load
While ($checksum == PixelChecksum(0,0, 50, 50))
Sleep(100);

MsgBox("Something in the region has changed!");
</syntaxhighlight>

[[Category:Core Function]]