VCreateImageSubwindow


 
Name
  VCreateImageSubwindow - creates a subwindow of the image window.
 
Synopsis
  VCreateImageSubwindow(win, xloc, yloc, width, height)
  Window *win;                          /*RETURN*/
  int xloc, yloc;
  int width, height;
 
Description
  VCreateImageSubwindow creates a subwindow of the image window. The
width, height and the location of the window can be specified.
VCreateImageSubwindow returns the ID of the created window and updates
the WINS_ID.COM file. The maximum number of subwindows that can be
created in 3DVIEWNIX is defined by 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, VCreateImageSubwindow 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.