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.