SetCEWatchDog

Sets the length of time in which the cel engine can do one draw.

Synopsis

Err SetCEWatchDog (Item bitmapItem,int32 db_ctr)

Description

This call controls how long DrawCels() allows the cel engine do one draw before it is killed. The delay interval is expressed in microseconds. The intent of SetCEWatchDog() is to provide a way to abort cel engine lock-ups (which can be caused by bad data, a linked list that is a loop, or other problems).

Currently, the default counter is 1,000,000 microseconds (1 second).

Arguments

bitmapItem: Item number of a bitmap structure.

db_ctr: Value for the draw counter, in microseconds.

Return Value

The call returns 0 if successful or an error code (a negative value) if an error occurs.

GRAFERR_BADDEADBOLT is returned if an illegal value is specified.

Implementation

Folio call implemented in Graphics folio V20.

Associated Files

graphics.h, graphics.lib