pcoip_sync_on_text

ExampleTeradici PCoIP Protocol Functions

Waits until specified text is displayed at the specified location.

Note: The text is identified using optical character recognition (OCR).

Known issue: The OCR engine removes the spaces from the recognized text.

int pcoip_sync_on_text( long x, long y, long width, long height, char value, char snapshot, long timeout, char* waitFor, char* LAST);

xThe horizontal distance, in pixels, of the bitmap's top left edge from the left border of the client window.
yThe vertical distance, in pixels, of the bitmap's top left edge from the upper border of the client window.
widthThe width, in pixels, of the bitmap containing the relevant text.
heightThe height, in pixels, of the bitmap containing the relevant text.
valueThe text for which to wait.
snapshotThe snapshot name.
timeout

The amount of time, in seconds, to wait until the expected text matches the actual text.

Default: 60 seconds (can be edited manually)

WaitFor

The event to occur on one of the specified areas and images. This argument is optional.

The function’s behavior with the WaitFor events is as follows:

  • Appear: The function waits for the specified area to match one of the specified images.
  • Change: The function waits for the specified area to match one of the specified images, and then not to match it. That is, the match is found, and then the area changes so that it no longer matches.
  • NotAppear: The function returns LR_FAIL if the image appears before the function reaches timeout. If the timeout is reached and the image has not appeared, the function returns LR_PASS.

The default is Appear.

LASTMarker that indicates the end of the argument list.

Parameterization

Standard parameterization is not available for this function.

Example

In this example, pcoip_sync_on_text causes the script to pause for the amount of time specified (timeout = 15 seconds), while searching for the text "Jungle" at the specified coordinates.

pcoip_sync_on_text(6, 47, 90, 44, "Jungle", "snapshot4", 15, "WaitFor=Appear", LAST);