size, the image is first resized.

The format of the XMakeImage method is:

unsigned int XMakeImage ( Display *display, const XResourceInfo *resource_info, XWindowInfo *window, Image *image, unsigned int width, unsigned int height );

A description of each parameter follows:

status:

Method XMakeImage returns True if the X image is successfully created. False is returned is there is a memory shortage.

display:

Specifies a connection to an X server; returned from XOpenDisplay.

resource_info:

Specifies a pointer to a X11 XResourceInfo structure.

window:

Specifies a pointer to a XWindowInfo structure.

image:

Specifies a pointer to a Image structure; returned from ReadImage.

width:

Specifies the width in pixels of the rectangular area to display.

height:

Specifies the height in pixels of the rectangular area to display.


XMakeMagnifyImage

Method XMakeMagnifyImage magnifies a region of an X image and displays it.

The format of the XMakeMagnifyImage method is:

XMakeMagnifyImage ( display, windows );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

windows:

Specifies a pointer to a XWindows structure.


XMakePixmap

Method XMakePixmap creates an X11 pixmap.

The format of the XMakePixmap method is:

    void XMakeStandardColormap(Display *display,XVisualInfo *visual_info,
      XResourceInfo *resource_info,Image *image,XStandardColormap *map_info,
      XPixelInfo *pixel_info)

A description of each parameter follows:

status:

Method XMakePixmap returns True if the X pixmap is successfully created. False is returned is there is a memory shortage.

resource_info:

Specifies a pointer to a X11 XResourceInfo structure.

display:

Specifies a connection to an X server; returned from XOpenDisplay.

window:

Specifies a pointer to a XWindowInfo structure.


XMakeStandardColormap

Method XMakeStandardColormap creates an X11 Standard Colormap.

The format of the XMakeStandardColormap method is:

XMakeStandardColormap ( display, visual_info, resource_info, image, map_info, pixel_info );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

visual_info:

Specifies a pointer to a X11 XVisualInfo structure; returned from XGetVisualInfo.

resource_info:

Specifies a pointer to a X11 XResourceInfo structure.

image:

Specifies a pointer to a Image structure; returned from ReadImage.

map_info:

If a Standard Colormap type is specified, this structure is initialized with info from the Standard Colormap.

pixel_info:

Specifies a pointer to a XPixelInfo structure.


XMakeWindow

Method XMakeWindow creates an X11 window.

The format of the XMakeWindow method is:

void XMakeWindow ( Display *display, Window parent, char **argv, int argc, XClassHint *class_hint, XWMHints *manager_hints, XWindowInfo *window_info ) window_info );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

parent:

Specifies the parent window_info.

argv:

Specifies the application's argument list.

argc:

Specifies the number of arguments.

class_hint:

Specifies a pointer to a X11 XClassHint structure.

manager_hints:

Specifies a pointer to a X11 XWMHints structure.

window_info:

Specifies a pointer to a X11 XWindowInfo structure.


XProgressMonitor

Method XProgressMonitor displays the progress a task is making in completing a task.

The format of the XProgressMonitor method is:

void XProgressMonitor ( const char *task, const unsigned int quantum, const unsigned int span );

A description of each parameter follows:

task:

Identifies the task in progress.

quantum:

Specifies the quantum position within the span which represents how much progress has been made in completing a task.

span:

Specifies the span relative to completing a task.


XQueryColorDatabase

Method XQueryColorDatabase looks up a RGB values for a color given in the target string.

The format of the XQueryColorDatabase method is:

unsigned int XQueryColorDatabase ( const char *target, ColorPacket *color );

A description of each parameter follows:

status:

Method XQueryColorDatabase returns True if the RGB values of the target color is defined, otherwise False is returned.

target:

Specifies the color to lookup in the X color database.

color:

A pointer to an ColorPacket structure. The RGB value of the target color is returned as this value.


XQueryPosition

Method XQueryPosition gets the pointer coordinates relative to a window.

The format of the XQueryPosition method is:

void XQueryPosition ( Display *display, const Window window, int *x, int *y );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

window:

Specifies a pointer to a Window.

x:

Return the x coordinate of the pointer relative to the origin of the window.

y:

Return the y coordinate of the pointer relative to the origin of the window.


XRefreshWindow

Method XRefreshWindow refreshes an image in a X window.

The format of the XRefreshWindow method is:

