VCreateThreedImageSubwindow
Name
VCreateThreedImageSubwindow - creates a three-dimensional looking
subwindow of the image window.
Synopsis
VCreateThreedImageSubwindow(win, xloc, yloc, width, height)
Window *win; /*RETURN*/
int xloc, yloc;
int width, height;
Description
VCreateThreedImageSubwindow creates a three-dimensional looking subwindow
of the image window with the specified width, height and the location. There
is a border around the window which is drawn to give an appearance of depth.
VCreateThreedImageSubwindow returns the ID of the window that it creates and
updates the WINS_ID.COM file. The maximum number of subwindows that can
be created in 3DVIEWNIX is MAX_SUBWINS (see 3DVIEWNIX.PAR).
Return Value
0 - work successfully.
3 - write error.
239 - exceeds the maximum number of subwindows (MAX_SUBWINS) under the
image window.
Parameters
win - the window ID of the window that is created.
xloc, yloc - the x and y coordinates of the upper-left pixel of the new
window relative to the origin of the parent (image window).
width, height - the width and height, in pixels, of the window.
Side Effects
None.
Entry Conditions
If win is NULL, or xloc, yloc, width, or height is invalid, or
VCreateWindows is not called earlier, VCreateThreedImageSubwindow prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
Related Functions
VDestroyImageSubwindow,
VGetImageSubwindows,
VGetWindowInformation.