int rmPipeSetWindow (RMpipe *toUse, HWND window, int windowWidth, int windowHeight)
RMpipe *toUse - a handle to an RMpipe object (input, but not const). HWND window - a valid Win32 window handle (input). int windowWidth, int windowHeight - integer values specifying the pixel width & height of the window "w".
Use this routine to "bind" a Win32 HWND window to an RMpipe. When this routine is called, a number of things happen:
1. The RMpipe's notion of the window size is set (rmPipeSetWindowSize).
2. The OpenGL context contained within the RMpipe is made current.
3. Final internal initialization within RM on the RMpipe's OpenGL context is performed, readying both RM and OpenGL for use.
After this call succeeds, on X11 systems is is safe to begin making raw OpenGL calls. Note that things work a bit differently in Win32. See rmauxSetInitFunc().
Returns RM_CHILL upon success, or RM_WHACKED upon failure.
This routine should be used by all applications to activate an OpenGL context and to bind a window to the RMpipe.
Note that there are no event callbacks associated with the RMpipe: when the window geometry changes (size, etc) it is the responsibility of the application to inform RM that the window geometry has changed (rmPipeSetWindowSize). There are separate versions of this routine for Win32 and X.