Xlib â C Language X Interface

More documents

Recommendations

Info

Xlib − C LibraryX11, Release 6.7 DRAFTtypedef struct {int charset_count;char **charset_list;}XOMCharSetList;The charset_list member is a list of one or more null-terminated charset names, and thecharset_count member is the number of charset names.The required charset list is owned by Xlib and should not be modified or freed by the client. Itwill be freed by a call to XCloseOM with the associated XOM. Until freed, its contents will notbe modified by Xlib.13.4.3.2. Query OrientationThe XNQueryOrientation argument returns the global orientation of text when drawn. Otherthan XOMOrientation_LTR_TTB, the set of orientations supported is locale-dependent. Thevalue of the argument is a pointer to a structure of type XOMOrientation. Clients are responsiblefor freeing the XOMOrientation structure by using XFree; this also frees the contents of thestructure.typedef struct {int num_orientation;XOrientation *orientation; /* Input Text description */}XOMOrientation;typedef enum {XOMOrientation_LTR_TTB,XOMOrientation_RTL_TTB,XOMOrientation_TTB_LTR,XOMOrientation_TTB_RTL,XOMOrientation_Context}XOrientation;The possible value for XOrientation may be:• XOMOrientation_LTR_TTB left-to-right, top-to-bottom global orientation• XOMOrientation_RTL_TTB right-to-left, top-to-bottom global orientation• XOMOrientation_TTB_LTR top-to-bottom, left-to-right global orientation• XOMOrientation_TTB_RTL top-to-bottom, right-to-left global orientation• XOMOrientation_Context contextual global orientation13.4.3.3. Directional Dependent DrawingThe XNDirectionalDependentDrawing argument indicates whether the text rendering functionsimplement implicit handling of directional text. If this value is True, the output method hasknowledge of directional dependencies and reorders text as necessary when rendering text. If thisvalue is False, the output method does not implement any directional text handling, and all characterdirections are assumed to be left-to-right.281
Xlib − C LibraryX11, Release 6.7 DRAFTRegardless of the rendering order of characters, the origins of all characters are on the primarydraw direction side of the drawing origin.This OM value presents functionality identical to the XDirectionalDependentDrawing function.13.4.3.4. Context Dependent DrawingThe XNContextualDrawing argument indicates whether the text rendering functions implementimplicit context-dependent drawing. If this value is True, the output method has knowledge ofcontext dependencies and performs character shape editing, combining glyphs to present a singlecharacter as necessary. The actual shape editing is dependent on the locale implementation andthe font set used.This OM value presents functionality identical to the XContextualDrawing function.13.4.4. Output Context FunctionsAn output context is an abstraction that contains both the data required by an output method andthe information required to display that data. There can be multiple output contexts for one outputmethod. The programming interfaces for creating, reading, or modifying an output contextuse a variable argument list. The name elements of the argument lists are referred to as XOC values.It is intended that output methods be controlled by these XOC values. As new XOC valuesare created, they should be registered with the X Consortium. An XOC can be used anywhere anXFontSet can be used, and vice versa; XFontSet is retained for compatibility with previousreleases. The concepts of output methods and output contexts include broader, more generalizedabstraction than font set, supporting complex and more intelligent text display, and dealing notonly with multiple fonts but also with context dependencies. However, XFontSet is widely usedin several interfaces, so XOC is defined as an upward compatible type of XFontSet.To create an output context, use XCreateOC.XOC XCreateOC(om, ...)XOM om;omSpecifies the output method.... Specifies the variable-length argument list to set XOC values.The XCreateOC function creates an output context within the specified output method.The base font names argument is mandatory at creation time, and the output context will not becreated unless it is provided. All other output context values can be set later.XCreateOC returns NULL if no output context could be created. NULL can be returned for anyof the following reasons:• A required argument was not set.• A read-only argument was set.• Anargument name is not recognized.• The output method encountered an output method implementation-dependent error.XCreateOC can generate a BadAtom error.To destroy anoutput context, use XDestroyOC.282
Page 3 and 4:
AcknowledgmentsThe design and imple
Page 5 and 6:
Release 6Stephen Gildea (X Consorti
Page 7 and 8:
Xlib − C LibraryX11, Release 6.7
Page 9 and 10:
Page 11 and 12:
Page 13 and 14:
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Page 21 and 22:
Page 23 and 24:
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Page 43 and 44:
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
Page 95 and 96:
Page 97 and 98:
Page 99 and 100:
Page 101 and 102:
Page 103 and 104:
Page 105 and 106:
Page 107 and 108:
Page 109 and 110:
Page 111 and 112:
Page 113 and 114:
Page 115 and 116:
Page 117 and 118:
Page 119 and 120:
Page 121 and 122:
Page 123 and 124:
Page 125 and 126:
Page 127 and 128:
Page 129 and 130:
Page 131 and 132:
Page 133 and 134:
Page 135 and 136:
Page 137 and 138:
Page 139 and 140:
Page 141 and 142:
Page 143 and 144:
Page 145 and 146:
Page 147 and 148:
Page 149 and 150:
Page 151 and 152:
Page 153 and 154:
Page 155 and 156:
Page 157 and 158:
Page 159 and 160:
Page 161 and 162:
Page 163 and 164:
Page 165 and 166:
Page 167 and 168:
Page 169 and 170:
Page 171 and 172:
Page 173 and 174:
Page 175 and 176:
Page 177 and 178:
Page 179 and 180:
Page 181 and 182:
Page 183 and 184:
Page 185 and 186:
Page 187 and 188:
Page 189 and 190:
Page 191 and 192:
Page 193 and 194:
Page 195 and 196:
Page 197 and 198:
Page 199 and 200:
Page 201 and 202:
Page 203 and 204:
Page 205 and 206:
Page 207 and 208:
Page 209 and 210:
Page 211 and 212:
Page 213 and 214:
Page 215 and 216:
Page 217 and 218:
Page 219 and 220:
Page 221 and 222:
Page 223 and 224:
Page 225 and 226:
Page 227 and 228:
Page 229 and 230:
Page 231 and 232:
Page 233 and 234:
Page 235 and 236: Xlib − C LibraryX11, Release 6.7
Page 285: Xlib − C LibraryX11, Release 6.7
Page 337 and 338:
Page 339 and 340:
Page 341 and 342:
Page 343 and 344:
Page 345 and 346:
Page 347 and 348:
Page 349 and 350:
Page 351 and 352:
Page 353 and 354:
Page 355 and 356:
Page 357 and 358:
Page 359 and 360:
Page 361 and 362:
Page 363 and 364:
Page 365 and 366:
Page 367 and 368:
Page 369 and 370:
Page 371 and 372:
Page 373 and 374:
Page 375 and 376:
Page 377 and 378:
Page 379 and 380:
Page 381 and 382:
Page 383 and 384:
Page 385 and 386:
Page 387 and 388:
Page 389 and 390:
Page 391 and 392:
Page 393 and 394:
Page 395 and 396:
Page 397 and 398:
Page 399 and 400:
Page 401 and 402:
Page 403 and 404:
Page 405 and 406:
Page 407 and 408:
Page 409 and 410:
Page 411 and 412:
Page 413 and 414:
Page 415 and 416:
Page 417 and 418:
Page 419 and 420:
Page 421 and 422:
Page 423 and 424:
Page 425 and 426:
Page 427 and 428:
Page 429 and 430:
Page 431 and 432:
Page 433 and 434:
Page 435 and 436:
Page 437 and 438:
Page 439 and 440:
Page 441 and 442:
Page 443 and 444:
Page 445 and 446:
Page 447 and 448:
Page 449 and 450:
Page 451 and 452:
Page 453 and 454:
Page 455 and 456:
Page 457 and 458:
Page 459 and 460:
Page 461 and 462:
Page 463 and 464:
Page 465 and 466:
Page 467 and 468:
Page 469 and 470:
Page 471 and 472:
Page 473 and 474:
Page 475 and 476:
Page 477 and 478:
Page 479 and 480:
Page 481 and 482:
Page 483 and 484:
Page 485 and 486:
Page 487 and 488:
Page 489 and 490:
Page 491 and 492:
Page 493 and 494:
Page 495 and 496:
4.2. Translating Screen Coordinates
Page 497 and 498:
10.7. Input Focus Events . . . . .
Page 499 and 500:
13.5.6.1. Input Style . . . . . . .
show all

Xlib â C Language X Interface

Create successful ePaper yourself

Delete template?

Save as template?

Xlib â C Language X Interface