home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / CLX / s03.doc < prev    next >
Encoding:
Interleaf document  |  1989-10-18  |  23.8 KB  |  866 lines
  1. <!OPS, Version = 5.2>
  2.  
  3. <!Document,
  4.     Print Rev Bars =    no,
  5.     Final Output Device =    "ps",
  6.     Default Printer =    "nearest-adps">
  7.  
  8. <!Font Definitions,
  9.     F2 = Times 10,
  10.     F3 = Times 10 Italic,
  11.     F4 = Times 8 Italic,
  12.     F5 = Times 18 Bold,
  13.     F6 = Times 12 Bold,
  14.     F7 = Times 10 Bold,
  15.     F8 = Symbol_B 8>
  16.  
  17. <!Page,
  18.     Bottom Margin =        1 inches,
  19.     Left Margin =        1 inches,
  20.     Right Margin =        1.15 inches,
  21.     First Page =        Right,
  22.     Starting Page # =     Inherit,
  23.     Page # Prefix =        "3<#1e>",
  24.     Hyphenation =        on,
  25.     Consecutive Hyphens =    2,
  26.     Vert. Just. =        off>
  27.  
  28. <!Autonumber Stream, List, 2,
  29.     Level 2 Suffix =    ,
  30.     Level 2 Starting Value = 0,
  31.     Level 2 Show =        no>
  32.  
  33. <!Autonumber Stream, Outline, 3,
  34.     Level 1 Symbol Type =    UPPER ROMAN,
  35.     Level 2 Symbol Type =    UPPER ALPHA>
  36.  
  37. <!Autonumber Stream, figure, 2,
  38.     Level 1 Prefix =    "Figure ",
  39.     Level 1 Suffix =    "<#1e>",
  40.     Level 1 Show =        no,
  41.     Level 2 Suffix =    ,
  42.     Level 2 Starting Value = 0,
  43.     Level 2 Show =        no>
  44.  
  45. <!Autonumber Stream, figurelet, 2,
  46.     Level 1 Symbol Type =    UPPER ALPHA,
  47.     Level 1 Prefix =    "Figure ",
  48.     Level 1 Suffix =    "<#1e>",
  49.     Level 1 Show =        no,
  50.     Level 2 Suffix =    "<#04>">
  51.  
  52. <!Autonumber Stream, invisible, 1,
  53.     Level 1 Suffix =    ,
  54.     Level 1 Show =        no>
  55.  
  56. <!Autonumber Stream, item, 2,
  57.     Level 2 Symbol Type =    LOWER ALPHA,
  58.     Level 2 Trail =        yes>
  59.  
  60. <!Autonumber Stream, paralet, 4,
  61.     Level 1 Symbol Type =    UPPER ALPHA,
  62.     Level 1 Suffix =    ,
  63.     Level 1 Show =        no,
  64.     Level 2 Prefix =    .,
  65.     Level 2 Suffix =    ,
  66.     Level 3 Prefix =    .,
  67.     Level 3 Suffix =    ,
  68.     Level 4 Prefix =    .,
  69.     Level 4 Suffix =    >
  70.  
  71. <!Autonumber Stream, paranum, 4,
  72.     Level 1 Suffix =    ,
  73.     Level 1 Show =        no,
  74.     Level 2 Prefix =    .,
  75.     Level 2 Suffix =    ,
  76.     Level 3 Prefix =    .,
  77.     Level 3 Suffix =    ,
  78.     Level 4 Prefix =    .,
  79.     Level 4 Suffix =    >
  80.  
  81. <!Autonumber Stream, table, 2,
  82.     Level 1 Prefix =    "Table ",
  83.     Level 1 Suffix =    "<#1e>",
  84.     Level 1 Show =        no,
  85.     Level 2 Suffix =    >
  86.  
  87. <!Autonumber Stream, tablelet, 2,
  88.     Level 1 Symbol Type =    UPPER ALPHA,
  89.     Level 1 Prefix =    "Table ",
  90.     Level 1 Suffix =    "<#1e>",
  91.     Level 1 Show =        no,
  92.     Level 2 Suffix =    "<#04>">
  93.  
  94. <!Class, arg,
  95.     Bottom Margin =        0.08 inches,
  96.     Left Margin =        1.85 inches,
  97.     First Indent =        -0.25 inches,
  98.     Line Spacing =        1.121 lines,
  99.     Font =            F3,
  100.     Left Tab =        -0.25/0 inches>
  101.  
  102. <!Class, bullet,
  103.     Bottom Margin =        0.153 inches,
  104.     Left Margin =        1.85 inches,
  105.     First Indent =        -0.25 inches,
  106.     Line Spacing =        1.121 lines,
  107.     Font =            F2,
  108.     Allow Page Break Within = no,
  109.     Left Tab =        -0.50/0 inches>
  110.  
  111. <!Class, caption,
  112.     Top Margin =        0.07 inches,
  113.     Bottom Margin =        0.07 inches,
  114.     Line Spacing =        1.100 lines,
  115.     Font =            F4>
  116.  
  117. <!Class, fig,
  118.     Top Margin =        0.07 inches,
  119.     Bottom Margin =        0.07 inches,
  120.     Line Spacing =        1.100 lines,
  121.     Alignment =        Left,
  122.     Font =            F5>
  123.  
  124. <!Class, p1para,
  125.     Bottom Margin =        0.153 inches,
  126.     Left Margin =        1.60 inches,
  127.     First Indent =        -1.60 inches,
  128.     Line Spacing =        1.121 lines,
  129.     Alignment =        Left,
  130.     Font =            F6,
  131.     Allow Page Break Within = no,
  132.     Allow Page Break After = no,
  133.     Left Tab =        -1.70/0 inches>
  134.  
  135. <!Class, p1rule,
  136.     Bottom Margin =        0 inches,
  137.     Line Spacing =        1 lines,
  138.     Font =            F2,
  139.     Hyphenation =        off,
  140.     Allow Page Break After = no,
  141.     Left Tab =        0/0.75*13 inches>
  142.  
  143. <!Class, p1stacked,
  144.     Bottom Margin =        0 inches,
  145.     Left Margin =        1.60 inches,
  146.     First Indent =        -1.60 inches,
  147.     Line Spacing =        1 lines,
  148.     Font =            F7,
  149.     Allow Page Break Within = no,
  150.     Allow Page Break After = no,
  151.     Left Tab =        -1.60/-0.17/0 inches>
  152.  
  153. <!Class, para,
  154.     Bottom Margin =        0.153 inches,
  155.     Left Margin =        1.60 inches,
  156.     Line Spacing =        1.121 lines,
  157.     Font =            F2,
  158.     Allow Page Break Within = no,
  159.     Left Tab =        0/0.75*13 inches>
  160.  
  161. <!Class, return,
  162.     Bottom Margin =        0.077 inches,
  163.     Left Margin =        1.60 inches,
  164.     First Indent =        -0.90 inches,
  165.     Line Spacing =        1.121 lines,
  166.     Alignment =        Left,
  167.     Font =            F7,
  168.     Hyphenation =        off,
  169.     Allow Page Break Within = no,
  170.     Allow Page Break After = no,
  171.     Left Tab =        -0.90/0 inches,
  172.     Right Tab =        7.50 inches>
  173.  
  174. <!Class, secno,
  175.     Top Margin =        0.07 inches,
  176.     Bottom Margin =        0.07 inches,
  177.     Line Spacing =        1.100 lines,
  178.     Alignment =        Left,
  179.     Font =            F5,
  180.     Autonumber Name =    paranum>
  181.  
  182. <!Class, secrule,
  183.     Bottom Margin =        0 inches,
  184.     Line Spacing =        1 lines,
  185.     Font =            F2,
  186.     Hyphenation =        off,
  187.     Allow Page Break After = no,
  188.     Left Tab =        0/0.75*13 inches,
  189.     Autonumber Name =    table>
  190.  
  191. <!Class, sectitle,
  192.     Bottom Margin =        0 inches,
  193.     Line Spacing =        1 lines,
  194.     Alignment =        Right,
  195.     Font =            F5,
  196.     Hyphenation =        off,
  197.     New Page =        yes,
  198.     Left Tab =        0/0.75*13 inches>
  199.  
  200. <!Class, syntax0,
  201.     Bottom Margin =        0 inches,
  202.     Left Margin =        1.60 inches,
  203.     First Indent =        -0.90 inches,
  204.     Line Spacing =        1.121 lines,
  205.     Alignment =        Left,
  206.     Font =            F7,
  207.     Hyphenation =        off,
  208.     Allow Page Break Within = no,
  209.     Allow Page Break After = no,
  210.     Left Tab =        -0.90/0 inches,
  211.     Right Tab =        8 inches>
  212.  
  213. <!Class, "table",
  214.     Top Margin =        0.07 inches,
  215.     Bottom Margin =        0.07 inches,
  216.     Line Spacing =        1.100 lines,
  217.     Font =            F7,
  218.     Autonumber Name =    table>
  219.  
  220. <!Class, title,
  221.     Top Margin =        0.07 inches,
  222.     Bottom Margin =        0.07 inches,
  223.     Line Spacing =        1.100 lines,
  224.     Alignment =        Right,
  225.     Font =            F5,
  226.     TOC Doc Name =        TOC>
  227.  
  228. <!Master Frame,
  229.     Name =            "At Anchor",
  230.     Placement =        At Anchor,
  231.     Width =            0.41 inches,
  232.     Height =        0.137 inches,
  233.     Vertical Alignment =    0.03 inches,
  234.     Diagram =
  235. V4,
  236. (g9,32767,0
  237.  (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
  238.   667,6))>
  239.  
  240. <!Master Frame,
  241.     Name =            p1rule,
  242.     Placement =        At Anchor,
  243.     Width =            6.35 inches,
  244.     Height =        0.153 inches,
  245.     Vertical Alignment =    0.007 inches,
  246.     Shared Contents =    yes,
  247.     Diagram =
  248. V4,
  249. (g9,1,0
  250.  (v4,1,0,0.006667,0.066723,6.326667,0.066611,17,2,0)
  251.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,0,1,1,0.066667,0.066667,6,6,0,0.066
  252.   667,6))>
  253.  
  254. <First Page Header, Frame =
  255. V4,
  256. (g9,0,0
  257.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0.007813,1,1,1,0.066667,0.066667,6,6,
  258.   0,0.066667,6))>
  259.  
  260. <Right Page Header, Frame =
  261. V4,
  262. (g9,1,0
  263.  (T8,1,12,5.533333,0.333333,0.8,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,
  264.   102,1101,2,
  265. <caption,
  266.     Alignment =        Right>
  267.  
  268. Screens
  269.  
  270. <End Text>)
  271.  (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
  272.   667,6))>
  273.  
  274. <Left Page Header, Frame =
  275. V4,
  276. (g9,1,0
  277.  (T8,1,12,0.013333,0.306667,3,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  278.   2,1101,2,
  279. <caption>
  280.  
  281. Screens
  282.  
  283. <End Text>)
  284.  (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
  285.   667,6))>
  286.  
  287. <Right Page Footer, Frame =
  288. V4,
  289. (g9,1,0
  290.  (t8,1,4,6.333333,0.266667,2,17,@nntimsps10b,\240)
  291.  (t8,2,4,0.006667,0.266667,0,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  292.  (v4,3,0,0,0.066667,6.333333,0.066554,17,2,0)
  293.  (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
  294.   667,6))>
  295.  
  296. <Left Page Footer, Frame =
  297. V4,
  298. (g9,1,0
  299.  (t8,1,4,0,0.266667,0,17,@nntimsps10b,\240)
  300.  (t8,2,4,6.333333,0.266667,2,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  301.  (v4,3,0,0.026667,0.066667,6.333333,0.066554,17,2,0)
  302.  (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
  303.   667,6))>
  304.  
  305. <sectitle,
  306.     Allow Page Break Within = no,
  307.     Allow Page Break After = no>
  308.  
  309. <|,"3<#1e>31">
  310. <Frame,
  311.     Name =            "At Anchor",
  312.     Placement =        At Anchor,
  313.     Width =            4.72 inches,
  314.     Height =        0.94 inches,
  315.     Vertical Alignment =    0.03 inches,
  316.     Page # =        "3<#1e>31",
  317.     Diagram =
  318. V4,
  319. (g9,1,0
  320.  (T8,1,12,0.133333,0.72,4.563333,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512
  321.   ,102,1101,3,
  322. <title>
  323.  
  324. SCREENS
  325.  
  326. <End Text>)
  327.  (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
  328.   667,6))>
  329. <Frame,
  330.     Name =            "At Anchor",
  331.     Placement =        At Anchor,
  332.     Width =            1.626 inches,
  333.     Height =        0.938 inches,
  334.     Vertical Alignment =    0 inches,
  335.     Page # =        "3<#1e>31",
  336.     Diagram =
  337. V4,
  338. (g9,1,0
  339.  (T8,1,12,0.066667,0.276667,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  340.   2,1101,3,
  341. <secno,
  342.     TOC Doc Name =        TOC>
  343.  
  344. <Autonum, paranum, 1, First = Yes>
  345.  
  346. <End Text>)
  347.  (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
  348.   2,1101,3,
  349. <"table">
  350.  
  351. <Autonum, table, 1, First = Yes>
  352.  
  353. <End Text>)
  354.  (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
  355.   1,3,
  356. <fig,
  357.     Alignment =        Both,
  358.     Font =            F7,
  359.     Autonumber Name =    figure>
  360.  
  361. <Autonum, figure, 1, First = Yes>
  362.  
  363. <End Text>)
  364.  (g9,5,0
  365.    (p7,5,8,19
  366.      (g9,5,0
  367.        (g9,5,0
  368.          (v4,5,0,0.266667,0,1.6,0,17,1,0)
  369.          (v4,6,0,1.6,0,1.6,0.933333,17,1,0)
  370.          (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0)
  371.          (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0))))
  372.    (g9,10,8
  373.      (p7,10,1032,13
  374.        (g9,10,0
  375.          (g9,10,0
  376.            (v4,10,0,1.331228,0.934813,1.465964,0.822222,17,1,0)
  377.            (v4,11,0,1.465964,0.822222,1.465964,0.615801,17,1,0)
  378.            (v4,12,0,1.465964,0.615801,1.353683,0.521973,17,1,0)
  379.            (v4,13,0,1.353683,0.521973,1.465964,0.428146,17,1,0)
  380.            (v4,14,0,1.465964,0.428146,1.465964,0.259256,17,1,0)
  381.            (v4,15,0,1.465964,0.259256,1.331228,0.146667,17,1,0)
  382.            (v4,16,0,1.331228,0.146667,1.016842,0.146667,17,1,0)
  383.            (v4,17,0,1.016842,0.146667,0.882104,0.259256,17,1,0)
  384.            (v4,18,0,0.882104,0.259256,0.882104,0.371848,17,1,0)
  385.            (v4,19,0,0.882104,0.371848,1.084209,0.371848,17,1,0)
  386.            (v4,20,0,1.084209,0.371848,1.084209,0.296789,17,1,0)
  387.            (v4,21,0,1.084209,0.296789,1.263859,0.296789,17,1,0)
  388.            (v4,22,0,1.263859,0.296789,1.263859,0.446912,17,1,0)
  389.            (v4,23,0,1.263859,0.446912,1.106666,0.446912,17,1,0)
  390.            (v4,24,0,1.106666,0.446912,1.106666,0.597035,17,1,0)
  391.            (v4,25,0,1.106666,0.597035,1.263859,0.597035,17,1,0)
  392.            (v4,26,0,1.263859,0.597035,1.263859,0.784691,17,1,0)
  393.            (v4,27,0,1.263859,0.784691,1.084209,0.784691,17,1,0)
  394.            (v4,28,0,1.084209,0.784691,1.084209,0.709628,17,1,0)
  395.            (v4,29,0,1.084209,0.709628,0.882104,0.709628,17,1,0)
  396.            (v4,30,0,0.882104,0.709628,0.882104,0.822222,17,1,0)
  397.            (v4,31,0,0.882104,0.822222,1.016842,0.934813,17,1,0)
  398.            (v4,32,0,1.016842,0.934813,1.331228,0.934813,17,1,0))))
  399.      (g9,33,2048
  400.        (v4,33,33,0.837192,0.146667,0.837192,0.146667,17,0,0)
  401.        (v4,34,33,0.837192,1.159997,0.837192,1.159997,17,0,0)
  402.        (v4,35,33,1.533333,1.159997,1.533333,1.159997,17,0,0)
  403.        (v4,36,33,1.533333,0.146667,1.533333,0.146667,17,0,0))))
  404.  (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
  405.   667,6))>
  406.  
  407. <secrule,
  408.     Allow Page Break Within = no,
  409.     Allow Page Break After = yes,
  410.     Autonumber Name =    >
  411.  
  412. <Index, "visuals", To Named = p1rule><Index, "screen", To Named = sectitle>
  413. <Frame,
  414.     Name =            "At Anchor",
  415.     Placement =        At Anchor,
  416.     Width =            6.35 inches,
  417.     Height =        0.153 inches,
  418.     Vertical Alignment =    0.007 inches,
  419.     Page # =        "3<#1e>31",
  420.     Diagram =
  421. V4,
  422. (g9,1,0
  423.  (v4,1,0,0.006667,0.066723,6.333333,0.066611,17,2,0)
  424.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,0,1,1,0.066667,0.066667,6,6,0,0.066
  425.   667,6))>
  426.  
  427. <p1stacked,
  428.     Font =            F2,
  429.     Left Tab =        -1.70/0 inches>
  430.  
  431. <F6>Screens and<Tab><F7>3.1<F0><#04>An X display supports graphical 
  432. output to one or more <F3>screens<F0>. Each
  433.  
  434. <p1para,
  435.     Alignment =        Both,
  436.     Font =            F2,
  437.     Allow Page Break After = yes>
  438.  
  439. <F6>Visuals<Tab><F0>screen has its own root window and window hierarchy. 
  440. Each window belongs to exactly one screen and cannot simultaneously 
  441. appear on another screen.
  442.  
  443. <para>
  444.  
  445. The kinds of graphics hardware used by X screens can vary greatly 
  446. in their support for color and in their methods for accessing raster 
  447. memory. X uses the concept of a <F3>visual type<F0> (usually referred 
  448. to simply as a <F3>visual<F0>) which uniquely identifies the hardware 
  449. capabilities of a display screen. Fundamentally, a visual is represented 
  450. by a <F7>card29<F0> integer ID, which uniquely identifies the visual 
  451. type relative to a single display. CLX also represents a visual with 
  452. a <F7>visual<#1e>info<F0> structure that contains other attributes 
  453. associated with a visual (see paragraph 1.6, Data Types). A screen 
  454. can support more than one depth (that is, pixel size), and for each 
  455. supported depth, a screen may support more than one visual. However, 
  456. it is more typical for a screen to have only a single depth and a 
  457. single visual type.
  458.  
  459. A visual represents various aspects of the screen hardware, as follows:
  460.  
  461. <bullet>
  462.  
  463. <F8>w<Tab><F0>A screen can be color or gray<#1e>scale. 
  464.  
  465. <F8>w<Tab><F0>A screen can have a colormap that is either writable 
  466. or read<#1e>only.
  467.  
  468. <F8>w<Tab><F0>A screen can have a single colormap or separate colormaps 
  469. for each of the red, green, and blue components. With separate colormaps, 
  470. a pixel value is decomposed into three parts to determine indexes 
  471. into each of the red, green, and blue colormaps.
  472.  
  473. <para>
  474.  
  475. <Index, "visual types", "classes supported"><Index, "classes of visual types supported">CLX supports the following 
  476. classes of visual types: <F7>:direct<#1e>color<F0>, <F7>:gray<#1e>scale
  477. <F0>, <F7>:pseudo<#1e>color<F0>, <F7>:static<#1e>color<F0>, <F7>:static<#1e>
  478. gray<F0>, and <F7>:true<#1e>color<F0>. The following tables show 
  479. how the characteristics of a screen determine the class of its visual 
  480. type.
  481.  
  482. For screens with a single colormap:
  483.  
  484. <Tab>  Color<Tab><Tab>Gray<#1e>Scale
  485.  
  486.   Read<#1e>only<Tab>  <F7>:static<#1e>color<F0><Tab><F7>:static<#1e>gray
  487. <F0><HR>
  488.   Writable<Tab>  <F7>:pseudo<#1e>color<F0><Tab><F7>:gray<#1e>scale
  489.  
  490. For screens with red, green, and blue colormaps:
  491.  
  492.   Read<#1e>only<Tab>  <F7>:true<#1e>color<F0><Tab><HR>
  493.   Writable<Tab>  <F7>:direct<#1e>color<F0><Tab><F7>:gray<#1e>scale
  494.  
  495. The visual class also indicates how screen colormaps are handled. 
  496. See paragraph 9.1, Colormaps and Colors.
  497.  
  498. <p1rule>
  499.  
  500. <Index, "screen", "attributes", To Named = sectitle>
  501. <Frame,
  502.     Name =            p1rule,
  503.     Placement =        At Anchor,
  504.     Width =            6.35 inches,
  505.     Height =        0.153 inches,
  506.     Vertical Alignment =    0.007 inches,
  507.     Shared Contents =    yes,
  508.     Page # =        "3<#1e>31">
  509.  
  510. <p1stacked,
  511.     Font =            F2,
  512.     Left Tab =        -1.70/0 inches>
  513.  
  514. <F6>Screen  <Tab><F7>3.2<F0><#04>In CLX, each display screen is 
  515. represented by a <F7>screen<F0> structure. The
  516.  
  517. <p1para,
  518.     Alignment =        Both,
  519.     Font =            F2,
  520.     Allow Page Break After = yes>
  521.  
  522. <F6>Attributes<Tab><F7>display<#1e>roots<F0> function returns the 
  523. list of <F7>screen<F0> structures for the display. The following 
  524. paragraphs discuss the attributes of CLX <F7>screen<F0> structures.
  525.  
  526. <syntax0>
  527.  
  528. <|,"3<#1e>32">screen<#1e>backing<#1e>stores <F3>screen<F0><Tab><F2>Function<F0><Index, "backing<#1e>stores attribute of screen"><Index, "screen", "backing<#1e>stores attribute"><Index, Doc = operations, "xlib:screen<#1e>backing<#1e>stores", Sort String = "screen<#1e>backing<#1e>stores">
  529.  
  530. <return>
  531.  
  532. <Tab><F2>Returns: <F3><HR>
  533.   backing<#1e>stores<#1e>type <F2><#1f> One of <F0>:always<F2>, <F0>:never
  534. <F2>, or <F0>:when<#1e>mapped<F2>.
  535.  
  536. <para>
  537.  
  538. Returns a value indicating when the <F3>screen<F0> supports backing 
  539. stores, although it may be storage limited in the number of windows 
  540. it can support at once. The value returned can be one of <F7>:always<F0>, 
  541. <F7>:never<F0>, or <F7>:when<#1e>mapped<F0>. 
  542.  
  543. <arg>
  544.  
  545. screen <F2><#1f> A <F7>screen<F2>.
  546.  
  547. <syntax0>
  548.  
  549. screen<#1e>black<#1e>pixel <F3>screen<F0><Tab><F2>Function<F0><Index, "black<#1e>pixel attribute of screen"><Index, "screen", "black<#1e>pixel attribute"><Index, Doc = operations, "xlib:screen<#1e>black<#1e>pixel", Sort String = "screen<#1e>black<#1e>pixel">
  550.  
  551. <return>
  552.  
  553. <Tab><F2>Returns: <F3><HR>
  554.   black<#1e>pixel <F2><#1f> Type <F0>pixel<F2>.
  555.  
  556. <para>
  557.  
  558. Returns the black pixel value for the specified <F3>screen<F0>. 
  559.  
  560. <arg>
  561.  
  562. screen <F2><#1f> A <F7>screen<F2>.
  563.  
  564. <syntax0>
  565.  
  566. screen<#1e>default<#1e>colormap <F3>screen<F0><Tab><F2>Function<F0><Index, "colormap", "screen default"><Index, "default colormap of screen"><Index, "screen", "colormap, default"><Index, Doc = operations, "xlib:screen<#1e>default<#1e>colormap", Sort String = "screen<#1e>default<#1e>colormap">
  567.  
  568. <return>
  569.  
  570. <Tab><F2>Returns: <F3><HR>
  571.   default<#1e>colormap <F2><#1f> Type <F0>colormap<F2>. 
  572.  
  573. <para>
  574.  
  575. Returns the <F3>default<#1e>colormap<F0> for the specified <F3>screen<F0>. 
  576. The <F3>default<#1e>colormap<F0> is initially associated with the 
  577. root window. Clients with minimal color requirements creating windows 
  578. of the same depth as the root may want to allocate from this map by 
  579. default. Most routine allocations of color should be made out of this 
  580. colormap.
  581.  
  582. <arg>
  583.  
  584. screen <F2><#1f> A <F7>screen<F2>.
  585.  
  586. <syntax0>
  587.  
  588. screen<#1e>depths <F3>screen<F0><Tab><F2>Function<F0><Index, "depths of screen"><Index, "screen", "depths"><Index, Doc = operations, "xlib:screen<#1e>depths", Sort String = "screen<#1e>depths">
  589.  
  590. <return>
  591.  
  592. <Tab><F2>Returns: <F3><HR>
  593.   depths <F2><#1f> Type <F0>alist<F2>.
  594.  
  595. <para>
  596.  
  597. Returns an association list that specifies what drawable depths are 
  598. supported on the specified <F3>screen<F0>. Elements of the returned 
  599. association list have the form (depth <F3>visual<F0>*), where each <F3>visua
  600. l<F0> is a <F7>visual<#1e>info<F0> structure. Pixmaps are supported 
  601. for each depth listed, and windows of that depth are supported if 
  602. at least one visual type is listed for the depth. A pixmap depth of 
  603. one is always supported and listed, but windows of depth one might 
  604. not be supported. A depth of zero is never listed, but zero<#1e>depth <F7>:inp
  605. ut<#1e>only<F0> windows are always supported.
  606.  
  607. <arg>
  608.  
  609. screen <F2><#1f> A <F7>screen<F2>.
  610.  
  611. <syntax0>
  612.  
  613. screen<#1e>event<#1e>mask<#1e>at<#1e>open <F3>screen<F0><Tab><F2>Function
  614. <F0><Index, "root", "event mask of screen"><Index, "event mask", "root of screen"><Index, "screen", "event mask root"><Index, Doc = operations, "xlib:screen<#1e>event<#1e>mask<#1e>at<#1e>open", Sort String = "screen<#1e>event<#1e>mask<#1e>at<#1e>open">
  615.  
  616. <return>
  617.  
  618. <Tab><F2>Returns: <F3><HR>
  619.   event<#1e>mask<#1e>at<#1e>open <F2><#1f> Type <F0>mask32<F2>.
  620.  
  621. <para>
  622.  
  623. Returns the initial root event mask for the specified <F3>screen<F0>.
  624.  
  625. <arg>
  626.  
  627. screen <F2><#1f> A <F7>screen<F2>.
  628.  
  629. <syntax0,
  630.     New Page =        yes>
  631.  
  632. <|,"3<#1e>33">screen<#1e>height <F3>screen<F0><Tab><F2>Function<F0><Index, "screen", "height"><Index, "height", "screen"><Index, Doc = operations, "xlib:screen<#1e>height", Sort String = "screen<#1e>height">
  633.  
  634. <return>
  635.  
  636. <Tab><F2>Returns: <F3><HR>
  637.   height <F2><#1f> Type <F0>card16<F2>.
  638.  
  639. <para>
  640.  
  641. Returns the <F3>height<F0> of the specified <F3>screen<F0> in 
  642. pixel units.
  643.  
  644. <arg>
  645.  
  646. screen <F2><#1f> A <F7>screen<F2>.
  647.  
  648. <syntax0>
  649.  
  650. screen<#1e>height<#1e>in<#1e>millimeters <F3>screen<F0><Tab><F2>Function
  651. <F0><Index, "height", "screen in millimeters"><Index, "screen", "height in millimeters"><Index, Doc = operations, "xlib:screen<#1e>height<#1e>in<#1e>millimeters", Sort String = "screen<#1e>height<#1e>in<#1e>millimeters">
  652.  
  653. <return>
  654.  
  655. <Tab><F2>Returns: <F3><HR>
  656.   height<#1e>in<#1e>millimeters <F2><#1f> Type <F0>card16<F2>.
  657.  
  658. <para>
  659.  
  660. Returns the height of the specified <F3>screen<F0> in millimeters. 
  661. The returned height can be used with the width in millimeters to determine 
  662. the physical size and the aspect ratio of the screen.
  663.  
  664. <arg>
  665.  
  666. screen <F2><#1f> A <F7>screen<F2>.
  667.  
  668. <syntax0>
  669.  
  670. screen<#1e>max<#1e>installed<#1e>maps<F2> <F3>screen<F0><Tab><F2>Function
  671. <F0><Index, "colormap", "maximum number for screen"><Index, "screen", "colormaps maximum number"><Index, Doc = operations, "xlib:screen<#1e>max<#1e>installed<#1e>maps", Sort String = "screen<#1e>max<#1e>installed<#1e>maps">
  672.  
  673. <return>
  674.  
  675. <Tab><F2>Returns: <F3><HR>
  676.   max<#1e>installed<#1e>colormaps <F2><#1f> Type <F0>card16<F2>.
  677.  
  678. <para>
  679.  
  680. Returns the maximum number of colormaps that can be installed simultaneously 
  681. with <F7>install<#1e>colormap<F0>.
  682.  
  683. <arg>
  684.  
  685. screen <F2><#1f> A <F7>screen<F2>.
  686.  
  687. <syntax0>
  688.  
  689. screen<#1e>min<#1e>installed<#1e>maps <F3>screen<F0><Tab><F2>Function<F0><Index, "colormap", "minimum number for screen"><Index, "screen", "colormaps minimum number"><Index, Doc = operations, "xlib:screen<#1e>min<#1e>installed<#1e>maps", Sort String = "screen<#1e>min<#1e>installed<#1e>maps">
  690.  
  691. <return>
  692.  
  693. <Tab><F2>Returns: <F3><HR>
  694.   min<#1e>installed<#1e>colormaps <F2><#1f> Type <F0>card16<F2>.
  695.  
  696. <para>
  697.  
  698. Returns the minimum number of colormaps that can be guaranteed to 
  699. be installed simultaneously.
  700.  
  701. <arg>
  702.  
  703. screen <F2><#1f> A <F7>screen<F2>.
  704.  
  705. <syntax0>
  706.  
  707. screen<#1e>p <F3>screen<F0><Tab><F2>Function<Index, Doc = operations, "xlib:screen<#1e>p", Sort String = "screen<#1e>p">
  708.  
  709. <return>
  710.  
  711. <Tab><F2>Returns: <F3><HR>
  712.   screen<#1e>p <F2><#1f> Type <F0>boolean<F2>.
  713.  
  714. <para>
  715.  
  716. Returns non<#1e><F7>nil<F0> if the <F3>screen<F0> argument is 
  717. a <F7>screen<F0> structure; otherwise, returns <F7>nil<F0>.
  718.  
  719. <syntax0>
  720.  
  721. screen<#1e>plist <F3>screen<F0><Tab><F2>Function<F0><Index, "property list", "screen"><Index, "screen", "property list"><Index, Doc = operations, "xlib:screen<#1e>plist", Sort String = "screen<#1e>plist">
  722.  
  723. <return>
  724.  
  725. <Tab><F2>Returns: <F3><HR>
  726.   plist <F2><#1f> Type <F0>list<F2>. 
  727.  
  728. <para>
  729.  
  730. Returns and (with <F7>setf<F0>) sets the property list for the specified 
  731. <F3>screen<F0>. This function provides a hook where extensions can 
  732. add data.
  733.  
  734. <arg>
  735.  
  736. screen <F2><#1f> A <F7>screen<F2>.
  737.  
  738. <syntax0>
  739.  
  740. screen<#1e>root <F3>screen<F0><Tab><F2>Function<F0><Index, "root", "window of screen"><Index, "screen", "root window"><Index, Doc = operations, "xlib:screen<#1e>root", Sort String = "screen<#1e>root">
  741.  
  742. <return>
  743.  
  744. <Tab><F2>Returns: <F3><HR>
  745.   root<#1e>window <F2><#1f> Type <F0>window <F2>or <F0>null<F2>.
  746.  
  747. <para>
  748.  
  749. Returns the <F3>root<#1e>window<F0> for the specified <F3>screen<F0>. 
  750. This function is useful with functions that take a parent window as 
  751. an argument. The class of the root window is always <F7>:input<#1e>output
  752. <F0>.
  753.  
  754. <arg>
  755.  
  756. screen <F2><#1f> A <F7>screen<F2>.
  757.  
  758. <syntax0>
  759.  
  760. <|,"3<#1e>34">screen<#1e>root<#1e>depth <F3>screen<F0><Tab><F2>Function<F0><Index, "root", "depth of screen"><Index, "screen", "root depth"><Index, Doc = operations, "xlib:screen<#1e>root<#1e>depth", Sort String = "screen<#1e>root<#1e>depth">
  761.  
  762. <return>
  763.  
  764. <Tab><F2>Returns: <F3><HR>
  765.   root<#1e>window<#1e>depth <F2><#1f> Type <F0>image<#1e>depth<F2>.
  766.  
  767. <para>
  768.  
  769. Returns the depth of the root window for the specified <F3>screen<F0>. 
  770. Other depths can also be supported on this <F3>screen<F0>.
  771.  
  772. <arg>
  773.  
  774. screen <F2><#1f> A <F7>screen<F2>.
  775.  
  776. <syntax0>
  777.  
  778. screen<#1e>root<#1e>visual <F3>screen<F0><Tab><F2>Function<F0><Index, "root", "visual type of screen"><Index, "screen", "root visual type"><Index, Doc = operations, "xlib:screen<#1e>root<#1e>visual", Sort String = "screen<#1e>root<#1e>visual">
  779.  
  780. <return>
  781.  
  782. <Tab><F2>Returns: <F3><HR>
  783.   root<#1e>window<#1e>visual <F2><#1f> Type <F0>card29<F2>.
  784.  
  785. <para>
  786.  
  787. Returns the default visual type for the root window for the specified <F3>scre
  788. en<F0>.
  789.  
  790. <arg>
  791.  
  792. screen <F2><#1f> A <F7>screen<F2>.
  793.  
  794. <syntax0>
  795.  
  796. screen<#1e>save<#1e>unders<#1e>p <F3>screen<F0><Tab><F2>Function<F0><Index, "save<#1e>unders<#1e>p attribute of screen"><Index, "screen", "save<#1e>unders<#1e>p attribute"><Index, Doc = operations, "xlib:screen<#1e>save<#1e>unders<#1e>p", Sort String = "screen<#1e>save<#1e>unders<#1e>p">
  797.  
  798. <return>
  799.  
  800. <Tab><F2>Returns: <F3><HR>
  801.   save<#1e>unders<#1e>p <F2><#1f> Type <F0>boolean<F2>.
  802.  
  803. <para>
  804.  
  805. If true, the server can support the save<#1e>under mode in <F7>create<#1e>wind
  806. ow<F0> and in changing window attributes.
  807.  
  808. <arg>
  809.  
  810. screen <F2><#1f> A screen.
  811.  
  812. <syntax0>
  813.  
  814. screen<#1e>white<#1e>pixel <F3>screen<F0><Tab><F2>Function<F0><Index, "white pixel of screen"><Index, "screen", "white pixel"><Index, Doc = operations, "xlib:screen<#1e>white<#1e>pixel", Sort String = "screen<#1e>white<#1e>pixel">
  815.  
  816. <return>
  817.  
  818. <Tab><F2>Returns: <F3><HR>
  819.   white<#1e>pixel <F2><#1f> Type <F0>pixel<F2>.
  820.  
  821. <para>
  822.  
  823. Returns the white pixel value for the specified <F3>screen<F0>. 
  824.  
  825. <arg>
  826.  
  827. screen <F2><#1f> A screen.
  828.  
  829. <syntax0>
  830.  
  831. screen<#1e>width <F3>screen<F0><Tab><F2>Function<F0><Index, "width", "screen"><Index, "screen", "width"><Index, Doc = operations, "xlib:screen<#1e>width", Sort String = "screen<#1e>width">
  832.  
  833. <return>
  834.  
  835. <Tab><F2>Returns: <F3><HR>
  836.   width <F2><#1f> Type <F0>card16<F2>.
  837.  
  838. <para>
  839.  
  840. Returns the width of the specified <F3>screen <F0>in pixel units.
  841.  
  842. <arg>
  843.  
  844. screen <F2><#1f> A screen.
  845.  
  846. <syntax0>
  847.  
  848. screen<#1e>width<#1e>in<#1e>millimeters <F3>screen<F0><Tab><F2>Function
  849. <F0><Index, "width", "screen in millimeters"><Index, "screen", "width in millimeters"><Index, Doc = operations, "xlib:screen<#1e>width<#1e>in<#1e>millimeters", Sort String = "screen<#1e>width<#1e>in<#1e>millimeters">
  850.  
  851. <return>
  852.  
  853. <Tab><F2>Returns: <F3><HR>
  854.   width<#1e>in<#1e>millimeters <F2><#1f> Type <F0>card16<F2>.
  855.  
  856. <para>
  857.  
  858. Returns the width of the specified <F3>screen<F0> in millimeters. 
  859. The returned width can be used with the height in millimeters to determine 
  860. the physical size and the aspect ratio of the screen.
  861.  
  862. <arg>
  863.  
  864. screen <F2><#1f> A screen.
  865.  
  866.