-+-+-+-+-+-+-+-+ START OF PART 119 -+-+-+-+-+-+-+-+ Xb(identi\256er)n(.)25 386 y(IN)50 b(Pint)108 b Fa(menuid)137 Xb Fq(menu)12 b(identi\256er)n(.)25 436 y(IN)50 b(Ptxpath)e XFa(menupath)95 b Fq(path)11 b(of)g(box)g(menu)g(\(left,)g(right,)f(up,)i X(down\).)25 486 y(IN)50 b(Pint)108 b Fa(font)194 b Fq(text)11 Xb(font.)25 536 y(IN)50 b(Pint)108 b Fa(textcolour)98 b Fq(colour)10 Xb(index)h(for)g(text.)25 585 y(IN)50 b(Pint)108 b Fa(intcolour)118 Xb Fq(colour)10 b(index)h(for)g(interior)n(.)25 635 y(IN)50 Xb(Pint)108 b Fa(edgecolour)76 b Fq(colour)10 b(index)h(for)g(edges.)25 X685 y(IN)50 b(Pint)108 b Fa(boxtlcolour)80 b Fq(colour)10 b(index)h(for)g X(top-left)f(of)h(box.)25 735 y(IN)50 b(Pint)108 b Fa(boxcolour)98 Xb Fq(colour)10 b(index)h(for)g(bottom-right)d(of)j(box.)25 X785 y(IN)50 b(Pint)108 b Fa(httextcolour)68 b Fq(colour)10 Xb(index)h(for)g(highlight)d(text.)25 835 y(IN)50 b(Pint)108 Xb Fa(htintcolour)88 b Fq(colour)10 b(index)h(for)g(highlight)d(interior)n(.) X25 884 y(IN)50 b(Pint)108 b Fa(htedgecolou)o(r)47 b Fq(colour)10 Xb(index)h(for)g(highlight)d(edges.)0 953 y(This)14 b(function)f(sets)h(the)h X(box)e(menu)i(path,)g(text)e(font)h(and)g(colour)f(attribute)g(values.)24 Xb(The)15 b(highlight)d(colour)h(indicies)g(are)0 1003 y(used)f(by)e(the)i X(function)d Fi(ptk_setboxmenuhighl)q(ightit)q(em)14 b Fq(to)d(highlight)d(a) Vk X(single)f(menu)h(item.)p 1121 1100 746 2 v 1121 1179 2 80 v X1135 1154 a Fb(ptk_setboxmenuhi)o(ghli)o(ghti)o(tem)p 1864 X1179 V 1121 1181 746 2 v 0 1255 a Fq(void)e Fp(ptk_setboxmenuhighlightitem)f XFq(\()i(Pint)g Fa(menuid)p Fq(,)f(Pint)g Fa(itemnum)h Fq(\))25 X1344 y(IN)50 b(Pint)e Fa(menuid)68 b Fq(menu)12 b(identi\256er)n(.)25 X1394 y(IN)50 b(Pint)e Fa(itemnum)h Fq(menu)12 b(item)f(number)n(.)0 X1469 y(This)16 b(function)f(highlights)e(a)k(menu)f(item)g(by)g(setting)f X(the)h(colour)g(index)f(values)i(for)e(the)h(text,)h(interior)e(and)h(edge)h X(of)f(a)0 1519 y(box)11 b(menu)g(item.)p 1257 1616 610 2 v X1257 1695 2 80 v 1271 1670 a Fb(ptk_setboxmenute)o(xtfon)o(t)p X1864 1695 V 1257 1697 610 2 v 0 1771 a Fq(void)f Fp(ptk_setboxmenutextfont)h XFq(\()g(Pint)f Fa(wsid)p Fq(,)i(Pint)e Fa(menuid)p Fq(,)h(Pint)f XFa(font)g Fq(\))25 1860 y(IN)50 b(Pint)e Fa(wsid)95 b Fq(workstation)9 Xb(identi\256er)n(.)25 1910 y(IN)50 b(Pint)e Fa(menuid)h Fq(menu)11 Xb(identi\256er)n(.)25 1960 y(IN)50 b(Pint)e Fa(font)106 b Fq(text)10 Xb(font.)0 2029 y(This)h(function)f(sets)i(the)f(text)f(font)h(of)g(all)g X(text)f(menu)i(items)f(in)g(the)g(menu)h(structure.)j(The)d(menu)f(must)h(be V) Xf(a)h(box)f(menu.)p 1340 2126 527 2 v 1340 2205 2 80 v 1354 X2179 a Fb(ptk_setmenupositi)o(on)p 1864 2205 V 1340 2207 527 X2 v 0 2281 a Fq(void)f Fp(ptk_setmenuposition)h Fq(\()g(Pint)f XFa(menuid)p Fq(,)h(Ppoint)f(*)p Fa(menupos)f Fq(\))25 2370 Xy(IN)50 b(Pint)122 b Fa(menuid)78 b Fq(menu)12 b(identi\256er)n(.)25 X2419 y(IN)50 b(Ppoint)9 b(*)50 b Fa(menupos)e Fq(menu)12 b(position.)0 X2495 y(This)f(function)e(sets)i(the)f(position)e(of)j(the)f(top-left)f X(corner)i(of)f(the)g(\256rst)h(menu)g(item.)k(The)c(position)e(is)h(given)g X(in)g(the)g(range)h(`5B0,)0 2544 y(1`5D.)18 b(If)12 b(the)g(position)e(resul Vts)i X(in)f(part)h(of)g(the)g(menu)h(being)e(clipped)h(then)g(the)g(actual)g X(position)e(is)i(adjusted)g(so)g(that)g(as)h(much)0 2594 y(as)f(possible)e X(of)h(the)h(menu)f(is)g(visible.)0 2956 y(13th)22 b(May)m(,)12 Xb(1992)626 b(137)828 b(2.01)p eop X%%Page: 138 139 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1403 -19 464 2 v 1403 60 2 80 v 1417 35 a Fb(ptk_setrotatorat)o X(trs)p 1864 60 V 1403 62 464 2 v 0 136 a Fq(void)10 b Fp(ptk_setr)o X(otatorattrs)i Fq(\()20 b(Pint)g Fa(wsid)p Fq(,)i(Pint)e Fa(menuid)p XFq(,)i(Pint)d Fa(titlefont)p Fq(,)i(Pint)e Fa(titlecolour)p XFq(,)435 186 y(Pint)10 b Fa(arrowcolour)p Fq(,)e(Pint)i Fa(arrowedgecolo)o X(ur)p Fq(,)e(Pint)i Fa(intcolour)p Fq(,)f(Pint)435 236 y Fa(edgecolour)o XFq(,)f(Pint)h Fa(bannercolou)o(r)p Fq(,)f(Pint)h Fa(boxtlcolour)p XFq(,)f(Pint)h Fa(boxbr-)435 285 y(colour)g Fq(\))25 336 y(IN)50 Xb(Pint)e Fa(wsid)242 b Fq(workstation)9 b(identi\256er)n(.)25 X386 y(IN)50 b(Pint)e Fa(menuid)196 b Fq(rotator)10 b(identi\256er)n(.)25 X436 y(IN)50 b(Pint)e Fa(titlefont)197 b Fq(title)10 b(font.)25 X485 y(IN)50 b(Pint)e Fa(titlecolour)159 b Fq(title)10 b(colour)g(index.)25 X535 y(IN)50 b(Pint)e Fa(arrowcolour)126 b Fq(arrow)11 b(interior)f(colour)g X(index.)25 585 y(IN)50 b(Pint)e Fa(arrowedgecolou)o(r)f Fq(arrow)11 Xb(edge)h(colour)e(index.)25 635 y(IN)50 b(Pint)e Fa(intcolour)177 Xb Fq(rotator)10 b(interior)g(colour)g(index.)25 685 y(IN)50 Xb(Pint)e Fa(edgecolour)135 b Fq(edge)12 b(colour)e(index.)25 X734 y(IN)50 b(Pint)e Fa(bannercolou)o(r)104 b Fq(banner)11 Xb(colour)g(index.)25 784 y(IN)50 b(Pint)e Fa(boxtlcolour)139 Xb Fq(top-left)9 b(colour)i(index.)25 834 y(IN)50 b(Pint)e Fa(boxbrcolour)125 Xb Fq(bottom-right)8 b(colour)j(index.)0 903 y(This)k(function)f(sets)h(the)g X(attribute)f(values)h(of)g(a)h(rotator)e(menu.)27 b(The)16 Xb(arrows)f(are)h(drawn)f(within)e(a)j(box)f(similar)f(to)h(that)0 X953 y(of)d(box)f(menu)h(items)h(and)f(the)f(box)h(has)g(an)h(area)g(for)e(a) Vi X(title)e(string.)16 b(All)11 b(arrows)h(are)h(drawn)f(with)f(the)g(same)j X(colour)d(values)0 1003 y(de\256ned)h(by)f Fi(arrowcolour)i XFq(for)e(the)g(interior)e(and)j Fi(arrowedgecolour)i Fq(for)d(the)g(outline. V) Xp 1413 1100 454 2 v 1413 1179 2 80 v 1427 1154 a Fb(ptk_setrotatorti)o(tl)o X(e)p 1864 1179 V 1413 1181 454 2 v 0 1255 a Fq(void)f Fp(ptk_setr)o X(otatortitle)h Fq(\()g(Pint)g Fa(menuid)p Fq(,)f(Pchar)i(*)p XFa(titlestr)d Fq(\))25 1344 y(IN)50 b(Pint)108 b Fa(menuid)49 Xb Fq(menu)11 b(identi\256er)n(.)25 1394 y(IN)50 b(Pchar)11 Xb(*)50 b Fa(titlestr)70 b Fq(title)10 b(string)g(of)h(rotator)f(banner)n(.)0 X1469 y(This)15 b(function)f(sets)i(the)g(title)e(string)g(of)h(the)h(rotator V) Xe(menu)i(to)f(be)h Fi(titlestr)p Fq(.)29 b(The)16 b(string)f(is)g X(automatically)f(scaled)j(to)0 1519 y(\256t)11 b(in)g(the)g(rotator)f(title) Vg X(box.)p 1333 1616 533 2 v 1333 1695 2 80 v 1347 1669 a Fb X(ptk_stringscanmenus)p 1864 1695 V 1333 1697 533 2 v 0 1771 Xa Fq(ptkboolean)g Fp(ptk_stringscanmenus)i Fq(\()f(Pint)f Fa(wsid)p XFq(,)h(Pchar)h(*)p Fa(str)p Fq(,)f(Pint)g(*)p Fa(menuid)p Fq(,)f(Pint)g(*)p XFa(itemnum)h Fq(\))25 1860 y(IN)91 b(Pint)109 b Fa(wsid)94 Xb Fq(workstation)9 b(identi\256er)n(.)25 1909 y(IN)91 b(Pchar)12 Xb(*)50 b Fa(str)125 b Fq(string.)25 1959 y(OUT)50 b(Pint)10 Xb(*)78 b Fa(menuid)48 b Fq(menu)12 b(identi\256er)n(.)25 2009 Xy(OUT)50 b(Pint)10 b(*)78 b Fa(itemno)58 b Fq(item)11 b(number)n(.)0 X2078 y(This)k(function)e(compares)j(the)f(character)h(string)d XFi(str)j Fq(with)d(the)i(items)g(of)f(all)h(posted)f(menus.)27 Xb(The)15 b(comparison)g(begins)0 2128 y(with)10 b(the)h(highest)f(priority)f X(menu)i(and)g(works)g(through)e(to)i(the)g(back)g(menu.)16 Xb(User)11 b(menu)h(items)f(are)h(also)f(searched)h(for)f(text)0 X2178 y(primitives)g(with)g(which)h(to)g(compare)i(the)e(string.)17 Xb(The)d(comparison)e(is)g(case)i(sensitive)e(so)g(that)g("item)g(1")h(is)f X(not)g(the)g(same)0 2227 y(as)g("IteM)f(1".)k(The)d(function)e(returns)h X(TRUE)h(if)e(the)h(string)f(matches)j(a)f(menu)f(item,)h(otherwise)f(F)m X(ALSE.)p 1380 2325 487 2 v 1380 2404 2 80 v 1394 2378 a Fb(ptk_unpostallme)o X(nu)p 1864 2404 V 1380 2406 487 2 v 0 2480 a Fq(void)f Fp(ptk_unpostallmenu) Vg XFq(\()i(Pint)e Fa(wsid)h Fq(\))25 2569 y(IN)50 b(Pint)e Fa(wsid)95 Xb Fq(workstation)9 b(identi\256er)n(.)25 2618 y(IN)50 b(Pint)e XFa(menuid)h Fq(menu)11 b(identi\256er)n(.)0 2693 y(This)g(function)f(unposts V) Xg(all)h(menus)h(from)f(the)g(workstation)f Fi(wsid)p Fq(.)0 X2956 y(13th)22 b(May)m(,)12 b(1992)626 b(138)828 b(2.01)p eop X%%Page: 139 140 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1439 -19 427 2 v 1439 60 2 80 v 1454 35 a Fb(ptk_unpostmenu)p X1864 60 V 1439 62 427 2 v 0 136 a Fq(void)10 b Fp(ptk_unpostmenu)i XFq(\()f(Pint)f Fa(wsid)p Fq(,)h(Pint)g Fa(menuid)f Fq(\))25 X225 y(IN)50 b(Pint)e Fa(wsid)95 b Fq(workstation)9 b(identi\256er)n(.)25 X275 y(IN)50 b(Pint)e Fa(menuid)h Fq(menu)11 b(identi\256er)n(.)0 X350 y(This)16 b(function)f(unposts)g(a)i(menu)f(structure)g(from)g(the)g X(workstation)e Fi(wsid)p Fq(.)31 b(The)17 b(front)e(and)h(back)h(menus)g(are V) Xg(updated)0 400 y(if)11 b(necessary)m(.)0 2956 y(13th)22 b(May)m(,)12 Xb(1992)626 b(139)828 b(2.01)p eop X%%Page: 140 141 Xbop 0 349 a Fj(Chapter)24 b(23)0 585 y Fs(W)n(indow)29 b(functions)0 X855 y Fr(23.1)59 b(Data)17 b(types)54 1027 y Fi(typedef)i(enum)108 X1076 y(`7B)126 1126 y(PTKESTRUCTWINDOW,)126 1176 y(PTKETERMINALWINDOW,)126 X1226 y(PTKETOPOLOGYWINDOW,)126 1276 y(PTKECONTENTWINDOW)108 X1325 y(`7D)f(ptkewindowtype;)54 1425 y(typedef)h(enum)108 1475 Xy(`7B)126 1525 y(PTKEWINDOWBANNER,)126 1575 y(PTKEWINDOWFRAME,)126 X1624 y(PTKEWINDOWVIEW,)126 1674 y(PTKEWINDOWICON)108 1724 y(`7D)f X(ptkewindowarea;)54 1824 y(typedef)h(enum)108 1873 y(`7B)126 X1923 y(PTKEWINDOWOPEN,)126 1973 y(PTKEWINDOWCLOSED,)108 2023 Xy(`7D)f(ptkewindowstate;)54 2122 y(typedef)h(enum)108 2172 y(`7B)126 X2222 y(PTKECAMERAON,)126 2272 y(PTKECAMERAOFF,)108 2322 y(`7D)f X(ptkecamerastate;)54 2421 y(typedef)h(struct)108 2471 y(`7B)126 X2521 y(Pint)g(windowid;)126 2571 y(ptkewindowarea)i(windowarea;)126 X2621 y(boolean)e(measure;)126 2670 y(Ppoint)g(value;)108 2720 Xy(`7D)f(ptkswindowoutput;)902 2956 y Fq(140)p eop X%%Page: 141 142 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)0 177 y Fr(23.2)59 b(Functions)p 1426 268 440 2 v X1426 347 2 80 v 1440 322 a Fb(ptk_backwindow)p 1864 347 V 1426 X349 440 2 v 0 423 a Fq(void)10 b Fp(ptk_backwindow)h Fq(\()g(Pint)g XFa(windid)f Fq(\))25 523 y(IN)50 b(Pint)e Fa(windid)h Fq(window)10 Xb(identi\256er)n(.)0 623 y(This)16 b(function)f(sets)h(the)g(post)f(priority V) Xf(of)i(a)g(window)f(structure)h(so)g(that)f(it)g(is)h(displayed)g(behind)f X(all)g(the)h(other)g(posted)0 672 y(windows)10 b(and)i(menus.)p X1416 770 450 2 v 1416 849 2 80 v 1430 823 a Fb(ptk_clearterm)o(ina)o(l)p X1864 849 V 1416 851 450 2 v 0 925 a Fq(void)e Fp(ptk_clearterminal)h XFq(\()g(Pint)g Fa(windid)f Fq(\))25 1024 y(IN)50 b(Pint)e Fa(windid)h XFq(terminal)11 b(window)f(identi\256er)n(.)0 1124 y(This)h(function)f X(empties)i(the)f(structure)f(containing)g(all)h(the)g(text)g(written)f(to)h X(the)g(TERMINAL)h(window)m(.)p 1416 1221 V 1416 1300 2 80 v X1430 1275 a Fb(ptk_closewindow)p 1864 1300 V 1416 1302 450 X2 v 0 1376 a Fq(void)e Fp(ptk_closewindow)h Fq(\()g(Pint)g XFa(windid)f Fq(\))25 1476 y(IN)50 b(Pint)e Fa(windid)h Fq(window)10 Xb(identi\256er)n(.)0 1575 y(This)h(function)f(posts)h(the)g(icon)g(structure V) Xf(and)i(unposts)e(the)h(window)f(structure)h(from)g(the)g(window')n(s)f X(workstation.)p 1396 1673 470 2 v 1396 1752 2 80 v 1410 1726 Xa Fb(ptk_createwindow)p 1864 1752 V 1396 1754 470 2 v 0 1828 Xa Fq(void)g Fp(ptk_cr)o(eatewindow)i Fq(\()17 b(Pint)g Fa(wsid)p XFq(,)h(Pint)e Fa(windid)p Fq(,)j(Ppoint)c(*)p Fa(size)p Fq(,)j(Ppoint)d(*)p XFa(position)p Fq(,)423 1878 y(Pchar)d(*)p Fa(titlestring)d XFq(\))25 1928 y(IN)50 b(Pint)122 b Fa(wsid)e Fq(workstation)9 Xb(identi\256er)n(.)25 1978 y(IN)50 b(Pint)122 b Fa(windid)90 Xb Fq(window)10 b(identi\256er)n(.)25 2028 y(IN)50 b(Ppoint)9 Xb(*)50 b Fa(size)127 b Fq(window)10 b(size.)25 2078 y(IN)50 Xb(Ppoint)9 b(*)50 b Fa(position)67 b Fq(window)10 b(position.)25 X2128 y(IN)50 b(Pchar)11 b(*)64 b Fa(titlestring)47 b Fq(title)10 Xb(string.)0 2197 y(This)16 b(function)e(creates)j(a)g(window)d(structure)h X(which)h(may)g(be)g(used)g(for)g(viewing)e(PHIGS)i(structures,)h(PHIGS)f(T)m X(oolkit)0 2246 y(topology)8 b(diagrams)j(and)f(PHIGS)g(T)m(oolkit)f X(structure)h(content)f(diagrams.)16 b(A)10 b(terminal)g(window)f(type)h X(which)g(contains)f(only)0 2296 y(text.)20 b(The)14 b(window)e(size)i(and)f X(position)e(are)j(given)f(in)f(the)h(range)h(`5B0,)g(1`5D.)20 b(Each)15 Xb(window)d(has)h(a)h(virtual)e(camera)j(which)d(is)0 2346 y(useful)e(for)f X(moving)g(around)g(a)i(scene.)16 b(This)10 b(function)e(requires)i X(hashtables)g("structureid",)f("label",)h("name",)i("viewindex".)0 X2956 y(13th)22 b(May)m(,)12 b(1992)626 b(141)828 b(2.01)p eop X%%Page: 142 143 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1466 -19 401 2 v 1466 60 2 80 v 1480 35 a Fb(ptk_delwindow)p X1864 60 V 1466 62 401 2 v 0 136 a Fq(ptkboolean)10 b Fp(ptk_delwindow)g XFq(\()i(Pint)e Fa(windid)g Fq(\))25 236 y(IN)50 b(Pint)e Fa(windid)h XFq(window)10 b(identi\256er)n(.)0 335 y(This)h(function)f(deletes)i(a)g X(window)e(from)h(the)g(PHIGS)g(T)m(oolkit)f(window)g(store.)p X1423 432 444 2 v 1423 512 2 80 v 1437 486 a Fb(ptk_frontwindow)p X1864 512 V 1423 514 444 2 v 0 588 a Fq(void)g Fp(ptk_fr)o(ontwindow)h XFq(\()g(Pint)g Fa(windid)f Fq(\))25 687 y(IN)50 b(Pint)e Fa(windid)h XFq(window)10 b(identi\256er)n(.)0 787 y(This)15 b(function)f(sets)i(the)f X(post)g(priority)e(of)i(the)g(window)f(structure)h(so)g(that)g(it)g(is)g X(displayed)f(on)h(top)g(of)g(all)g(other)g(posted)0 837 y(windows)10 Xb(but)h(has)h(a)f(lower)g(prioity)e(than)i(the)g(current)g(back)h(menu.)p X1343 934 523 2 v 1343 1013 2 80 v 1357 988 a Fb(ptk_inqbannerheigh)o(t)p X1864 1013 V 1343 1015 523 2 v 0 1089 a Fq(void)e Fp(ptk_inqbannerheight)i XFq(\()f(Pint)f Fa(windid)p Fq(,)h(P\257oat)g(*)p Fa(bannerheigh)o(t)p XFq(,)e(Pint)h(*)p Fa(err)g Fq(\))25 1178 y(IN)91 b(Pint)111 Xb Fa(windid)155 b Fq(window)10 b(identi\256er)n(.)25 1228 y(OUT)50 Xb(P\257oat)11 b(*)50 b Fa(bannerheig)o(ht)d Fq(height)10 b(of)h(banner)n(.)2 V5 X1277 y(OUT)50 b(Pint)10 b(*)80 b Fa(err)212 b Fq(error)11 b(indicator)n(.)0 X1346 y(This)k(function)f(may)i(be)f(used)h(to)f(obtain)f(the)h(height)f(of)h X(a)h(window)e(banner)n(.)27 b(It)15 b(is)g(returned)g(in)f(the)i(range)f(`5B V0,) Xh(1`5D.)28 b(The)0 1396 y(error)11 b(code)h(=)g(1)f(if)g Fi(windid)h XFq(doesn')o(t)f(exist.)p 1400 1493 467 2 v 1400 1572 2 80 v X1414 1547 a Fb(ptk_inqbannerti)o(tl)o(e)p 1864 1572 V 1400 X1574 467 2 v 0 1648 a Fq(void)f Fp(ptk_inqbannertitle)h Fq(\()e(Pint)f XFa(windid)p Fq(,)h(Pint)g Fa(len)p Fq(,)g(Pchar)h(*)p Fa(titlestr)p XFq(,)e(Pint)g(*)p Fa(totlen)p Fq(,)g(Pint)g(*)p Fa(err)431 X1698 y Fq(\))25 1749 y(IN)91 b(Pint)109 b Fa(windid)48 b Fq(window)11 Xb(identi\256er)n(.)25 1798 y(IN)91 b(Pint)109 b Fa(len)101 Xb Fq(length)11 b(of)g(string.)25 1848 y(IN)91 b(Pchar)12 b(*)50 Xb Fa(titlestr)j Fq(title)10 b(string)g(of)h(banner)n(.)25 1898 Xy(OUT)50 b(Pint)10 b(*)78 b Fa(totlen)61 b Fq(actual)12 b(length)e(of)h X(string.)25 1948 y(OUT)50 b(Pint)10 b(*)78 b Fa(err)105 b Fq(error)11 Xb(indicator)n(.)0 2017 y(This)g(function)f(may)i(be)f(used)h(to)f(obtain)f X(the)h(title)f(of)h(a)h(window)m(.)j(The)d(error)f(code)g(=)h(1)f(if)g XFi(windid)i Fq(doesn')o(t)d(exist.)p 1346 2114 520 2 v 1346 +-+-+-+-+-+-+-+- END OF PART 119 +-+-+-+-+-+-+-+-