HC_Set_Window_Frame

void HC_Set_Window_Frame(char const *flag)
void HC_Set_Window_Frame(char const flag)

Causes the system to automatically delineate any windows encountered.

Set_Window_Frame tells HOOPS to draw a frame around a HOOPS window. The options for flag are “on”, “off” or “single”, with the added optional modifiers of “inset” and “decorative”.

A value of “on” draws the frame as a two-pixel-wide frame, while “single” draws the frame a single pixel in width.

There are two modifiers that can be used in conjunction with either “on” or “single”. By default, turning a window frame on will result in the image being shrunk a little. Setting the “decorative” modifier will ensure that the image will not be shrunk at all, and that the frame will be drawn on top of any geometry in the window. The second modifier - “inset” - will guarantee that the window frame will be wholly inside the window frame of the owning window. So, if the scene contains one window on top of another, both of which have the same window coordinates, setting the “inset” option will ensure that both window frames will be visible.

The color of the frame is set through the “window contrast” color.

If HOOPS is running on top of another windowing system, that other windowing system may automatically outline the topmost HOOPS window, in which case HOOPS does not bother to re-outline it. The “border” and “control area” Driver_Options may be of interest in this situation.

HC_Set_Window, HC_Set_Window_Pattern, HC_Set_Color, HC_Set_Driver_Options.

Parameters

flag: A string that details the framing behavior for the currently open segment.