diff options
Diffstat (limited to 'specs/XProtocol/X11.protocol')
| -rw-r--r-- | specs/XProtocol/X11.protocol | 591 |
1 files changed, 410 insertions, 181 deletions
diff --git a/specs/XProtocol/X11.protocol b/specs/XProtocol/X11.protocol index 660700b..3a4d15c 100644 --- a/specs/XProtocol/X11.protocol +++ b/specs/XProtocol/X11.protocol @@ -1,4 +1,9 @@ .\" $Xorg: X11.protocol,v 1.3 2000/08/17 19:42:23 cpqbld Exp $ +.\" +.\" +.\" +.\" +.\" $XFree86: xc/doc/specs/XProtocol/X11.protocol,v 1.3 2001/01/17 16:57:42 dawes Exp $ .EH '''' .OH '''' .EF '''' @@ -1440,8 +1445,8 @@ delim %% .sM .IN "CreateWindow" "" "@DEF@" .PN CreateWindow -.in +.2i .LP +.in +.2i \fIwid\fP, \fIparent\fP\^: WINDOW .br \fIclass\fP\^: @@ -1461,7 +1466,9 @@ delim %% \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap , @@ -1945,14 +1952,16 @@ The server might or might not make a copy of the pixmap. .sM .IN "ChangeWindowAttributes" "" "@DEF@" .PN ChangeWindowAttributes -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Colormap , @@ -2033,14 +2042,14 @@ a subset of the attributes may have been altered. .sM .IN "GetWindowAttributes" "" "@DEF@" .PN GetWindowAttributes -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i visual: VISUALID .br class: @@ -2077,7 +2086,9 @@ all-event-masks, your-event-mask: SETofEVENT do-not-propagate-mask: SETofDEVICEEVENT .br override-redirect: BOOL +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2095,10 +2106,12 @@ Your-event-mask is the event mask selected by the querying client. .sM .IN "DestroyWindow" "" "@DEF@" .PN DestroyWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2129,10 +2142,12 @@ this request has no effect. .sM .IN "DestroySubwindows" "" "@DEF@" .PN DestroySubwindows -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2146,15 +2161,17 @@ request on all children of the window, in bottom-to-top stacking order. .sM .IN "ChangeSaveSet" "" "@DEF@" .PN ChangeSaveSet -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fImode\fP\^: .Pn { Insert , .PN Delete } +.in -.2i .LP Errors: +.in +.2i .PN Match , .PN Value , .PN Window @@ -2176,12 +2193,14 @@ the server automatically removes them from the save-set. .sM .IN "ReparentWindow" "" "@DEF@" .PN ReparentWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^, \fIparent\fP\^: WINDOW .br \fIx\fP\^, \fIy\fP\^: INT16 +.in -.2i .LP +.in +.2i Errors: .PN Match , .PN Window @@ -2234,10 +2253,12 @@ background, and the new parent is not the same depth as the window. .sM .IN "MapWindow" "" "@DEF@" .PN MapWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2272,10 +2293,12 @@ Similar tiling and exposure take place for any newly viewable inferiors. .sM .IN "MapSubwindows" "" "@DEF@" .PN MapSubwindows -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2290,10 +2313,12 @@ in top-to-bottom stacking order. .sM .IN "UnmapWindow" "" "@DEF@" .PN UnmapWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2309,10 +2334,12 @@ Normal exposure processing on formerly obscured windows is performed. .sM .IN "UnmapSubwindows" "" "@DEF@" .PN UnmapSubwindows -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2327,14 +2354,16 @@ in bottom-to-top stacking order. .sM .IN "ConfigureWindow" "" "@DEF@" .PN ConfigureWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Match , .PN Value , @@ -2675,14 +2704,16 @@ Attempts to configure a root window have no effect. .sM .IN "CirculateWindow" "" "@DEF@" .PN CirculateWindow -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIdirection\fP\^: .Pn { RaiseLowest , .PN LowerHighest } +.in -.2i .LP +.in +.2i Errors: .PN Value , .PN Window @@ -2714,14 +2745,14 @@ Exposure processing is performed on formerly obscured windows. .sM .IN "GetGeometry" "" "@DEF@" .PN GetGeometry -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i root: WINDOW .br depth: CARD8 @@ -2729,7 +2760,9 @@ depth: CARD8 x, y: INT16 .br width, height, border-width: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Drawable .in -.2i @@ -2751,21 +2784,23 @@ window as a drawable to this request. .sM .IN "QueryTree" "" "@DEF@" .PN QueryTree -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW -.LP .in -.2i +.LP \(-> -.in +.2i .LP +.in +.2i root: WINDOW .br parent: WINDOW or .PN None .br children: LISTofWINDOW +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -2778,19 +2813,21 @@ The children are listed in bottom-to-top stacking order. .sM .IN "InternAtom" "" "@DEF@" .PN InternAtom -.in +.2i .LP +.in +.2i \fIname\fP\^: STRING8 .br \fIonly-if-exists\fP\^: BOOL .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i atom: ATOM or .PN None +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Value @@ -2811,16 +2848,18 @@ Atoms remain defined until server reset (see section 10). .sM .IN "GetAtomName" "" "@DEF@" .PN GetAtomName -.in +.2i .LP +.in +.2i \fIatom\fP\^: ATOM .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i name: STRING8 +.in -.2i .LP +.in +.2i Errors: .PN Atom .in -.2i @@ -2832,8 +2871,8 @@ This request returns the name for the given atom. .sM .IN "ChangeProperty" "" "@DEF@" .PN ChangeProperty -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIproperty\fP, \fItype\fP\^: ATOM @@ -2846,7 +2885,9 @@ This request returns the name for the given atom. .PN Append } .br \fIdata\fP\^: LISTofINT8 or LISTofINT16 or LISTofINT32 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Atom , @@ -2895,12 +2936,14 @@ The maximum size of a property is server-dependent and may vary dynamically. .sM .IN "DeleteProperty" "" "@DEF@" .PN DeleteProperty -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIproperty\fP\^: ATOM +.in -.2i .LP +.in +.2i Errors: .PN Atom , .PN Window @@ -2916,8 +2959,8 @@ event on the window unless the property does not exist. .sM .IN "GetProperty" "" "@DEF@" .PN GetProperty -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIproperty\fP\^: ATOM @@ -2931,8 +2974,8 @@ event on the window unless the property does not exist. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i type: ATOM or .PN None .br @@ -2941,7 +2984,9 @@ format: {0, 8, 16, 32} bytes-after: CARD32 .br value: LISTofINT8 or LISTofINT16 or LISTofINT32 +.in -.2i .LP +.in +.2i Errors: .PN Atom , .PN Value , @@ -2997,14 +3042,16 @@ event is generated on the window. .sM .IN "RotateProperties" "" "@DEF@" .PN RotateProperties -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIdelta\fP\^: INT16 .br \fIproperties\fP\^: LISTofATOM +.in -.2i .LP +.in +.2i Errors: .PN Atom , .PN Match , @@ -3039,16 +3086,18 @@ error is generated, no properties are changed. .sM .IN "ListProperties" "" "@DEF@" .PN ListProperties -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i atoms: LISTofATOM +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -3060,8 +3109,8 @@ This request returns the atoms of properties currently defined on the window. .sM .IN "SetSelectionOwner" "" "@DEF@" .PN SetSelectionOwner -.in +.2i .LP +.in +.2i \fIselection\fP\^: ATOM .br \fIowner\fP\^: WINDOW or @@ -3069,7 +3118,9 @@ This request returns the atoms of properties currently defined on the window. .br \fItime\fP\^: TIMESTAMP or .PN CurrentTime +.in -.2i .LP +.in +.2i Errors: .PN Atom , .PN Window @@ -3122,17 +3173,19 @@ Selections are global to the server. .sM .IN "GetSelectionOwner" "" "@DEF@" .PN GetSelectionOwner -.in +.2i .LP +.in +.2i \fIselection\fP\^: ATOM .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i owner: WINDOW or .PN None +.in -.2i .LP +.in +.2i Errors: .PN Atom .in -.2i @@ -3148,8 +3201,8 @@ is returned, then there is no owner for the selection. .sM .IN "ConvertSelection" "" "@DEF@" .PN ConvertSelection -.in +.2i .LP +.in +.2i \fIselection\fP, \fItarget\fP\^: ATOM .br \fIproperty\fP\^: ATOM or @@ -3159,7 +3212,9 @@ is returned, then there is no owner for the selection. .br \fItime\fP\^: TIMESTAMP or .PN CurrentTime +.in -.2i .LP +.in +.2i Errors: .PN Atom , .PN Window @@ -3181,8 +3236,8 @@ The arguments are passed on unchanged in either of the events. .sM .IN "SendEvent" "" "@DEF@" .PN SendEvent -.in +.2i .LP +.in +.2i \fIdestination\fP\^: WINDOW or .PN PointerWindow or @@ -3193,7 +3248,9 @@ or \fIevent-mask\fP\^: SETofEVENT .br \fIevent\fP\^: <normal-event-format> +.in -.2i .LP +.in +.2i Errors: .PN Value , .PN Window @@ -3250,8 +3307,8 @@ Active grabs are ignored for this request. .sM .IN "GrabPointer" "" "@DEF@" .PN GrabPointer -.in +.2i .LP +.in +.2i \fIgrab-window\fP\^: WINDOW .br \fIowner-events\fP\^: BOOL @@ -3273,15 +3330,17 @@ Active grabs are ignored for this request. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i status: .Pn { Success , .PN AlreadyGrabbed , .PN Frozen , .PN InvalidTime , .PN NotViewable } +.in -.2i .LP +.in +.2i Errors: .PN Cursor , .PN Value , @@ -3380,8 +3439,8 @@ replaced by the current server time. .sM .IN "UngrabPointer" "" "@DEF@" .PN UngrabPointer -.in +.2i .LP +.in +.2i \fItime\fP\^: TIMESTAMP or .PN CurrentTime .in -.2i @@ -3413,8 +3472,8 @@ completely outside the boundaries of the root window. .sM .IN "GrabButton" "" "@DEF@" .PN GrabButton -.in +.2i .LP +.in +.2i \fImodifiers\fP\^: SETofKEYMASK or .PN AnyModifier .br @@ -3436,7 +3495,9 @@ completely outside the boundaries of the root window. .br \fIcursor\fP\^: CURSOR or .PN None +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Cursor , @@ -3507,8 +3568,8 @@ The request has no effect on an active grab. .sM .IN "UngrabButton" "" "@DEF@" .PN UngrabButton -.in +.2i .LP +.in +.2i \fImodifiers\fP\^: SETofKEYMASK or .PN AnyModifier .br @@ -3516,7 +3577,9 @@ The request has no effect on an active grab. .PN AnyButton .br \fIgrab-window\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Value , .PN Window @@ -3538,8 +3601,8 @@ The request has no effect on an active grab. .sM .IN "ChangeActivePointerGrab" "" "@DEF@" .PN ChangeActivePointerGrab -.in +.2i .LP +.in +.2i \fIevent-mask\fP\^: SETofPOINTEREVENT .br \fIcursor\fP\^: CURSOR or @@ -3547,7 +3610,9 @@ The request has no effect on an active grab. .br \fItime\fP\^: TIMESTAMP or .PN CurrentTime +.in -.2i .LP +.in +.2i Errors: .PN Cursor , .PN Value @@ -3567,8 +3632,8 @@ with .sM .IN "GrabKeyboard" "" "@DEF@" .PN GrabKeyboard -.in +.2i .LP +.in +.2i \fIgrab-window\fP\^: WINDOW .br \fIowner-events\fP\^: BOOL @@ -3582,15 +3647,17 @@ with .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i status: .Pn { Success , .PN AlreadyGrabbed , .PN Frozen , .PN InvalidTime , .PN NotViewable } +.in -.2i .LP +.in +.2i Errors: .PN Value , .PN Window @@ -3671,8 +3738,8 @@ replaced by the current server time. .sM .IN "UngrabKeyboard" "" "@DEF@" .PN UngrabKeyboard -.in +.2i .LP +.in +.2i \fItime\fP\^: TIMESTAMP or .PN CurrentTime .in -.2i @@ -3702,8 +3769,8 @@ becomes not viewable. .sM .IN "GrabKey" "" "@DEF@" .PN GrabKey -.in +.2i .LP +.in +.2i \fIkey\fP\^: KEYCODE or .PN AnyKey .br @@ -3717,7 +3784,9 @@ becomes not viewable. \fIpointer-mode\fP, \fIkeyboard-mode\fP\^: .Pn { Synchronous , .PN Asynchronous } +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Value , @@ -3789,8 +3858,8 @@ error is generated if there is a conflicting grab for any combination. .sM .IN "UngrabKey" "" "@DEF@" .PN UngrabKey -.in +.2i .LP +.in +.2i \fIkey\fP\^: KEYCODE or .PN AnyKey .br @@ -3798,7 +3867,9 @@ error is generated if there is a conflicting grab for any combination. .PN AnyModifier .br \fIgrab-window\fP\^: WINDOW +.in -.2i .LP +.in +.2i Errors: .PN Value , .PN Window @@ -3820,8 +3891,8 @@ This request has no effect on an active grab. .sM .IN "AllowEvents" "" "@DEF@" .PN AllowEvents -.in +.2i .LP +.in +.2i \fImode\fP: .Pn { AsyncPointer , .PN SyncPointer , @@ -3836,7 +3907,9 @@ This request has no effect on an active grab. .br \fItime\fP\^: TIMESTAMP or .PN CurrentTime +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -4015,14 +4088,14 @@ on other connections. .sM .IN "QueryPointer" "" "@DEF@" .PN QueryPointer -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i root: WINDOW .br child: WINDOW or @@ -4033,7 +4106,9 @@ same-screen: BOOL root-x, root-y, win-x, win-y: INT16 .br mask: SETofKEYBUTMASK +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -4061,8 +4136,8 @@ may lag the physical state if device event processing is frozen. .sM .IN "GetMotionEvents" "" "@DEF@" .PN GetMotionEvents -.in +.2i .LP +.in +.2i \fIstart\fP, \fIstop\fP\^: TIMESTAMP or .PN CurrentTime .br @@ -4070,10 +4145,12 @@ may lag the physical state if device event processing is frozen. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i events: LISTofTIMECOORD +.in -.2i .LP +.in +.2i where: .TS l l. @@ -4081,7 +4158,9 @@ TIMECOORD: [x, y: INT16 .br \ time: TIMESTAMP] .TE +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -4102,23 +4181,25 @@ If the stop time is in the future, it is equivalent to specifying .sM .IN "TranslateCoordinates" "" "@DEF@" .PN TranslateCoordinates -.in +.2i .LP +.in +.2i \fIsrc-window\fP, \fIdst-window\fP: WINDOW .br \fIsrc-x\fP, \fIsrc-y\fP\^: INT16 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i same-screen: BOOL .br child: WINDOW or .PN None .br dst-x, dst-y: INT16 +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -4138,8 +4219,8 @@ then that child is returned. .sM .IN "WarpPointer" "" "@DEF@" .PN WarpPointer -.in +.2i .LP +.in +.2i \fIsrc-window\fP\^: WINDOW or .PN None .br @@ -4151,7 +4232,9 @@ then that child is returned. \fIsrc-width\fP, \fIsrc-height\fP\^: CARD16 .br \fIdst-x\fP, \fIdst-y\fP\^: INT16 +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -4187,8 +4270,8 @@ moved the pointer. .sM .IN "SetInputFocus" "" "@DEF@" .PN SetInputFocus -.in +.2i .LP +.in +.2i \fIfocus\fP\^: WINDOW or .PN PointerRoot or @@ -4201,7 +4284,9 @@ or .br \fItime\fP\^: TIMESTAMP or .PN CurrentTime +.in -.2i .LP +.in +.2i Errors: .PN Match , .PN Value , @@ -4271,8 +4356,8 @@ but the last-focus-change time is not affected. .PN GetInputFocus .LP \(-> -.in +.2i .LP +.in +.2i focus: WINDOW or .PN PointerRoot or @@ -4293,8 +4378,8 @@ This request returns the current focus state. .PN QueryKeymap .LP \(-> -.in +.2i .LP +.in +.2i keys: LISTofCARD8 .in -.2i .eM @@ -4311,12 +4396,14 @@ may lag the physical state if device event processing is frozen. .sM .IN "OpenFont" "" "@DEF@" .PN OpenFont -.in +.2i .LP +.in +.2i \fIfid\fP\^: FONT .br \fIname\fP\^: STRING8 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN IDChoice , @@ -4344,10 +4431,12 @@ and can be stored as a component of any graphics context. .sM .IN "CloseFont" "" "@DEF@" .PN CloseFont -.in +.2i .LP +.in +.2i \fIfont\fP\^: FONT +.in -.2i .LP +.in +.2i Errors: .PN Font .in -.2i @@ -4360,18 +4449,20 @@ The font itself will be freed when no other resource references it. .sM .IN "QueryFont" "" "@DEF@" .PN QueryFont -.in +.2i .LP +.in +.2i \fIfont\fP\^: FONTABLE .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i font-info: FONTINFO .br char-infos: LISTofCHARINFO +.in -.2i .LP +.in +.2i where: .IP .TS @@ -4401,7 +4492,9 @@ CHARINFO: [left-side-bearing: INT16 \ descent: INT16 \ attributes: CARD16] .TE +.in -.2i .LP +.in +.2i Errors: .PN Font .in -.2i @@ -4539,16 +4632,16 @@ server-dependent. .sM .IN "QueryTextExtents" "" "@DEF@" .PN QueryTextExtents -.in +.2i .LP +.in +.2i \fIfont\fP\^: FONTABLE .br \fIstring\fP\^: STRING16 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i draw-direction: .Pn { LeftToRight , .PN RightToLeft } @@ -4566,7 +4659,9 @@ overall-width: INT32 overall-left: INT32 .br overall-right: INT32 +.in -.2i .LP +.in +.2i Errors: .PN Font .in -.2i @@ -4604,16 +4699,16 @@ then undefined characters in the string are also ignored. .sM .IN "ListFonts" "" "@DEF@" .PN ListFonts -.in +.2i .LP +.in +.2i \fIpattern\fP\^: STRING8 .br \fImax-names\fP\^: CARD16 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i names: LISTofSTRING8 .in -.2i .eM @@ -4636,27 +4731,30 @@ The returned names are in lowercase. .sM .IN "ListFontsWithInfo" "" "@DEF@" .PN ListFontsWithInfo -.in +.2i .LP +.in +.2i \fIpattern\fP\^: STRING8 .br \fImax-names\fP\^: CARD16 .in -.2i .LP - \(->+ -.in +.2i + \(-> .LP +.in +.2i name: STRING8 .br -info: FONTINFO +info FONTINFO .br replies-hint: CARD32 +.in -.2i .LP +.in +.2i where: +.in -.2i .LP -FONTINFO: <same type definition as in +.in +.2i +FONTINFO: <same type definition as in .PN QueryFont > -.in -.2i .eM .LP This request is similar to @@ -4679,10 +4777,12 @@ sequence. .sM .IN "SetFontPath" "" "@DEF@" .PN SetFontPath -.in +.2i .LP +.in +.2i \fIpath\fP\^: LISTofSTRING8 +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -4709,8 +4809,8 @@ The meaning of an error from this request is system specific. .PN GetFontPath .LP \(-> -.in +.2i .LP +.in +.2i path: LISTofSTRING8 .in -.2i .eM @@ -4721,8 +4821,8 @@ This request returns the current search path for fonts. .sM .IN "CreatePixmap" "" "@DEF@" .PN CreatePixmap -.in +.2i .LP +.in +.2i \fIpid\fP\^: PIXMAP .br \fIdrawable\fP\^: DRAWABLE @@ -4730,7 +4830,9 @@ This request returns the current search path for fonts. \fIdepth\fP\^: CARD8 .br \fIwidth\fP, \fIheight\fP\^: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Drawable , @@ -4757,10 +4859,12 @@ window as a drawable to this request. .sM .IN "FreePixmap" "" "@DEF@" .PN FreePixmap -.in +.2i .LP +.in +.2i \fIpixmap\fP\^: PIXMAP +.in -.2i .LP +.in +.2i Errors: .PN Pixmap .in -.2i @@ -4773,8 +4877,8 @@ The pixmap storage will be freed when no other resource references it. .sM .IN "CreateGC" "" "@DEF@" .PN CreateGC -.in +.2i .LP +.in +.2i \fIcid\fP\^: GCONTEXT .br \fIdrawable\fP\^: DRAWABLE @@ -4782,7 +4886,9 @@ The pixmap storage will be freed when no other resource references it. \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Drawable , @@ -5655,14 +5761,16 @@ changes to a single gcontext. .sM .IN "ChangeGC" "" "@DEF@" .PN ChangeGC -.in +.2i .LP +.in +.2i \fIgc\fP\^: GCONTEXT .br \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Font , @@ -5694,12 +5802,14 @@ a subset of the components may have been altered. .sM .IN "CopyGC" "" "@DEF@" .PN CopyGC -.in +.2i .LP +.in +.2i \fIsrc-gc\fP, \fIdst-gc\fP\^: GCONTEXT .br \fIvalue-mask\fP\^: BITMASK +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN GContext , @@ -5719,14 +5829,16 @@ error results). .sM .IN "SetDashes" "" "@DEF@" .PN SetDashes -.in +.2i .LP +.in +.2i \fIgc\fP\^: GCONTEXT .br \fIdash-offset\fP\^: CARD16 .br \fIdashes\fP\^: LISTofCARD8 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN GContext , @@ -5791,8 +5903,8 @@ would be included in the dash when drawn unclipped. .sM .IN "SetClipRectangles" "" "@DEF@" .PN SetClipRectangles -.in +.2i .LP +.in +.2i \fIgc\fP\^: GCONTEXT .br \fIclip-x-origin\fP, \fIclip-y-origin\fP\^: INT16 @@ -5804,7 +5916,9 @@ would be included in the dash when drawn unclipped. .PN YSorted , .PN YXSorted , .PN YXBanded } +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN GContext , @@ -5860,10 +5974,12 @@ extents. .sM .IN "FreeGC" "" "@DEF@" .PN FreeGC -.in +.2i .LP +.in +.2i \fIgc\fP\^: GCONTEXT +.in -.2i .LP +.in +.2i Errors: .PN GContext .in -.2i @@ -5876,8 +5992,8 @@ and destroys the gcontext. .sM .IN "ClearArea" "" "@DEF@" .PN ClearArea -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -5885,7 +6001,9 @@ and destroys the gcontext. \fIwidth\fP, \fIheight\fP: CARD16 .br \fIexposures\fP\^: BOOL +.in -.2i .LP +.in +.2i Errors: .PN Match , .PN Value , @@ -5923,8 +6041,8 @@ window in this request. .sM .IN "CopyArea" "" "@DEF@" .PN CopyArea -.in +.2i .LP +.in +.2i \fIsrc-drawable\fP, \fIdst-drawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -5934,7 +6052,9 @@ window in this request. \fIwidth\fP, \fIheight\fP\^: CARD16 .br \fIdst-x\fP, \fIdst-y\fP\^: INT16 +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -5987,8 +6107,8 @@ graphics-exposures, clip-x-origin, clip-y-origin, clip-mask .sM .IN "CopyPlane" "" "@DEF@" .PN CopyPlane -.in +.2i .LP +.in +.2i \fIsrc-drawable\fP, \fIdst-drawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6000,7 +6120,9 @@ graphics-exposures, clip-x-origin, clip-y-origin, clip-mask \fIdst-x\fP, \fIdst-y\fP\^: INT16 .br \fIbit-plane\fP\^: CARD32 +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6036,8 +6158,8 @@ clip-mask .sM .IN "PolyPoint" "" "@DEF@" .PN PolyPoint -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6047,7 +6169,9 @@ clip-mask .PN Previous } .br \fIpoints\fP\^: LISTofPOINT +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6071,8 +6195,8 @@ clip-x-origin, clip-y-origin, clip-mask .sM .IN "PolyLine" "" "@DEF@" .PN PolyLine -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6082,7 +6206,9 @@ clip-x-origin, clip-y-origin, clip-mask .PN Previous } .br \fIpoints\fP\^: LISTofPOINT +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6129,18 +6255,24 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes .sM .IN "PolySegment" "" "@DEF@" .PN PolySegment -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT .br \fIsegments\fP\^: LISTofSEGMENT +.in -.2i .LP +.in +.2i where: +.in -.2i .LP +.in +.2i SEGMENT: [x1, y1, x2, y2: INT16] +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6168,14 +6300,16 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes .sM .IN "PolyRectangle" "" "@DEF@" .PN PolyRectangle -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT .br \fIrectangles\fP\^: LISTofRECTANGLE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6211,14 +6345,16 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes .sM .IN "PolyArc" "" "@DEF@" .PN PolyArc -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT .br \fIarcs\fP\^: LISTofARC +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6340,8 +6476,8 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes .sM .IN "FillPoly" "" "@DEF@" .PN FillPoly -.in +.2i .LP +.in +.2in \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6356,7 +6492,9 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes .PN Previous } .br \fIpoints\fP\^: LISTofPOINT +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6416,14 +6554,16 @@ tile-stipple-x-origin, tile-stipple-y-origin .sM .IN "PolyFillRectangle" "" "@DEF@" .PN PolyFillRectangle -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT .br \fIrectangles\fP\^: LISTofRECTANGLE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6457,14 +6597,16 @@ tile-stipple-x-origin, tile-stipple-y-origin .sM .IN "PolyFillArc" "" "@DEF@" .PN PolyFillArc -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT .br \fIarcs\fP\^: LISTofARC +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6521,8 +6663,8 @@ tile-stipple-x-origin, tile-stipple-y-origin .sM .IN "PutImage" "" "@DEF@" .PN PutImage -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6541,7 +6683,9 @@ tile-stipple-x-origin, tile-stipple-y-origin .PN ZPixmap } .br \fIdata\fP\^: LISTofBYTE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6604,8 +6748,8 @@ GC mode-dependent components: foreground, background .sM .IN "GetImage" "" "@DEF@" .PN GetImage -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIx\fP, \fIy\fP\^: INT16 @@ -6620,15 +6764,17 @@ GC mode-dependent components: foreground, background .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i depth: CARD8 .br visual: VISUALID or .PN None .br data: LISTofBYTE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN Match , @@ -6690,8 +6836,8 @@ It is intended specifically for rudimentary hardcopy support. .sM .IN "PolyText8" "" "@DEF@" .PN PolyText8 -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6699,7 +6845,9 @@ It is intended specifically for rudimentary hardcopy support. \fIx\fP, \fIy\fP\^: INT16 .br \fIitems\fP\^: LISTofTEXTITEM8 +.in -.2i .LP +.in +.2i where: .TS r l. @@ -6709,7 +6857,9 @@ TEXTELT8: [delta: INT8 .br \ string: STRING8] .TE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN Font , @@ -6751,8 +6901,8 @@ tile-stipple-x-origin, tile-stipple-y-origin .sM .IN "PolyText16" "" "@DEF@" .PN PolyText16 -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6760,7 +6910,9 @@ tile-stipple-x-origin, tile-stipple-y-origin \fIx\fP, \fIy\fP\^: INT16 .br \fIitems\fP\^: LISTofTEXTITEM16 +.in -.2i .LP +.in +.2i where: .TS r l. @@ -6770,7 +6922,9 @@ TEXTELT16: [delta: INT8 .br \ string: STRING16] .TE +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN Font , @@ -6791,8 +6945,8 @@ CHAR2B is taken as the most significant byte). .sM .IN "ImageText8" "" "@DEF@" .PN ImageText8 -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6800,7 +6954,9 @@ CHAR2B is taken as the most significant byte). \fIx\fP, \fIy\fP\^: INT16 .br \fIstring\fP\^: STRING8 +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6849,8 +7005,8 @@ subwindow-mode, clip-x-origin, clip-y-origin, clip-mask .sM .IN "ImageText16" "" "@DEF@" .PN ImageText16 -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIgc\fP\^: GCONTEXT @@ -6858,7 +7014,9 @@ subwindow-mode, clip-x-origin, clip-y-origin, clip-mask \fIx\fP, \fIy\fP\^: INT16 .br \fIstring\fP\^: STRING16 +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN GContext , @@ -6878,8 +7036,8 @@ CHAR2B is taken as the most significant byte). .sM .IN "CreateColormap" "" "@DEF@" .PN CreateColormap -.in +.2i .LP +.in +.2i \fImid\fP\^: COLORMAP .br \fIvisual\fP\^: VISUALID @@ -6889,7 +7047,9 @@ CHAR2B is taken as the most significant byte). \fIalloc\fP\^: .Pn { None , .PN All } +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN IDChoice , @@ -6959,10 +7119,12 @@ in all cases, none of these entries can be freed with .sM .IN "FreeColormap" "" "@DEF@" .PN FreeColormap -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP +.in -.2i .LP +.in +.2i Errors: .PN Colormap .in -.2i @@ -6992,10 +7154,12 @@ This request has no effect on a default colormap for a screen. .sM .IN "CopyColormapAndFree" "" "@DEF@" .PN CopyColormapAndFree -.in +.2i .LP +.in +.2i \fImid\fP, \fIsrc-cmap\fP\^: COLORMAP +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap , @@ -7035,10 +7199,12 @@ and that have not been freed since they were allocated. .sM .IN "InstallColormap" "" "@DEF@" .PN InstallColormap -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP +.in -.2i .LP +.in +.2i Errors: .PN Colormap .in -.2i @@ -7085,10 +7251,12 @@ the required list). .sM .IN "UninstallColormap" "" "@DEF@" .PN UninstallColormap -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP +.in -.2i .LP +.in +.2i Errors: .PN Colormap .in -.2i @@ -7117,16 +7285,18 @@ event is generated on every window having that colormap as an attribute. .sM .IN "ListInstalledColormaps" "" "@DEF@" .PN ListInstalledColormaps -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i cmaps: LISTofCOLORMAP +.in -.2i .LP +.in +.2i Errors: .PN Window .in -.2i @@ -7143,20 +7313,22 @@ request). .sM .IN "AllocColor" "" "@DEF@" .PN AllocColor -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIred\fP, \fIgreen\fP, \fIblue\fP\^: CARD16 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i pixel: CARD32 .br red, green, blue: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap @@ -7173,22 +7345,24 @@ the same read-only entry, allowing entries to be shared. .sM .IN "AllocNamedColor" "" "@DEF@" .PN AllocNamedColor -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIname\fP\^: STRING8 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i pixel: CARD32 .br exact-red, exact-green, exact-blue: CARD16 .br visual-red, visual-green, visual-blue: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap , @@ -7210,8 +7384,8 @@ and the visual values specify the values actually used in the colormap. .sM .IN "AllocColorCells" "" "@DEF@" .PN AllocColorCells -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIcolors\fP, \fIplanes\fP\^: CARD16 @@ -7220,10 +7394,12 @@ and the visual values specify the values actually used in the colormap. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i pixels, masks: LISTofCARD32 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap , @@ -7264,8 +7440,8 @@ The RGB values of the allocated entries are undefined. .sM .IN "AllocColorPlanes" "" "@DEF@" .PN AllocColorPlanes -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIcolors\fP, \fIreds\fP, \fIgreens\fP, \fIblues\fP\^: CARD16 @@ -7274,12 +7450,14 @@ The RGB values of the allocated entries are undefined. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i pixels: LISTofCARD32 .br red-mask, green-mask, blue-mask: CARD32 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Colormap , @@ -7323,14 +7501,16 @@ corresponding independent entries are updated. .sM .IN "FreeColors" "" "@DEF@" .PN FreeColors -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIpixels\fP\^: LISTofCARD32 .br \fIplane-mask\fP\^: CARD32 +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Colormap , @@ -7380,12 +7560,14 @@ it is arbitrary as to which pixel is reported. .sM .IN "StoreColors" "" "@DEF@" .PN StoreColors -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIitems\fP\^: LISTofCOLORITEM +.in -.2i .LP +.in +.2i where: .TS l l. @@ -7395,7 +7577,9 @@ COLORITEM: [pixel: CARD32 .br \ red, green, blue: CARD16] .TE +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Colormap , @@ -7424,8 +7608,8 @@ it is arbitrary as to which pixel is reported. .sM .IN "StoreNamedColor" "" "@DEF@" .PN StoreNamedColor -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIpixel\fP\^: CARD32 @@ -7433,7 +7617,9 @@ it is arbitrary as to which pixel is reported. \fIname\fP\^: STRING8 .br \fIdo-red\fP, \fIdo-green\fP\^, \fIdo-blue\fP\^: BOOL +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Colormap , @@ -7459,23 +7645,28 @@ errors are the same as in .sM .IN "QueryColors" "" "@DEF@" .PN QueryColors -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIpixels\fP\^: LISTofCARD32 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i colors: LISTofRGB +.in -.2i .LP +.in +.2i where: +.in -.2i .LP -.DS 0 +.in +.2i RGB: [red, green, blue: CARD16] -.DE +.in -.2i +.LP +.in +.2i Errors: .PN Colormap , .PN Value @@ -7495,20 +7686,22 @@ it is arbitrary as to which pixel is reported. .sM .IN "LookupColor" "" "@DEF@" .PN LookupColor -.in +.2i .LP +.in +.2i \fIcmap\fP\^: COLORMAP .br \fIname\fP\^: STRING8 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i exact-red, exact-green, exact-blue: CARD16 .br visual-red, visual-green, visual-blue: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Colormap , .PN Name @@ -7526,8 +7719,8 @@ and uppercase and lowercase do not matter. .sM .IN "CreateCursor" "" "@DEF@" .PN CreateCursor -.in +.2i .LP +.in +.2i \fIcid\fP\^: CURSOR .br \fIsource\fP\^: PIXMAP @@ -7540,7 +7733,9 @@ and uppercase and lowercase do not matter. \fIback-red\fP, \fIback-green\fP, \fIback-blue\fP\^: CARD16 .br \fIx\fP, \fIy\fP\^: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN IDChoice , @@ -7590,8 +7785,8 @@ The server might or might not make a copy of the pixmap. .sM .IN "CreateGlyphCursor" "" "@DEF@" .PN CreateGlyphCursor -.in +.2i .LP +.in +.2i \fIcid\fP\^: CURSOR .br \fIsource-font\fP\^: FONT @@ -7604,7 +7799,9 @@ The server might or might not make a copy of the pixmap. \fIfore-red\fP, \fIfore-green\fP, \fIfore-blue\fP\^: CARD16 .br \fIback-red\fP, \fIback-green\fP, \fIback-blue\fP\^: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Font , @@ -7644,10 +7841,12 @@ them are to be made. .sM .IN "FreeCursor" "" "@DEF@" .PN FreeCursor -.in +.2i .LP +.in +.2i \fIcursor\fP\^: CURSOR +.in -.2i .LP +.in +.2i Errors: .PN Cursor .in -.2i @@ -7660,14 +7859,16 @@ The cursor storage will be freed when no other resource references it. .sM .IN "RecolorCursor" "" "@DEF@" .PN RecolorCursor -.in +.2i .LP +.in +.2i \fIcursor\fP\^: CURSOR .br \fIfore-red\fP, \fIfore-green\fP, \fIfore-blue\fP\^: CARD16 .br \fIback-red\fP, \fIback-green\fP, \fIback-blue\fP\^: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Cursor .in -.2i @@ -7681,8 +7882,8 @@ the change is visible immediately. .sM .IN "QueryBestSize" "" "@DEF@" .PN QueryBestSize -.in +.2i .LP +.in +.2i \fIclass\fP: .Pn { Cursor , .PN Tile , @@ -7694,10 +7895,12 @@ the change is visible immediately. .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i width, height: CARD16 +.in -.2i .LP +.in +.2i Errors: .PN Drawable , .PN Match , @@ -7738,14 +7941,14 @@ error results). .sM .IN "QueryExtension" "" "@DEF@" .PN QueryExtension -.in +.2i .LP +.in +.2i \fIname\fP\^: STRING8 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i present: BOOL .br major-opcode: CARD8 @@ -7779,8 +7982,8 @@ and uppercase and lowercase matter. .PN ListExtensions .LP \(-> -.in +.2i .LP +.in +.2i names: LISTofSTRING8 .in -.2i .eM @@ -7790,21 +7993,23 @@ This request returns a list of all extensions supported by the server. .sM .IN "SetModifierMapping" "" "@DEF@" .PN SetModifierMapping -.in +.2i .LP +.in +.2i \fIkeycodes-per-modifier\fP\^: CARD8 .br \fIkeycodes\fP\^: LISTofKEYCODE .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i status: .Pn { Success , .PN Busy , .PN Failed } +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Value @@ -7870,8 +8075,8 @@ status. .PN GetModifierMapping .LP \(-> -.in +.2i .LP +.in +.2i keycodes-per-modifier: CARD8 .br keycodes: LISTofKEYCODE @@ -7903,14 +8108,16 @@ The order of keycodes within each set is chosen arbitrarily by the server. .sM .IN "ChangeKeyboardMapping" "" "@DEF@" .PN ChangeKeyboardMapping -.in +.2i .LP +.in +.2i \fIfirst-keycode\fP\^: KEYCODE .br \fIkeysyms-per-keycode\fP\^: CARD8 .br \fIkeysyms\fP\^: LISTofKEYSYM +.in -.2i .LP +.in +.2i Errors: .PN Alloc , .PN Value @@ -7963,20 +8170,22 @@ it is merely stored for reading and writing by clients (see section 5). .sM .IN "GetKeyboardMapping" "" "@DEF@" .PN GetKeyboardMapping -.in +.2i .LP +.in +.2i \fIfirst-keycode\fP\^: KEYCODE .br \fIcount\fP\^: CARD8 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i keysyms-per-keycode: CARD8 .br keysyms: LISTofKEYSYM +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8018,12 +8227,14 @@ is used to fill in unused elements for individual keycodes. .sM .IN "ChangeKeyboardControl" "" "@DEF@" .PN ChangeKeyboardControl -.in +.2i .LP +.in +.2i \fIvalue-mask\fP\^: BITMASK .br \fIvalue-list\fP\^: LISTofVALUE +.in -.2i .LP +.in +.2i Errors: .PN Match , .PN Value @@ -8168,8 +8379,8 @@ a subset of the controls may have been altered. .PN GetKeyboardControl .LP \(-> -.in +.2i .LP +.in +.2i key-click-percent: CARD8 .br bell-percent: CARD8 @@ -8202,10 +8413,12 @@ with the least significant bit in the byte representing key 8N. .sM .IN "Bell" "" "@DEF@" .PN Bell -.in +.2i .LP +.in +.2i \fIpercent\fP\^: INT8 +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8230,18 +8443,20 @@ base + [(base * percent) / 100] .sM .IN "SetPointerMapping" "" "@DEF@" .PN SetPointerMapping -.in +.2i .LP +.in +.2i \fImap\fP\^: LISTofCARD8 .in -.2i .LP \(-> -.in +.2i .LP +.in +.2i status: .Pn { Success , .PN Busy } +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8280,8 +8495,8 @@ status. .PN GetPointerMapping .LP \(-> -.in +.2i .LP +.in +.2i map: LISTofCARD8 .in -.2i .eM @@ -8296,14 +8511,16 @@ The nominal mapping for a pointer is the identity mapping: map[i]=i. .sM .IN "ChangePointerControl" "" "@DEF@" .PN ChangePointerControl -.in +.2i .LP +.in +.2i \fIdo-acceleration\fP, \fIdo-threshold\fP\^: BOOL .br \fIacceleration-numerator\fP, \fIacceleration-denominator\fP\^: INT16 .br \fIthreshold\fP\^: INT16 +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8327,8 +8544,8 @@ error, as does a zero value for acceleration-denominator. .PN GetPointerControl .LP \(-> -.in +.2i .LP +.in +.2i acceleration-numerator, acceleration-denominator: CARD16 .br threshold: CARD16 @@ -8341,8 +8558,8 @@ This request returns the current acceleration and threshold for the pointer. .sM .IN "SetScreenSaver" "" "@DEF@" .PN SetScreenSaver -.in +.2i .LP +.in +.2i \fItimeout\fP, \fIinterval\fP\^: INT16 .br \fIprefer-blanking\fP\^: @@ -8354,7 +8571,9 @@ This request returns the current acceleration and threshold for the pointer. .Pn { Yes , .PN No , .PN Default } +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8401,8 +8620,8 @@ randomly reorigined periodically. .PN GetScreenSaver .LP \(-> -.in +.2i .LP +.in +.2i timeout, interval: CARD16 .br prefer-blanking: @@ -8421,12 +8640,14 @@ This request returns the current screen-saver control values. .sM .IN "ForceScreenSaver" "" "@DEF@" .PN ForceScreenSaver -.in +.2i .LP +.in +.2i \fImode\fP\^: .Pn { Activate , .PN Reset } +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8448,14 +8669,16 @@ as if device input had just been received. .sM .IN "ChangeHosts" "" "@DEF@" .PN ChangeHosts -.in +.2i .LP +.in +.2i \fImode\fP\^: .Pn { Insert , .PN Delete } .br \fIhost\fP: HOST +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Value @@ -8519,8 +8742,8 @@ The server performs no automatic swapping on the address bytes. .PN ListHosts .LP \(-> -.in +.2i .LP +.in +.2i mode: .Pn { Enabled , .PN Disabled } @@ -8539,12 +8762,14 @@ Each HOST is padded to a multiple of four bytes. .sM .IN "SetAccessControl" "" "@DEF@" .PN SetAccessControl -.in +.2i .LP +.in +.2i \fImode\fP\^: .Pn { Enable , .PN Disable } +.in -.2i .LP +.in +.2i Errors: .PN Access , .PN Value @@ -8564,13 +8789,15 @@ error results). .sM .IN "SetCloseDownMode" "" "@DEF@" .PN SetCloseDownMode -.in +.2i .LP +.in +.2i \fImode\fP: .Pn { Destroy , .PN RetainPermanent , .PN RetainTemporary } +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8587,11 +8814,13 @@ The meaning of the close-down mode is described in section 10. .sM .IN "KillClient" "" "@DEF@" .PN KillClient -.in +.2i .LP +.in +.2i \fIresource\fP\^: CARD32 or .PN AllTemporary +.in -.2i .LP +.in +.2i Errors: .PN Value .in -.2i @@ -8795,8 +9024,8 @@ can both be used to modify the active grab. .br .IN "MotionNotify" "" "@DEF@" .PN MotionNotify -.in +.2i .LP +.in +.2i \fIroot\fP, \fIevent\fP\^: WINDOW .br \fIchild\fP\^: WINDOW or @@ -8925,8 +9154,8 @@ request. .br .IN "LeaveNotify" "" "@DEF@" .PN LeaveNotify -.in +.2i .LP +.in +.2i \fIroot\fP, \fIevent\fP\^: WINDOW .br \fIchild\fP\^: WINDOW or @@ -9160,8 +9389,8 @@ and final positions for the events. .br .IN "FocusOut" "" "@DEF@" .PN FocusOut -.in +.2i .LP +.in +.2i \fIevent\fP\^: WINDOW .br \fImode\fP\^: @@ -9484,8 +9713,8 @@ above) as if the focus were to change from G to F. .sM .IN "KeymapNotify" "" "@DEF@" .PN KeymapNotify -.in +.2i .LP +.in +.2i \fIkeys\fP\^: LISTofCARD8 .in -.2i .eM @@ -9503,8 +9732,8 @@ and .sM .IN "Expose" "" "@DEF@" .PN Expose -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP, \fIwidth\fP, \fIheight\fP\^: CARD16 @@ -9581,8 +9810,8 @@ events is not constrained. .sM .IN "GraphicsExposure" "" "@DEF@" .PN GraphicsExposure -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fIx\fP, \fIy\fP, \fIwidth\fP, \fIheight\fP\^: CARD16 @@ -9625,8 +9854,8 @@ and minor-opcode is always zero. .sM .IN "NoExposure" "" "@DEF@" .PN NoExposure -.in +.2i .LP +.in +.2i \fIdrawable\fP\^: DRAWABLE .br \fImajor-opcode\fP\^: CARD8 @@ -9655,8 +9884,8 @@ and the minor-opcode is always zero. .sM .IN "VisibilityNotify" "" "@DEF@" .PN VisibilityNotify -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIstate\fP\^: @@ -9726,8 +9955,8 @@ events is not constrained. .sM .IN "CreateNotify" "" "@DEF@" .PN CreateNotify -.in +.2i .LP +.in +.2i \fIparent\fP, \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -9750,8 +9979,8 @@ request. .sM .IN "DestroyNotify" "" "@DEF@" .PN DestroyNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .in -.2i .eM @@ -9778,8 +10007,8 @@ otherwise constrained. .sM .IN "UnmapNotify" "" "@DEF@" .PN UnmapNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .br \fIfrom-configure\fP\^: BOOL @@ -9804,8 +10033,8 @@ when the window itself had a win-gravity of .sM .IN "MapNotify" "" "@DEF@" .PN MapNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .br \fIoverride-redirect\fP\^: BOOL @@ -9826,8 +10055,8 @@ The override-redirect flag is from the window's attribute. .sM .IN "MapRequest" "" "@DEF@" .PN MapRequest -.in +.2i .LP +.in +.2i \fIparent\fP, \fIwindow\fP\^: WINDOW .in -.2i .eM @@ -9843,8 +10072,8 @@ request is issued on an unmapped window with an override-redirect attribute of .sM .IN "ReparentNotify" "" "@DEF@" .PN ReparentNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP, \fIparent\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -9870,8 +10099,8 @@ The override-redirect flag is from the window's attribute. .sM .IN "ConfigureNotify" "" "@DEF@" .PN ConfigureNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -9908,8 +10137,8 @@ The override-redirect flag is from the window's attribute. .sM .IN "GravityNotify" "" "@DEF@" .PN GravityNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -9932,8 +10161,8 @@ and specify the position of the upper-left outer corner of the window. .sM .IN "ResizeRequest" "" "@DEF@" .PN ResizeRequest -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIwidth\fP, \fIheight\fP\^: CARD16 @@ -9952,8 +10181,8 @@ The width and height are the requested inside size, not including the border. .sM .IN "ConfigureRequest" "" "@DEF@" .PN ConfigureRequest -.in +.2i .LP +.in +.2i \fIparent\fP, \fIwindow\fP\^: WINDOW .br \fIx\fP, \fIy\fP\^: INT16 @@ -9994,8 +10223,8 @@ and .sM .IN "CirculateNotify" "" "@DEF@" .PN CirculateNotify -.in +.2i .LP +.in +.2i \fIevent\fP, \fIwindow\fP\^: WINDOW .br \fIplace\fP\^: @@ -10023,8 +10252,8 @@ Otherwise, it is below all siblings. .sM .IN "CirculateRequest" "" "@DEF@" .PN CirculateRequest -.in +.2i .LP +.in +.2i \fIparent\fP, \fIwindow\fP\^: WINDOW .br \fIplace\fP: @@ -10045,8 +10274,8 @@ and the place specifies what the new position in the stacking order should be. .sM .IN "PropertyNotify" "" "@DEF@" .PN PropertyNotify -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIatom\fP\^: ATOM @@ -10086,8 +10315,8 @@ The timestamp indicates the server time when the property was changed. .sM .IN "SelectionClear" "" "@DEF@" .PN SelectionClear -.in +.2i .LP +.in +.2i \fIowner\fP\^: WINDOW .br \fIselection\fP\^: ATOM @@ -10108,8 +10337,8 @@ request. .sM .IN "SelectionRequest" "" "@DEF@" .PN SelectionRequest -.in +.2i .LP +.in +.2i \fIowner\fP\^: WINDOW .br \fIselection\fP\^: ATOM @@ -10148,8 +10377,8 @@ standard \fIInter-Client Communication Conventions Manual\fP. .sM .IN "SelectionNotify" "" "@DEF@" .PN SelectionNotify -.in +.2i .LP +.in +.2i \fIrequestor\fP\^: WINDOW .br \fIselection\fP, \fItarget\fP\^: ATOM @@ -10177,8 +10406,8 @@ or when a selection conversion could not be performed (indicated with property .sM .IN "ColormapNotify" "" "@DEF@" .PN ColormapNotify -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fIcolormap\fP\^: COLORMAP or @@ -10208,8 +10437,8 @@ the state indicates whether the colormap is currently installed. .sM .IN "MappingNotify" "" "@DEF@" .PN MappingNotify -.in +.2i .LP +.in +.2i \fIrequest\fP: .Pn { Modifier , .PN Keyboard , @@ -10240,8 +10469,8 @@ then first-keycode and count indicate the range of altered keycodes. .sM .IN "ClientMessage" "" "@DEF@" .PN ClientMessage -.in +.2i .LP +.in +.2i \fIwindow\fP\^: WINDOW .br \fItype\fP\^: ATOM |