Bitmap Tab

The Bitmap tab is available from the Agent Options dialog box and contains the following options:

Bitmap match count
Specifies an integer representing the number of consecutive snapshots that must be the same for the bitmap to be considered stable. Snapshots are taken up to the number of seconds specified by the Bitmap match timeout option, with a pause specified by Bitmap match interval occurring between each snapshot. This option affects the CaptureBitmap, GetBitmapCRC, VerifyBitmap, and WaitBitmap methods. Default is 5.
Bitmap match interval (seconds)
Specifies a number representing the time interval between snapshots to use for ensuring the stability of the bitmap image. The snapshots are taken up to the time specified by the Bitmap match timeout option. This option affects the CaptureBitmap, GetBitmapCRC, VerifyBitmap, and WaitBitmap methods. Default is 0.1 seconds.
Bitmap match timeout (seconds)
Specifies a number representing the total time allowed for a bitmap image to become stable. During the time period, Silk Test Classic takes multiple snapshots of the image, waiting the number of seconds specified by the Bitmap match interval option between snapshots. If the timeout period is reached before the number of bitmaps specified by the match count option, Silk Test Classic stops taking snapshots and raises the exception E_BITMAP_NOT_STABLE. This option affects the CaptureBitmap, GetBitmapCRC, VerifyBitmap, and WaitBitmap methods. Default is 5 seconds.
Bitmap compare tolerance (pixels)
Specifies an integer representing the number of pixels of difference below which two bitmaps are considered to match. If the number of pixels that are different is smaller than the number specified with this option, the bitmaps are considered identical. The maximum tolerance is 32,767 pixels. The bitmap pixel tolerance is used by the VerifyBitmap and WaitBitmap methods, as well as the SYS_ CompareBitmap function. Default is 0 pixels.

You can also get and set bitmap options using the GetOption and SetOption methods.

4Test statement which sets the selected option

When you set an option, this field displays the 4Test statement that represents the selected option. For example, if you set the Window timeout to 5 seconds on the Timing tab, the following 4Test statement displays:

Agent.SetOption(OPT_WINDOW_TIMEOUT,5)

The statement uses the SetOption method to operate on the agent object. OPT_WINDOW_TIMEOUT is the internal 4Test name of the Window Timeout option and 5 is the current, default value of the option, five seconds.

This code is useful if you want to set a local value for a given agent. You can type or change the code yourself, then click the Copy to Clipboard button to copy the statement to the clipboard.

Copy to Clipboard
Copies the 4Test statement which sets the option to the clipboard.