", Hyphenation = on, Consecutive Hyphens = 2, Vert. Just. = off> ", Level 1 Show = no, Level 2 Suffix = , Level 2 Starting Value = 0, Level 2 Show = no> ", Level 1 Show = no, Level 2 Suffix = "<#04>"> ", Level 1 Show = no, Level 2 Suffix = > ", Level 1 Show = no, Level 2 Suffix = "<#04>"> Cursors ) (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066 667,6))> Cursors ) (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> <|,"10<#1e>107"> CURSORS ) (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066 667,6))> ) (T8,2,12,0.026667,0.733333,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10 2,1101,3, <"table"> ) (T8,3,12,0.066667,0.6,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,110 1,3, ) (g9,5,0 (p7,5,8,19 (g9,5,0 (g9,5,0 (v4,5,0,0.266667,0,1.6,0,17,1,0) (v4,6,0,1.6,0,1.6,0.933333,17,1,0) (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0) (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0)))) (g9,10,8 (g9,10,1032 (p7,10,8,13 (g9,10,0 (g9,10,0 (v4,10,0,1.375614,0.934817,1.484035,0.822222,17,1,0) (v4,11,0,1.484035,0.822222,1.484035,0.259258,17,1,0) (v4,12,0,1.484035,0.259258,1.375614,0.146667,17,1,0) (v4,13,0,1.375614,0.146667,1.122632,0.146667,17,1,0) (v4,14,32,1.122632,0.146667,1.176842,0.296786,17,0,0) (v4,15,0,1.176842,0.296786,1.321403,0.296786,17,1,0) (v4,16,0,1.321403,0.296786,1.321403,0.784693,17,1,0) (v4,17,0,1.321403,0.784693,1.176842,0.784693,17,1,0) (v4,18,32,1.176842,0.784693,1.122632,0.934817,17,0,0) (v4,19,0,1.122632,0.934817,1.375614,0.934817,17,1,0)))) (p7,21,8,13 (g9,21,0 (g9,21,0 (v4,21,32,1.122632,0.934817,1.176842,0.784693,17,0,0) (v4,22,0,1.176842,0.784693,1.176842,0.296786,17,1,0) (v4,23,32,1.176842,0.296786,1.122632,0.146667,17,0,0) (v4,24,0,1.122632,0.146667,1.014211,0.259258,17,1,0) (v4,25,0,1.014211,0.259258,1.014211,0.822222,17,1,0) (v4,26,0,1.014211,0.822222,1.122632,0.934817,17,1,0))))) (g9,27,2048 (v4,27,33,0.96,1.160001,0.96,1.160001,17,0,0) (v4,28,33,0.96,0.146667,0.96,0.146667,17,0,0) (v4,29,33,1.538245,0.146667,1.538245,0.146667,17,0,0) (v4,30,33,1.538245,1.160001,1.538245,1.160001,17,0,0))) (g9,32,8 (p7,32,1032,13 (g9,32,0 (g9,32,0 (v4,32,0,0.914386,0.934813,0.914386,0.146667,17,1,0) (v4,33,0,0.914386,0.146667,0.769824,0.146667,17,1,0) (v4,34,0,0.769824,0.146667,0.625263,0.296789,17,1,0) (v4,35,0,0.625263,0.296789,0.625263,0.371848,17,1,0) (v4,36,0,0.625263,0.371848,0.751755,0.371848,17,1,0) (v4,37,0,0.751755,0.371848,0.751755,0.934813,17,1,0) (v4,38,0,0.751755,0.934813,0.914386,0.934813,17,1,0)))) (g9,39,2048 (v4,39,33,0.607192,0.146667,0.607192,0.146667,17,0,0) (v4,40,33,0.607192,1.159997,0.607192,1.159997,17,0,0) (v4,41,33,0.986667,1.159997,0.986667,1.159997,17,0,0) (v4,42,33,0.986667,0.146667,0.986667,0.146667,17,0,0)))) (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> Introduction10.1<#04>A cursor is a visible shape that appears at the current position ofthe pointer device. The cursor shape moves with the pointer to providecontinuous feedback to the user about the current location of the pointer.Each window can have a cursor attribute that defines the appearance of thepointer cursor when the pointer position lies within the window. See window<#1e>cu rsor. A cursor image is composed of a source bitmap, a mask bitmap, a hot spot, a foreground color, and a background color. Either 1<#1e>bit pixmaps orfont glyphs can be used to specify source and mask bitmaps. The sourcebitmap identifies the foreground and background pixels of the cursor image;the mask bitmap identifies which source pixels are actually drawn. The maskbitmap thus allows a cursor to assume any shape. The hot spot defines theposition within the cursor image that is displayed at the pointer position. In CLX, a cursor is represented by a cursor object. This section describesthe CLX functions to: wCreate and free cursor objects wChange cursor colors wInquire the best cursor size wAccess cursor attributes Creating 10.2<#04>The following paragraphs describe the CLX functions used to create Cursorsand free cursorobjects. create<#1e>cursor &key :source :mask :x :y :foreground :background Functioncursor", Sort String = "create<#1e>cursor"> Returns:
cursor <#1f> Type cursor. Creates and returns a cursor. :x and :y define the position of the hot spot relative to the origin of the :source. :foreground and :background colors must bespecified, even if the server only has a :static<#1e>gray or :gray<#1e>scal e screen.The :source, :x, and :yargu ments must also be specified. The cursor image is drawn by drawing a pixel from the :source bitmap atevery position where the corresponding bit in the :mask bitmap is 1. If thecorresponding :source bit is 1, a pixel is drawn in the :foregroundcolor; otherwise, a pixel is drawn in the :background color. If the :mask isomitted, all :source pixels are drawn. If given, the :mask must be the same size as the :source. An X server may not be able to support every cursor size. A server is free to modify any component of the cursor to satisfy hardware or software limitations. The :source and :mask can be freed immediately after the cursor is created. Subsequent drawing in the :source or:mask pixmap has an undefined effect on the cursor. :source <#1f> The source pixmap. This argument is required. <|,"10<#1e>108">:mask <#1f> The mask pixmap. :x, :y <#1f> The hot spot position in the :source . This argument is required. :foreground <#1f> A color object specifying the foreground color. This argument is required. :background <#1f> A color object specifying the background color. This argument is required. create<#1e>glyph<#1e>cursor &key :source<#1e>font :source<#1e>char :mask<#1e>font Functionglyph<#1e>cursor", Sort String = "create<#1e>glyph<#1e>cursor">
(:mask<#1e>char 0) :foreground :background Returns:
cursor <#1f> Type cursor. Creates and returns a cursor defined by font glyphs. The source bitmap isdefined by the :source<#1e>font and :source<#1e>char. The mask bitmap is defined bythe :mask<#1e>font and :mask<#1e> char. It is an error if the :source<#1e>char and:mask<#1e> char are not valid indexes for the :source<#1e>font and :mask<#1e>font,respectively. The hot spot position is defined by the <#7f>character origin" of the source glyph, that is, the position [- char<#1e>left<#1e>bearing, char<#1e>asc ent]relative to the upper left corner of the source glyph bitmap. Source and mask bits are compared after aligning the character origins ofthe source and mask glyphs. The source and mask glyphs need not have thesame size or character origin position. If the :mask<#1e>f ont isomitted, all source pixels are drawn. An X server may not be able to support every cursor size. A server is freeto modify any component of the cursor to satisfy hardware or software limitations. Either of the :source<#1e>font or :mask<#1e>font can be closed after the cursor iscreated. :source<#1e>font <#1f> The source font. This is a required argument. :source<#1e>char <#1f> An index specifying a glyph in the source font. Thisis a required argument. :mask<#1e>font <#1f> The mask font. :mask<#1e>char <#1f> An index specifying a glyph in the mask font. :foreground <#1f> A color object specifying the foreground color. Thisis a required argument. :background <#1f> A color object specifying the background color. Thisis a required argument. free<#1e>cursor cursorFunctioncursor", Sort String = "free<#1e>cursor"> Destroys the cursor object. Cursor server resources are freed when no other references remain. cursor <#1f> A cursor object. Cursor10.3<#04>The following paragraphs describe the CLX functions used to operate Functionson cursor objects. <|,"10<#1e>109">query<#1e>best<#1e>cursor width height displayFunctio nbest<#1e>cursor", Sort String = "query<#1e>best<#1e>cursor"> Returns:
width, height <#1f> Type card16. Returns the cursor size closest to the requested width and heigh t that is best suited to the display. The width and height returned define the largestcursor size supported by the X server. Clients should always be prepared tolimit cursor sizes to those supported by the server. display <#1f> A display object. width,height <#1f> The requested cursor size. recolor<#1e>cursor cursor foreground backgroundFunctio ncursor", Sort String = "recolor<#1e>cursor"> Changes the color of the specified cursor. If thecursor is displayed on a screen, the change is visible immediately. cursor <#1f> A cursor object. foreground <#1f> A color object specifying the new foreground color. background <#1f> A color object specifying the new background color. Cursor10.4<#04>The complete set of cursor attributes is discussed in the following Attributesparagraphs. cursor<#1e>display cursorFunctiondisplay", Sort String = "cursor<#1e>display"> Returns:
display <#1f> Type display. Returns the display object associated with the specified cursor . cursor <#1f> A cursor object. cursor<#1e>equal cursor<#1e>1 cursor<#1e>2Functio nequal", Sort String = "cursor<#1e>equal"> Returns true if the two arguments refer to the same server resource and nil if they do not. cursor<#1e>1, cursor<#1e>2 <#1f> cursor objects. cursor<#1e>id cursorFunctionid", Sort String = "cursor<#1e>id"> Returns:
id <#1f> Type resource<#1e>id. Returns the unique resource ID that has been assigned to the specified cur sor. cursor <#1f> A cursor object. cursor<#1e>p cursorFunctionp", Sort String = "cursor<#1e>p"> Returns:
cursor<#1e>p <#1f> Type boolean. Returns true if the argument is a cursor object and nil otherwise. cursor<#1e>plist cursorFunctionplist", Sort String = "cursor<#1e>plist"> Returns:
plist <#1f> A property list. Returns and (with setf) sets the property list for the specified cursor. This function provides a hook where extensions can add data. cursor <#1f> A cursor object. <|,"10<#1e>110"> .