Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

glutcreatesubwindow(3) [centos man page]

UNTITLED
LOCAL UNTITLED NAME
glutCreateSubWindow -- Create a subwindow LIBRARY
OpenGLUT - window SYNOPSIS
#include <openglut.h> int glutCreateSubWindow(int parentID, int x, int y, int w, int h); PARAMETERS
parentID Parent window identifier x Horizontal position of subwindow y Vertical position of subwindow w Width of subwindow h Height of subwindow DESCRIPTION
In almost every regard that is important to you, a subwindow is like a top-level window. It has a window id; it has its own set of event callbacks; you can render to it; you are notified of its creation; ... A subwindow lives inside of some other window (possibly a top-level window, possibly another subwindow). Because of this, it generally only interacts with other windows of your own creation, hence it is not subjected to a window manager. This is the primary source for its differ- ences from a top-level window: - There are no borders or decorations. - There is no title bar, hence no title. - Requests tend to be acted on a little more directly, without interference from a window manager. - The subwindow inherits the display mode of its parent. Like a top-level window, you must register a display callback function if you wish to use glutMainloop(). A notable case where this function can fail is for offscreen windows. A coherent concept of a subwindow of an offscreen window would intro- duce more complication than is presently believed to be worthwhile. Attempting such a window presently just fails. Failure is denoted by a 0 window id being returned. Subwindows can be very useful for partitioning a window into GUI elements: They have their own input callbacks, so you don't have to figure out which window an event is for. Graphics are clipped to the boundaries of your subwindows, so you do not need to worry much about where your drawing goes. Because windows and subwindows work almost identically from the perspective of a GLUT program, it is relatively easy to move a cluster of related controls into a separate top-level window---or, conversely, embed what was a top-level window inside of another window. OpenGLUT can also report some basic statistics about your (sub)window, relieving you of the duty of tracking all of that information for yourself. SEE ALSO
glutCreateWindow(3) glutDestroyWindow(3) glutCreateMenuWindow(3) Epoch

Check Out this Related Man Page

XMoveWindow()															     XMoveWindow()

Name
  XMoveWindow - move a window.

Synopsis
  XMoveWindow(display, w, x, y)
	Display *display;
	Window w;
	int x, y;

Arguments
  display  Specifies a connection to an X server; returned from XOpenDisplay().

  w	   Specifies the ID of the window to be moved.

  x	   Specify the new x and y coordinates of the upper-left pixel of the window's border (or of the window itself, if it has no border),
  y	   relative to the window's parent.

Description
  XMoveWindow() changes the position of the origin of the specified window relative to its parent.  XMoveWindow() does not change the mapping
  state, size, or stacking order of the window, nor does it raise the window.  Moving a mapped window will lose its contents if:

  o  Its background_pixmap attribute is ParentRelative.

  o  The window is obscured by nonchildren and no backing store exists.

  If the contents are lost, exposure events will be generated for the window and any mapped subwindows.  Moving a mapped window will generate
  exposure events on any formerly obscured windows.

  If the override_redirect attribute of the window is False (see Volume One,  Chapter 4,  Window  Attributes)  and  the  window  manager  has
  selected  SubstructureRedirectMask on the parent, then a ConfigureRequest event is sent to the window manager, and no further processing is
  performed.

  If a client has selected StructureNotifyMask on the window, then a ConfigureNotify event is generated after the move takes place,  and  the
  event  will  contain	the final position of the window.  This is only useful in the case of top-level windows, since the window manager may
  modify or disallow moves.

Errors
  BadWindow

See Also
  XCirculateSubwindows(),  XCirculateSubwindowsDown(),	XCirculateSubwindowsUp(),  XConfigureWindow(),	XLowerWindow(),  XMoveResizeWindow(),
  XQueryTree(), XRaiseWindow(), XReparentWindow(), XResizeWindow(), XRestackWindows().

Xlib - Window Manipulation													     XMoveWindow()
Man Page