void XRefreshWindow ( Display *display, const XWindowInfo *window, const XEvent *event );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

window:

Specifies a pointer to a XWindowInfo structure.

event:

Specifies a pointer to a XEvent structure. If it is NULL, the entire image is refreshed.


XRemoteCommand

Method XRemoteCommand forces a remote display(1) to display the specified image filename.

The format of the XRemoteCommand method is:

void XRemoteCommand ( Display *display, const char *window, const char *filename );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

window:

Specifies the name or id of an X window.

filename:

The name of the image filename to display.


XRetainWindowColors

Method XRetainWindowColors sets X11 color resources on a window. This preserves the colors associated with an image displayed on the window.

The format of the XRetainWindowColors method is:

void XRetainWindowColors ( Display *display, const Window window );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

window:

Specifies a pointer to a XWindowInfo structure.


XSelectWindow

Method XSelectWindow allows a user to select a window using the mouse. If the mouse moves, a cropping rectangle is drawn and the extents of the rectangle is returned in the crop_info structure.

The format of the XSelectWindow function is:

target_window=XSelectWindow ( display, crop_info );

A description of each parameter follows:

window:

XSelectWindow returns the window id.

display:

Specifies a pointer to the Display structure; returned from XOpenDisplay.

crop_info:

Specifies a pointer to a RectangleInfo structure. It contains the extents of any cropping rectangle.


XSignalHandler

Method XSignalHandler is called if the program execution is interrupted.

The format of the XSignalHandler method is:

    void XSetCursorState(Display *display,XWindows *windows,
      const unsigned int state)
=head2 XSetCursorState

Method XSetCursorState sets the cursor state to busy, otherwise the cursor are reset to their default.

The format of the XXSetCursorState method is:

XSetCursorState ( display, windows, state );

A description of each parameter follows:

display:

Specifies a connection to an X server; returned from XOpenDisplay.

windows:

Specifies a pointer to a XWindows structure.

state:

An unsigned integer greater than 0 sets the cursor state to busy, otherwise the cursor are reset to their default.


XSetWindows

Method XSetWindows sets the X windows structure if the windows info is specified. Otherwise the current windows structure is returned.

The format of the XSetWindows method is:

XWindows *XSetWindows ( XWindows *windows_info );

A description of each parameter follows:

windows:

Method XSetWindows returns a pointer to the XWindows structure.

windows_info:

Initialize the Windows structure with this information.


XUserPreferences

Method XUserPreferences saves the preferences in a configuration file in the users' home directory.

The format of the XUserPreferences method is:

void XUserPreferences ( XResourceInfo *resource_info );

A description of each parameter follows:

resource_info:

Specifies a pointer to a X11 XResourceInfo structure.


XVisualClassName

Method XVisualClassName returns the visual class name as a character string.

The format of the XVisualClassName method is:

char *XVisualClassName ( const int class );

A description of each parameter follows:

visual_type:

XVisualClassName returns the visual class as a character string.

class:

Specifies the visual class.


XWarning

Method XWarning displays a warning message in a Notice widget.

The format of the XWarning method is:

void XWarning ( const unsigned int warning, const char *message, const char *qualifier );

A description of each parameter follows:

warning:

Specifies the numeric warning category.

message:

Specifies the message to display before terminating the program.

qualifier:

Specifies any qualifier to the message.


XWindowByID

Method XWindowByID locates a child window with a given ID. If not window with the given name is found, 0 is returned. Only the window specified and its subwindows are searched.

The format of the XWindowByID function is:

child=XWindowByID ( display, window, id );

A description of each parameter follows:

child:

XWindowByID returns the window with the specified id. If no windows are found, XWindowByID returns 0.

display:

Specifies a pointer to the Display structure; returned from XOpenDisplay.

id:

Specifies the id of the window to locate.


XWindowByName

Method XWindowByName locates a window with a given name on a display. If no window with the given name is found, 0 is returned. If more than one window has the given name, the first one is returned. Only root and its children are searched.

The format of the XWindowByName function is:

window=XWindowByName ( display, root_window, name );

A description of each parameter follows:

window:

XWindowByName returns the window id.

display:

Specifies a pointer to the Display structure; returned from XOpenDisplay.

root_window:

Specifies the id of the root window.

name:

Specifies the name of the window to locate.


XWindowByPropery

Method XWindowByProperty locates a child window with a given property. If no window with the given name is found, 0 i