=xwindows - X11 Utility Methods for ImageMagick9/


NAME



xwindows - 8X11 Utility Methods for ImageMagick




(

SYNOPSIS



Junsigned int IsTrue( const char *message );

lunsigned int XAnnotateImage( Display *display, const XPixelInfo *pixel_info, XAnnotateInfo,*annotate_info, Image *image );

rXFontStruct * XBestFont( Display *display, const XResourceInfo *resource_info, const unsigned int text_font );

ivoid XBestIconSize( Display *display, XWindowInfo *window, Image *image );

jvoid XBestPixel( Display *display, const Colormap colormap, XColor *colors, unsigned int,number_colors, XColor *color );

lXVisualInfo * XBestVisualInfo( Display *display, XStandardColormap *map_info, XResourceInfo*resource_info );

`void XCheckRefreshWindows( Display *display, XWindows *windows );

QXClientMessage( display, window, protocol, message, timestamp );

Hclient_window= XClientWindow( display, target_window );

xvoid XConfigureImageColormap( Display *display, XResourceInfo *resource_info, XWindows *windows, Image*image );

kvoid XConstrainWindowPosition( Display *display, XWindowInfo *window_info );

Tvoid XDelay( Display *display, const unsigned long milliseconds );

Ovoid XDestroyWindowColors( Display *display, Window window );

rvoid XDisplayImageInfo( Display *display, const XResourceInfo *resource_info, XWindows *windows,/Image *undo_image, Image *image );

Mstatus= XDrawImage( display, pixel_info, draw_info, image );

*XError( display, error );

ovoid XFreeResources( Display *display, XVisualInfo *visual_info, XStandardColormap *map_info,=XPixelInfo *pixel_info, XFontStruct *font_info, XResourceInfoE*resource_info, XWindowInfo *window_info )resource_info,window_info );

qvoid XFreeStandardColormap( Display *display, const XVisualInfo *visual_info, XStandardColormap1*map_info, XPixelInfo *pixel_info );

Uvoid XGetAnnotateInfo( XAnnotateInfo *annotate_info );

\void XGetMapInfo( const XVisualInfo *visual_info, const Colormap colormap,+XStandardColormap *map_info );

ovoid XGetPixelInfo( Display *display, const XVisualInfo *visual_info, const XStandardColormapG*map_info, const XResourceInfo *resource_info, Image *image, XPixelInfo'*pixel_info )pixel_info );

schar * XGetResourceClass( XrmDatabase database, const char *client_name, const char *keyword, char!*resource_default );

mXrmDatabase XGetResourceDatabase( Display *display, const char *client_name );

_void XGetResourceInfo( XrmDatabase database, char *client_name, XResourceInfo*resource_info );

wchar * XGetResourceInstance( XrmDatabase database, const char *client_name, const char *keyword, const&char *resource_default );

Kchar * XGetScreenDensity( Display *display );

XWindow XGetSubwindow( Display *display, Window window, int x, int y );

\unsigned int XGetWindowColor( Display *display, char *name );

rImage * XGetWindowImage( Display *display, const Window window, const unsigned int borders, constunsigned int level );

ovoid XGetWindowInfo( Display *display, XVisualInfo *visual_info, XStandardColormap *map_info,=XPixelInfo *pixel_info, XFontStruct *font_info, XResourceInfoJ*resource_info, XWindowInfo *window )resource_info, window );

Kvoid XHighlightEllipse( Display *display, Window window, =GC annotate_context, const RectangleInfo*highlight_info );

Hvoid XHighlightLine( Display *display, Window window, 8GC annotate_context, const XSegment*highlight_info );

Mvoid XHighlightRectangle( Display *display, Window window, =GC annotate_context, const RectangleInfo*highlight_info );

lImage * XImportImage( const ImageInfo *image_info, XImportInfo *ximage_info );

nXWindows * XInitializeWindows( Display *display, XResourceInfo *resource_info );

^Cursor XMakeCursor( Display *display, Window window, Colormap colormap, char9*background_color, char *foreground_color );

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

7XMakeMagnifyImage( display, windows );

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

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

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

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

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

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

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

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

Dtarget_window= XSelectWindow( display, crop_info );

<XSetCursorState( display, windows, state );

OXWindows * XSetWindows( XWindows *windows_info );

Uvoid XUserPreferences( XResourceInfo *resource_info );

<char * XVisualClassName( const int class );

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

;child= XWindowByID( display, window, id );

Ewindow= XWindowByName( display, root_window, name );




B

FUNCTION DESCRIPTIONS






$

IsTrue



IMethod IsTrue returns True if the message is ``true'', ``on'', ``yes'' or``1''.

#The format of the IsTrue method is:F

unsigned int IsTrue ( const char *message );


=A description of each parameter follows:

8

option:


8either True or False depending on the message parameter.$

message:


)Specifies a pointer to a character array.






4

XAnnotateImage



4Method XAnnotateImage annotates the image with text.

+The format of the XAnnotateImage method is:

unsigned int XAnnotateImage ( Display *display, const XPixelInfo *pixel_info, XAnnotateInfo *annotate_info, Image *image );


=A description of each parameter follows:

#

status:


IMethod XAnnotateImage returns True if the image is successfully annotated;with text. False is returned is there is a memory shortage.$

display:


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

pixel_info:


.Specifies a pointer to a XPixelInfo structure.*

annotate_info:


1Specifies a pointer to a XAnnotateInfo structure."

image:


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






*

XBestFont



[Method XBestFont returns the ``best'' font. ``Best'' is defined as a font specified in the X resource database or a font such that the text width displayed with the font does not exceed the specified maximum width.

&The format of the XBestFont method is:

XFontStruct *XBestFont ( Display *display, const XResourceInfo *resource_info, const unsigned int text_font );


=A description of each parameter follows:

!

font:


7XBestFont returns a pointer to a XFontStruct structure.$

display:


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

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.&

text_font:


6True is font should be mono-spaced (typewriter style).






2

XBestIconSize



KMethod XBestIconSize returns the ``best'' icon size. ``Best'' is defined asHan icon size that maintains the aspect ratio of the image. If the windowEmanager has preferred icon sizes, one of the preferred sizes is used.

*The format of the XBestIconSize method is:

void XBestIconSize ( Display *display, XWindowInfo *window, Image *image );


=A description of each parameter follows:

$

display:


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

image:


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






,

XBestPixel



xMethod XBestPixel returns a pixel from an array of pixels that is closest to the requested color. If the color array is <NULL, the colors are obtained from the X server.

'The format of the XBestPixel method is:

void XBestPixel ( Display *display, const Colormap colormap, XColor *colors, unsigned int number_colors, XColor *color );


=A description of each parameter follows:

"

pixel:


BXBestPixel returns the pixel value closest to the requested color.$

display:


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

colormap:


Specifies the ID of the 'X server colormap.#

colors:


(Specifies an array of XColor structures.*

number_colors:


HSpecifies the number of XColor structures in the color definition array."

color:


Specifies the desired ;RGB value to find in the colors array.






6

XBestVisualInfo



JMethod XBestVisualInfo returns visual information for a visual that is the5``best'' the server supports. ``Best'' is defined as:

    +
  1. .

    H

     Restrict the visual list to those supported by the default screen.
    
  2. .

    T

     If a visual type is specified, restrict the visual list to those of that type.
    
  3. .

    k

     If a map type is specified, choose the visual that matches the id specified by the Standard Colormap.
    


H

  4  From the list of visuals, choose one that can display the mostG     simultaneous colors.  If more than one visual can display the sameB     number of simultaneous colors, one is chosen based on a rank.


,The format of the XBestVisualInfo method is:

XVisualInfo *XBestVisualInfo ( Display *display, XStandardColormap *map_info, XResourceInfo *resource_info );


=A description of each parameter follows:

(

visual_info:


'XBestVisualInfo returns a pointer to a /X11 XVisualInfo structure.$

display:


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

map_info:


JIf map_type is specified, this structure is initialized with info from theStandard Colormap.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.






@

XCheckRefreshWindows



'Method XCheckRefreshWindows checks the IX server for exposure events for a particular window5and updates the area associated withe exposure event.

1The format of the XCheckRefreshWindows method is:\

void XCheckRefreshWindows ( Display *display, XWindows *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.






4

XClientMessage



FMethod XClientMessage sends a message to a window with XSendEvent. The@message is initialized with a particular protocol type and atom.

-The format of the XClientMessage function is:[

XClientMessage ( display, window, protocol, message, timestamp );


=A description of each parameter follows:

$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.#

window:


*Specifies a pointer to a Window structure.%

protocol:


Specifies an atom value.$

message:


5Specifies an atom value which is the message to send.&

timestamp:


Specifies a value of type Time.






2

XClientWindow



SMethod XClientWindow finds a window, at or below the specified window, which has a }WM_STATE property. If such a window is found, it is returned, otherwise the argument window is returned.

,The format of the XClientWindow function is:Q

client_window=XClientWindow ( display, target_window );


=A description of each parameter follows:

*

client_window:


NXClientWindow returns a window, at or below the specified window, which has a XWM_STATE property otherwise the argument target_window is returned.$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.*

target_window:


Specifies the window to find a 'WM_STATE property.






F

XConfigureImageColormap



-Method XConfigureImageColormap creates a new X colormap.

4The format of the XConfigureImageColormap method is:

void XConfigureImageColormap ( Display *display, XResourceInfo *resource_info, XWindows *windows, Image *image );


=A description of each parameter follows:

$

display:


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

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.$

windows:


,Specifies a pointer to a XWindows structure."

image:


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






H

XConstrainWindowPosition



IMethod XConstrainWindowPosition assures a window is positioned witin the )X server boundaries.

5The format of the XConstrainWindowPosition method is:g

void XConstrainWindowPosition ( Display *display, XWindowInfo *window_info );


=A description of each parameter follows:

$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.(

window_info:


/Specifies a pointer to a XWindowInfo structure.






$

XDelay



GMethod XDelay suspends program execution for the number of milliseconds specified.

"The format of the Delay method is:]

void XDelay ( Display *display, const unsigned long milliseconds );


=A description of each parameter follows:

$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.)

milliseconds:


?Specifies the number of milliseconds to delay before returning.






@

XDestroyWindowColors



"Method XDestroyWindowColors frees HX11 color resources previously saved on a window by.XRetainWindowColors or programs like xsetroot.

1The format of the XDestroyWindowColors method is:X

void XDestroyWindowColors ( Display *display, 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 Window structure.






:

XDisplayImageInfo



7Method XDisplayImageInfo displays information about an X image.

.The format of the XDisplayImageInfo method is:

void XDisplayImageInfo ( Display *display, const XResourceInfo *resource_info, XWindows *windows, Image *undo_image, Image *image );


=A description of each parameter follows:

$

display:


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

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.$

windows:


,Specifies a pointer to a XWindows structure.'

undo_image:


BSpecifies a pointer to a Image structure; returned from ReadImage."

image:


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






,

XDrawImage



,Method XDrawImage draws a line on the image.

'The format of the XDrawImage method is:V

status=XDrawImage ( display, pixel_info, draw_info, image );


=A description of each parameter follows:

#

status:


FMethod XDrawImage returns True if the image is successfully drawd with6text. False is returned is there is a memory shortage.$

display:


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

pixel_info:


.Specifies a pointer to a XPixelInfo structure.&

draw_info:


-Specifies a pointer to a XDrawInfo structure."

image:


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






$

XError



9Method XError ignores BadWindow errors for XQueryTree andJXGetWindowAttributes, and ignores BadDrawable errors for XGetGeometry, andIignores BadValue errors for XQueryColor. It returns False in those cases.Otherwise it returns True.

%The format of the XError function is:4

XError ( display, error );


=A description of each parameter follows:

$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay."

error:


Specifies the error event.






4

XFreeResources



Method XFreeResources frees #X11 resources.

+The format of the XFreeResources method is:

void XFreeResources ( Display *display, XVisualInfo *visual_info, XStandardColormap *map_info, XPixelInfo *pixel_info, XFontStruct *font_info, XResourceInfo *resource_info, XWindowInfo *window_info ) resource_info, window_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 fromXGetVisualInfo.%

map_info:


JIf map_type is specified, this structure is initialized with info from theStandard Colormap.'

pixel_info:


.Specifies a pointer to a XPixelInfo structure.&

font_info:


/Specifies a pointer to a XFontStruct structure.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.(

window_info:


Specifies a pointer to a /X11 XWindowInfo structure.






B

XFreeStandardColormap



&Method XFreeStandardColormap frees an "X11 colormap.

2The format of the XFreeStandardColormap method is:

void XFreeStandardColormap ( Display *display, const XVisualInfo *visual_info, XStandardColormap *map_info, XPixelInfo *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 fromXGetVisualInfo.%

map_info:


JIf map_type is specified, this structure is initialized with info from theStandard Colormap.'

pixel_info:


.Specifies a pointer to a XPixelInfo structure.






8

XGetAnnotateInfo



?Method XGetAnnotateInfo initializes the AnnotateInfo structure.

,The format of the GetAnnotateInfo method is:Q

void XGetAnnotateInfo ( XAnnotateInfo *annotate_info );


=A description of each parameter follows:

*

annotate_info:


1Specifies a pointer to a XAnnotateInfo structure.






.

XGetMapInfo



?Method XGetMapInfo initializes the XStandardColormap structure.

.The format of the XStandardColormap method is:

void XGetMapInfo ( const XVisualInfo *visual_info, const Colormap colormap, XStandardColormap *map_info );


=A description of each parameter follows:

%

colormap:


Specifies the ID of the 'X server colormap.(

visual_info:


Specifies a pointer to a =X11 XVisualInfo structure; returned fromXGetVisualInfo.%

map_info:


Specifies a pointer to a 5X11 XStandardColormap structure.






2

XGetImageInfo



<Method XGetImportInfo initializes the XImportInfo structure.

+The format of the XGetImportInfo method is:

6

    void XGetImportInfo(XImportInfo *ximage_info)


=A description of each parameter follows:

(

ximage_info:


-Specifies a pointer to a ImageInfo structure.






2

XGetPixelInfo



9Method XGetPixelInfo initializes the PixelInfo structure.

*The format of the XGetPixelInfo method is:

void XGetPixelInfo ( Display *display, const XVisualInfo *visual_info, const XStandardColormap *map_info, const XResourceInfo *resource_info, Image *image, XPixelInfo *pixel_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 fromXGetVisualInfo.%

map_info:


JIf map_type is specified, this structure is initialized with info from theStandard Colormap.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure."

image:


BSpecifies a pointer to a Image structure; returned from ReadImage.'

pixel_info:


.Specifies a pointer to a XPixelInfo structure.






:

XGetResourceClass



%Method XGetResourceClass queries the JX server for the specified resource name or class. IfGthe resource name or class is not defined in the database, the supplieddefault value is returned.

.The format of the XGetResourceClass method is:

char *XGetResourceClass ( XrmDatabase database, const char *client_name, const char *keyword, char *resource_default );


=A description of each parameter follows:

"

value:


GMethod XGetResourceClass returns the resource value associated with theHname or class. If none is found, the supplied default value is returned.%

database:


BSpecifies a resource database; returned from XrmGetStringDatabase.(

client_name:


GSpecifies the application name used to retrieve resource info from the 'X server database.$

keyword:


3Specifies the keyword of the value being retrieved.-

resource_default:


DSpecifies the default value to return if the query fails to find thespecified keyword/class.






@

XGetResourceDatabase



KMethod XGetResourceDatabase creates a new resource database and initializesit.

1The format of the XGetResourceDatabase method is:i

XrmDatabase XGetResourceDatabase ( Display *display, const char *client_name );


=A description of each parameter follows:

%

database:


IMethod XGetResourceDatabase returns the database after it is initialized.$

display:


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

client_name:


GSpecifies the application name used to retrieve resource info from the 'X server database.






8

XGetResourceInfo



?Method XGetResourceInfo initializes the ResourceInfo structure.

-The format of the XGetResourceInfo method is:z

void XGetResourceInfo ( XrmDatabase database, char *client_name, XResourceInfo *resource_info );


=A description of each parameter follows:

%

database:


BSpecifies a resource database; returned from XrmGetStringDatabase.(

client_name:


GSpecifies the application name used to retrieve resource info from the 'X server database.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.






@

XGetResourceInstance



(Method XGetResourceInstance queries the EX server for the specified resource name. If theKresource name is not defined in the database, the supplied default value is returned.

1The format of the XGetResourceInstance method is:

char *XGetResourceInstance ( XrmDatabase database, const char *client_name, const char *keyword, const char *resource_default );


=A description of each parameter follows:

"

value:


JMethod XGetResourceInstance returns the resource value associated with theHname or class. If none is found, the supplied default value is returned.%

database:


BSpecifies a resource database; returned from XrmGetStringDatabase.(

client_name:


GSpecifies the application name used to retrieve resource info from the 'X server database.$

keyword:


3Specifies the keyword of the value being retrieved.-

resource_default:


DSpecifies the default value to return if the query fails to find thespecified keyword/class.






:

XGetScreenDensity



4Method XGetScreenDensity returns the density of the 6X server screen in dots-per-inch.

.The format of the XGetScreenDensity method is:G

char *XGetScreenDensity ( Display *display );


=A description of each parameter follows:

$

density:


4Method XGetScreenDensity returns the density of the /X screen in dots-per-inch.$

display:


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






2

XGetSubwindow



KMethod XGetSubwindow returns the subwindow of a window chosen the user withthe pointer and a button press.

*The format of the XGetSubwindow method is:a

Window XGetSubwindow ( Display *display, Window window, int x, int y );


=A description of each parameter follows:

&

subwindow:


Method XGetSubwindow returns JNULL if no subwindow is found otherwise the subwindow is returned.$

display:


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

window:


Specifies a pointer to a Window.

x:


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

y:


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






6

XGetWindowColor



RMethod XGetWindowColor returns the color of a pixel interactively chosen from the X server.

,The format of the XGetWindowColor method is:X

unsigned int XGetWindowColor ( Display *display, char *name );


=A description of each parameter follows:

#

status:


FMethod XGetWindowColor returns True if the color is obtained from the FX server. False is returned if any errors occurs.$

display:


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

name:


)The name of of the color if found in the KX Color Database is returned in this character string.






6

XGetWindowImage



6Method XGetWindowImage reads an image from the target HX window and returns it. XGetWindowImage optionallyKdescends the window hierarchy and overlays the target image with each childJimage in an optimized fashion. Any child window that have the same visual,7colormap, and are contained by its parent are exempted.

,The format of the XGetWindowImage method is:

Image *XGetWindowImage ( Display *display, const Window window, const unsigned int borders, const unsigned int level );


=A description of each parameter follows:

"

image:


!Method XGetWindowImage returns a HMIFF image if it can be successfully read from the X window. CA null image is returned if any errors occurs.$

display:


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

window:


.Specifies the window to obtain the image from.$

borders:


@Specifies whether borders pixels are to be saved with the image."

level:


Specifies an unsigned integer representing the level of decent in the window hierarchy. This value must be zero or one on the initial call to XGetWindowImage. =A value of zero returns after one call. A value of one causes the function to descend the window hierarchy and overlay the target image with each subwindow image.






4

XGetWindowInfo



<Method XGetWindowInfo initializes the XWindowInfo structure.

+The format of the XGetWindowInfo method is:

void XGetWindowInfo ( Display *display, XVisualInfo *visual_info, XStandardColormap *map_info, XPixelInfo *pixel_info, XFontStruct *font_info, XResourceInfo *resource_info, XWindowInfo *window ) resource_info, window );


=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 fromXGetVisualInfo.%

map_info:


JIf map_type is specified, this structure is initialized with info from theStandard Colormap.'

pixel_info:


.Specifies a pointer to a XPixelInfo structure.&

font_info:


/Specifies a pointer to a XFontStruct structure.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.






:

XHighlightEllipse



.Method XHighlightEllipse puts a border on the HX server around a region defined by highlight_info.

.The format of the XHighlightEllipse method is:

void XHighlightEllipse ( Display *display, Window window, GC annotate_context, const RectangleInfo *highlight_info );


=A description of each parameter follows:

$

display:


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

window:


*Specifies a pointer to a Window structure.-

annotate_context:


Specifies a pointer to a "GC structure.+

highlight_info:


ISpecifies a pointer to a RectangleInfo structure. It contains the extentsof any highlighting rectangle.






4

XHighlightLine



+Method XHighlightLine puts a border on the HX server around a region defined by highlight_info.

+The format of the XHighlightLine method is:

void XHighlightLine ( Display *display, Window window, GC annotate_context, const XSegment *highlight_info );


=A description of each parameter follows:

$

display:


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

window:


*Specifies a pointer to a Window structure.-

annotate_context:


Specifies a pointer to a "GC structure.+

highlight_info:


ISpecifies a pointer to a RectangleInfo structure. It contains the extentsof any highlighting rectangle.






>

XHighlightRectangle



0Method XHighlightRectangle puts a border on the HX server around a region defined by highlight_info.

0The format of the XHighlightRectangle method is:

void XHighlightRectangle ( Display *display, Window window, GC annotate_context, const RectangleInfo *highlight_info );


=A description of each parameter follows:

$

display:


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

window:


*Specifies a pointer to a Window structure.-

annotate_context:


Specifies a pointer to a "GC structure.+

highlight_info:


ISpecifies a pointer to a RectangleInfo structure. It contains the extentsof any highlighting rectangle.






0

XImportImage



.Procedure XImportImage reads an image from an X window.

)The format of the XImportImage method is:

Image *XImportImage ( const ImageInfo *image_info, XImportInfo *ximage_info );


=A description of each parameter follows:

'

image_info:


.Specifies a pointer to an ImageInfo structure.(

ximage_info:


0Specifies a pointer to an XImportInfo structure.






<

XInitializeWindows



=Method XInitializeWindows initializes the XWindows structure.

/The format of the XInitializeWindows method is:j

XWindows *XInitializeWindows ( Display *display, XResourceInfo *resource_info );


=A description of each parameter follows:

$

windows:


=XInitializeWindows returns a pointer to a XWindows structure.$

display:


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

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.






.

XMakeCursor



(Method XMakeCursor creates a crosshairs X11 cursor.

(The format of the XMakeCursor method is:

Cursor XMakeCursor ( Display *display, Window window, Colormap colormap, char *background_color, char *foreground_color );


=A description of each parameter follows:

$

display:


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

window:


Specifies the GID of the window for which the cursor is assigned.%

colormap:


Specifies the EID of the colormap from which the background and#foreground color will be retrieved.-

background_color:


5Specifies the color to use for the cursor background.-

foreground_color:


5Specifies the color to use for the cursor foreground.






,

XMakeImage



Method XMakeImage creates an CX11 image. If the image size differs from the @X11 image 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 JX image is successfully created. False is returned isthere is a memory shortage.$

display:


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

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.#

window:


/Specifies a pointer to a XWindowInfo structure."

image:


BSpecifies a pointer to a Image structure; returned from ReadImage."

width:


ASpecifies the width in pixels of the rectangular area to display.#

height:


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






:

XMakeMagnifyImage



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

.The format of the XMakeMagnifyImage method is:A

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:

N

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


=A description of each parameter follows:

#

status:


'Method XMakePixmap returns True if the KX pixmap is successfully created. False is returned isthere is a memory shortage.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.$

display:


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

window:


/Specifies a pointer to a XWindowInfo structure.






B

XMakeStandardColormap



(Method XMakeStandardColormap creates an +X11 Standard Colormap.

2The format of the XMakeStandardColormap method is:u

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 fromXGetVisualInfo.*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure."

image:


BSpecifies a pointer to a Image structure; returned from ReadImage.%

map_info:


GIf 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.






8

XProgressMonitor



AMethod XProgressMonitor displays the progress a task is making incompleting a task.

-The format of the XProgressMonitor method is:z

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:


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

span:


1Specifies the span relative to completing a task.






>

XQueryColorDatabase



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

0The 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 IRGB values of the target color is defined, otherwiseFalse is returned.#

target:


%Specifies the color to lookup in the &X color database."

color:


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






4

XQueryPosition



HMethod XQueryPosition gets the pointer coordinates relative to a window.

+The format of the XQueryPosition method is:h

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:


DReturn the x coordinate of the pointer relative to the origin of thewindow.

y:


DReturn the y coordinate of the pointer relative to the origin of thewindow.






4

XRefreshWindow



.Method XRefreshWindow refreshes an image in a X window.

+The format of the XRefreshWindow method is:s

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:


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






4

XRemoteCommand



HMethod XRemoteCommand forces a remote display(1) to displaythe specified image filename.

+The format of the XRemoteCommand method is:m

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 HX11 color resources on a window. This preserves the8colors associated with an image displayed on the window.

0The 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.






2

XSelectWindow



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

,The format of the XSelectWindow function is:M

target_window=XSelectWindow ( display, crop_info );


=A description of each parameter follows:

#

window:


$XSelectWindow returns the window id.$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.&

crop_info:


ISpecifies a pointer to a RectangleInfo structure. It contains the extentsof any cropping rectangle.






4

XSignalHandler



HMethod XSignalHandler is called if the program execution is interrupted.

+The format of the XSignalHandler method is:

A

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


JMethod XSetCursorState sets the cursor state to busy, otherwise the cursorare reset to their default.

-The format of the XXSetCursorState method is:F

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:


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






.

XSetWindows



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

(The format of the XSetWindows method is:K

XWindows *XSetWindows ( XWindows *windows_info );


=A description of each parameter follows:

$

windows:


?Method XSetWindows returns a pointer to the XWindows structure.)

windows_info:


7Initialize the Windows structure with this information.






8

XUserPreferences



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

-The format of the XUserPreferences method is:Q

void XUserPreferences ( XResourceInfo *resource_info );


=A description of each parameter follows:

*

resource_info:


Specifies a pointer to a 1X11 XResourceInfo structure.






8

XVisualClassName



DMethod XVisualClassName returns the visual class name as a characterstring.

-The format of the XVisualClassName method is:E

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:s

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



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

*The format of the XWindowByID function is:D

child=XWindowByID ( display, window, id );


=A description of each parameter follows:

"

child:


GXWindowByID returns the window with the specified id. If no windows arefound, XWindowByID returns 0.$

display:


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

id:


)Specifies the id of the window to locate.






2

XWindowByName



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

,The format of the XWindowByName function is:N

window=XWindowByName ( display, root_window, name );


=A description of each parameter follows:

#

window:


$XWindowByName returns the window id.$

display:


ISpecifies 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.






8

XWindowByPropery



IMethod XWindowByProperty locates a child window with a given property. IfGno window with the given name is found, 0 is returned. If more than oneIwindow has the given property, the first one is returned. Only the window*specified and its subwindows are searched.

0The format of the XWindowByProperty function is:

9

    child=XWindowByProperty(display,window,property)


=A description of each parameter follows:

"

child:


JXWindowByProperty returns the window id with the specified property. If no/windows are found, XWindowByProperty returns 0.$

display:


ISpecifies a pointer to the Display structure; returned from XOpenDisplay.%

property:


/Specifies the property of the window to locate.