home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / doc / CLX / s04.doc < prev    next >
Encoding:
Interleaf document  |  1989-10-18  |  72.3 KB  |  2,384 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 Italic,
  10.     F3 = Times 10,
  11.     F4 = Times 8 Italic,
  12.     F5 = Times 18 Bold,
  13.     F6 = Times 10 Bold,
  14.     F7 = Times 18,
  15.     F8 = Times 12 Bold,
  16.     F9 = Courier 8,
  17.     F10 = Times 8,
  18.     F11 = Symbol_B 8,
  19.     F12 = Times 6>
  20.  
  21. <!Page,
  22.     Bottom Margin =        1 inches,
  23.     Left Margin =        1 inches,
  24.     Right Margin =        1.15 inches,
  25.     First Page =        Right,
  26.     Starting Page # =     Inherit,
  27.     Page # Prefix =        "4<#1e>",
  28.     Hyphenation =        on,
  29.     Consecutive Hyphens =    2,
  30.     Vert. Just. =        off>
  31.  
  32. <!Autonumber Stream, List, 2,
  33.     Level 2 Suffix =    ,
  34.     Level 2 Starting Value = 0,
  35.     Level 2 Show =        no>
  36.  
  37. <!Autonumber Stream, Outline, 3,
  38.     Level 1 Symbol Type =    UPPER ROMAN,
  39.     Level 2 Symbol Type =    UPPER ALPHA>
  40.  
  41. <!Autonumber Stream, figure, 2,
  42.     Level 1 Prefix =    "Figure ",
  43.     Level 1 Suffix =    "<#1e>",
  44.     Level 1 Show =        no,
  45.     Level 2 Suffix =    ,
  46.     Level 2 Starting Value = 0,
  47.     Level 2 Show =        no>
  48.  
  49. <!Autonumber Stream, figurelet, 2,
  50.     Level 1 Symbol Type =    UPPER ALPHA,
  51.     Level 1 Prefix =    "Figure ",
  52.     Level 1 Suffix =    "<#1e>",
  53.     Level 1 Show =        no,
  54.     Level 2 Suffix =    "<#04>">
  55.  
  56. <!Autonumber Stream, invisible, 1,
  57.     Level 1 Suffix =    ,
  58.     Level 1 Show =        no>
  59.  
  60. <!Autonumber Stream, item, 2,
  61.     Level 2 Symbol Type =    LOWER ALPHA,
  62.     Level 2 Trail =        yes>
  63.  
  64. <!Autonumber Stream, paralet, 4,
  65.     Level 1 Symbol Type =    UPPER ALPHA,
  66.     Level 1 Suffix =    ,
  67.     Level 1 Show =        no,
  68.     Level 2 Prefix =    .,
  69.     Level 2 Suffix =    ,
  70.     Level 3 Prefix =    .,
  71.     Level 3 Suffix =    ,
  72.     Level 4 Prefix =    .,
  73.     Level 4 Suffix =    >
  74.  
  75. <!Autonumber Stream, paranum, 4,
  76.     Level 1 Suffix =    ,
  77.     Level 1 Show =        no,
  78.     Level 2 Prefix =    .,
  79.     Level 2 Suffix =    ,
  80.     Level 3 Prefix =    .,
  81.     Level 3 Suffix =    ,
  82.     Level 4 Prefix =    .,
  83.     Level 4 Suffix =    >
  84.  
  85. <!Autonumber Stream, table, 2,
  86.     Level 1 Prefix =    "Table ",
  87.     Level 1 Suffix =    "<#1e>",
  88.     Level 1 Show =        no,
  89.     Level 2 Suffix =    >
  90.  
  91. <!Autonumber Stream, tablelet, 2,
  92.     Level 1 Symbol Type =    UPPER ALPHA,
  93.     Level 1 Prefix =    "Table ",
  94.     Level 1 Suffix =    "<#1e>",
  95.     Level 1 Show =        no,
  96.     Level 2 Suffix =    "<#04>">
  97.  
  98. <!Class, arg,
  99.     Bottom Margin =        0.08 inches,
  100.     Left Margin =        1.85 inches,
  101.     First Indent =        -0.25 inches,
  102.     Line Spacing =        1.121 lines,
  103.     Font =            F2,
  104.     Left Tab =        -0.25/0 inches>
  105.  
  106. <!Class, bullet,
  107.     Bottom Margin =        0.153 inches,
  108.     Left Margin =        1.85 inches,
  109.     First Indent =        -0.25 inches,
  110.     Line Spacing =        1.121 lines,
  111.     Font =            F3,
  112.     Allow Page Break Within = no,
  113.     Left Tab =        -0.50/0 inches>
  114.  
  115. <!Class, caption,
  116.     Top Margin =        0.07 inches,
  117.     Bottom Margin =        0.07 inches,
  118.     Line Spacing =        1.100 lines,
  119.     Font =            F4>
  120.  
  121. <!Class, endrule,
  122.     Bottom Margin =        0.15 inches,
  123.     Left Margin =        1.60 inches,
  124.     Line Spacing =        1.121 lines,
  125.     Alignment =        Left,
  126.     Font =            F3,
  127.     Hyphenation =        off,
  128.     Allow Page Break Within = no,
  129.     Left Tab =        0/1.75/2.30/3.50/7.50 inches>
  130.  
  131. <!Class, fig,
  132.     Top Margin =        0.07 inches,
  133.     Bottom Margin =        0.07 inches,
  134.     Line Spacing =        1.100 lines,
  135.     Alignment =        Left,
  136.     Font =            F5>
  137.  
  138. <!Class, keyword2,
  139.     Bottom Margin =        0.153 inches,
  140.     Left Margin =        1.85 inches,
  141.     First Indent =        -0.25 inches,
  142.     Line Spacing =        1.121 lines,
  143.     Font =            F6,
  144.     Left Tab =        -0.50/0 inches>
  145.  
  146. <!Class, newpage,
  147.     Bottom Margin =        0 inches,
  148.     Line Spacing =        1 lines,
  149.     Alignment =        Left,
  150.     Font =            F7,
  151.     Hyphenation =        off,
  152.     New Page =        yes,
  153.     Left Tab =        >
  154.  
  155. <!Class, p1para,
  156.     Bottom Margin =        0.153 inches,
  157.     Left Margin =        1.60 inches,
  158.     First Indent =        -1.60 inches,
  159.     Line Spacing =        1.121 lines,
  160.     Alignment =        Left,
  161.     Font =            F8,
  162.     Allow Page Break Within = no,
  163.     Allow Page Break After = no,
  164.     Left Tab =        -1.70/0 inches>
  165.  
  166. <!Class, p1rule,
  167.     Bottom Margin =        0 inches,
  168.     Line Spacing =        1 lines,
  169.     Font =            F3,
  170.     Hyphenation =        off,
  171.     Allow Page Break After = no,
  172.     Left Tab =        0/0.75*13 inches>
  173.  
  174. <!Class, p1stacked,
  175.     Bottom Margin =        0 inches,
  176.     Left Margin =        1.60 inches,
  177.     First Indent =        -1.60 inches,
  178.     Line Spacing =        1.121 lines,
  179.     Alignment =        Left,
  180.     Font =            F8,
  181.     Allow Page Break Within = no,
  182.     Allow Page Break After = no,
  183.     Left Tab =        -1.70/0 inches>
  184.  
  185. <!Class, para,
  186.     Bottom Margin =        0.153 inches,
  187.     Left Margin =        1.60 inches,
  188.     Line Spacing =        1.121 lines,
  189.     Font =            F3,
  190.     Allow Page Break Within = no,
  191.     Left Tab =        0/0.75*13 inches>
  192.  
  193. <!Class, return,
  194.     Bottom Margin =        0.077 inches,
  195.     Left Margin =        1.60 inches,
  196.     First Indent =        -0.90 inches,
  197.     Line Spacing =        1.121 lines,
  198.     Alignment =        Left,
  199.     Font =            F6,
  200.     Hyphenation =        off,
  201.     Allow Page Break Within = no,
  202.     Allow Page Break After = no,
  203.     Left Tab =        -0.90/0 inches,
  204.     Right Tab =        7.50 inches>
  205.  
  206. <!Class, secno,
  207.     Top Margin =        0.07 inches,
  208.     Bottom Margin =        0.07 inches,
  209.     Line Spacing =        1.100 lines,
  210.     Alignment =        Left,
  211.     Font =            F5,
  212.     Autonumber Name =    paranum>
  213.  
  214. <!Class, secrule,
  215.     Bottom Margin =        0 inches,
  216.     Line Spacing =        1 lines,
  217.     Font =            F3,
  218.     Hyphenation =        off,
  219.     Allow Page Break After = no,
  220.     Left Tab =        0/0.75*13 inches,
  221.     Autonumber Name =    table>
  222.  
  223. <!Class, sectitle,
  224.     Bottom Margin =        0 inches,
  225.     Line Spacing =        1 lines,
  226.     Alignment =        Right,
  227.     Font =            F5,
  228.     Hyphenation =        off,
  229.     New Page =        yes,
  230.     Left Tab =        0/0.75*13 inches>
  231.  
  232. <!Class, stabrule,
  233.     Bottom Margin =        0 inches,
  234.     Line Spacing =        1 lines,
  235.     Font =            F6,
  236.     Hyphenation =        off,
  237.     Allow Page Break Within = no,
  238.     Allow Page Break After = no,
  239.     Left Tab =        0/1.60 inches>
  240.  
  241. <!Class, syntax,
  242.     Bottom Margin =        0.077 inches,
  243.     Left Margin =        1.60 inches,
  244.     First Indent =        -0.90 inches,
  245.     Line Spacing =        1.121 lines,
  246.     Alignment =        Left,
  247.     Font =            F6,
  248.     Hyphenation =        off,
  249.     Allow Page Break Within = no,
  250.     Allow Page Break After = no,
  251.     Left Tab =        -0.90/0 inches,
  252.     Right Tab =        8 inches>
  253.  
  254. <!Class, syntax0,
  255.     Bottom Margin =        0 inches,
  256.     Left Margin =        1.60 inches,
  257.     First Indent =        -0.90 inches,
  258.     Line Spacing =        1.121 lines,
  259.     Alignment =        Left,
  260.     Font =            F6,
  261.     Hyphenation =        off,
  262.     Allow Page Break Within = no,
  263.     Allow Page Break After = no,
  264.     Left Tab =        -0.90/0 inches,
  265.     Right Tab =        8 inches>
  266.  
  267. <!Class, t1ST,
  268.     Bottom Margin =        0 inches,
  269.     Left Margin =        1.60 inches,
  270.     Line Spacing =        1.121 lines,
  271.     Alignment =        Left,
  272.     Font =            F3,
  273.     Left Tab =        0/1.50 inches>
  274.  
  275. <!Class, t1SThead,
  276.     Bottom Margin =        0.15 inches,
  277.     Left Margin =        1.60 inches,
  278.     Line Spacing =        1.121 lines,
  279.     Alignment =        Left,
  280.     Font =            F3,
  281.     Left Tab =        0/1.50 inches>
  282.  
  283. <!Class, t2,
  284.     Bottom Margin =        0 inches,
  285.     Left Margin =        1.60 inches,
  286.     Line Spacing =        1.114 lines,
  287.     Alignment =        Left,
  288.     Font =            F3,
  289.     Left Tab =        0/1.50/0.75*4 inches>
  290.  
  291. <!Class, "table",
  292.     Top Margin =        0.07 inches,
  293.     Bottom Margin =        0.07 inches,
  294.     Line Spacing =        1.100 lines,
  295.     Font =            F6,
  296.     Autonumber Name =    table>
  297.  
  298. <!Class, tabtitle1,
  299.     Bottom Margin =        0 inches,
  300.     Line Spacing =        1 lines,
  301.     Font =            F6,
  302.     Hyphenation =        off,
  303.     Allow Page Break Within = no,
  304.     Allow Page Break After = no,
  305.     Left Tab =        0/1.60 inches,
  306.     Autonumber Name =    table,
  307.     TOC Doc Name =        TOC>
  308.  
  309. <!Class, title,
  310.     Top Margin =        0.07 inches,
  311.     Bottom Margin =        0.07 inches,
  312.     Line Spacing =        1.100 lines,
  313.     Alignment =        Right,
  314.     Font =            F5,
  315.     TOC Doc Name =        TOC>
  316.  
  317. <!Master Frame,
  318.     Name =            "At Anchor",
  319.     Placement =        At Anchor,
  320.     Width =            0.41 inches,
  321.     Height =        0.137 inches,
  322.     Vertical Alignment =    0.03 inches,
  323.     Diagram =
  324. V4,
  325. (g9,32767,0
  326.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,1,0,1,1,0.066667,0.066667,6,6,0,0.066
  327.   667,6))>
  328.  
  329. <!Master Frame,
  330.     Name =            p1rule,
  331.     Placement =        At Anchor,
  332.     Width =            6.35 inches,
  333.     Height =        0.153 inches,
  334.     Vertical Alignment =    0.007 inches,
  335.     Shared Contents =    yes,
  336.     Diagram =
  337. V4,
  338. (g9,1,0
  339.  (v4,1,0,0.006667,0.066723,6.326667,0.066611,17,2,0)
  340.  (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
  341.   667,6))>
  342.  
  343. <First Page Header, Frame =
  344. V4,
  345. (g9,0,0
  346.  (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,1,1,1,1,0.066667,0.066667,6,6,0,0.066
  347.   667,6))>
  348.  
  349. <Right Page Header, Frame =
  350. V4,
  351. (g9,1,0
  352.  (T8,1,12,4.6,0.333333,1.71,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,
  353.   1101,2,
  354. <caption,
  355.     Alignment =        Right>
  356.  
  357. Windows and Pixmaps
  358.  
  359. <End Text>)
  360.  (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
  361.   667,6))>
  362.  
  363. <Left Page Header, Frame =
  364. V4,
  365. (g9,1,0
  366.  (T8,1,12,0,0.316667,1.013333,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10
  367.   2,1101,6,
  368. <caption,
  369.     Alignment =        Left>
  370.  
  371. Windows and Pixmaps
  372.  
  373. <End Text>)
  374.  (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
  375.   667,6))>
  376.  
  377. <Right Page Footer, Frame =
  378. V4,
  379. (g9,1,0
  380.  (t8,1,4,6.333333,0.266667,2,17,@nntimsps10b,\240)
  381.  (t8,2,4,0.006667,0.266667,0,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  382.  (v4,3,0,0,0.066667,6.333333,0.066554,17,2,0)
  383.  (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
  384.   667,6))>
  385.  
  386. <Left Page Footer, Frame =
  387. V4,
  388. (g9,1,0
  389.  (t8,1,4,0,0.266667,0,17,@nntimsps10b,\240)
  390.  (t8,2,4,6.333333,0.266667,2,17,@nntimsps8i,CLX\ Programmer's\ Reference)
  391.  (v4,3,0,0.026667,0.066667,6.333333,0.066554,17,2,0)
  392.  (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
  393.   667,6))>
  394.  
  395. <sectitle,
  396.     Allow Page Break Within = no,
  397.     Allow Page Break After = no>
  398.  
  399. <|,"4<#1e>35">
  400. <Frame,
  401.     Name =            "At Anchor",
  402.     Placement =        At Anchor,
  403.     Width =            4.72 inches,
  404.     Height =        0.94 inches,
  405.     Vertical Alignment =    0.03 inches,
  406.     Diagram =
  407. V4,
  408. (g9,1,0
  409.  (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
  410.   ,102,1101,3,
  411. <title>
  412.  
  413. WINDOWS AND PIXMAPS
  414.  
  415. <End Text>)
  416.  (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
  417.   667,6))>
  418. <Frame,
  419.     Name =            "At Anchor",
  420.     Placement =        At Anchor,
  421.     Width =            1.626 inches,
  422.     Height =        0.938 inches,
  423.     Vertical Alignment =    0 inches,
  424.     Diagram =
  425. V4,
  426. (g9,1,0
  427.  (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
  428.   2,1101,3,
  429. <secno,
  430.     TOC Doc Name =        TOC>
  431.  
  432. <Autonum, paranum, 1, First = Yes>
  433.  
  434. <End Text>)
  435.  (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
  436.   2,1101,3,
  437. <"table">
  438.  
  439. <Autonum, table, 1, First = Yes>
  440.  
  441. <End Text>)
  442.  (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
  443.   1,3,
  444. <fig,
  445.     Alignment =        Both,
  446.     Font =            F6,
  447.     Autonumber Name =    figure>
  448.  
  449. <Autonum, figure, 1, First = Yes>
  450.  
  451. <End Text>)
  452.  (g9,5,0
  453.    (p7,5,8,19
  454.      (g9,5,0
  455.        (g9,5,0
  456.          (v4,5,0,0.266667,0,1.6,0,17,1,0)
  457.          (v4,6,0,1.6,0,1.6,0.933333,17,1,0)
  458.          (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0)
  459.          (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0))))
  460.    (g9,10,8
  461.      (g9,10,1032
  462.        (p7,10,8,13
  463.          (g9,10,0
  464.            (g9,10,0
  465.              (v4,10,0,1.451931,0.934813,1.249826,0.934813,17,1,0)
  466.              (v4,11,0,1.249826,0.934813,1.249826,0.784691,17,1,0)
  467.              (v4,12,32,1.249826,0.784691,1.249826,0.653326,17,0,0)
  468.              (v4,13,0,1.249826,0.653326,1.249826,0.353084,17,1,0)
  469.              (v4,14,32,1.249826,0.353084,1.227369,0.146667,17,0,0)
  470.              (v4,15,0,1.227369,0.146667,1.451931,0.146667,17,1,0)
  471.              (v4,16,0,1.451931,0.146667,1.451931,0.653326,17,1,0)
  472.              (v4,17,0,1.451931,0.653326,1.564212,0.653326,17,1,0)
  473.              (v4,18,0,1.564212,0.653326,1.564212,0.784691,17,1,0)
  474.              (v4,19,0,1.564212,0.784691,1.451931,0.784691,17,1,0)
  475.              (v4,20,0,1.451931,0.784691,1.451931,0.934813,17,1,0))))
  476.        (p7,22,8,13
  477.          (g9,22,0
  478.            (g9,22,0
  479.              (v4,22,32,1.249826,0.784691,1.249826,0.653326,17,0,0)
  480.              (v4,23,0,1.249826,0.653326,1.002807,0.653326,17,1,0)
  481.              (v4,24,0,1.002807,0.653326,1.249826,0.353084,17,1,0)
  482.              (v4,25,32,1.249826,0.353084,1.227369,0.146667,17,0,0)
  483.              (v4,26,0,1.227369,0.146667,0.823159,0.615801,17,1,0)
  484.              (v4,27,0,0.823159,0.615801,0.823159,0.784691,17,1,0)
  485.              (v4,28,0,0.823159,0.784691,1.249826,0.784691,17,1,0)))))
  486.      (g9,29,2048
  487.        (v4,29,33,0.800701,0.146667,0.800701,0.146667,17,0,0)
  488.        (v4,30,33,0.800701,1.159997,0.800701,1.159997,17,0,0)
  489.        (v4,31,33,1.586667,1.159997,1.586667,1.159997,17,0,0)
  490.        (v4,32,33,1.586667,0.146667,1.586667,0.146667,17,0,0))))
  491.  (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
  492.   667,6))>
  493.  
  494. <secrule,
  495.     Allow Page Break Within = no,
  496.     Allow Page Break After = yes,
  497.     Autonumber Name =    >
  498.  
  499. <Index, "drawable", To Named = sectitle><Index, "pixmap", To Named = sectitle><Index, "window", To Named = sectitle>
  500. <Frame,
  501.     Name =            "At Anchor",
  502.     Placement =        At Anchor,
  503.     Width =            6.35 inches,
  504.     Height =        0.153 inches,
  505.     Vertical Alignment =    0.007 inches,
  506.     Diagram =
  507. V4,
  508. (g9,1,0
  509.  (v4,1,0,0.006667,0.066723,6.333333,0.066611,17,2,0)
  510.  (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
  511.   667,6))>
  512.  
  513. <p1para,
  514.     Alignment =        Both,
  515.     Font =            F3,
  516.     Allow Page Break After = yes>
  517.  
  518. <F8>Drawables<Tab><F6>4.1<F0><#04>Both windows and pixmaps can 
  519. be used as sources and destinations in graphics operations. These 
  520. are collectively known as <F2>drawables<F0>. The following functions 
  521. apply to both windows and pixmaps.
  522.  
  523. <syntax,
  524.     Left Tab =        -0.90/0 inches,
  525.     Right Tab =        7.50 inches>
  526.  
  527. drawable<#1e>display<F3> <F2>drawable<F0><Tab><F3>Function<Index, Doc = operations, "xlib:drawable<#1e>display", Sort String = "drawable<#1e>display">
  528.  
  529. <para>
  530.  
  531. Returns the display for the specified <F2>drawable<F0>.
  532.  
  533. <arg>
  534.  
  535. drawable <F3><#1f> A <F6>drawable<F3> object.
  536.  
  537. <syntax,
  538.     Left Tab =        -0.90/0 inches,
  539.     Right Tab =        7.50 inches>
  540.  
  541. drawable<#1e>equal<F3> <F2>drawable<#1e>1<F0> <F2>drawable<#1e>2<F0><Tab>
  542. <F3>Function<Index, Doc = operations, "xlib:drawable<#1e>equal", Sort String = "drawable<#1e>equal">
  543.  
  544. <para>
  545.  
  546. Returns true if the two arguments refer to the same server resource, 
  547. and <F6>nil<F0> if they do not.
  548.  
  549. <arg>
  550.  
  551. drawable<#1e>1<F3>,<F6> <F0>drawable<#1e>2 <F3><#1f> <F6>drawable<F3> 
  552. objects.
  553.  
  554. <syntax,
  555.     Bottom Margin =        0 inches,
  556.     Left Tab =        -0.90/0 inches,
  557.     Right Tab =        7.50 inches>
  558.  
  559. drawable<#1e>id<F3> <F2>drawable<F0><Tab><F3>Function<Index, Doc = operations, "xlib:drawable<#1e>id", Sort String = "drawable<#1e>id">
  560.  
  561. <return>
  562.  
  563. <Tab><F3>Returns: <F2><HR>
  564.   id <F3><#1f> Type <F0>resource<#1e>id<F3>.
  565.  
  566. <para>
  567.  
  568. Returns the unique resource ID assigned to the specified <F2>drawable<F0>.
  569.  
  570. <arg>
  571.  
  572. drawable <F3><#1f> A <F6>drawable<F3> object.
  573.  
  574. <syntax,
  575.     Bottom Margin =        0 inches,
  576.     Left Tab =        -0.90/0 inches,
  577.     Right Tab =        7.50 inches>
  578.  
  579. drawable<#1e>p<F3> <F2>drawable<F0><Tab><F3>Function<Index, Doc = operations, "xlib:drawable<#1e>p", Sort String = "drawable<#1e>p">
  580.  
  581. <return>
  582.  
  583. <Tab><F3>Returns: <F2><HR>
  584.   boole <F3><#1f> Type <F0>boolean<F3>.
  585.  
  586. <para>
  587.  
  588. Returns true if the argument is a <F6>drawable<F0> and <F6>nil<F0> 
  589. otherwise.
  590.  
  591. <syntax,
  592.     Bottom Margin =        0 inches,
  593.     Left Tab =        -0.90/0 inches,
  594.     Right Tab =        7.50 inches>
  595.  
  596. drawable<#1e>plist<F3> <F2>drawable<F0><Tab><F3>Function<Index, Doc = operations, "xlib:drawable<#1e>plist", Sort String = "drawable<#1e>plist">
  597.  
  598. <return>
  599.  
  600. <Tab><F3>Returns: <F2><HR>
  601.   plist <F3><#1f> A property list.
  602.  
  603. <para>
  604.  
  605. Returns and (with <F6>setf<F0>) sets the property list for the specified 
  606. <F2>drawable<F0>. This function provides a hook where extensions 
  607. can add data.
  608.  
  609. <p1rule>
  610.  
  611. <Index, "window", "creating">
  612. <Frame,
  613.     Name =            p1rule,
  614.     Placement =        At Anchor,
  615.     Width =            6.35 inches,
  616.     Height =        0.153 inches,
  617.     Vertical Alignment =    0.007 inches,
  618.     Shared Contents =    yes>
  619.  
  620. <p1stacked,
  621.     Line Spacing =        1 lines,
  622.     Alignment =        Both,
  623.     Font =            F3>
  624.  
  625. <F8>Creating <Tab><F6>4.2<F0><#04>A window is a <F6>drawable<F0> 
  626. that can also receive input events. CLX<FJ>
  627.  
  628. <p1para,
  629.     Alignment =        Both,
  630.     Font =            F3,
  631.     Allow Page Break After = yes>
  632.  
  633. <F8>Windows<Tab><F0>represents a window with a <F6>window <F0>object. 
  634. The <F6>create<#1e>window<F0> function creates a new <F6>window<F0> 
  635. object.
  636.  
  637. <syntax,
  638.     Bottom Margin =        0 inches,
  639.     Left Tab =        -0.90/0 inches,
  640.     Right Tab =        7.50 inches>
  641.  
  642. create<#1e>window<F3> &key <F0>:parent :x :y :width :height<F3> 
  643. (<F0>:depth<F3> 0)<Tab>Function<Index, Doc = operations, "xlib:create<#1e>window", Sort String = "create<#1e>window"><HR>
  644. (<F0>:border<#1e>width<F3> 0) (<F0>:class<F3> <F0>:copy<F3>) 
  645. (<F0>:visual :copy<F3>) <F0>:background <HR>
  646. :border :gravity :bit<#1e>gravity :backing<#1e>store :backing<#1e>planes <F9> 
  647. <F0>:backing<#1e>pixel :save<#1e>under :event<#1e>mask :do<#1e>not<#1e>propaga
  648. te<#1e>mask  :override<#1e>redirect :colormap :cursor
  649.  
  650. <return>
  651.  
  652. <Tab><F3>Returns: <F2><HR>
  653.   window<F3> <#1f> Type <F0>window<F3>.
  654.  
  655. <para>
  656.  
  657. Creates and returns a window. A <F6>:parent<F0> window must be specified; 
  658. the first window created by a client will have a root window as its <F6>:paren
  659. t<F0>. The new window is initially unmapped and is placed on top 
  660. of its siblings in the stacking order. A <F6>:create<#1e>notify<F0> 
  661. event is generated by the server.
  662.  
  663. <|,"4<#1e>36">The <F6>:class<F0> of a window can be <F6>:input<#1e>output <F0>or 
  664. <F6>:input<#1e>only<F0>. Windows of class <F6>:input<#1e>only<F0> 
  665. cannot be used as the destination drawable for graphics output and 
  666. can never receive <F6>:exposure<F0> events, but otherwise operate 
  667. the same as <F6>:input<#1e>output<F0> windows. The <F6>:class<F0> 
  668. can also be <F6>:copy<F0>, in which case the new window has the 
  669. same class as its <F6>:parent<F0>. 
  670.  
  671. For an <F6>:input<#1e>output<F0> window, the <F6>:visual<F0> and <F6>:dept
  672. h<F0> must be a combination<SP>supported by the <F6>:parent<F0>'s 
  673. screen, but the <F6>:depth<F0> need not be the same as the <F6>:parent<F0>'
  674. s. The <F6>:parent<F0> of an <F6>:input<#1e>output<F0> window 
  675. must also be <F6>:input<#1e>output<F0>. A <F6>:depth<F0> of 0 
  676. means that the depth of the <F6>:parent<F0> is used.
  677.  
  678. For an <F6>:input<#1e>only<F0> window, the <F6>:depth<F0> must 
  679. be zero, and the <F6>:visual<F0> must be<SP>supported by the <F6>:parent
  680. <F0>'s screen. The <F6>:parent<F0> of an <F6>:input<#1e>only<F0> 
  681. window can<SP>be of any class. The only attributes that can be given 
  682. for an <F6>:input<#1e>only<F0><SP>window are <F6>:cursor<F0>, <F6>:do<#1e>
  683. not<#1e>propagate<#1e>mask<F0>, <F6>:event<#1e>mask<F0>, <F6>:gravity<F0>, 
  684. and<SP><F6>:override<#1e>redirect<F0>.
  685.  
  686. <arg>
  687.  
  688. <F6>:parent<F3> <#1f> The parent window. This argument is required.
  689.  
  690. <F6>:x<F3>, <F6>:y<F3> <#1f> <F6>int16<F3> coordinates for the 
  691. outside upper<#1e>left corner of the new window with respect to the 
  692. origin (inside upper<#1e>left corner) of the <F6>:parent<F3>. These 
  693. arguments are required.
  694.  
  695. <F6>:width<F3>, <F6>:height<F3> <#1f> <F6>card16<F3> values 
  696. for the size of the new window. These arguments are required. 
  697.  
  698. <F6>:depth<F3> <#1f> A <F6>card16<F3> specifying the depth of 
  699. the new window.
  700.  
  701. <F6>:class<F3> <#1f> One of <F6>:input<#1e>outpu<F3>t, <F6>:input<#1e>only
  702. <F3>, or<F6> :copy<F3>.
  703.  
  704. <F6>:visual<F3> <#1f> A <F6>card29<F3> ID specifying the visual 
  705. type of the new window.
  706.  
  707. <F6>:background<F3>, <F6>:backing<#1e>pixel<F3>, <F6>:backing<#1e>planes
  708. <F3>, <F6>:backing<#1e>store<F3>, <F6>:bit<#1e>gravity<F3>, <F6>:border
  709. <F3>, <F6>:border<#1e>width<F3>, <F6>:colormap<F3>, <F6>:cursor<F3>, 
  710. <F6>:do<#1e>not<#1e>propagate<#1e>mask<F3>, <F6>:event<#1e>mask<F3>, <F6>:
  711. gravity<F3>, <F6>:override<#1e>redirect<F3>, <F6>:save<#1e>under<F3> 
  712. <#1f> Initial attribute values for the new window. If <F6>nil<F3>, 
  713. the default value is defined by the X protocol. See paragraph 4.3, 
  714. Window Attributes.
  715.  
  716. <p1rule,
  717.     New Page =        yes>
  718.  
  719. <|,"4<#1e>37"><Index, "window", "attributes">
  720. <Frame,
  721.     Name =            p1rule,
  722.     Placement =        At Anchor,
  723.     Width =            6.35 inches,
  724.     Height =        0.153 inches,
  725.     Vertical Alignment =    0.007 inches,
  726.     Shared Contents =    yes>
  727.  
  728. <p1stacked,
  729.     Line Spacing =        1 lines,
  730.     Alignment =        Both,
  731.     Font =            F3>
  732.  
  733. <F8>Window <Tab><F6>4.3<F0><#04>The following paragraphs describe 
  734. the CLX functions used to return or<FJ>
  735.  
  736. <p1para,
  737.     Alignment =        Both,
  738.     Font =            F3,
  739.     Allow Page Break After = yes>
  740.  
  741. <F8>Attributes<Tab><F0>change window attributes. Using the <F6>with<#1e>stat
  742. e<F0> macro improves the performance of attribute access by batching 
  743. related accesses in the minimum number of server requests.
  744.  
  745. <syntax,
  746.     Bottom Margin =        0 inches,
  747.     Left Tab =        -0.90/0 inches,
  748.     Right Tab =        7.50 inches>
  749.  
  750. drawable<#1e>border<#1e>width<F9> <F2>drawable<F0><Tab><F3>Function<F0><Index, "border<#1e>width attribute of window"><Index, "window", "attribute", "border<#1e>width"><Index, Doc = operations, "xlib:drawable<#1e>border<#1e>width", Sort String = "drawable<#1e>border<#1e>width">
  751.  
  752. <return>
  753.  
  754. <Tab><F3>Returns: <F2><HR>
  755.   border<#1e>width <F3><#1f> Type <F0>card16<F3>.
  756.  
  757. <para>
  758.  
  759. Returns the <F2>border<#1e>width<F0> of the <F2>drawable<F0> in 
  760. pixels. It always returns zero if the <F2>drawable<F0> is a pixmap 
  761. or an <F6>:input<#1e>only<F0> window. Used with <F6>setf<F0>, 
  762. this function also changes the border width of the <F6>:input<#1e>only<F0> 
  763. window. The default border width of a new window is zero.
  764.  
  765. Changing just the border width leaves the outer left corner of a window 
  766. in a fixed position but moves the absolute position of the window's 
  767. origin. It is an error to make the border width of an <F6>:input<#1e>only
  768. <F0> window nonzero.
  769.  
  770. When changing the border<#1e>width of a window, if the override<#1e>redirect 
  771. attribute of the window is <F6>:off<F0> and some other client has 
  772. selected <F6>:substructure<#1e>redirect<F0> on the parent, a <F6>:configure<#1e>
  773. request<F0> event is generated, and no further processing is performed. 
  774. Otherwise, the border<#1e>width is changed.
  775.  
  776. <arg>
  777.  
  778. drawable<F9> <F3><#1f> A <F6>drawable<F3> object.
  779.  
  780. <syntax,
  781.     Bottom Margin =        0 inches,
  782.     Left Tab =        -0.90/0 inches,
  783.     Right Tab =        7.50 inches>
  784.  
  785. drawable<#1e>depth <F2>drawable<F0><Tab><F3>Function<F0><Index, "depth attribute of window"><Index, "window", "attribute", "depth"><Index, Doc = operations, "xlib:drawable<#1e>depth", Sort String = "drawable<#1e>depth">
  786.  
  787. <return>
  788.  
  789. <Tab><F3>Returns: <F2><HR>
  790.   depth <F3><#1f> Type <F0>card8<F3>.
  791.  
  792. <para>
  793.  
  794. Returns the depth of the specified <F2>drawable<F0> (bits per pixel).
  795.  
  796. <arg>
  797.  
  798. drawable <F3><#1f> A <F6>drawable<F3> object.
  799.  
  800. <syntax,
  801.     Bottom Margin =        0 inches,
  802.     Left Tab =        -0.90/0 inches,
  803.     Right Tab =        7.50 inches>
  804.  
  805. drawable<#1e>height <F2>drawable<F0><Tab><F3>Function<F0><Index, "height", "attribute of window"><Index, "window", "attribute", "height"><Index, Doc = operations, "xlib:drawable<#1e>height", Sort String = "drawable<#1e>height">
  806.  
  807. <return>
  808.  
  809. <Tab><F3>Returns: <F2><HR>
  810.   inside<#1e>height <F3><#1f> Type <F0>card16<F3>.
  811.  
  812. <syntax,
  813.     Bottom Margin =        0 inches,
  814.     Left Tab =        -0.90/0 inches,
  815.     Right Tab =        7.50 inches>
  816.  
  817. drawable<#1e>width <F2>drawable<F0><Tab><F3>Function<F0><Index, "width", "attribute of window"><Index, "window", "attribute", "width"><Index, Doc = operations, "xlib:drawable<#1e>width", Sort String = "drawable<#1e>width">
  818.  
  819. <return>
  820.  
  821. <Tab><F3>Returns: <F2><HR>
  822.   inside<#1e>width <F3><#1f> Type <F0>card16<F3>.
  823.  
  824. <para>
  825.  
  826. These functions return the height or width of the <F2>drawable<F0>. 
  827. These coordinates define the inside size of the <F2>drawable<F0>, 
  828. in pixels. Used with <F6>setf<F0>, these functions also change the 
  829. inside height or width of a window. However, the height or width of 
  830. a pixmap cannot be changed. 
  831.  
  832. Changing the width and height resizes a window without changing its 
  833. position or stacking priority. 
  834.  
  835. Changing the size of a mapped window may cause the window to lose 
  836. its contents and generate an <F6>:exposure<F0> event. If a mapped 
  837. window is made smaller, <F6>:exposure<F0> events are generated on 
  838. windows that it formerly obscured.
  839.  
  840. When changing the size of a window, if the override<#1e>redirect attribute 
  841. of the window is <F6>:off<F0> and some other client has selected <F6>:substr
  842. ucture<#1e>redirect<F0> on the parent, a <F6>:configure<#1e>request<F0> 
  843. event is generated, and no further processing is performed. Otherwise, 
  844. if another client has selected <F6>:resize<#1e>redirect<F0> on the 
  845. window, a <F6>:resize<#1e>request<F0> event is generated, and the 
  846. current inside width and height are maintained. Note that the override<#1e>redi
  847. rect attribute of the window has no effect on <F6>:resize<#1e>redirect<F0> 
  848. and that <F6>:substructure<#1e>redirect<F0> on the parent has precedence 
  849. over <F6>:resize<#1e>redirect<F0> on the window.
  850.  
  851. <|,"4<#1e>38">When the inside size of the window is changed, the children 
  852. of the window can move according to their window gravity. Depending 
  853. on the window's bit gravity, the contents of the window can also be 
  854. moved. 
  855.  
  856. <arg>
  857.  
  858. drawable <F3><#1f> A <F6>drawable<F3> object.
  859.  
  860. <syntax,
  861.     Bottom Margin =        0 inches,
  862.     Allow Page Break After = yes,
  863.     Left Tab =        -0.90/0 inches,
  864.     Right Tab =        7.50 inches>
  865.  
  866. drawable<#1e>x <F2>drawable<F0><Tab><F3>Function<Index, "window", "x coordinate"><F0><Index, Doc = operations, "xlib:drawable<#1e>x", Sort String = "drawable<#1e>x">
  867.  
  868. <return,
  869.     Allow Page Break After = yes>
  870.  
  871. <Tab><F3>Returns: <F2><HR>
  872.   outside<#1e>left <F3><#1f> Type <F0>int16<F3>.
  873.  
  874. <syntax0>
  875.  
  876. drawable<#1e>y <F2>drawable<F3><Tab>Function<F0><Index, "window", "y coordinate"><Index, Doc = operations, "xlib:drawable<#1e>y", Sort String = "drawable<#1e>y">
  877.  
  878. <return>
  879.  
  880. <Tab><F3>Returns: <F2><HR>
  881.   outside<#1e>top <F3><#1f> Type <F0>int16<F3>.
  882.  
  883. <para>
  884.  
  885. These functions return the x or y coordinate of the specified <F2>drawable
  886. <F0>. They always return zero if the <F2>drawable<F0> is a pixmap. 
  887. These coordinates define the location of the top left pixel of the 
  888. window's border or of the window, if it has no border. Used with <F6>setf
  889. <F0>, these functions also change the x or y coordinate of a window. 
  890. However, the x or y coordinate of a pixmap cannot be changed.
  891.  
  892. Changing the x and y coordinates moves a window without changing its 
  893. size or stacking priority. Moving a mapped window generates <F6>:exposure
  894. <F0> events on any formerly obscured windows.
  895.  
  896. When changing the position of a window, if the override<#1e>redirect 
  897. attribute of the window is <F6>:off<F0> and some other client has 
  898. selected<F6> :substructure<#1e>redirect<F0> on the parent, a <F6>:configure<#1e>
  899. request<F0> event is generated, and no further processing is performed. 
  900. Otherwise, the window is moved.
  901.  
  902. <arg>
  903.  
  904. drawable <F3><#1f> A <F6>drawable<F3> object.
  905.  
  906. <syntax,
  907.     Bottom Margin =        0 inches,
  908.     Left Tab =        -0.90/0 inches,
  909.     Right Tab =        7.50 inches>
  910.  
  911. window<#1e>all<#1e>event<#1e>masks <F2>window<F0><Tab><F3>Function<F0><Index, "event masks", "window"><Index, "window", "event masks"><Index, Doc = operations, "xlib:window<#1e>all<#1e>event<#1e>masks ", Sort String = "window<#1e>all<#1e>event<#1e>masks ">
  912.  
  913. <return>
  914.  
  915. <Tab><F3>Returns:<F2> <HR>
  916.   all<#1e>event<#1e>masks <F3><#1f> Type <F0>mask32<F3>.
  917.  
  918. <para>
  919.  
  920. Returns the inclusive<#1e>or of the event masks selected on the specified 
  921. <F2>window<F0> by all clients.
  922.  
  923. <arg>
  924.  
  925. window <F3><#1f> A<F6> window<F3>.
  926.  
  927. <syntax,
  928.     Bottom Margin =        0 inches,
  929.     Left Tab =        -0.90/0 inches,
  930.     Right Tab =        7.50 inches>
  931.  
  932. setf <F3>(<F0>window<#1e>background<F3>)<F0> <F2>window background<F0><Tab>
  933. <F3>Function<F0><Index, "background attribute", "window"><Index, "window", "attribute", "background"><Index, Doc = operations, "xlib:window<#1e>background", Sort String = "window<#1e>background">
  934.  
  935. <return>
  936.  
  937. <Tab><F3>Returns: <F2><HR>
  938.   background <F3><#1f> Either a <F0>pixel<F3>, a <F0>pixmap<F3>, <F0>:non
  939. e<F3>, or <F0>:parent<#1e>relative<F3>.
  940.  
  941. <para>
  942.  
  943. Changes the <F2>background<F0> attribute of the <F2>window<F0> 
  944. to the specified value. This operation is not allowed on an <F6>:input<#1e>onl
  945. y<F0> window. Changing the background does not cause the window contents 
  946. to be changed. Note that the background of a window cannot be returned 
  947. from the X server. The default background of a new window is <F6>:none<F0>.
  948.  
  949. In general, the server automatically fills in exposed areas of the 
  950. window when they are first made visible. A background pixmap is tiled 
  951. to fill each area. However, if the background is <F6>:none<F0>, 
  952. the server will not modify<SP> exposed areas. If the background is <F6>:parent
  953. <#1e>relative<F0>, the window and its parent must have the same depth. 
  954. In this case, the window shares the same background as its parent. 
  955. The parent's background is not copied and is reexamined whenever the 
  956. window's background is required. If the background is <F6>:parent<#1e>relative
  957. <F0>, the background pixmap tile origin is the same as the parent's; 
  958. otherwise, the tile origin is the window origin.
  959.  
  960. <arg>
  961.  
  962. window <F3><#1f> A <F6>window<F3>.
  963.  
  964. background <F3><#1f> Either a <F6>pixel<F3>, a <F6>pixmap<F3>, <F6>:none
  965. <F3>, or <F6>:parent<#1e>relative<F3>.
  966.  
  967. <syntax,
  968.     Bottom Margin =        0 inches,
  969.     Left Tab =        -0.90/0 inches,
  970.     Right Tab =        7.50 inches>
  971.  
  972. <|,"4<#1e>39">window<#1e>backing<#1e>pixel<F9> <F2>window<F0><Tab><F3>Function
  973. <F0><Index, "backing<#1e>pixel attribute of window"><Index, "window", "attribute", "backing<#1e>pixel"><Index, Doc = operations, "xlib:window<#1e>backing<#1e>pixel", Sort String = "window<#1e>backing<#1e>pixel">
  974.  
  975. <return>
  976.  
  977. <Tab><F3>Returns:<F2> <HR>
  978.   backing<#1e>pixel <F3><#1f> Type <F0>pixel<F3>.
  979.  
  980. <para>
  981.  
  982. Returns and (with <F6>setf<F0>) changes the value of the backing<#1e>pixel 
  983. attribute for the specified <F2>window<F0>. Changing the backing<#1e>pixel 
  984. attribute of a mapped window may have no immediate effect. The default 
  985. backing<#1e>pixel of a new window is zero.
  986.  
  987. <arg>
  988.  
  989. window <F3><#1f> A <F6>window<F3>.
  990.  
  991. <syntax,
  992.     Bottom Margin =        0 inches,
  993.     Left Tab =        -0.90/0 inches,
  994.     Right Tab =        7.50 inches>
  995.  
  996. window<#1e>backing<#1e>planes<F9> <F2>window<F0><Tab><F3>Function<F0><Index, "backing<#1e>planes attribute of window"><Index, "window", "attribute", "backing<#1e>planes"><Index, Doc = operations, "xlib:window<#1e>backing<#1e>planes", Sort String = "window<#1e>backing<#1e>planes">
  997.  
  998. <return>
  999.  
  1000. <Tab><F3>Returns:<F2> <HR>
  1001.   backing<#1e>planes <F3><#1f> Type <F0>pixel<F3>.
  1002.  
  1003. <para>
  1004.  
  1005. Returns and (with <F6>setf<F0>) changes the value of the backing<#1e>planes 
  1006. attribute for the specified <F2>window<F0>. Changing the backing<#1e>planes 
  1007. attribute of a mapped window may have no immediate effect. The default 
  1008. backing<#1e>planes of a new window is all one's.
  1009.  
  1010. <arg>
  1011.  
  1012. window <F3><#1f> A <F6>window<F3>.
  1013.  
  1014. <syntax,
  1015.     Bottom Margin =        0 inches,
  1016.     Left Tab =        -0.90/0 inches,
  1017.     Right Tab =        7.50 inches>
  1018.  
  1019. window<#1e>backing<#1e>store <F2>window<F0><Tab><F3>Function<F0><Index, "backing<#1e>store attribute of window"><Index, "window", "attribute", "backing<#1e>store"><Index, Doc = operations, "xlib:window<#1e>backing<#1e>store", Sort String = "window<#1e>backing<#1e>store">
  1020.  
  1021. <return>
  1022.  
  1023. <Tab><F3>Returns:<F2> <HR>
  1024.   backing<#1e>store<#1e>type <F3><#1f> One of <F0>:always<F3>, <F0>:not<#1e>
  1025. useful<F3>, or <F0>:when<#1e>mapped<F3>.
  1026.  
  1027. <para>
  1028.  
  1029. Returns and (with <F6>setf<F0>) changes the value of the backing<#1e>store 
  1030. attribute for the specified <F2>window<F0>. Changing the backing<#1e>store 
  1031. attribute of an obscured window to <F6>:when<#1e>mapped<F0> or <F6>:always
  1032. <F0> may have no immediate effect. The default backing<#1e>store 
  1033. of a new window is <F6>:not<#1e>useful<F0>.
  1034.  
  1035. <arg>
  1036.  
  1037. window <F3><#1f> A <F6>window<F3>.
  1038.  
  1039. <syntax,
  1040.     Bottom Margin =        0 inches,
  1041.     Left Tab =        -0.90/0 inches,
  1042.     Right Tab =        7.50 inches>
  1043.  
  1044. window<#1e>bit<#1e>gravity <F2>window<F0><Tab><F3>Function<F0><Index, "bit<#1e>gravity attribute of window", Sort String = "bit gravity attribute of window"><Index, "window", "attribute", "bit<#1e>gravity"><Index, Doc = operations, "xlib:window<#1e>bit<#1e>gravity", Sort String = "window<#1e>bit<#1e>gravity">
  1045.  
  1046. <return>
  1047.  
  1048. <Tab><F3>Returns:<HR>
  1049. <F2>  bit<#1e>gravity <F3><#1f> Type <F0>bit<#1e>gravity<F3>.
  1050.  
  1051. <para>
  1052.  
  1053. Returns and (with <F6>setf<F0>) changes the bit<#1e>gravity attribute 
  1054. of the <F2>window<F0>. If a window is reconfigured without changing 
  1055. its inside width or height, the contents of the window move with the 
  1056. window and are not lost. Otherwise, the contents of the resized window 
  1057. are either moved or lost, depending on its bit<#1e>gravity attribute. 
  1058. The default bit<#1e>gravity of a new window is <F6>:forget<F0>.
  1059.  
  1060. For example, suppose a window's size is changed by <F2>W<F0> pixels 
  1061. in width and <F2>H<F0> pixels in height. The following table shows, 
  1062. for each bit<#1e>gravity value, the change in position (relative to 
  1063. the window origin) that results for each pixel of the window contents.
  1064.  
  1065. <t2,
  1066.     Allow Page Break After = no>
  1067.  
  1068. <F6>Bit<#1e>Gravity<Tab>X Change<Tab><Tab>Y Change
  1069.  
  1070. <t2>
  1071.  
  1072. <Tab-><Tab-><Tab-><Tab-><Tab-><Tab->
  1073.  
  1074. <F6>:center<F0><Tab><F2>W/<F0>2<Tab><Tab><F2>H/<F0>2 
  1075.  
  1076. <F6>:east<F0><Tab><F2>W<F0><Tab><Tab><F2>H/<F0>2
  1077.  
  1078. <F6>:north<F0><Tab><F2>W/<F0>2<Tab><Tab>0 
  1079.  
  1080. <F6>:north<#1e>east<F0><Tab><F2>W<F0><Tab><Tab>0 
  1081.  
  1082. <F6>:north<#1e>west<F0><Tab>0<Tab><Tab>0 
  1083.  
  1084. <F6>:south<F0><Tab><F2>W/<F0>2<Tab><Tab><F2>H<F0> 
  1085.  
  1086. <F6>:south<#1e>east<F0><Tab>W<Tab><Tab>H
  1087.  
  1088. <F6>:south<#1e>west<F0><Tab>0<Tab><Tab>H 
  1089.  
  1090. <F6>:west<F0><Tab>0<Tab><Tab>H/2<HR>
  1091.  
  1092.  
  1093. <para>
  1094.  
  1095. A <F6>:static<F0> bit<#1e>gravity indicates the contents or window 
  1096. should not move relative to the origin of the root window. 
  1097.  
  1098. <|,"4<#1e>40">A server can choose to ignore the specified bit<#1e>gravity 
  1099. attribute and use <F6>:forget<F0> instead. A <F6>:forget<F0> bit<#1e>gravit
  1100. y attribute indicates that the window contents are always discarded 
  1101. after a size change, even if backing<#1e>store or save<#1e>under attributes 
  1102. are <F6>:on<F0>. The window's background is displayed (unless it 
  1103. is <F6>:none<F0>), and zero or more <F6>:exposure<F0> events are 
  1104. generated.
  1105.  
  1106. <arg>
  1107.  
  1108. window <F3><#1f> A <F6>window<F3>.
  1109.  
  1110. <syntax,
  1111.     Bottom Margin =        0 inches,
  1112.     Left Tab =        -0.90/0 inches,
  1113.     Right Tab =        7.50 inches>
  1114.  
  1115. setf <F3>(<F0>window<#1e>border<F3>) <F2>window border<F0><Tab><F3>Functi
  1116. on<F0><Index, "border attribute of window"><Index, "window", "attribute", "border"><Index, Doc = operations, "xlib:window<#1e>border", Sort String = "window<#1e>border">
  1117.  
  1118. <return>
  1119.  
  1120. <Tab><F3>Returns:<F2> <HR>
  1121.   border <F3><#1f> Either a <F0>pixel<F3>, a <F0>pixmap<F3>, 
  1122. or <F0>:copy<F3>.
  1123.  
  1124. <para>
  1125.  
  1126. Changes the <F2>border <F0>attribute of the <F2>window<F0> to 
  1127. the specified value. This operation is not allowed on an <F6>:input<#1e>only
  1128. <F0> window. Changing the border attribute also causes the window 
  1129. border to be repainted. Note that the border of a window cannot be 
  1130. returned from the X server. The default border of a new window is <F6>:copy
  1131. <F0>.
  1132.  
  1133. A border pixmap is tiled to fill the border. The border pixmap tile 
  1134. origin is<SP>the same as the background tile origin. A border pixmap 
  1135. and the window<SP>must have the same root and depth. If the border 
  1136. is <F6>:copy<F0>, the parent's<SP>border is copied and used; subsequent 
  1137. changes to the parent's border do not<SP>affect the window border.
  1138.  
  1139. <arg>
  1140.  
  1141. window <F3><#1f> A <F6>window<F3>.
  1142.  
  1143. border <F3><#1f> Either a <F6>pixel<F3>, a <F6>pixmap<F3>, or <F6>:copy
  1144. <F3>.
  1145.  
  1146. <syntax,
  1147.     Bottom Margin =        0 inches,
  1148.     Left Tab =        -0.90/0 inches,
  1149.     Right Tab =        7.50 inches>
  1150.  
  1151. window<#1e>class <F2>window<F0><Tab><F3>Function<F0><Index, "window", "class"><Index, "class", "window"><Index, Doc = operations, "xlib:window<#1e>class", Sort String = "window<#1e>class">
  1152.  
  1153. <return>
  1154.  
  1155. <Tab><F3>Returns: <F2><HR>
  1156.   class <F3><#1f> Either <F0>:input<#1e>output<F3> or <F0>:input<#1e>only
  1157. <F3>.
  1158.  
  1159. <para>
  1160.  
  1161. Returns the <F2>class<F0> of the specified <F2>window<F0>. 
  1162.  
  1163. <arg>
  1164.  
  1165. window <F3><#1f> A <F6>window<F3>.
  1166.  
  1167. <syntax,
  1168.     Bottom Margin =        0 inches,
  1169.     Left Tab =        -0.90/0 inches,
  1170.     Right Tab =        7.50 inches>
  1171.  
  1172. window<#1e>colormap<F3> <F2>window<F0><Tab><F3>Function<F0><Index, "colormap", "attribute of window"><Index, "window", "attribute", "colormap"><Index, Doc = operations, "xlib:window<#1e>colormap", Sort String = "window<#1e>colormap">
  1173.  
  1174. <return>
  1175.  
  1176. <Tab><F3>Returns: <F2><HR>
  1177.   colormap <F3><#1f> Type<F0> colormap<F3> or <F0>null<F3>. 
  1178.  
  1179. <para>
  1180.  
  1181. Returns and (with <F6>setf<F0>) changes the value of the colormap 
  1182. attribute for the specified <F2>window<F0>. A value of <F6>:copy<F0> 
  1183. is never returned, since the parent's colormap attribute is actually 
  1184. copied, but the attribute can be set to <F6>:copy<F0> in a <F6>setf<F0> 
  1185. form. Changing the colormap of a window (defining a new map, not changing 
  1186. the contents of the existing map) generates a <F6>:colormap<#1e>notify<F0> 
  1187. event. Changing the colormap of a visible window may have no immediate 
  1188. effect on the screen (see <F6>install<#1e>colormap<F0>). The default 
  1189. colormap of a new window is <F6>:copy<F0>.
  1190.  
  1191. <arg>
  1192.  
  1193. window <F3><#1f> A <F6>window<F3>.
  1194.  
  1195. <syntax,
  1196.     Bottom Margin =        0 inches,
  1197.     Left Tab =        -0.90/0 inches,
  1198.     Right Tab =        7.50 inches>
  1199.  
  1200. window<#1e>colormap<#1e>installed<#1e>p <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:window<#1e>colormap<#1e>installed<#1e>p", Sort String = "window<#1e>colormap<#1e>installed<#1e>p">
  1201.  
  1202. <return>
  1203.  
  1204. <Tab><F3>Returns: <F2><HR>
  1205.   colormap<#1e>installed<#1e>p <F3><#1f> Type <F0>boolean<F3>. 
  1206.  
  1207. <para>
  1208.  
  1209. Returns non<#1e><F6>nil<F0> if the colormap associated with this <F2>window
  1210. <F0> is installed. Otherwise, this function returns <F6>nil<F0>.
  1211.  
  1212. <arg>
  1213.  
  1214. window <F3><#1f> A <F6>window<F3>.
  1215.  
  1216. <syntax,
  1217.     Bottom Margin =        0 inches,
  1218.     Left Tab =        -0.90/0 inches,
  1219.     Right Tab =        7.50 inches>
  1220.  
  1221. <|,"4<#1e>41">setf <F3>(<F0>window<#1e>cursor<F3>) <F2>window cursor<F0><Tab>
  1222. <F3>Function<F0><Index, "cursor", "attribute of window"><Index, "window", "attribute", "cursor"><Index, Doc = operations, "xlib:window<#1e>cursor", Sort String = "window<#1e>cursor">
  1223.  
  1224. <return>
  1225.  
  1226. <Tab><F3>Returns: <F2><HR>
  1227.   cursor <F3><#1f> Type <F0>cursor <F3>or<F0> :none<F3>. 
  1228.  
  1229. <para>
  1230.  
  1231. Changes the <F2>cursor<F0> attribute of the <F2>window<F0> to 
  1232. the specified value. Changing the cursor of a root window to <F6>:none<F0> 
  1233. restores the default cursor. Note that the cursor of window cannot 
  1234. be returned from the X server. The default cursor of a new window 
  1235. is <F6>:none<F0>.
  1236.  
  1237. <arg>
  1238.  
  1239. window <F3><#1f> A <F6>window<F3>.
  1240.  
  1241. cursor <F3><#1f> Either <F6>cursor<F3> or <F6>:none<F3>.
  1242.  
  1243. <syntax0>
  1244.  
  1245. window<#1e>display<F3> <F2>window<F0><Tab><F3>Function<F0><Index, "display", "window object"><Index, "window", "display object"><Index, Doc = operations, "xlib:window<#1e>display", Sort String = "window<#1e>display">
  1246.  
  1247. <return>
  1248.  
  1249. <Tab><F3>Returns: <F2><HR>
  1250.   display <F3><#1f> Type <F0>display<F3>. 
  1251.  
  1252. <para>
  1253.  
  1254. Returns the <F6>display<F0> object associated with the specified <F2>window
  1255. <F0>. 
  1256.  
  1257. <arg>
  1258.  
  1259. window <#1f> <F3>A <F6>window<F3>.
  1260.  
  1261. <syntax,
  1262.     Bottom Margin =        0 inches,
  1263.     Left Tab =        -0.90/0 inches,
  1264.     Right Tab =        7.50 inches>
  1265.  
  1266. window<#1e>do<#1e>not<#1e>propagate<#1e>mask <F2>window<F0><Tab><F3>Function
  1267. <F0><Index, "do<#1e>not<#1e>propagate<#1e>mask attribute of window"><Index, "window", "attribute", "do<#1e>not<#1e>propagate<#1e>mask"><Index, Doc = operations, "xlib:window<#1e>do<#1e>not<#1e>propagate<#1e>mask", Sort String = "window<#1e>do<#1e>not<#1e>propagate<#1e>mask">
  1268.  
  1269. <return>
  1270.  
  1271. <Tab><F3>Returns: <F2><HR>
  1272.   do<#1e>not<#1e>propagate<#1e>mask <F3><#1f> Type <F0>mask32<F3>.
  1273.  
  1274. <para>
  1275.  
  1276. Returns and (with <F6>setf<F0>) changes the do<#1e>not<#1e>propagate<#1e>mask 
  1277. attribute for the<SP>window. The default do<#1e>not<#1e>propagate<#1e>mask 
  1278. of a new window is zero.
  1279.  
  1280. If a window receives an event from one of the user input devices, 
  1281. and if no<SP>client has selected to receive the event, the event can 
  1282. instead be<SP>propagated up the window hierarchy to the first ancestor 
  1283. for which some client<SP>has selected it. However, any event type 
  1284. selected by the do<#1e>not<#1e>propagate<#1e>mask<SP>is not be propagated. 
  1285. The types of events that can be selected by the<SP>do<#1e>not<#1e>propagate<#1e>
  1286. mask are those of type <F6>device<#1e>event<#1e>mask<#1e>class<F0>. 
  1287. See paragraph<SP>12.2, Selecting Events.
  1288.  
  1289. <arg>
  1290.  
  1291. window <F3><#1f> A <F6>window<F3>.
  1292.  
  1293. <syntax,
  1294.     Bottom Margin =        0 inches,
  1295.     Left Tab =        -0.90/0 inches,
  1296.     Right Tab =        7.50 inches>
  1297.  
  1298. window<#1e>equal <F2>window<#1e>1<F3> <F2>window<#1e>2<F0><Tab><F3>Functio
  1299. n<Index, Doc = operations, "xlib:window<#1e>equal", Sort String = "window<#1e>equal">
  1300.  
  1301. <return>
  1302.  
  1303. <Tab><F3>Returns: <F2><HR>
  1304.   <F0>boolean<F3>.
  1305.  
  1306. <para>
  1307.  
  1308. Returns non<#1e><F6>nil<F0> if the two arguments are the same window, 
  1309. and <F6>nil<F0> if they are not.
  1310.  
  1311. <arg>
  1312.  
  1313. window<#1e>1<F3>, <F0>window<#1e>2 <F3><#1f> The windows to compare 
  1314. for equality.
  1315.  
  1316. <syntax,
  1317.     Bottom Margin =        0 inches,
  1318.     Left Tab =        -0.90/0 inches,
  1319.     Right Tab =        7.50 inches>
  1320.  
  1321. window<#1e>event<#1e>mask<F3> <F2>window<F0><Tab><F3>Function<F0><Index, "event<#1e>mask", Sort String = "event mask", "attribute of window"><Index, "window", "attribute", "event<#1e>mask"><Index, Doc = operations, "xlib:window<#1e>event<#1e>mask", Sort String = "window<#1e>event<#1e>mask">
  1322.  
  1323. <return>
  1324.  
  1325. <Tab><F3>Returns: <F2><HR>
  1326.   event<#1e>mask <F3><#1f> Type <F0>mask32<F3>.<F2> 
  1327.  
  1328. <para>
  1329.  
  1330. Returns and (with <F6>setf<F0>) changes the value of the event<#1e>mask 
  1331. attribute for the <F2>window<F0>. The default event<#1e>mask of 
  1332. a new window is zero.
  1333.  
  1334. <arg>
  1335.  
  1336. window <F3><#1f> A <F6>window<F3>.
  1337.  
  1338. <syntax,
  1339.     Bottom Margin =        0 inches,
  1340.     Left Tab =        -0.90/0 inches,
  1341.     Right Tab =        7.50 inches>
  1342.  
  1343. window<#1e>gravity <F2>window<F0><Tab><F3>Function<F0><Index, "gravity attribute of window"><Index, "window", "attribute", "gravity"><Index, Doc = operations, "xlib:window<#1e>gravity", Sort String = "window<#1e>gravity">
  1344.  
  1345. <return>
  1346.  
  1347. <Tab><F3>Returns:<HR>
  1348.  <F2> gravity <F3><#1f> Type <F0>win<#1e>gravity<F3>.
  1349.  
  1350. <para>
  1351.  
  1352. Returns and (with <F6>setf<F0>) changes the gravity attribute of 
  1353. the <F2>window<F0>. If a parent window is reconfigured without changing 
  1354. its inside width or height, then all child windows move with the parent 
  1355. and are not changed. Otherwise, each child of the resized parent is 
  1356. moved, depending on the child's gravity attribute. The default gravity 
  1357. of a new window is <F6>:north<#1e>west<F0>.
  1358.  
  1359. <|,"4<#1e>42">For example, suppose the size of the window's parent is changed 
  1360. by <F2>W<F0> pixels in width and <F2>H<F0> pixels in height. The 
  1361. following table shows, for each possible gravity value, the resulting 
  1362. change in the window's position relative to its parent's origin. When 
  1363. the window is moved, two events are generated<#1f>a <F6>:configure<#1e>notify
  1364. <F0> event followed by a <F6>:gravity<#1e>notify<F0> event.
  1365.  
  1366. <t2,
  1367.     Allow Page Break After = no>
  1368.  
  1369. <F6>Gravity<Tab>X Change<Tab><Tab>Y Change
  1370.  
  1371. <t2>
  1372.  
  1373. <Tab-><Tab-><Tab-><Tab-><Tab-><Tab->
  1374.  
  1375. <F6>:center<F0><Tab><F2>W/<F0>2<Tab><Tab><F2>H/<F0>2 
  1376.  
  1377. <F6>:east<F0><Tab><F2>W<F0><Tab><Tab><F2>H/<F0>2
  1378.  
  1379. <F6>:north<F0><Tab><F2>W/<F0>2<Tab><Tab>0 
  1380.  
  1381. <F6>:north<#1e>east<F0><Tab><F2>W<F0><Tab><Tab>0 
  1382.  
  1383. <F6>:north<#1e>west<F0><Tab>0<Tab><Tab>0 
  1384.  
  1385. <F6>:south<F0><Tab><F2>W/<F0>2<Tab><Tab><F2>H<F0> 
  1386.  
  1387. <F6>:south<#1e>east<F0><Tab>W<Tab><Tab>H
  1388.  
  1389. <F6>:south<#1e>west<F0><Tab>0<Tab><Tab>H 
  1390.  
  1391. <F6>:west<F0><Tab>0<Tab><Tab>H/2<HR>
  1392.  
  1393.  
  1394. <para>
  1395.  
  1396. A <F6>:static<F0> gravity indicates that the position of the window 
  1397. should not move relative to the origin of the root window. 
  1398.  
  1399. An <F6>:unmap<F0> gravity is like <F6>:north<#1e>west<F0>, except 
  1400. the window is also unmapped and an <F6>:unmap<#1e>notify<F0> event 
  1401. is generated. This <F6>:unmap<#1e>notify<F0> event is generated 
  1402. after the <F6>:configure<#1e>notify<F0> event is generated for the 
  1403. parent.
  1404.  
  1405. <arg>
  1406.  
  1407. window <F3><#1f> A <F6>window<F3>.
  1408.  
  1409. <syntax,
  1410.     Bottom Margin =        0 inches,
  1411.     Left Tab =        -0.90/0 inches,
  1412.     Right Tab =        7.50 inches>
  1413.  
  1414. window<#1e>id <F2>window<F0><Tab><F3>Function<F0><Index, "ID", Sort String = id, "window"><Index, "window", "ID", Sort String = id><Index, Doc = operations, "xlib:window<#1e>id", Sort String = "window<#1e>id">
  1415.  
  1416. <return>
  1417.  
  1418. <Tab><F3>Returns: <F2><HR>
  1419.   <F3>The <F0>resource<#1e>id<F3> of the window.
  1420.  
  1421. <para>
  1422.  
  1423. Returns the unique ID assigned to <F2>window<F0>.
  1424.  
  1425. <arg>
  1426.  
  1427. window <F3><#1f> A <F6>window<F3>.
  1428.  
  1429. <syntax,
  1430.     Bottom Margin =        0 inches,
  1431.     Left Tab =        -0.90/0 inches,
  1432.     Right Tab =        7.50 inches>
  1433.  
  1434. window<#1e>map<#1e>state <F2>window<F0><Tab><F3>Function<F0><Index, "map state of window", Sort String = "map<#1e>state of window"><Index, "window", "map state"><Index, Doc = operations, "xlib:window<#1e>map<#1e>state", Sort String = "window<#1e>map<#1e>state">
  1435.  
  1436. <return>
  1437.  
  1438. <Tab><F3>Returns: <F2><HR>
  1439.   map<#1e>state <F3><#1f> One of <F0>:unmapped<F3>,<F0> :unviewable<F3>,
  1440. <F0> <F3>or<F0> :viewable<F3>.
  1441.  
  1442. <para>
  1443.  
  1444. Returns the map state of <F2>window<F0>. A window is <F6>:unviewable<F0> 
  1445. if it is mapped but some ancestor is unmapped.
  1446.  
  1447. <arg>
  1448.  
  1449. window <F3><#1f> A <F6>window<F3>.<F10> 
  1450.  
  1451. <syntax,
  1452.     Bottom Margin =        0 inches,
  1453.     Left Tab =        -0.90/0 inches,
  1454.     Right Tab =        7.50 inches>
  1455.  
  1456. window<#1e>override<#1e>redirect <F2>window<F0><Tab><F3>Function<F0><Index, "override<#1e>redirect attribute of window", Sort String = "override redirect attribute of window"><Index, "window", "attribute", "override<#1e>redirect"><Index, Doc = operations, "xlib:window<#1e>override<#1e>redirect", Sort String = "window<#1e>override<#1e>redirect">
  1457.  
  1458. <return>
  1459.  
  1460. <Tab><F3>Returns: <F2><HR>
  1461.   override<#1e>redirect <F3><#1f> Either <F0>:on<F3> or <F0>:off<F3>.
  1462.  
  1463. <para>
  1464.  
  1465. Returns and (with <F6>setf<F0>) changes the value of the override<#1e>redirec
  1466. t attribute for <F2>window<F0>. The default override<#1e>redirect 
  1467. of a new window is <F6>:off<F0>.
  1468.  
  1469. The override<#1e>redirect attribute determines whether or not attempts 
  1470. to change<SP>window geometry or parent hierarchy can be <F2>redirected<F0> 
  1471. by a window<SP>manager or some other client. The functions that might 
  1472. be affected by the<SP>override<#1e>redirect attribute are <F6>circulate<#1e>wi
  1473. ndow<#1e>down<F0>, <F6>circulate<#1e>window<#1e>up<F0>,<SP><F6>drawable<#1e>
  1474. border<#1e>width<F0>, <F6>drawable<#1e>height<F0>, <F6>drawable<#1e>width
  1475. <F0>, <F6>drawable<#1e>x<F0>,<SP><F6>drawable<#1e>y<F0>, <F6>map<#1e>wind
  1476. ow<F0>, and <F6>window<#1e>priority<F0>.
  1477.  
  1478. <arg>
  1479.  
  1480. window <F3><#1f> A <F6>window<F3>.
  1481.  
  1482. <syntax,
  1483.     Bottom Margin =        0 inches,
  1484.     Left Tab =        -0.90/0 inches,
  1485.     Right Tab =        7.50 inches>
  1486.  
  1487. <|,"4<#1e>43">window<#1e>p <F2>object<F0><Tab><F3>Function<Index, Doc = operations, "xlib:window<#1e>p", Sort String = "window<#1e>p">
  1488.  
  1489. <return>
  1490.  
  1491. <Tab><F3>Returns: <F2><HR>
  1492.   window<#1e>p <F3><#1f> Type <F0>boolean<F3>.
  1493.  
  1494. <para>
  1495.  
  1496. Returns non<#1e><F6>nil <F0>if the <F2>object<F0> argument is 
  1497. a window; otherwise, it returns <F6>nil<F0>.
  1498.  
  1499. <syntax,
  1500.     Bottom Margin =        0 inches,
  1501.     Left Tab =        -0.90/0 inches,
  1502.     Right Tab =        7.50 inches>
  1503.  
  1504. window<#1e>plist <F2>window<F0><Tab><F3>Function<F0><Index, "property list", "window"><Index, "window", "property list"><Index, Doc = operations, "xlib:window<#1e>plist", Sort String = "window<#1e>plist">
  1505.  
  1506. <return>
  1507.  
  1508. <Tab><F3>Returns: <F2><HR>
  1509.   plist <F3><#1f> A property list.
  1510.  
  1511. <para>
  1512.  
  1513. Returns and (with <F6>setf<F0>) sets the property list for the specified 
  1514. <F2>window<F0>. This function provides a hook where extensions can 
  1515. hang data.
  1516.  
  1517. <arg>
  1518.  
  1519. window <F3><#1f> A <F6>window<F3>.
  1520.  
  1521. <syntax,
  1522.     Bottom Margin =        0 inches,
  1523.     Left Tab =        -0.90/0 inches,
  1524.     Right Tab =        7.50 inches>
  1525.  
  1526. setf <F3>(<F0>window<#1e>priority<F3> <F2>window<F3>) (&optional <F2>sibl
  1527. ing<F3>) <F2>mode<F0><Tab><F3>Function<F0><Index, "stacking priority of window"><Index, "window", "stacking priority"><Index, Doc = operations, "xlib:window<#1e>priority", Sort String = "window<#1e>priority">
  1528.  
  1529. <return>
  1530.  
  1531. <Tab><F3>Returns: <F2><HR>
  1532.   mode <F3><#1f> One of <F0>:above<F3>, <F0>:below<F3>, <F0>:bottom<#1e>i
  1533. f<F3>,<F0> :opposite<F3>,<F0> <F3>or <F0>:top<#1e>if<F3>.
  1534.  
  1535. <para>
  1536.  
  1537. Changes the stacking priority element of the <F2>window<F0> to the 
  1538. specified value. It is an error if the <F2>sibling<F0> argument 
  1539. is specified and is not actually a sibling of the window. Note that 
  1540. the priority of an existing window cannot be returned from the X server.
  1541.  
  1542. When changing the priority of a window, if the override<#1e>redirect 
  1543. attribute<SP>of the window is <F6>:off<F0> and some other client 
  1544. has selected<SP>:substructure<#1e>redirect on the parent, a :configure<#1e>requ
  1545. est event is<SP>generated, and no further processing is performed. 
  1546. Otherwise, the priority<SP>is changed.
  1547.  
  1548. <arg>
  1549.  
  1550. window <F3><#1f> A <F6>window<F3>.
  1551.  
  1552. sibling <F3><#1f> An optional argument specifying that <F0>window<F3> 
  1553. is to be restacked relative to this sibling <F6>window<F3>.
  1554.  
  1555. mode <F3><#1f> One of <F6>:above<F3>, <F6>:below<F3>, <F6>:bottom<#1e>if
  1556. <F3>,<F6> :opposite<F3>,<F6> <F3>or <F6>:top<#1e>if<F3>.
  1557.  
  1558. <syntax,
  1559.     Bottom Margin =        0 inches,
  1560.     Left Tab =        -0.90/0 inches,
  1561.     Right Tab =        7.50 inches>
  1562.  
  1563. window<#1e>save<#1e>under<F9> <F2>window<F0><Tab><F3>Function<F0><Index, "save<#1e>under attribute of window"><Index, "window", "attribute", "save<#1e>under"><Index, Doc = operations, "xlib:window<#1e>save<#1e>under", Sort String = "window<#1e>save<#1e>under">
  1564.  
  1565. <return>
  1566.  
  1567. <Tab><F3>Returns:<F2> <HR>
  1568.   save<#1e>under <F3><#1f> Either <F0>:on <F3>or <F0>:off<F3>.
  1569.  
  1570. <para>
  1571.  
  1572. Returns and (with <F6>setf<F0>) changes the value of the save<#1e>under 
  1573. attribute for the specified <F2>window<F0>. Changing the save<#1e>under 
  1574. attribute of a mapped window may have no immediate effect.
  1575.  
  1576. <arg>
  1577.  
  1578. window <F3><#1f> A <F6>window<F3>.
  1579.  
  1580. <syntax0>
  1581.  
  1582. window<#1e>visual <F2>window<F0><Tab><F3>Function<F0><Index, "visual type of window"><Index, "window", "visual type"><Index, Doc = operations, "xlib:window<#1e>visual", Sort String = "window<#1e>visual">
  1583.  
  1584. <return>
  1585.  
  1586. <Tab><F3>Returns: <F2><HR>
  1587.   visual<#1e>type <F3><#1f> Type <F0>card29<F3>.
  1588.  
  1589. <para>
  1590.  
  1591. Returns the <F2>visual<#1e>type<F0> associated with the specified <F2>window
  1592. <F0>.
  1593.  
  1594. <arg>
  1595.  
  1596. window <F3><#1f> A <F6>window<F3>.
  1597.  
  1598. <syntax,
  1599.     Bottom Margin =        0.15 inches,
  1600.     Left Tab =        -0.90/0 inches,
  1601.     Right Tab =        7.50 inches>
  1602.  
  1603. with<#1e>state <F2>drawable <F3>&body<F2> body<F0><Tab><F3>Macro<Index, Doc = operations, "xlib:with<#1e>state", Sort String = "with<#1e>state">
  1604. <F0><Index, "window", "attributes", "batching"><Index, "drawable", "geometry", "values, batching">
  1605.  
  1606. <para>
  1607.  
  1608. Batches successive read and write accesses to window attributes and 
  1609. drawable geometry, in order to minimize the number of requests sent 
  1610. to the server. Batching occurs automatically within the dynamic extent 
  1611. of the <F2>body<F0>. The<SP><F2>body<F0> is not executed within 
  1612. a <F6>with<#1e>display<F0> form.
  1613.  
  1614. <|,"4<#1e>44">All window attributes can be returned or changed in a single 
  1615. request.<SP>Similarly, all drawable geometry values can be returned 
  1616. or changed in a single request. <F6>with<#1e>state<F0> combines 
  1617. accesses to these values into the minimum number of server requests 
  1618. necessary to guarantee that each read<SP>access returns the current 
  1619. server state of the <F2>drawable<F0>. The number of<SP>server requests 
  1620. sent depends on the sequence of calls to reader and <F6>setf<F0><SP>functions 
  1621. within the dynamic extent of the <F2>body<F0>. There are two groups 
  1622. of<SP>reader and <F6>setf<F0> functions<#1f>the Window Attributes 
  1623. group and the Drawable Geometry group<#1f>as shown in Table 4<#1e>1.
  1624.  
  1625. <stabrule,
  1626.     New Page =        yes>
  1627.  
  1628. <|,"4<#1e>45"><Tab><Tab->
  1629.  
  1630. <tabtitle1,
  1631.     Autonumber Level =    2,
  1632.     TOC Doc Name =        TABLETOC>
  1633.  
  1634. <Index, "window", "attributes", "reader and setf functions"><Index, "drawable", "geometry", "reader and setf functions"><Index, "representation type", "standard conversions">Table 
  1635. 4<#1e>1<Tab>Groups of<SP>Reader and Setf Functions<HR>
  1636. <Tab><Tab->
  1637.  
  1638. <t1SThead,
  1639.     Bottom Margin =        0 inches,
  1640.     Left Tab =        0/0.80/2.60 inches>
  1641.  
  1642. <F6>Group<Tab>Reader Functions<Tab>Setf Functions<HR>
  1643. <Tab-><Tab-><Tab->
  1644.  
  1645. <t1ST,
  1646.     Left Tab =        0/0.80/2.60 inches>
  1647.  
  1648. Window <F6><Tab>window<#1e>all<#1e>event<#1e>masks<Tab>window<#1e>background
  1649.  
  1650. Attributes<F6><Tab>window<#1e>backing<#1e>pixel<Tab>window<#1e>backing<#1e>pix
  1651. el
  1652.  
  1653. <F6><Tab>window<#1e>backing<#1e>planes<Tab>window<#1e>backing<#1e>planes
  1654.  
  1655. <F6><Tab>window<#1e>backing<#1e>store<Tab>window<#1e>backing<#1e>store
  1656.  
  1657. <F6><Tab>window<#1e>bit<#1e>gravity<Tab>window<#1e>bit<#1e>gravity
  1658.  
  1659. <F6><Tab>window<#1e>class<Tab>window<#1e>border
  1660.  
  1661. <F6><Tab>window<#1e>colormap<Tab>window<#1e>colormap
  1662.  
  1663. <F6><Tab>window<#1e>colormap<#1e><Tab>window<#1e>cursor
  1664.  
  1665. <F6><Tab> installed<#1e>p<Tab>window<#1e>do<#1e>not<#1e>propagate<#1e>mask<Tab>
  1666.  
  1667. <F6><Tab>window<#1e>do<#1e>not<#1e><Tab>window<#1e>event<#1e>mask
  1668.  
  1669. <F6><Tab> propagate<#1e>mask<Tab>window<#1e>gravity
  1670.  
  1671. <F6><Tab>window<#1e>event<#1e>mask<Tab>window<#1e>override<#1e>redirect
  1672.  
  1673. <F6><Tab>window<#1e>gravity<Tab>window<#1e>save<#1e>under
  1674.  
  1675. <F6><Tab>window<#1e>map<#1e>state<Tab>
  1676.  
  1677. <F6><Tab>window<#1e>override<#1e>redirect<Tab>
  1678.  
  1679. <F6><Tab>window<#1e>save<#1e>under
  1680.  
  1681. <F6><Tab>window<#1e>visual  
  1682.  
  1683. <F6><Tab>
  1684.  
  1685. Drawable<F6><Tab>drawable<#1e>border<#1e>width<Tab>drawable<#1e>border<#1e>wid
  1686. th
  1687.  
  1688. Geometry<F6><Tab>drawable<#1e>depth<Tab>drawable<#1e>height
  1689.  
  1690. <F6><Tab>drawable<#1e>height<Tab>drawable<#1e>width
  1691.  
  1692. <F6><Tab>drawable<#1e>root<Tab>drawable<#1e>x
  1693.  
  1694. <F6><Tab>drawable<#1e>width<Tab>drawable<#1e>y
  1695.  
  1696. <F6><Tab>drawable<#1e>x<Tab>window<#1e>priority
  1697.  
  1698. <F6><Tab>drawable<#1e>y
  1699.  
  1700. <endrule>
  1701.  
  1702. <Tab-><Tab-><Tab-><Tab->
  1703.  
  1704. <para>
  1705.  
  1706. The results from a sequence of calls to <F6>setf<F0> functions in 
  1707. a given group are cached and sent in a single server request, either 
  1708. upon exit from the <F2>body<F0> or when a reader function from the 
  1709. corresponding group is called.
  1710.  
  1711. <F6>with<#1e>state<F0> sends a single request to update all its 
  1712. cached values for the <F2>drawable<F0> before the first call to 
  1713. a reader function within the <F2>body<F0> and also<SP>before the 
  1714. first call to a reader function following a sequence of calls to <F6>setf
  1715. <F0> functions from the corresponding group. 
  1716.  
  1717. <arg>
  1718.  
  1719. drawable <F3><#1f> A <F6>display<F3>.
  1720.  
  1721. body <F3><#1f> The forms in which attributes accesses are batched.
  1722.  
  1723. <p1rule>
  1724.  
  1725. <Index, "stacking order of window", To Named = p1rule><Index, "window", "stacking order", To Named = p1rule>
  1726. <Frame,
  1727.     Name =            p1rule,
  1728.     Placement =        At Anchor,
  1729.     Width =            6.35 inches,
  1730.     Height =        0.153 inches,
  1731.     Vertical Alignment =    0.007 inches,
  1732.     Shared Contents =    yes>
  1733.  
  1734. <p1para,
  1735.     Alignment =        Both,
  1736.     Font =            F3,
  1737.     Allow Page Break After = yes>
  1738.  
  1739. <F8>Stacking Order<Tab><F6>4.4<F0><#04>Sibling windows can <F2>stack<F0> 
  1740. on top of each other. Windows above can <F2>obscure<F0> or <F2>occlude<F0> 
  1741. lower windows. This relationship between sibling windows is known 
  1742. as the stacking order. The <F6>window<#1e>priority<F0> function 
  1743. can be used to change the stacking order of a single window. CLX also 
  1744. provides functions to raise or lower children of a window. Raising 
  1745. a mapped window can generate <F6>:exposure<F0> events for the window 
  1746. and any mapped subwindows that were formerly obscured. Lowering a 
  1747. mapped window can generate <F6>:exposure<F0> events on any windows 
  1748. it formerly obscured.
  1749.  
  1750. <syntax,
  1751.     Left Tab =        -0.90/0 inches,
  1752.     Right Tab =        7.50 inches>
  1753.  
  1754. circulate<#1e>window<#1e>down <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:circulate<#1e>window<#1e>down", Sort String = "circulate<#1e>window<#1e>down">
  1755.  
  1756. <para>
  1757.  
  1758. Lowers the highest mapped child of the specified <F2>window<F0> 
  1759. that partially or completely occludes another child to the bottom 
  1760. of the stack. Completely unobscured children are unaffected. Exposure 
  1761. processing is performed on formerly obscured windows.
  1762.  
  1763. <|,"4<#1e>46">If some other client has selected <F6>:substructure<#1e>redirect<F0> 
  1764. on the <F2>window<F0>, a <F6>:circulate<#1e>request<F0> event 
  1765. is generated, and no further processing is performed. Otherwise, the 
  1766. child window is lowered and a <F6>:circulate<#1e>notify<F0> event 
  1767. is generated if the <F2>window<F0> is actually restacked.
  1768.  
  1769. <arg>
  1770.  
  1771. window <F3><#1f> A <F6>window<F3>.
  1772.  
  1773. <syntax,
  1774.     Left Tab =        -0.90/0 inches,
  1775.     Right Tab =        7.50 inches>
  1776.  
  1777. circulate<#1e>window<#1e>up <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:circulate<#1e>window<#1e>up", Sort String = "circulate<#1e>window<#1e>up">
  1778.  
  1779. <para>
  1780.  
  1781. Raises the lowest mapped child of the specified <F2>window<F0> that 
  1782. is partially or completely occluded by another child to the top of 
  1783. the stack. Completely unobscured children are unaffected. Exposure 
  1784. processing is performed on formerly obscured windows.
  1785.  
  1786. If another client has selected <F6>:substructure<#1e>redirect<F0> 
  1787. on the <F2>window<F0>, a <F6>:circulate<#1e>request<F0> event 
  1788. is generated, and no further processing is performed. Otherwise, the 
  1789. child window is raised and a <F6>:circulate<#1e>notify<F0> event 
  1790. is generated if the <F2>window<F0> is actually restacked.
  1791.  
  1792. <arg>
  1793.  
  1794. window <F3><#1f> A <F6>window<F3>.
  1795.  
  1796. <p1rule>
  1797.  
  1798. <Index, "window", "hierarchy", To Named = p1rule>
  1799. <Frame,
  1800.     Name =            p1rule,
  1801.     Placement =        At Anchor,
  1802.     Width =            6.35 inches,
  1803.     Height =        0.153 inches,
  1804.     Vertical Alignment =    0.007 inches,
  1805.     Shared Contents =    yes>
  1806.  
  1807. <p1stacked,
  1808.     Line Spacing =        1 lines,
  1809.     Alignment =        Both,
  1810.     Font =            F3>
  1811.  
  1812. <F8>Window <Tab><F6>4.5<F0><#04>All the windows in X are arranged 
  1813. in a strict hierarchy. At the top of<F6><FJ>
  1814.  
  1815. <p1para,
  1816.     Alignment =        Both,
  1817.     Font =            F3,
  1818.     Allow Page Break After = yes>
  1819.  
  1820. <F8>Hierarchy<Tab><F0>the hierarchy are the root windows, which 
  1821. cover the display screens. Each root window is partially or completely 
  1822. covered by its child windows. All windows, except for root windows, 
  1823. have parents. Child windows can have their own children. In this way, 
  1824. a tree of arbitrary depth on each screen can be created. CLX provides 
  1825. several functions for examining and modifying the window hierarchy.
  1826.  
  1827. <syntax,
  1828.     Bottom Margin =        0 inches,
  1829.     Left Tab =        -0.90/0 inches,
  1830.     Right Tab =        7.50 inches>
  1831.  
  1832. drawable<#1e>root <F2>drawable<F0><Tab><F3>Function<Index, Doc = operations, "xlib:drawable<#1e>root", Sort String = "drawable<#1e>root">
  1833.  
  1834. <return>
  1835.  
  1836. <Tab><F3>Returns: <F2><HR>
  1837.   root<#1e>window <F3><#1f> Type <F0>window<F3>.<F2> 
  1838.  
  1839. <para>
  1840.  
  1841. Returns the root window of the specified <F2>drawable<F0>.
  1842.  
  1843. <arg>
  1844.  
  1845. drawable <F3><#1f> A <F6>drawable<F3>.
  1846.  
  1847. <syntax,
  1848.     Bottom Margin =        0 inches,
  1849.     Left Tab =        -0.90/0 inches,
  1850.     Right Tab =        7.50 inches>
  1851.  
  1852. query<#1e>tree <F2>window <F3>&key (<F0>:result<#1e>type<F3> <F0>`list
  1853. <F3>)<F0><Tab><F3>Function<Index, Doc = operations, "xlib:query<#1e>tree", Sort String = "query<#1e>tree">
  1854.  
  1855. <return,
  1856.     Left Tab =        -0.90/0/0.10/7.50 inches>
  1857.  
  1858. <Tab><F3>Returns: <F2><HR>
  1859. <Tab>children <F3><#1f> Type <F0>sequence<F3> of <F0>window<F3>.<F2><HR>
  1860. <Tab>parent <#1f> <F3>Type <F0>window<F3> or <F0>null<F3>.<F2><HR>
  1861. <Tab>root <F3><#1f> Type <F0>window<F3>.<F2> 
  1862.  
  1863. <para>
  1864.  
  1865. Returns the <F2>children<F0> windows, the <F2>parent<F0> window, 
  1866. and the <F2>root<F0> window for the specified <F2>window<F0>. 
  1867. The children are returned as a sequence of windows in current stacking 
  1868. order, from bottom<#1e>most (first) to top<#1e>most (last). The <F6>:result<#1e>
  1869. type<F0> specifies the type of children sequence returned.
  1870.  
  1871. <arg>
  1872.  
  1873. window <F3><#1f> A <F6>window<F3>.
  1874.  
  1875. <keyword2>
  1876.  
  1877. :result<#1e>type <F3><#1f> A valid type specifier for a sub<#1e>type 
  1878. of <F0>sequence<F3>. The default is a <F0>list<F3>.
  1879.  
  1880. <syntax,
  1881.     Left Tab =        -0.90/0 inches,
  1882.     Right Tab =        7.50 inches>
  1883.  
  1884. reparent<#1e>window <F2>window parent x<F3> <F2>y<F0><Tab><F3>Function<Index, Doc = operations, "xlib:reparent<#1e>window", Sort String = "reparent<#1e>window">
  1885.  
  1886. <para>
  1887.  
  1888. Changes a <F2>window<F0>'s <F2>parent<F0> within a single screen. 
  1889. There is no way to move a window between screens.
  1890.  
  1891. The specified <F2>window<F0> is reparented by inserting it as a 
  1892. child of the specified <F2>parent<F0>. If the <F2>window<F0> is 
  1893. mapped, an <F6>unmap<#1e>window<F0> operation is automatically performed 
  1894. on the specified <F2>window<F0>. The <F2>window<F0> is then removed 
  1895. from its current position in the hierarchy and inserted as the child 
  1896. of the specified <F2>parent<F0>. The <F2>window<F0> is placed 
  1897. on top in the stacking order with respect to sibling windows.
  1898.  
  1899. <|,"4<#1e>47">After reparenting the specified <F2>window,<F0> a <F6>:reparent<#1e>no
  1900. tify<F0> event is generated. The override<#1e>redirect attribute 
  1901. of the <F2>window<F0> is passed on in this event. Window manager 
  1902. clients normally should ignore this event if this attribute is <F6>:on<F0>. 
  1903. See Section 12, Events and Input, for more information on <F6>:reparent<#1e>no
  1904. tify<F0> event processing. Finally, if the specified <F2>window<F0> 
  1905. was originally mapped, a <F6>map<#1e>window<F0> operation is automatically 
  1906. performed on it.
  1907.  
  1908. The X server performs normal exposure processing on formerly obscured 
  1909. windows. It might not generate <F6>:exposure<F0> events for regions 
  1910. from the initial <F6>unmap<#1e>window<F0> operation if they are 
  1911. immediately obscured by the final <F6>map<#1e>window<F0> operation.
  1912.  
  1913. It is an error if any of the following are true: 
  1914.  
  1915. <bullet>
  1916.  
  1917. <F11>w<Tab><F0>The new <F2>parent<F0> window is not on the same 
  1918. screen as the old parent window.
  1919.  
  1920. <F11>w<Tab><F0>The new <F2>parent<F0> window is the specified <F2>window
  1921. <F0> or an inferior of the specified <F2>window<F0>.
  1922.  
  1923. <F11>w<Tab><F0>The specified <F2>window<F0> has a <F6>:parent<#1e>relative
  1924. <F0> background attribute and the new <F2>parent<F0> window is 
  1925. not the same depth as the specified <F2>window<F0>.
  1926.  
  1927. <arg>
  1928.  
  1929. window <F3><#1f> A <F6>window<F3>.
  1930.  
  1931. parent <F3><#1f> The new parent <F6>window<F3>.
  1932.  
  1933. x<F3>, <F0>y <F3><#1f> The position (type <F6>int16<F3>) of the <F0>windo
  1934. w<F3> in its new <F0>parent<F3>. These coordinates are relative 
  1935. to the <F0>parent<F3>'s origin, and specify the new position of 
  1936. the upper, left, outer corner of the <F0>window<F3>.
  1937.  
  1938. <syntax,
  1939.     Bottom Margin =        0 inches,
  1940.     Left Tab =        -0.90/0 inches,
  1941.     Right Tab =        7.50 inches>
  1942.  
  1943. translate<#1e>coordinates <F2>source source<#1e>x source<#1e>y destination
  1944. <F0><Tab><F3>Function<Index, Doc = operations, "xlib:translate<#1e>coordinates", Sort String = "translate<#1e>coordinates">
  1945.  
  1946. <return,
  1947.     Left Tab =        -0.90/0/0.10/7.50 inches>
  1948.  
  1949. <Tab><F3>Returns: <F2><HR>
  1950. <Tab>destination<#1e>x <F3><#1f> Type <F0>int16<F3> or <F0>null<F3>.<F2> <HR>
  1951. <Tab>destination<#1e>y<F3> <#1f> Type <F0>int16<F3> or <F0>null<F3>.<F2> <HR>
  1952. <Tab>destination<#1e>child <F3><#1f> Type <F0>window<F3> or <F0>null<F3>.
  1953. <F2> 
  1954.  
  1955. <para>
  1956.  
  1957. Returns the position defined by <F2>source<#1e>x<F0> and <F2>source<#1e>y
  1958. <F0> (relative to the origin of the <F2>source<F0> window), expressed 
  1959. as coordinates relative to the origin of the <F2>destination<F0> 
  1960. window.
  1961.  
  1962. <arg>
  1963.  
  1964. source <F3><#1f> A <F6>window<F3> defining the source coordinate 
  1965. system.
  1966.  
  1967. source<#1e>x<F3>, <F0>source<#1e>y <F3><#1f> Coordinates (<F6>int16<F3>) 
  1968. relative to the origin of the <F0>source<F3> <F6>window<F3>.
  1969.  
  1970. destination <F3><#1f> A <F6>window<F3> defining the destination 
  1971. coordinate system.
  1972.  
  1973. <p1rule>
  1974.  
  1975. <Index, "mapping windows", To Named = p1rule><Index, "window", "mapping", To Named = p1rule><Index, "unmapping windows", To Named = p1rule><Index, "window", "unmapping", To Named = p1rule>
  1976. <Frame,
  1977.     Name =            p1rule,
  1978.     Placement =        At Anchor,
  1979.     Width =            6.35 inches,
  1980.     Height =        0.153 inches,
  1981.     Vertical Alignment =    0.007 inches,
  1982.     Shared Contents =    yes>
  1983.  
  1984. <p1stacked,
  1985.     Line Spacing =        1 lines,
  1986.     Alignment =        Both,
  1987.     Font =            F3>
  1988.  
  1989. <F8>Mapping <Tab><F6>4.6<F0><#04>A window is considered mapped 
  1990. if a <F6>map<#1e>window<F0> call has been made
  1991.  
  1992. <p1para,
  1993.     Alignment =        Both,
  1994.     Font =            F3,
  1995.     Allow Page Break After = yes>
  1996.  
  1997. <F8>Windows<Tab><F0>on it. When windows are first created, they 
  1998. are not mapped because an application may wish to create a window 
  1999. long before it is mapped to the screen. A mapped window may not be 
  2000. visible on the screen for one of the following reasons:
  2001.  
  2002. <bullet>
  2003.  
  2004. <F11>w<Tab><F0>It is obscured by another opaque sibling window.
  2005.  
  2006. <F11>w<Tab><F0>One of its ancestors is not mapped.
  2007.  
  2008. <F11>w<Tab><F0>It is entirely clipped by an ancestor.
  2009.  
  2010. <para>
  2011.  
  2012. <|,"4<#1e>48">A subwindow will appear on the screen as long as all of its 
  2013. ancestors are mapped and not obscured by a sibling or clipped by an 
  2014. ancestor. Mapping a window that has an unmapped ancestor does not 
  2015. display the window, but marks it as eligible for display when the 
  2016. ancestor becomes mapped. Such a window is called unviewable. When 
  2017. all its ancestors are mapped, the window becomes viewable and remains 
  2018. visible on the screen if not obscured by any sibling or ancestor. 
  2019.  
  2020. Any output to a window not visible on the screen is discarded. <F6>:exposure
  2021. <F0> events are generated for the window when part or all of it becomes 
  2022. visible on the screen. A client only receives the <F6>:exposure<F0> 
  2023. events if it has selected them. Mapping or unmapping a window does 
  2024. not change its stacking order priority.
  2025.  
  2026. <syntax,
  2027.     Left Tab =        -0.90/0 inches,
  2028.     Right Tab =        7.50 inches>
  2029.  
  2030. map<#1e>window <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:map<#1e>window", Sort String = "map<#1e>window">
  2031.  
  2032. <para>
  2033.  
  2034. Maps the <F2>window<F0>. This function has no effect when the <F2>window
  2035. <F0> is already mapped.
  2036.  
  2037. If the override<#1e>redirect attribute of the <F2>window<F0> is <F6>:off
  2038. <F0> and another client has selected <F6>:substructure<#1e>redirect<F0> 
  2039. on the parent window, the X server generates a <F6>:map<#1e>request<F0> 
  2040. event and the <F6>map<#1e>window<F0> function does not map the <F2>window
  2041. <F0>. Otherwise, the <F2>window<F0> is mapped, and the X server 
  2042. generates a <F6>:map<#1e>notify<F0> event.
  2043.  
  2044. If the <F2>window<F0> becomes visible and no earlier contents for 
  2045. it are remembered, <F6>map<#1e>window<F0> tiles the window with 
  2046. its background. If no background was defined for the window, the existing 
  2047. screen contents are not altered, and the X server generates one or 
  2048. more <F6>:exposure<F0> events. If a backing<#1e>store was maintained 
  2049. while the window was unmapped, no <F6>:exposure<F0> events are generated. 
  2050. If a backing<#1e>store will now be maintained, a full window exposure 
  2051. is always generated. Otherwise, only visible regions may be reported. 
  2052. Similar tiling and exposure take place for any newly viewable inferiors.
  2053.  
  2054. <F6>map<#1e>window<F0> generates <F6>:exposure<F0> events on each <F6>:inp
  2055. ut<#1e>output<F0> window that it causes to become visible. 
  2056.  
  2057. <arg>
  2058.  
  2059. window <F3><#1f> A <F6>window<F3>.
  2060.  
  2061. <syntax,
  2062.     New Page =        yes,
  2063.     Left Tab =        -0.90/0 inches,
  2064.     Right Tab =        7.50 inches>
  2065.  
  2066. <|,"4<#1e>49">map<#1e>subwindows <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:map<#1e>subwindows", Sort String = "map<#1e>subwindows">
  2067.  
  2068. <para>
  2069.  
  2070. Maps all child windows for a specified <F2>window<F0> in top<#1e>to<#1e>botto
  2071. m stacking order. The X server generates an <F6>:exposure<F0> event 
  2072. on each newly visible window. This function is much more efficient 
  2073. than mapping each child individually.
  2074.  
  2075. <arg>
  2076.  
  2077. window <F3><#1f> A <F6>window<F3>.
  2078.  
  2079. <syntax,
  2080.     Left Tab =        -0.90/0 inches,
  2081.     Right Tab =        7.50 inches>
  2082.  
  2083. unmap<#1e>window <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:unmap<#1e>window", Sort String = "unmap<#1e>window">
  2084.  
  2085. <para>
  2086.  
  2087. Unmaps the specified <F2>window<F0> and causes the X server to generate 
  2088. an <F6>:unmap<#1e>notify<F0> event. If the specified <F2>window<F0> 
  2089. is already unmapped, <F6>unmap<#1e>window<F0> has no effect. Normal 
  2090. exposure processing on formerly obscured windows is performed. Any 
  2091. child window is no longer viewable. Unmapping the <F2>window<F0> 
  2092. generates <F6>:exposure<F0> events on windows that were formerly 
  2093. obscured by <F2>window<F0> and its children.
  2094.  
  2095. <arg>
  2096.  
  2097. window <F3><#1f> A <F6>window<F3>.
  2098.  
  2099. <syntax,
  2100.     Left Tab =        -0.90/0 inches,
  2101.     Right Tab =        7.50 inches>
  2102.  
  2103. unmap<#1e>subwindows <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:unmap<#1e>subwindows", Sort String = "unmap<#1e>subwindows">
  2104.  
  2105. <para>
  2106.  
  2107. Unmaps all child windows for the specified <F2>window<F0> in bottom 
  2108. to top stacking order. The X server generates an <F6>:unmap<#1e>notify<F0> 
  2109. event on each child and <F6>:exposure<F0> events on formerly obscured 
  2110. windows. Using this function is much more efficient than unmapping 
  2111. child windows individually.
  2112.  
  2113. <arg>
  2114.  
  2115. window <F3><#1f> A <F6>window<F3>.
  2116.  
  2117. <p1rule>
  2118.  
  2119. <Index, "destroying windows"><Index, "window", "destroying">
  2120. <Frame,
  2121.     Name =            p1rule,
  2122.     Placement =        At Anchor,
  2123.     Width =            6.35 inches,
  2124.     Height =        0.153 inches,
  2125.     Vertical Alignment =    0.007 inches,
  2126.     Shared Contents =    yes>
  2127.  
  2128. <p1stacked,
  2129.     Line Spacing =        1 lines,
  2130.     Alignment =        Both,
  2131.     Font =            F3>
  2132.  
  2133. <F8>Destroying <Tab><F6>4.7<F0><#04>CLX provides functions to destroy 
  2134. a window or destroy all children of
  2135.  
  2136. <p1para,
  2137.     Alignment =        Both,
  2138.     Font =            F3,
  2139.     Allow Page Break After = yes>
  2140.  
  2141. <F8>Windows<Tab><F0>a window.<F6> <F0>Note that by default, windows 
  2142. are destroyed when a connection is closed. For further information, 
  2143. see paragraph 2.4, Closing the Display, and paragraph 12.4, Client 
  2144. Termination. 
  2145.  
  2146. <syntax,
  2147.     Left Tab =        -0.90/0 inches,
  2148.     Right Tab =        7.50 inches>
  2149.  
  2150. destroy<#1e>window <F2>window<F0><Tab><F3>Function<Index, Doc = operations, "xlib:destroy<#1e>window", Sort String = "destroy<#1e>window">
  2151.  
  2152. <para>
  2153.  
  2154. Destroys the specified <F2>window<F0> as well as all of its inferiors. 
  2155. The windows should never again be referenced. If the specified <F2>window
  2156. <F0> is mapped, it is automatically unmapped. The window and all 
  2157. of its inferiors are then destroyed, and a <F6>:destroy<#1e>notify<F0> 
  2158. event is generated for each window. The ordering of the <F6>:destroy<#1e>notif
  2159. y<F0> events is such that for any given window being destroyed, <F6>:destroy<#1e>
  2160. notify<F0> is generated on the window's inferiors before being generated 
  2161. on the window. The ordering among siblings and across sub<#1e>hierarchies 
  2162. is not otherwise constrained. If the <F2>window<F0> is a root window, 
  2163. no windows are destroyed. Destroying a mapped window generates <F6>:exposure
  2164. <F0> events on other windows that the mapped window obscured.
  2165.  
  2166. <arg>
  2167.  
  2168. window <F3><#1f> A <F6>window<F3>.
  2169.  
  2170. <syntax,
  2171.     Left Tab =        -0.90/0 inches,
  2172.     Right Tab =        7.50 inches>
  2173.  
  2174. destroy<#1e>subwindows<F2> window <F0><Tab><F3>Function<Index, Doc = operations, "xlib:destroy<#1e>subwindows", Sort String = "destroy<#1e>subwindows">
  2175.  
  2176. <para>
  2177.  
  2178. Destroys all inferiors of the specified <F2>window<F0>, in bottom 
  2179. to top stacking order. The X server generates a <F6>:destroy<#1e>notify<F0> 
  2180. event for each window. This is much more efficient than deleting many 
  2181. windows individually. The inferiors should never be referenced again. 
  2182.  
  2183. <arg>
  2184.  
  2185. window <F3><#1f> A <F6>window<F3>.
  2186.  
  2187. <p1rule>
  2188.  
  2189. <|,"4<#1e>50"><Index, "pixmap", To Named = p1rule>
  2190. <Frame,
  2191.     Name =            p1rule,
  2192.     Placement =        At Anchor,
  2193.     Width =            6.35 inches,
  2194.     Height =        0.153 inches,
  2195.     Vertical Alignment =    0.007 inches,
  2196.     Shared Contents =    yes>
  2197.  
  2198. <p1stacked,
  2199.     Line Spacing =        1 lines,
  2200.     Alignment =        Both,
  2201.     Font =            F6>
  2202.  
  2203. <F8>Pixmaps <Tab><F0>4.8<F3><#04>A <F2>pixmap<F3> is a three<#1e>dimension
  2204. al array of bits. A pixmap is normally<FJ>
  2205.  
  2206. <p1para,
  2207.     Alignment =        Both,
  2208.     Font =            F6>
  2209.  
  2210. <F8><Tab><F3>thought of as a two<#1e>dimensional array of pixels, 
  2211. where each pixel can be a value from 0 to 
  2212. <Frame,
  2213.     Name =            "At Anchor",
  2214.     Placement =        At Anchor,
  2215.     Width =            0.35 inches,
  2216.     Height =        0.15 inches,
  2217.     Vertical Alignment =    0.02 inches,
  2218.     Diagram =
  2219. V4,
  2220. (g9,1,0
  2221.  (m8,1,12,0,0.133333,clas10,2\ sup\ n\ -1)
  2222.  (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
  2223.   667,6))>
  2224. , where <F2>n<F3> is the depth of the pixmap. A pixmap can also 
  2225. be thought of as a stack of <F2>n<F3> bitmaps. A <F2>bitmap<F3> 
  2226. is a single bit pixmap of depth 1. CLX provides functions to: 
  2227.  
  2228. <bullet>
  2229.  
  2230. <F11>w<Tab><F0>Create or free a pixmap 
  2231.  
  2232. <F11>w<Tab><F0>Test if an object is a pixmap 
  2233.  
  2234. <F11>w<Tab><F0>Test if two pixmap objects are equal 
  2235.  
  2236. <F11>w<Tab><F0>Return the pixmap resource ID from a <F6>pixmap<F0> 
  2237. object 
  2238.  
  2239. <para>
  2240.  
  2241. Note that pixmaps can only be used on the screen where they were created. 
  2242. Pixmaps are off<#1e>screen server resources that are used for a number 
  2243. of operations. These include defining patterns for cursors or as the 
  2244. source for certain raster operations. 
  2245.  
  2246. <syntax0>
  2247.  
  2248. create<#1e>pixmap<F3> &key <F0>:width<F3> <F0>:height<F3> <F0>:depth
  2249. <F3> <F0>:drawable<Tab><F3>Function<Index, Doc = operations, "xlib:create<#1e>pixmap", Sort String = "create<#1e>pixmap">
  2250.  
  2251. <return>
  2252.  
  2253. <Tab><F3>Returns: <F2><HR>
  2254.   pixmap <F3><#1f> Type <F0>pixmap<F3>.
  2255.  
  2256. <para>
  2257.  
  2258. Creates a pixmap of the specified <F6>:width<F0>, <F6>:height<F0>, 
  2259. and <F6>:depth<F0>. It is valid to pass a window whose class is <F6>:input<#1e>
  2260. only<F0> as the <F6>:drawable<F0> argument. The <F6>:width<F0> 
  2261. and <F6>:height<F0> arguments must be nonzero. The <F6>:depth<F0> 
  2262. must be supported by the screen of the specified <F6>:drawable<F0>.
  2263.  
  2264. <keyword2>
  2265.  
  2266. :width<F3>,<F0> :height <F3><#1f> The nonzero width and height 
  2267. (type <F0>card16<F3>). 
  2268.  
  2269. :depth <F3><#1f> The depth (type <F0>card8<F3>) of the pixmap. 
  2270.  
  2271. :drawable <F3><#1f> A <F0>drawable<F3> which determines the screen 
  2272. where the pixmap will be used.
  2273.  
  2274. <syntax>
  2275.  
  2276. free<#1e>pixmap<F3> <F2>pixmap<F0><Tab><F3>Function<Index, Doc = operations, "xlib:free<#1e>pixmap", Sort String = "free<#1e>pixmap">
  2277.  
  2278. <para>
  2279.  
  2280. Allows the X server to free the pixmap storage when no other server 
  2281. resources reference it. The pixmap should never be referenced again. 
  2282.  
  2283. <arg>
  2284.  
  2285. pixmap <F3><#1f> A <F6>pixmap<F3>.
  2286.  
  2287. <syntax0>
  2288.  
  2289. pixmap<#1e>display<F3> <F2>pixmap<F0><Tab><F3>Function<Index, Doc = operations, "xlib:pixmap<#1e>display", Sort String = "pixmap<#1e>display">
  2290.  
  2291. <return>
  2292.  
  2293. <Tab><F3>Returns: <F2><HR>
  2294.   display <F3><#1f> Type <F0>display<F3>. 
  2295.  
  2296. <para>
  2297.  
  2298. Returns the <F6>display<F0> object associated with the specified <F2>pixmap
  2299. <F0>. 
  2300.  
  2301. <arg>
  2302.  
  2303. pixmap <#1f> <F3>A <F6>pixmap<F3>.
  2304.  
  2305. <syntax,
  2306.     Left Tab =        -0.90/0 inches,
  2307.     Right Tab =        7.50 inches>
  2308.  
  2309. pixmap<#1e>equal <F2>pixmap<#1e>1 pixmap<#1e>2<F0><Tab><F3>Function<Index, Doc = operations, "xlib:pixmap<#1e>equal", Sort String = "pixmap<#1e>equal">
  2310.  
  2311. <para>
  2312.  
  2313. Returns true if the two arguments refer to the same server resource, 
  2314. and <F6>nil<F0> if they do not.
  2315.  
  2316. <arg>
  2317.  
  2318. pixmap<#1e>1<F3>,<F0> pixmap<#1e>2 <F3><#1f> A three<#1e>dimensional 
  2319. array of bits to be tested.
  2320.  
  2321. <syntax,
  2322.     Bottom Margin =        0 inches,
  2323.     Left Tab =        -0.90/0 inches,
  2324.     Right Tab =        7.50 inches>
  2325.  
  2326. pixmap<#1e>id <F2>pixmap<F0><Tab><F3>Function<Index, Doc = operations, "xlib:pixmap<#1e>id", Sort String = "pixmap<#1e>id">
  2327.  
  2328. <return>
  2329.  
  2330. <Tab><F3>Returns: <F2><HR>
  2331.   id <F3><#1f> Type <F0>resource<#1e>id<F3>.
  2332.  
  2333. <para>
  2334.  
  2335. Returns the unique resource ID that has been assigned to the specified <F2>pix
  2336. map<F0>.
  2337.  
  2338. <arg>
  2339.  
  2340. pixmap <F3><#1f> A <F6>pixmap<F3>.
  2341.  
  2342. <syntax,
  2343.     Bottom Margin =        0 inches,
  2344.     Left Tab =        -0.90/0 inches,
  2345.     Right Tab =        7.50 inches>
  2346.  
  2347. <|,"4<#1e>51">pixmap<#1e>p <F2>object<F0><Tab><F3>Function<Index, Doc = operations, "xlib:pixmap<#1e>p", Sort String = "pixmap<#1e>p">
  2348.  
  2349. <return>
  2350.  
  2351. <Tab><F3>Returns: <F2><HR>
  2352.   pixmap <F3><#1f> Type <F0>boolean<F3>.
  2353.  
  2354. <para>
  2355.  
  2356. Returns true if the argument is a <F6>pixmap<F0> object and <F6>nil<F0> 
  2357. otherwise.
  2358.  
  2359. <syntax,
  2360.     Bottom Margin =        0 inches,
  2361.     Left Tab =        -0.90/0 inches,
  2362.     Right Tab =        7.50 inches>
  2363.  
  2364. pixmap<#1e>plist <F2>pixmap<F0><Tab><F3>Function<Index, Doc = operations, "xlib:pixmap<#1e>plist", Sort String = "pixmap<#1e>plist">
  2365.  
  2366. <return>
  2367.  
  2368. <Tab><F3>Returns: <F2><HR>
  2369.   plist <F3><#1f> A property list.
  2370.  
  2371. <para>
  2372.  
  2373. Returns and (with <F6>setf<F0>) sets the property list for the specified 
  2374. <F2>pixmap<F0>. This function provides a hook where extensions can 
  2375. add data.
  2376.  
  2377. <arg>
  2378.  
  2379. pixmap <F3><#1f> A <F6>pixmap<F3>.
  2380.  
  2381. <newpage>
  2382.  
  2383. <|,"4<#1e>52">
  2384.