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.
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.
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.
- See also:
- Update_Display, Reset_System, Set_Driver, Set_Driver_Options, Set_Heuristics, Await_Event, Check_For_Events, Get_Selection, Get_Wakeup.