AaÿR¼ffHH d dFootnote TableFootnote* à* à. . / - Ð Ñlp(2\“ \.TOCHeadingÙIë@Ù ÚÛÜ”ÝýÞ ß aàþá bâãÿä-å@æVçlèé–ê˜òWõ¼ö¾÷ø cùú û düýþ ÿ e f g— j³ kTçõ¶’mû»OÔÕ½×UÉ Róè lý:õ•®ù ñlã mYÓ«ÃpJ u=Õ ÈY–! ;" oÒŸÚ#•ƒö$ nM¶%€³$&ÌH9' <†( p\æ)Ç–Éý ýÝ (b/320797: Figure: Figure 1: Array_tile class hierarchyR¢kþà [¡9l14292: Figure: Figure 2: Dimensions of one cell and attributes names for positions of children within a cellÿã f23567: Figure: Figure 3: The layout of children when ARRAY_TILE_LAYOUT is set to ARRAY_TILE_LAYOUT_ROW ú i94812: Figure: Figure 4: The layout of children when ARRAY_TILE_LAYOUT is set to ARRAY_TILE_LAYOUT_COLUMN Þ Z68810: Figure: Figure 12: Setting the drawarea coordinate dimensions and drawing an circle þ ;35102: Figure: Figure 11: Drawarea code to display a circle O31032: Figure: Figure 13: The data structure for a custom display list function÷ ø cR92704: Figure: Figure 14: The drawing command for the custom display list function =70469: Figure: Figure 15: The Display_list_arg data structure TçõV13129: Figure: Figure 16: The rendering function for the custom display list operation Y–V78234: Figure: Figure 17: The map event callback for the custom display list operation ! 97:048245: Figure: Figure 10: A clockobj set to 5:04à ' l14:38789: Figure: Figure 7: A box dimensions of a box object. Ž Ùit a h aßwitZ68810: Figure: Figure 12: Setting the drawarea coordinate dimensions and drawing an circle báRAYl14292: Figure: Figure 2: Dimensions of one cell and attributes names for positions of children within a cellIL cøCOLf23567: Figure: Figure 3: The layout of children when ARRAY_TILE_LAYOUT is set to ARRAY_TILE_LAYOUT_ROW dû02:i94812: Figure: Figure 4: The layout of children when ARRAY_TILE_LAYOUT is set to ARRAY_TILE_LAYOUT_COLUMNu eÿom ;35102: Figure: Figure 11: Drawarea code to display a circlehaw fnd ;35102: Figure: Figure 11: Drawarea code to display a circleFe gispZ68810: Figure: Figure 12: Setting the drawarea coordinate dimensions and drawing an circle jplaO31032: Figure: Figure 13: The data structure for a custom display list functioneto k liR92704: Figure: Figure 14: The drawing command for the custom display list function lee=70469: Figure: Figure 15: The Display_list_arg data structure mZ68V13129: Figure: Figure 16: The rendering function for the custom display list operation n$RAY048245: Figure: Figure 10: A clockobj set to 5:04at o"namV78234: Figure: Figure 17: The map event callback for the custom display list operation p(chi:38789: Figure: Figure 7: A box dimensions of a box object.!<$lastpagenum>ig<$monthname> <$daynum>, <$year>Y"<$monthnum>/<$daynum>/<$shortyear>OL<$monthname> <$daynum>, <$year>g"<$monthnum>/<$daynum>/<$shortyear><$monthname> <$daynum>, <$year> "<$monthnum>/<$daynum>/<$shortyear>e <$fullfilename>g <$filename>t <$paratext[Title]>e <$paratext[Heading]> <$curpagenum>O31 <$marker1>e <$marker2>tu (Continued)Pagepage<$pagenum>iHeading & Page Ò<$paratext>Ó on page<$pagenum>e See Heading & Page%See Ò<$paratext>Ó on page<$pagenum>.gTable & Page7Table<$paranumonly>, Ò<$paratext>,Ó on page<$pagenum>:+ (Sheet <$tblsheetnum> of <$tblsheetcount>)i figure numbern<$paranumonly>õõwwPlkoöxxPat÷yyP84:øzzP : ù{{QaAaú||QoAiû}}Paonü~~Pi38ýQgA þ’’@is ÿQ.A••@la´´@··@dnu¼¼@"%²QaAm¾¾@LÅÅ@>‘±ÄÞ, ‘Vr>g’J$mo“V$da”Ihor•I–Jthn—Uynu˜Ir> ™I$mošh$da›Jhorœh hlfižl Figure 20: Ÿh$pa htle¡=¢ht[H£lFigure 21: O31¤h er¥k¦kker§k¨ked)©kªkage«hm>i¬kdink Ò<®k>Ó ¯k$pa°lFigure 19: age±h Ò<²kee³k$pa´kµk Pa¶k<$·kly>¸ktex¹kageºkm>:»k(Sh¼kshe½k <$¾koun¿k fiÀkernÁhumoÂ=ÃhÎhwPlÏhÑhatÒh÷yÓkÔkzP ÕXÖBAa×Bú|ØBÙh}PaÚBÛB38ÜkýÝlFigure 24: æhÿçkék•@êkëlFigure 22: nuìkík"îk%ïkðk¾@Lñkòk‘ôk‘Võk’Jök“V÷k”Iøk•Iùk–Júk—Uûk˜Iük™Iýkšhþk›JÿkœhkhkžlhFik hkkkk k21: h k¥kk¦k k§kk¨kh©klªkFigure 23: hdink Ò<k>Ó k$pakkurek±hk²kk³kk´kkµkk¶kk·kk¸kk¹k kºk!k»k"k¼k#k½k$k¾k%k¿k&kÀk'kÁh(kÂ=)hÃh*kÎh+hÏh,lÑhFigure 25: -k.kzP /k0kAa1kú|2k3k}Pa4k5k386ký7k9kure:læhFigure 17: ;h•@<h=k>kure?kìkAkíkBkîkFhïkGhðkHkñkIkòkJhôkLhõkMhökNh÷kOhøkPhùkQlúk Figure 13: Rh™ITkšhVh›JghœhhTh Figure 7: ihFijh khlBmhnhohpP21:{l Figure 11: k|lFigure 12: ¨k}lhFigure 14: ~lureFigure 15: l Ò<Figure 16: k€lFigure 18: ureŽhkhk•hk™hk›hkœkkhk©hkªhk»k kîk!kðk"kòk#kók$kõk%k h&kk'kh(k h)hh*kh+hh,lhFiBhhl Figure 10: ú|h2kh3kh4kl5k Figure 9: h7kh9kl:l Figure 8: hkku™4duÙw|dvÙ}H$Ô wÚxuH$Ô õhªªªªUU`›ªJHìzÔ xÚwyu: HìzÔ öhªªªªUU`‘ªhH$Ô yÚxzuFiH$Ô ÷lªªªªUU`’ªleHìzÔ zÚy{uFiHìzÔ øhªªªªUU`“ªeHHÔˆ{Úz|uHHÔˆùkk`”¡kHHÔˆ|Ú{uhHHÔˆúk`•¡hlH$Ô }Ú~vH$Ô û|kªªªªUU`–ªhkHìzÔ ~Ú}vkHìzÔ ühUTUTªªh—¯0SlingShot 2.0 ProgrammerÕs HandbookÙ11ÚHHÔˆÚ~vHHÔˆý`˜¡d€ÙŒªªH“Ó3Kº^¨Ú‚€H RH R©FootnoteHqùv?ü^¨‚Úƒ€hHz·¸Hz·¸©hSingle Line H'´ƒÚ‚…€„„Footnote „Þƒz ™ÔH§ùvD£f^¨…Üƒ†€H°·¸H°·¸©eDouble LineÔHºÔ†Ú…‰€‡ˆDouble LineÔ‡Ýˆ†ÔÔÔˆÝ‡†kÔÔH†Ô ‰Ú†‹€ŠŠSingle LineÔŠÝ‰zÔÔHZ´‹Ú‰Œ€ TableFootnote E¸¾GX-RŸb^¨ŒÚ‹€ÚE¸¾PoE¸¾Po©Ú TableFootnote\Û;Sÿ÷ªI‰1ÛhÚW³ÿéÛh’“´ÛdŽÙÙ‘‘dÙÚR$¦HCm™ˆÚùv$¦HCm™ˆÿ·¸h`™¡HHÔˆ‘ÚŽHHÔˆ»»¬²Þ ªªªªUUh¬ Ï\ªªUUhÝ½AThe rendering callback for the custom display list operation e3Ï[ªªUU ¬}Notice that no clipping is done in this rendering function. The gc¬ in the Display_list_arg is guaranteed to have the @ÏZªªUU¬wproper clip rectangle so that the X server will not paint outside the bounds of the drawarea. In some situations, this SiMÏYªªUU¬pclipping may be inadequate because of limitations in the X coordinate space or because a large number of server ZÏXªªUU¬tnnclipped entries in a display list. You may decide to add clipping to a custom rendering function, trading off gÏWªªUU@¬´'implementation effort for the feature. ÙyÏVªªUU ¬zThe final callback for a custom display list operation detects if events map to the rendered parts of a drawarea. This is †ÏUªªUU ¬·¸qnot to be confused with the ¾RECTOBJ_MAP_EVENT_PROC¬ callback, which maps events to objects. This callback “ÏTªªUU ¬tchecks to see if the things painted by the display list map to an event. Like the rendering function, the event map ÏSªªUU ¬li}callback is associated with the drawing operation when display_list_append()¬ installs the operation into the display ÏRªªUU ¬anzlist. Also like the rendering function, the display list is traversed from the beginning to the end to detect if an event ºÏQªªUU@ ¬inmaps to the drawarea®. nÛô£IœBmÉ’Û“ecnÛô£IœBmÉþUUtn`¨in d`¯¨ay<drawarea1 = (Drawarea) xv_create( owner, DRAWAREA, NULL ); g `®¨5VDrawArc( drawarea1, 0, 0, 2500, 2500, 0, 360*64 ); ª'`¬¨fi ÿ÷[fžI›%$“ð’ oeraIí€QÿÿÐ%žmÐ”Ú¶reVmÐ•–·Üar•’bÌ„¡må•Û–”no•’bÌ„¡måEVOC`³¨ch p`´¨s.double left = 0.0; ªª`µ¨ksdouble right = 1.0; a'`¶¨aydouble top = 0.0; . L2`·¨Hdouble bottom = 1.0; =`¸¨li aH`¹¨ed4drawarea1 = (Drawarea) xv_create( owner, DRAWAREA, ndS`º¨e DRAWAREA_LEFT_X, &left, ÏR^`»¨liDRAWAREA_RIGHT_X, &right, ci`¼¨liDRAWAREA_UPPER_Y, &top, nnit`½¨etDRAWAREA_LOWER_Y, &bottom, `¾¨drNULL ); nŠ`¿¨“7DDrawArc( drawarea1, 0.0, 0.0, .25, .25, 0, 360*64 ); •`²¨n’?6ÒÇ‚“$½–ð•”a1= (H²Ôÿü—Ù˜¶EAH²Ôÿü·(c(reUTUTªª ¡±00‚These two function calls are actually made by the SlingShot packages when you do xv_set, so calling them in the application is unURUTªª@¡±„†necessary if you set an attribute that causes the drawarea to be repainted. The appendix has more detail on these two function calls.HÆÔ ÿþ˜Ù—¶blHÆÔ ÿþ·ê(bl= UTUTªª`Â±_Currently only DDrawString, DDrawImage, DFillRectangle, and DFillPoly support event detection.read±Ù²²RAHHÔˆ²Ú±HHÔˆÃÃ‘ ªªªªUUh+¬RE _aºªªUUh,½AThe map event callback for the custom display list operation 2a¹ªªUU(;¬xFigure "25# shows the map event function, CustomStringMapEvent()¬, used by our example custom display list ?a¸ªªUU;¬eoperation. This function converts the virtual coordinates to X coordinates, and uses the XView macro hLa·ªªUU;al~rect_includesrect()¬ to see if the event occured on the text. ®The return value indicates if the event was on the image Ya¶ªªUU@;® s.that was rendered, in this case, on the text. kaµªªUU ©¬ndpFinally, the attribute ¾DRAWAREA_MAP_EVENTS¬ controls one other aspect of the event mapping process for a xa´ªªUU©¬= }drawarea®. When set to the default value, ÀDRAWAREA_MAP_ANY®, a¬ll events falling in the rectangular region of a …a³ªªUU©¬wdrawarea are considered to map to the drawarea, and the display list event mapping callbacks are not invoked.® When ªª’a²ªªUU©®set to ÀDRAWAREA_MAP_FIRST®, the display list is traversed until one of the map functions returns ÀTRUE®, indicating Ÿa±ªªUU©®t othat the event mapped to the drawarea. When set to ÀDRAWAREA_MAP_LAST®, all the map functions are called on.¬a°ªªUU©®vezregardless of multiple true return values. By combining ÀDRAWAREA_MAP_LAST® and VSetMarkKey()®, you can find ¹a¯ªªUU@©®reXout what portion of a display list mapped to an event, even with overlapping rendering.;_[<Šÿû¥Iˆ_’O³Ú¶¸as’O´µ¹ªªø ù”I˜D’]´éµ³teø ù”I˜D’]otpe`Ó¨pptypedef struct { `Ô¨= Display_list_cmdcmd; `Ü¨ !doublevirtual_x, virtual_y; e'`ç¨ rintstring_length; …a³2`é¨drchar*string; =`ê¨aw} CustomString;am6Ò n.W$«µë´³ nt iV‰’?·ÛÕmÁ¶Ú³¸©¿mÁ·¸¹RE@ ’B©·Uø’·é¸¶is@ ’B©·Uø’re`ì¨ti,voidDrawCustomString(drawarea, x, y, str) d `í¨heDrawareadrawarea; _LA`î¨p doublex, y; d'`ï¨©char*str; of 2`ñ¨rn{ es.=`ò¨DRCustomString*ptr; H`õ¨®%static Display_list_vecvector = { uS`ö¨a CustomStringRender, ev^`÷¨rlCustomStringMapEvent, ûi`ø¨ NULL, t`ù¨ªª}; ù`T¨ Š`ú¨’]if(!str) •`ð¨pereturn; `Ó `û¨uc6ptr = (CustomString*) display_list_append(drawarea, «`ü¨$&vector, sizeof(CustomString)); ¶`ý¨t tÁ`þ¨ptr->virtual_x = x; Ì`ÿ¨ptr->virtual_y = y; ×`¨n.$ptr->string_length = strlen(str); ÛÕâ`¨ptr->string = str; í`ô¨’}¸>$‰³·XÛw¸ë·¶]í„Qÿÿ¨$ø$³»ÚŽ¯¶÷¼À‘stÿöÉ¬’ÄóíØ¼éÀ»ÿöÉ¬’ÄóíØLA`¨ou `¥¨*void CustomStringRender(dl_argÈ, ptr) `¨Display_list_arg*dl_arg; '`¨õCustomString*ptr; st_2`¨{ =`¨mSintxÈ, y; H`òÈintcenter_x, center_y; S`È L^`Èù-x = dl_convert_rx(dl_arg, ptr->virtual_x); i`Èr)-y = dl_convert_ry(dl_arg, ptr->virtual_y); t`óÈr C`Èla0center_x = x - XTextWidth(dl_arg->font_info, &vŠ`õÈom0ptr->string, ptr->string_length)/2¨;È þ•`ðÈal5center_y = y¨ + dl_arg->font_info->ascent -È `ÈG(dl_arg->font_info->ascent + dl_arg->font_info->descent)/2¨;È st«` ¨ô ¶`¨·X<XDrawString(dl_arg->dpy, dl_arg->win_xid, dl_arg->gcÈ, Á`Ècenter_x, center_y, ÀÌ`îÈÉp¨tr->string, ×`¨ptr->string_length); â`¨v} ustí` ¨arÈ`m…}ÿü£$õ÷½Ú«sp¯¾¿¬; [eí–n+íg©¾é¿½ng[eí–n+íg©`¨È y`*¨òtypedef struct { `¨Drawareadrawarea; '`¨= Canvas_shellcanvas_shell; 2`¨'Rectrect;/* rect of drawarea */ ->v=`¨4doublex_m, x_b, y_m, y_b;/* interpolation */ XH`¨foXv_Fontfont; S`¨ptXFontStruct*font_info; )/2^`¨*void*assoc;/* client handle *È/ i`»ÈXv_opaquecurrent_mark_key; argt`¨t l`¨es,/* following only set during rendering */ Š`¨Display*dpy; >•` ¨idXIDwin_xid; `!¨ GCgc; «`"¨Cmscms; É¶`#¨ng Á`$¨/* private fields */ Ì`%¨vintindex; ×`&¨m…void*ext; â`'¨} Display_list_arg; [eùg©`(¨¿ö6Ñœ%îÉ/¿á¾½[eÛe¥n/þ Àá¼»¨ÈN’QÿÿÆÛÛ·ÃÚ± s¾·ÄÅ²ÉöÁI¥ÿ·$ÄáÅÃIm¯¼I¤ú·!ÅêÄÃheIm¯¼I¤ú·!/*of`-È `/Èub2int C¨ustomStringMapEvent(dl_arg, ptr, event) `.¨Display_list_arg*dl_arg; '`0¨tCustomString*ptr; 2`1¨*aEvent*event; =`2¨{ `»H`?¨c Rectrect; ;S`À¨ ^`§¨/rect.r_width = XTextWidth(dl_arg->font_info, i`¨¨&ptr->string, ptr->string_length); t`©¨/rect.r_height = dl_arg->font_info->ascent + ¨`ª¨ dl_arg->font_info->descent; $Š`¦¨ f d•`6¨Hrect.r_left = dl_convert_rx(dl_arg, ptr->virtual_x) - rect.r_width/2; ' `7¨st8rect.r_top = dl_convert_ry(dl_arg, ptr->virtual_y) - «`A¨ÛeA(dl_arg->font_info->ascent + dl_arg->font_info->descent) / 2; s¶`B¨ Á`=¨á@if(rect_includespoint(&rect, event_x(event), event_y(event))) I¤Ì`>¨@returÈn TRUE;¨/* The user clicked on this text. */ i×`9¨gMelse l_aâ`4¨>returÈn FALSE;¨/* Did not click on this text. */ í`5¨ng} tr;·!`3¨1am¤eÿýˆ·6¨mÒÈÚ–±2`mÒÉÉ² {$Ô×ì’mŽœ½úÉÚÈ 5clockobj.rs/tmp_mnt/home/brianw/DOC/clockobj.rsorÿÔ ÿü~X˜ÌÚV«PÍÑ¬&ri¢~|áÛ·VmÐÍþÎÌÎÑect¯ç³J>,K>’ÎÍÏÌÍÏÑen + d»]/})Kê£lÕÏÎÐÌÎÐÑrg>fo·…+$têKê¡.gòÐÏÓÌÏÓÑ¦¨ f¢~ $]\»\z^ØÑÙÌ_lÍGH>UU_UVÒÙ#»#»al½Á|À’²æà@,bÓÐÕÌÐÕÑ7¨st‰ô^&ñÕVÕßÓÖÌÓÖÑar p‰ô^&ñ‰ôuüGÿö4s|<`A‰ôi|G€ÖáÕØÌÕØÑt dl‰ôi|G‰ôuüGÿö4s|<¶´Ÿ[¦ñªª×áØÙÌØÙÑ=á´Ÿ[¦ñ!_I[¦ñÿö4s|<eveIôfæò€ØáÖ×ÌÖ×Ñ!ÉôfæòIôfæòÿÿ4sÿø¦ç¨!ßJ€BK~wóÙá×ÚÌ×ÚÑex!ßJ…¦ò!ßJ…¦òº9RECTOBJ_BORDER*Öd 4s¦äÚÙÜÌÙÜÑn LS"_I}¦ñ*Öd ÿö4s|<s t·4ŸY|GÕUÛÿÞßÌÞßÑr;·!·4ŸY|G·4ŸpQœÿö4s|<¨mÒ Uu*·‰Èü:ÜÚÝÌÚÝÑ²ßI‚&ñ Uu*·ÿåßQ‘a_Im¦ñª«ÝÜÞÌÜÞÑrs>/o_IQœa_Im¦ñÿJßü=rso–_Ip¦ñUVª«ÞÝÛÌÝÛÑ–_IQœ²´Ÿp¦ñÿt ÈQ“VmÐ°4ŸJ¦ñ*ª%ª«ßÿÛãÌÛãÑ,K’°_IJ¦ñ°4ŸpQœÿö4s|<Kê£p_I~A%¿HwóàÿäâÌäáÑtêp_Iƒ¦ñp_Iƒ¦ñºÑBOX_GAP¢~€|áÀ,áëâÌàÑGH€|á.@,|áÿÿ€ÿþ|á½ÁU‚ª¶sUUŒªªâàáÌ7¨st]‰õ\¦ñUVãÿßäÌßäÑar p]‰õoüG]‰õ\¦ñÿœ‰É¦æ`Ad_JIüF*ª%ª«äÿãàÌãàÑt dld‰ôo¦ñd_JIüFÿª_Ñ‘¶0€, $]-hwóáÑÌáÑ=0€,À 0€,À ºsBoxõÜžÕUpÀ øº"$(¯(±#Ö×ÑGHÕUÄ\/*#Ù»ÒÒ»µ»d$ÙÑ%%HHÔˆ%Ú$HHÔˆÁ4sUT UTªª`Õ¦The Extensions ßÑ-ª¨ªªUU ¬4ŸsThe following sections describe each of the SlingShot extensions. The descriptions are sorted by the class name so Ý:ª§ªªUU@¬>/#the reader may wish to scan ahead. –_IõÜžnHpÀ ø»&$'('(#–_IõÜž-=pÀ øÅ'$*&*&#4ŸJ¦ñ~‘ónHpÀ ø»($&"&"#_IJ¦ñ~‘óÕUpÀ øº)$+*+*#A%¿H~‘ó-=pÀ øÅ*$)')'#_Iƒ¦ñGHÕUpÀ øº+$,),)#áëGHnHpÀ ø»,$µ+µ+#|áÿ€g€†ÿý•)-ÚÀÿá/>Áä‰õ<•V ÕTª§.Ù=?-?> p3=¦~ÀaJkêIŒ/ß0-01_JIüF¤V JkàI~0à/1-/1‰ôo¦ñ¤V LÕTª§1Ù02-23$]/0¹/°¸!á¢ yŒ2à13-13€,Ê€ùï¹/ùï¥žRectobj øº¤V LÕTª§3Ù24-<.\12>þÀaJkêIŒ4ß35-56<•V JkàI~5à46-46<•V LÕTª§6Ù57-:=45 þÀaJkêIŒ7ß68-89•V JkàI~8à79-79Th Ex•V LÕTª§9Ù8:-;<Th78B °¸Aéí yŒ:à9;-6=thcùïB ùï¥ XView Genericsåˆ°¸*4ñ yŒ;à:<-9<2ùïåˆùï¥h Array_tile•V LÕTª§<Ù;=-3=.À9;<•V LÕTª§=Ù<.-<.À6:€*$ªª>ÙW-À.W€*$ªª?á.A-.A>À øºg€†ÿý•)@ÚUÀÿáBUVå_Iñ*ªUSAå?W-?W>#ñ*ªUS*ªUSÿÿ*¤+#¦~ÀaJkêIŒBßC@CD¤V JkàI~CàBD@BDÕT¤V LÕTª§DÙCE@EFaBC¹/°¸!á¢ yŒEàDF@DFÊ€ùï¹/ùï¥1Rectobj¤V¤V LÕTª§FÙEG@OQ0DE>þÀaJkêIŒGßFH@HI€ùï<•V JkàI~HàGI@GILÕT<•V LÕTª§IÙHJ@MPaGH þÀaJkêIŒJßIK@KLJkà•V JkàI~KàJL@JLLÕT•V LÕTª§LÙKM@NOJKB °¸Aéí yŒMàLN@IPcùïB ùï¥9 XView Generic)"°¸Ç½ yŒNàMO@LO 2ùï)"ùï¥6Bagth•V LÕTª§OÙNP@FPQneLN<•V LÕTª§PÙOQ@OQIM<•V ÕTª§QÙPR@RU•VFP€*$ªªRáQS@QSU•V ñ*ªUSSåRT@RTU€*ñ*ªUS*ªUSÿÿ*¤€‰ªªUSTåSU@SUøº€‰ªªUS£ªªUSÿ˜€ÿÿ*¤€*$ªªUÙT@QTg€†ÿý•)VÚÌ«USÿáXk¬æ~À‰ªªUSWåA>-A>V‰ªªUS£ªªUSÿ˜€ÿÿ*¤ÕT¦~ÀaJkêIŒXßYVYZaBC¤V JkàI~YàXZVXZÊ€¤V LÕTª§ZÙY[V[\VXY¹/°¸!á¢ yŒ[àZ\VZ\þÀÊ€ùï¹/ùï¥Rectobjùï¤V LÕTª§\Ù[]VegZ[>þÀaJkêIŒ]ß\^V^_aGH<•V JkàI~^à]_V]_Jkà<•V LÕTª§_Ù^`Vcf]^ þÀaJkêIŒ`ß_aVabJK•V JkàI~aà`bV`bc•V LÕTª§bÙacVdec`aB °¸Aéí yŒcàbdV_fcùïB ùï¥a XView GenericT)cÆ°¸8u yŒdàceVbe2ùï)cÆùï¥QBoxIM•V LÕTª§eÙdfV\fg•Vbd<•V LÕTª§fÙegVeg•V_c<•V ÕTª§gÙfhVhk€\f€*$ªªhágiVgik€‰ªªñ*ªUSiåhjVhjk€ªªñ*ªUS*ªUSÿÿ*¤€‰ªªUSjåikVikT€‰ªªUS£ªªUSÿ˜€ÿÿ*¤€*$ªªkÙjVgjg€†ÿý•Ev=lÚUSÿýv=~º®ç~Àæœ¤(dyJkêIŒmß~nlnoC¤Vä3:&^JkàI~nàmolmo€¤Vä3:&^LÕTª§oÙnplpqYmnìŸ-´;ü® yŒpàoqloq€ ä4ýMìŸ4ýM¥eCanvas_shellä3:&^LÕTª§qÙprlþÀopf`Ü)RJkêIŒrßqslst•V c÷rÈ7JkàI~sàrtlrt•V c÷rÈ7LÕTª§tÙsulx{þÀrsf`Ü(dyJkêIŒußtvlvw•V c÷r&^JkàI~vàuwluw•V c÷r&^LÕTª§wÙvxlyz uvyqKxï!á¢ yŒxàwylt{ùïŠbÂ&yqKÂ&¥ Rectobj)cÆiû&-´@Íì yŒyàxzlwzŠb4ýMiû&4ýM¥oXView CanvasÕTc÷r&^LÕTª§zÙy{lwyc÷rÈ7LÕTª§{Ùz}ltx˜'9´0 yŒ|àºl*˜'@ýg˜'@ýg¥k€€*A ã}á{€lk€°»¤*ª~æml€°»¤ÇåÄ¤ÿò;ÿýyrT±p1X±2Üå€|l±p1X±ãì„1X±ÿØÁÚ.ÇåÄ¤UV€æ}lUSÇåÄ¤ÇåÄ0ùrÿò;ÿýyrJkêg€gÿÿ•)Ú¯^ÿá‚•°èo¦~ÀaJkêIŒ‚ßƒƒ„pq¤V JkàI~ƒà‚„‚„oq¤V LÕTª§„Ùƒ……†as‚ƒ¹/°¸!á¢ yŒ…à„†„†Ê€ùï¹/ùï¥ŒRectobjl¤V LÕTª§†Ù…‡‘t„…>þÀaJkêIŒ‡ß†ˆˆ‰ul<•V JkàI~ˆà‡‰‡‰bl<•V LÕTª§‰ÙˆŠw‡ˆ þÀaJkêIŒŠß‰‹‹Œxl•V JkàI~‹àŠŒŠŒylt•V LÕTª§ŒÙ‹ŽReŠ‹B °¸Aéí yŒàŒŽ‰zcùïB ùï¥ XView Genericv%È°¸oÃ yŒŽàŒ2ùï%Èùï¥§CBox}•V LÕTª§ÙŽ†‘àŒŽ<•V LÕTª§Ù‘‘k‰<•V ÕTª§‘Ù’’•k†€*$ªª’á‘“‘“•€ñ*ªUS“å’”’”•Tpñ*ªUS*ªUSÿÿ*¤‰ªªUS”å“•“•åÄ‰ªªUS£ªªUSÿ˜€ÿÿ*¤US€*$ªª•Ù”kê‘”g€†ÿý•)–ÚÈ±ÿá—¦²é~Àw1‹ÊJkêIŒ—ß˜–˜™q¤Vt±Ç *¯JkàI~˜à—™–—™q¤Vt±Ç *¯LÕTª§™Ù˜š–š›ƒ—˜Š+ Ûg!á¢ yŒšà™›–™›€›q$žŠ+ $ž¥eRectobj¤Vt±Ç *¯LÕTª§›Ùšœ–¤¦…™š©k‹ÊJkêIŒœß›–ž<•V@ *¯JkàI~àœž–œž<•V@ *¯LÕTª§žÙŸ–¢¥ˆœØŒ÷‹ÊJkêIŒŸßž – ¡•VÖ# *¯JkàI~ àŸ¡–Ÿ¡t•VÖ# *¯LÕTª§¡Ù ¢–£¤‹Ÿ µµÛgAéí yŒ¢à¡£–ž¥9ª«$žµµ$ž¥V XView Genericæå¾Ûg+Pò yŒ£à¢¤–¡¤üŽ7$žæå¾$ž¥BDrawareaÖ# *¯LÕTª§¤Ù£¥–›¥¦•V¡£@ *¯LÕTª§¥Ù¤§–¤‚¦•Vž¢@ *¯q*¦ª§¦Ù„–€›„€*$ªª§á¥ª–*ªUSÀ*«€ª«¨åƒ„–ƒ„¦*ªUSÀ*«€ÕÕV€ÿÏÿÿUSUS9þ½‹ÊJkêIŒªß§–€ªªUSd«Ù*¬¬"HHÔˆ¬Ú«HHÔˆVÌV®kêß`×¹VBox *¯ªªªªUU P¬—sThe Box extension is subclassed from the Rectobj extension and inherits its attributes and features. The following tob)ª©ªªUU@P¬ª§figure shows this hierarchy. Ê;ª¨ªªUUho¬æ sª¬ªªUU`|½I~Box class hierarchy •V‰ª«ªªUU O¬Ù…A box object position®s nonuniform s¬ize®d¬ children in a single dimensioned non overlapping array. The layout direction ‹–ªªªªUUO¬yŒƒcan be vertical or horizontal. Figure ¬(13) shows a horizontal box with three children. The size of the box is determined Ö#£ª©ªªUUO¬¥uby the size of the children, a border between the boxÕs bounds, and a gap between each child. Children less than the ª°ª¨ªªUU@O¬*«4size of the box are centered along the layout axis. Âª§ªªUUhR¬þ½& êiª½ªªUUhQ½€.'The dimensions of a horizontal box object dÙ®®#HHÔˆ®ÚHHÔˆll¬°ªª UU`Ø¹ex Canvas_shell lªªªªUU ¬towThe Canvas_shell extension is subclassed from the XView Canvas and inherits its attributes. It also has attributes and . Ê)ª©ªªUU@¬Pfeatures inherited from the Rectobj. The following figure shows this hierarchy. je;ª¨ªªUUhÙ¬onç äªªUU`}½chCanvas_shell class hierarchy n¦ ãªªUU ¬aynA Canvas_shell is very similar to an XView canvas, except that it knows about SlingShot children. Because the ³ âªªUU ¬eevCanvas_shell is a subclass of the XView Canvas object, any attributes that are appropriate for a regular canvas, such À áªªUU@ ¬a 'as XV_WIDTH and WIN_CMS, can be used. n tÒ àªªUU ¬OrThe Canvas_shell uses several callbacks of the canvas_shell: ¾CANVAS_REPAINT_PROC¬ to repaint its children, ß ßªªUU¾hoqWIN_EVENT_PROC¬ of the paint windows to send events to its children, and ¾OPENWIN_SPLIT_PROC¬ to update ì ÞªªUU¬xdata structures when a window is split. In some cases applications need to use these callbacks, so these attributes can bcù ÝªªUU¬iexbe overridden. If you do this, it is important that you call the underlying Canvas_shell function from your application ob ÜªªUU¬igyfunction. For example, canvas_shell_split_proc()¬, the default view split callback for the canvas_shell should be ÛªªUU¬lltcalled if you set your own ¾OPENWIN_SPLIT_INIT_PROC¬. The default functions for these callbacks are listed in Ca ÚªªUU@¬bcthe appendix. 2 ÙªªUU ¬nyXThe canvas_shell supports attributes to optimize repainting. For example, the attribute DT? ØªªUU¾ bgCANVAS_SHELL_DELAY_REPAINT¬ reduces painting during the context of several calls to xv_set(), which _REL ×ªªUU¬reordinarily repaints all changes to SlingShot objects for each xv_set() call. Setting this attribute to ¾TRUE¬ allows the _SPY ÖªªUU¬dayapplication to temporarily delay painting of all objects within that canvas_shell. It should not be set to ¾FALSE® of ÕªªUU®ca”indefinitely.¬ When it is finally set to ¾TRUE¬, all changes that hav®e occurred s¬ince it was set to ¾FALSE¬ will be painted. Üs ÔªªUU¬fuvThe default event handler for paint windows, canvas_shell_event_proc()¬, sets this attribute so that SlingShot € ÓªªUU¬ll‚callbacks donÕt need to b®e bracketed w¬ith the attribute. You will still need this for event callbacks from other objects, ÒªªUU@¬ndsuch as panel items or menus. Ÿ ÑªªUU V¬s vThe canvas_shell also supports batching of repaints t®o off screen p¬ixmaps. Depending on the application, some ¬ ÐªªUUV¬ng€repainting may be visually distracting, especially when objects overlap. When this attribute is set to ¾TRUE¬, it creates e¹ ÏªªUUV¬ Soa pixmap the size of the canvas_shellÕs paint windows. Later when objects in the canvas_shell are updated, the ng Æ ÎªªUU@V¬hiTrepainted images are drawn to the pixmap, and then copied as a whole to the window. fiØ ÍªªUU ¬t vThe Canvas_shell also understands the attributes of the Rectobj. For example, the attributes ¾RECTOBJ_MENU¬ and å ÌªªUU@¾oRECTOBJ_CHILDREN¬ have the same meaning and work exactly the same for Canvas_shell as it does for Rectobjs. Sl÷ ËªªUU ¬UUyThe Canvas_shell has slightly different semantics for the ¾XV_OWNER¬ and ¾RECTOBJ_PARENT¬ attributes. In the m ÊªªUU¬ ÒrRectobj package and its subclasses, these are identical. The Canvas_shell package always returns ¾NULL¬ for ÉªªUU@¾crnRECTOBJ_PARENT¬. This makes it convenient to differentiate if the application is walking up the hierarchy. d¯Ù W°°$seHHÔˆ°Ú¯ ÏHHÔˆ®² csh`Ú¹s.CBox wªªªªUUhm¬ cè hTª®ªªUU`~½heCBox class hierarchy ijªªªUU ª¬ aqThe CBox object centers all its children within its bounds. If children become bigger than the cbox, it enlarges ewª¬ªªUUª¬ut}accordingly. If the children are resizable (¾RECTOBJ_RESIZABLE¬ is ¾TRUE¬), then the children are resized to the e„ª«ªªUU@ª¬exCboundaries of the cbox, minus the border (¾RECTOBJ_BORDER¬). UUd±Ùgh²²%s HHÔˆ²Ú±ECHHÔˆ–È°´ªª`l¹ag Clockobj uªªªªUU F¬e wTh®e Clockobj e¬xtension is subclassed from the Drawarea extension and inherits its attributes and features. The it )ª©ªªUU@F¬er'following figure shows this hierarchy. the;ª¨ªªUUhn¬é sª¬ªªUU`½ WClockobj class hierarchy ‰ª«ªªUU(<¬|A clockobj is an analog 12 hour time display with three major features (see Figure $17%): a hour hand, a minute hand, ªª–ªªªªUU<¬ cand a clock face. Time is set with two attributes: ¾CLOCKOBJ_HR¬ and ¾CLOCKOBJ_MIN¬. If enabled, the time can also the£ª©ªªUU@<¬ e=be set by the user by clicking and dragging the clock hands. eµª¨ªªUUhæ¬I~ myªªUUh:½th!A clockobj set to 5:04 o tƒxªªUU G¬ªtAdditional features, such as decorations on the face, can be added to a clockobj. The clockobj is a subclass of the wªªUUG¬pdrawarea, so you can do drawarea operations on it. For example, the following code sample changes the face from uvªªUU@G¬e circular to rectangular: n©mË`H¨ fVClear(my_clock); nsi´mË`I¨s /VDrawRectangle(my_clock, 0, 0, 10000, 10000); ¬erÅuªªUU`J¬ sPThis feature could be used to add numbers and tics to the face, if desired®. c×tªªUU Ã¬ª«xThe time can be directly set by the user by clicking and dragging on the hands of the clock if ÀCLOCKOBJ_MOVABLE¬ anäsªªUU@Ã¬ªªqis ÀTRUE¬. The application is notified when the user changes the time with ÀCLOCKOBJ_MOVE_PROC¬.À ¬d³Ùhe´´&beHHÔˆ´Ú³raHHÔˆW²·I~ `Û¹th Drawarea cªªªªUU •¬ tnThe Drawarea extension is subclassed from the Rectobj extension and inherits its attributes and features. The )ª©ªªUU@•¬ o'following figure shows this hierarchy. o y;ª¨ªªUUhš¬ oò nsª¬ªªUU`€½leDrawarea class hierarchy ‰ª«ªªUU Ž¬roqThe Drawarea package provides an abstraction for rendering by using drawing commands, such as Òdraw a rectangleÓ –ªªªªUUŽ¬myvand Òdraw a filled arcÓ. These are similar to Xlib routines, but have some advantages: rendering is done on a virtual £ª©ªªUUŽ¬t~coordinate system, refresh events are handled automatically, and the API i®s simpler b¬ecause there are fewer ÒcontextÓ °ª¨ªªUUŽ¬ªªparguments (GC, Window, Display). These features can greatly simplify applications when rendering operations are RO½ª§ªªUU@Ž¬ required. Ïª¦ªªUU ¬sThere are two simultaneous virtual (cartesian) coordinate systems that can be used by the programmer. The ÒVÓ (for Üª¥ªªUU¬ cvvirtual) coordinate system runs from 0 to 10000 with the origin at the upper left. Rendering commands, in the form of éª¤ªªUU¬ªª}function calls, output graphics scaled to these dimensions. For example, the following code in Figure ¬ÿ19 draws a cöª£ªªUU@¬Ž1circle in the upper left quadrant of a drawarea. fª¢ªªUUh«¬inÛ nI† ªªUUh°½s &þDrawarea code to display a circle _†ªªUU Á¬edxExcept for the position and dimension arguments, the semantics of this call are the same as the Xlib call XDrawArc®. col†ªªUUÁ®ef„Typically, th¬e functions that render into this coordinate system take the name of th®e corresponding X¬lib function, with s y†ªªUUÁ¬ayuÒVÓ (or ÒDÓ) in place of ÒX.Ó The drawarea also has functions for setting fill styles, line widths, colors, etc. The ¦††ªªUU@Á¬Th/complete list of functions is in the appendix. din˜†ªªUU ¬anzThe ÒDÓ (for double) coordinate system uses programmable dimensions and has ®a separate s¬et of rendering functions ¥†ªªUUH¬ l}that use doubles for arguments. The code in Figure ¬ß20ý creates the same effect as that in Figure ¬19. x·†ªªUU œ¬ngoThe dimensions of the double coordinate system can be changed at any time, which is useful if you need to pan, ª¢Ä†ªªUUœ¬‚zoom, or rescale. For example, if we wanted to zoom into the circle created in Figure ¬20, we could set the coordinate Ñ†ªªUUœ¬f usystem to (0.0, 0.0, 0.25, 0.25) and it would fill the drawarea. Any other drawing that is outside of the coordinate iÞ…ÿªªUU@œ¬e system is clipped. of GH-=pÀ øÅµ$,,#cton,d¶Ù(o··'Ó HHÔˆ·Ú¶r HHÔˆ””—˜´¹et ¦ªªªªUUh±¬ThÜ e´yªªUUhž½nsEÞSetting the drawarea coordinate dimensions and drawing an circle dÊxªªUU ™¬prlWhen the drawing command function calls are made, the Xlib calls are not immediately made. Drawing commands bl×wªªUU™¬Thufunctions actually store the commands and their arguments away in a display list that can be replayed when a refresh iävªªUU™¬ubvis needed. In some cases, the application may need to explicitly make the changes appear on the screen. The reason is ñuªªUU™¬e,rthat the drawing commands do not go through xv_set, which knows how to repaint updated objects. To get the object þtªªUU™¬.0‡to repaint completely, call rectobj_repaint_rect()¬ followed by rectobj_flush_repaint()¬. This strategy repaints the lipsªªUU™¬Àuentire display list and handles any objects that may overlap the drawarea. This can be suboptimal if you just issued rªªUU™¬zonly a few drawing commands and donÕt have overlapping objects, so the drawarea provides a function, VFlush()¬, to %qªªUU@™¬ng…optimize this situation. VFlush()¬ paints all drawing commands since the last repaint or the last VFlush()¬ operation. m7pªªUU ›¬UU”The display lis®t has¬ ®a ¬simple® structure and use:¬ it is not editable, all changes to it are appended to the end of the list, isDoªªUU›¬asoand it is always traversed (when repainting and detecting events) in one direction. If changes need to be made ¬e,QnªªUU@›¬ cjsomewhere in the middle of the display list, it should be cleared with VClear()¬ and then rebuilt: ]mÃ`œ¨ntVClear( drawarea ) renmªªUU ¬()sThis function deletes all drawing commands in the drawarea. After calling this, the application should restore the lay{lªªUU@¬an8display list if any state is to remain after clearing. tikªªUU ¢¬suxDrawarea® objects¬ are not opaque, so interesting interfaces can be created by overlapping several drawareas. For iošjªªUU¢¬,wexample, imagine you decided to annotate a drawarea with textual labels, but you needed the ability to hide the labels th§iªªUU¢¬)kon command. One approach would be to create two drawareas at the same position, dimensions, and coordinate i´hªªUU¢¬ ausystem. The first drawarea could contain the drawing and the second could contain the labels. Simply by toggling the nÁgªªUU@¢ÀenWXV_SHOW¬ attribute on the drawarea, you could alternately hide and show the labels. e mÓfªªUU Î¬aywThe drawarea can have event callbacks, such as double click procs. If the attribute ¾DRAWAREA_MAP_EVENTS¬ is set UUàeªªUUÎ¬ctto ¾TRUE¬, an event will be checked against the entries in the display list to see if the drawarea is not opaque at that 8diídªªUUHÎ¬stolocationê. If ¾FALSE¬, all events that fall on the drawarea are assumed to be mapped to the drawarea. in m¹`p¸eaDrawarea and the Display List cªªUU ¬ªªpThe functions supported by the drawarea are actually operations on a display list. This list is hidden from the to,bªªUU ¬thsprogrammer via the drawing commands but can be accessed directly. This feature is useful if you need to extend the co9aªªUU ¬ªª‚rendering capabilities of the drawarea, such as adding a spline for example. To understand the display list, let®Õ¬s create F`ªªUU ¬enŽa new display list function that draws tex®t positioned by t¬h®e stringÕs center r¬ather than the baseline of the fon®t (as is S_ªªUU@ ®ou1the case with VDrawString and DDrawString).¬ Ed¸ÙÎ¹¹( aHHÔˆ¹Ú¸e HHÔˆ³¶·¬dr iªªªªUU Ï¬atvThe first step in creating a new drawing routine is to define a data structure for the information used to render and ª©ªªUUÏ¬in‰detect events. Figure 21 shows this data structure, note that the first field, cmd¬, is necessary and is used to link the n ª¨ªªUUÏ¬hi|structure into the display list. The remaining fields in the structure are for use by our custom display list functions and re-ª§ªªUU@Ï¬ne-describe the virtual coordinates and string. r?ª¦ªªUUhÒ¬f w®<ôªªUUh£½ng;The data structure for a custom display list operation ÕÄ<óªªUU(Ñ¬ªª~The second step is to create a drawing command function that the application will use. Figure 22 shows this function, Ñ<òªªUUÑ¬twhich allocates space in the display list by calling the display list function display_list_append()¬. The first argument Þ<ñªªUUÑ¬ƒto display_list_append()¬ is the drawarea to draw into. The second argument, vector,¬ defines the callback functions awië<ðªªUUÑ¬efvused to render and map events on the drawarea. The last argument specifies the size needed to fit the structure into ø<ïªªUUÑ¬rethe display list. (You may wish to check for ¾NULL¬ return value here - which indicates that it was unable to allocate the s<îªªUUÑ¬ieyneeded memory.) display_list_append()¬ is like malloc()¬ because it returns a memory address and should be d<íªªUUÑ¬ r‡appropriately casted and initialized. In this example, w®e do not c¬opy the string data into the display lis®t so that we can se<ìªªUUÑ®eawoptimize for constant strings. If the strings were not constant, this c¬ould be done simply by allocating the right wh,<ëªªUU@Ñ¬e amount of space (basically by adding in strlen()¬ to the third argument to display_list_append()¬) and copying it. o><êªªUUh¤¬ap TªªªªUUhë½ t>The drawing command for the custom display list operation jª©ªªUU wivCustomStringRender()¬ is the callback that renders the custom display list operation. This function is called with wª¨ªªUU¬o rendering context and scaling factors set up in the first argument. The structure of this argument, Display_list_arg¬, is b„ª§ªªUU¬ s†shown in Figure 23. Of all the display list structures introduced so far, this is the only one that you should need to b®e ˜'C´0 yŒºà|lop˜'Jýg˜'Jýg¥iizGHÕUÄ\A€»ÙÒ c#Ò}_*›iÏBg¼äÀay!ª°½ÈÁõan8RTÕd{ª‹OU=½Ú ¼¥¦ f 1column.rs/tmp_mnt/home/brianw/DOC/column.rsl ©ÿù$Ñ¾Ú rz¶ß¿ËöÑTª²ü@zªœmª£¿ä§¾ y +row.rs/tmp_mnt/home/brianw/DOC/row.rsay_dÀÙ oÁÁHHÔˆÁÚÀdrHHÔˆ-¼%opn `¹wiArray_tile gReªªªªUU Ÿ¬capThe Array_tile extension is subclassed from the Rectobj extension and inherits its attributes and features. The g )ª©ªªUU@Ÿ¬g 'following figure shows this hierarchy. st;ª¨ªªUUhj¬guä sª¬ªªUUhh½ÝArray_tile class hierarchy wn ‰ª«ªªUU g¬qAn array_tile is a geometry manager and positions its children in a two dimensional array. The number of columns 0–ªªªªUUg¬uand the number of rows is programmable. The width and the height of an array_tile are divided up into gaps and cells °£ª©ªªUU@g¬RT,and each child is positioned inside a cell. µª¨ªªUU ¬tmpCell size is defined by two attributes: ¾ARRAY_TILE_COLUMN_WIDTH¬ and ¾ARRAY_TILE_ROW_HEIGHT¬. If a §Âª§ªªUU@¬bchild is added that is bigger than the size of the cell, all cells in the array_tile get larger. Ôª¦ªªUU ¬qChildren are positioned within the cell according to the ¾ARRAY_TILE_ALIGN¬ attribute. Cell dimensions and eáª¥ªªUU¬Ÿ{attributes for child positioning within one cell are shown in Figure á8â. All children are positioned using the same ªªîª¤ªªUU@¬owalignment. owsª£ªªUUh¬I~÷ ªhÕMªªUUh½ XàDimensions of one cell and attributes names for positions of children within a cell e ~ÕLªªUU ¬gepThe cells of the array_tile can be organized by row major and column major order. The ¾ARRAY_TILE_LAYOUT¬ er‹ÕKªªUU¬mmrattribute controls this. If it is set to ¾ARRAY_TILE_LAYOUT_ROW¬, the major axis is a rows (horizontal). An ˜ÕJªªUU¬ iiarray_tile with row major order and three rows is shown in Figure ø9ù. If this attribute is set to ¬¥ÕIªªUU¾LEnARRAY_TILE_LAYOUT_COLUMN¬, the major axis is columns (vertical). An array_tile with column major order and ²ÕHªªUU¬ g{three columns is shown in Figure û10ü. In these figures, the first number in the parenthesis is the major index, the . C¿ÕGªªUU@¬ eisecond number is the minor index. Row and column positions start at zero, with (0, 0) at the upper left. hÑÕFªªUUh ¬neõ GÕJªªUUh½ªª^ãThe layout of children when ¾ARRAY_TILE_LAYOUT½ is set to ÀARRAY_TILE_LAYOUT_ROW ]ÕIªªUU ¬butThere are several attributes used to control automatic positioning of children. Automatic positioning is enabled by bjÕHªªUU¬luƒdefault, but can be di®s¬abled by setting ¾ARRAY_TILE_AUTO_POSITION¬ to ¾FALSE¬. If disabled, the application is ROWwÕGªªUU¬iskresponsible for setting the row and column position of newly added children via ¾ARRAY_TILE_ROW¬ and FigdÙs HHÔˆÚ, HHÔˆ¾¾ÁVrr e ªªªªUU¾orqARRAY_TILE_COLUMN¬. If enabled, the array_tile positions new children as they are added. If all the cells are eª©ªªUU@¬e ]occupied, new columns or rows are added depending on the value of ¾ARRAY_TILE_LAYOUT¬. t%ª¨ªªUU ¬, qThe number of rows and columns can be explicitly set, but should be set carefully. If the number of cells in the 2ª§ªªUU¬ž~array_tile becomes lower than the number of children, some children will becom®e unmanaged®.¬ Unmanaged children ?ª¦ªªUU¬madare not visible. You may make them visible again by explicitly resetting their row and column (with Lª¥ªªUU@¾PO3ARRAY_TILE_ROW¬ and ¾ARRAY_TILE_COLUMN¬). tio^ª¤ªªUUh¬UUö s>ªªªªUUh½seaúThe layout of children when ÀARRAY_TILE_LAYOUT½ is set to ÀARRAY_TILE_LAYOUT_COLUMN Tª©ªªUU k¬wThe class of the children of an array_tile can be any subclass of rectobj. The interface is the same regardless of the ªªaª¨ªªUU@k¬AR6class and the classes can be mixed in one array_tile. dUÙIfVV!ª©HHÔˆVÚUluHHÔˆ@@¬ue¾`Ö¹¬Bag ª¨ªªªªUU M¬ThsThe Bag extension is subclassed from the Rectobj extension and inherits its attributes and features. The following ªª)ª©ªªUU@M¬y_figure shows this hierarchy. b;ª¨ªªUUhi¬meå esª¬ªªUU`{½Bag class hierarchy nm‰ª«ªªUU L¬ª¦A bag objec®t expands or shrinks to fit t¬he dimensions of its children. In general use, you create a bag object and add UU–ªªªªUUL¬LEšchildren to it specifying the®ir¬ ¾XV_X¬ and ¾XV_ÃY® values a¬s offsets from th®e bagÕ¬s coordinate system. As children are £ª©ªªUUL¬LEƒadded®,¬ ®deleted, ¬or change size, the bag changes size to fit to the smallest rectangle containing all the children. sa°ª¨ªªUUL¬heqAdditionally, you can specify some border space between the bounds of the children and the edges of the bag with f½ª§ªªUU@L¾RECTOBJ_BORDER¬. ÚÏª¦ªªUU N¬The origin of the bag can be anchored (the default) or unanchored. If it is unanchored (¾BAG_ANCHORED¬ is ¾FALSE¬) frÜª¥ªªUUN¬enmthe bag will reset itÕs origin whenever shrinking to fit its children. When resetting the origin under these héª¤ªªUUN¬izcircumstances, the bounds of the bag are reset while the children retain their absolute coordinates. If this attribute is öª£ªªUUN¾ i‹TRUE¬, the bag will not change its origin to fit to the children, and the childrenÕs offset (¾XV_X¬ and ¾XV_Y¬) will remain d ª¢ªªUU@N¬lu the same. g€†ÿý•)WÚ³inÿáXŸ´òn ¦~ÀaJkêIŒXßYWYZ,¬¤V JkàI~YàXZWXZth ba¤V LÕTª§ZÙY[W[\esXY¹/°¸!á¢ yŒ[àZ\WZ\n.Ê€ùï¹/ùï¥eRectobjnal¤V LÕTª§\Ù[]WegacZ[>þÀaJkêIŒ]ß\^W^_ndthe<•V JkàI~^à]_W]_UU@L<•V LÕTª§_Ù^`Wcfªª]^ þÀaJkêIŒ`ß_aWabn e a•V JkàI~aà`bW`bd.If •V LÕTª§bÙacWde`aB °¸Aéí yŒcàbdW_fNcùïB ùï¥t XView GenericeW‡°¸+Pò yŒdàceWbe2ùïW‡ùï¥gDrawareahe•V LÕTª§eÙdfW\fganbd<•V LÕTª§fÙegWeghi_c<•V ÕTª§gÙfhWhŸco\f€*$ªªhágiWgiŸªªUUñ*ªUSiåhžWhžŸothañ*ªUS*ªUSÿÿ*¤dre7•S *¯JkàI~àª€–ª€XVX7•S *¯LÕTª§€Ù–‚ ªJ×*Ûg&Q¦ yŒà€‚–€‚ÿý]ÿý$žJ×*$ž¥Clockobj7•S *¯LÕTª§‚Ùƒ–¥ƒ¦ß€!ÕU€ª«ƒå‚¨–‚¨¦àZ!ÕU€7€€0ª«ÿÿUSZÙ_€ª«„å¨¦–¨¦yŒà_€tª«€ÿmÕVÿÿUS‰ªªUSžåiŸWiŸÙ]‰ªªUS£ªªUSÿ˜€ÿÿ*¤]ß€*$ªªŸÙžWI~gžÏB/ü- è½¡¼ª§ÏBÏB¬^þÀÂÒD3€nªª¡å ¢¼£¥ a•VÂÒD3€1|î3€|îòIf Ð$—4'q È6¢å¡£¼Ð$—UU€½ñ¸¿¿Ò^owGHJÕUGH>UUÿÓGH'ÕFKÿøñóDÕU\õU*²¾õ¿Á¿ÁÒ*«»ñóDÕUeçHEÿÓñó'ÕF"°fœž>UU€¿ñ½¾½¾ÒpARfœžJÕUfœž>UU2œž'ÕFž†ùkG†Ÿ`qÎ¶Áò¾Â¾Òß—·1óKâÿ†ùkKâÿÁIARRAY_TILE_COLUMN_WIDTH±s•2!e½X0Î¶ÂðÁÅÅÃs•2%Âs•2%ÂÁNARRAY_TILE_ROW_HEIGHTåhñóÕUb±o/*ÃÙÉ»¸»#ÂÄnHÕd.÷äÄïÇÉÇÃ`žnHÕdnH:ÍHÜÿàÕVuêhñóÕU *«ÅôÂÇÂÇÃSTÄ™hñóÕUsžÕUñóÿàôdÉùhñó; *«ÇôÅÄÅÄÃLI_Shñó;sž;ñó*¡³y¼IBÛÊ`mÒÈð¦¼ARAY_µUj«Ï€TÕUÉðÄÃž¶åÿÝ$yúGÈ·Ëðª¾ÂAY_duîLeftdvroRight—îd€LE ReferenceEucd)Ž½d°CoverÙ¸d± ÕUd$did À¿d !¥d! "Uñód"!#«Òd#"$ñód$#%¯d%$&±ARd&%'³d'&(¶ òd(')¸ ùkd)(«OL=}C$À@=±E¸Footnote$$æf™>tU ÕUclass-description class-endæf™?AÊ Ï€HÃlžå$yG´ðØüY_ Dproset( æf™@P chaptereSingle LineproseÕUæf™AA ñó class-end!Òæf™B¹P$ section'prose( æf™DP class-nameSingle Lineclass-descriptionæf™F¡CellHeadingæf™G¡CellBodyæf™H¤Tð TableTitleT:Table : æf™I¡pteBodyÀ@Jª êñó Ôs- !Header$$æf™Lq selattr-default Default: attr-procs™$$æf™Mp attr-description attr-argumentæfæf™NA Hlæf™´Øü Dattr-endCeÀ@O¤ê ÔTa TFootere æf™P¸P subsectionproseæf™QP subsectionproser$$æf™SA lse attr-usageUsage:attr-end À@T½e FigureFigure : prosenÀ@U¯ê Ô FooterÀ@Vª êÀ Ô Footeræf™WPa attr-nameattr-description( æf™X¦P æfchapterSingle Lineprose À@Yer Figure Figure : prose$$æf™[q l attr-argument Argument:attr-defaultH$æf™]Q ,l‹Hl´Ø ü erDlist with bullet¥$$æf™^q Fol attr-procsProcs: attr-usageÀ@_ptiFootnoteæf™aQ ing Hl´ÀØ@ü DrhŒlistingFiæf™cP™ sectionproseæf™h¬A Hl´Øü l‹ Dproseæf™iQt $™Hl´Øü D trhŒs:code65Û" æf™jA Hl´æfØü Dlist descriptionæf™k¨Q $HglFi´æfØ™ü D™hŒcode À@l½e Figure Figure : Hprose¡Ñ« zÙVÓ¡ÿÌà¢ Times-12-izÙVÓ£îãø¤ egY¥H©¦ ÿÌà§ Courier-10 æ_ý‰¨5Û"©© zÙVÓª zÙVÓ¬ h°„² Times-10-i zÙVÓ®egY¯ ÿÌà° Times-10-izÙVÓ±gÿÌà²ØTimes-16 ÿÌà³Times-10ÿÌà´ Times-24 ÿÌàµ Courier-9ÿÌà¶ureHelvetica-12 <egY¸©¹ à æ_ý‰º Courier-9ÿÌà»Times-12 h°„²½gY æ_ý‰¾© æ_ý‰À Courier-10æ_ý‰Á_ý‰;cóoÂ © Courier-9 æ_ý‰Ã æ_ý‰ÈÙ)â"ÙÚ€ÛFÿÿØ;ÜÝ€Þ€ßZ€àZ€áZäF€åF€æF€èF€éF€êZ€ëF€ïF€ðF€ñF€òF€ôF€õF€þZ€ÿF€Z€F€Z€Z€Z€F€ F€F™!F€$Zeuj€eThinfMedium€gDoublehThick@i Very ThinÉÙÉÊeeeeeeeeegHHFGFHFGFHFGFHFGFÙHFGFFormat AËefeeeeefHHFGFHFGFHFGFHFGFHFGFFormat B-=-.CommentCourierTimes Helveticað RegularRegular BoldRegularItalic^ÿAš¤CÑÔ¨Ó›%!~£ C(õj†wè ç×UÉ 9=v7Rñ×@€UHý:õ7Ö¡•®ùfLm!^ñlã±êVxYlÏ7ÞÓ«b|uï…pJt€yöu=Õ@xk3j–7°Q"¡;Â”ÒÒŸÚ¤WWDI•ƒö‹ä@óöM¶’È.0Zñ·Z¯¢¿åÁÞíws94—Dx.ULç™žÚoÀo-æÍÐôá•w>=}Ö£òV±˜GR0åÒ/oåÌp%ß´îÔÉˆhõì³{)ç¶îUÜ21.#LC ÞS^%ÂÄ*èšèÛçÿ‰Zƒ¿ŸšBUöHûvš