Functions | |
HC_BOOLEAN | Update_One_Display (const char *segment) |
Executes Update_Display on a single driver instance. More... | |
Detailed Description
Function Documentation
◆ Update_One_Display()
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.