Brief Index      Full Index      Events Index      I.M. Reference

Update_One_Display


Functions

HC_BOOLEAN Update_One_Display (const char *segment)

Function Documentation

HC_BOOLEAN Update_One_Display ( const char *  segment  ) 

Executes Update_Display on a single driver instance.

Parameters:
segment - segment from which to begin an update. The segment must be a driver instance, such as /driver/opengl/window2
Returns:
status - Flag indicating whether or not HOOPS completed drawing the scene in the last update. A (1) indicates it did draw the complete scene, while a (0) indicates that the previous update was aborted before completion, due to a call to IM function HIC_Abort_Update.

DETAILS

HC_Update_One_Display instructs HOOPS to perform an update on a single driver instance. For example, in some cases the developer may want to update a postscript driver tree, but to avoid a display update.

NOTES

Drivers that are updated using this function should set the "isolated" driver option (see Set_Driver_Options() ) prior to the first update. One consequence of this requirement is that developers must decide at the time of driver creation whether a given driver is to be updated with this function or with Update_Display. The consequences of not setting the "isolated" driver option can include a crash if and when an expose event trickles down to a normal Update_Display on any of the currently active drivers while this function is working.

RESTRICTIONS

See also:
Update_Display, Reset_System, Set_Driver, Set_Driver_Options, Set_Heuristics, Await_Event, Check_For_Events, Get_Selection, Get_Wakeup.

Brief Index      Full Index      Events Index      I.M. Reference