-+-+-+-+-+-+-+-+ START OF PART 116 -+-+-+-+-+-+-+-+ Xb(identi\256er)n(.)25 2427 y(IN)91 b(Pint)81 b Fa(root)64 b XFq(structure)11 b(network)f(identi\256er)n(.)25 2477 y(OUT)50 Xb(Pint)10 b(*)50 b Fa(error)g Fq(error)11 b(code.)0 2546 y(This)k(function)f X(creates)i(a)g(diagram)g(of)e(the)i(structure)e(network)g(speci\256ed)i(by)f XFi(root)p Fq(.)28 b(The)16 b(diagram)g(is)f(a)g(PHIGS)h(struc-)0 X2596 y(ture)c(which)g(uses)i(boxes)e(connected)h(by)f(lines)g(to)g(represent V) Xh(structures)f(and)h(EXECUTE)h(STRUCTURE)f(elements.)20 b(The)0 X2645 y(error)11 b(code)g(=)h(1)f(if)g(the)f(root)h(structure)f(does)h(not)f X(exist)h(and)g(=)h(2)f(if)f Fi(topid)i Fq(already)g(exists.)j(This)c X(function)e(requires)i(hashta-)0 2695 y(bles)g("structureid",)f("label",)i X("name".)902 2956 y(123)p eop X%%Page: 124 125 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1250 -19 616 2 v 1250 60 2 80 v 1264 35 a Fb(ptk_createtopol)o X(ogypa)o(ths)p 1864 60 V 1250 62 616 2 v 0 136 a Fq(void)10 Xb Fp(ptk_cr)o(eatetopologypaths)h Fq(\()g(Pint)g Fa(topid)p XFq(,)f(Pexecre\257stlst)i(*)p Fa(paths)p Fq(,)e(Pint)g(*)p XFa(error)g Fq(\))25 225 y(IN)91 b(Pint)235 b Fa(topid)59 b XFq(topology)9 b(identi\256er)n(.)25 275 y(IN)91 b(Pexecre\257stlst)12 Xb(*)49 b Fa(paths)g Fq(structure-element)10 b(paths.)25 324 Xy(OUT)50 b(Pint)10 b(*)204 b Fa(error)61 b Fq(error)11 b(code.)0 X393 y(This)i(function)e(creates)j(a)f(topology)e(diagram)h(using)g(the)h X(structure)f(path)g(list)g Fi(paths)p Fq(.)20 b(This)13 b(enables)g(a)h X(topology)c(diagram)0 443 y(to)h(be)h(built)e(of)i(a)g(non-existent)e X(structure)i(network)f(or)g(of)h(a)g(subset)g(of)f(an)h(actual)g(structure)g X(network.)k(The)c(error)g(code)g(=)g(1)0 493 y(if)f Fi(topid)h XFq(already)g(exists.)j(This)c(function)f(requires)h(hashtables)g X("structureid",)f("label",)i("name".)p 1446 590 421 2 v 1446 X669 2 80 v 1460 644 a Fb(ptk_deltopology)p 1864 669 V 1446 X671 421 2 v 0 745 a Fq(ptkboolean)e Fp(ptk_deltopology)f Fq(\()j(Pint)e XFa(topid)g Fq(\))25 845 y(IN)50 b(Pint)e Fa(topid)h Fq(topology)9 Xb(identi\256er)n(.)0 945 y(This)h(function)g(deletes)h(a)g(topology)d X(diagram)j(from)f(the)g(PHIGS)h(T)m(oolkit)e(topology)f(store.)15 Xb(The)d(function)d(returns)h(TRUE)h(if)0 994 y(a)h(topology)d(is)i(deleted,) Vh X(otherwise)e(F)m(ALSE.)p 1346 1091 520 2 v 1346 1171 2 80 v X1360 1145 a Fb(ptk_inqnodeposition)p 1864 1171 V 1346 1173 X520 2 v 0 1247 a Fq(void)g Fp(ptk_inqnodeposition)g Fq(\()h(Pint)g XFa(topid)p Fq(,)f(Pint)g Fa(structid)p Fq(,)g(Ppoint)g(*)p XFa(nodept)p Fq(,)f(Pint)h(*)p Fa(err)h Fq(\))25 1335 y(IN)91 Xb(Pint)122 b Fa(topid)86 b Fq(topology)9 b(identi\256er)n(.)25 X1385 y(IN)91 b(Pint)122 b Fa(structid)48 b Fq(structure)11 Xb(identi\256er)n(.)25 1435 y(OUT)50 b(Ppoint)10 b(*)49 b Fa(nodept)54 Xb Fq(node)11 b(position.)25 1485 y(OUT)50 b(Pint)10 b(*)91 Xb Fa(err)120 b Fq(error)11 b(indicator)n(.)0 1554 y(This)k(function)e(may)i X(be)h(used)f(to)f(obtain)g(the)g(position)f(of)h(a)i(topology)c(node)j(in)f X(a)i(topology)c(diagram.)26 b(The)16 b(position)c(is)0 1604 Xy(returned)e(in)g(the)h(range)g(`5B0,)g(1`5D.)k(The)d(node)e(is)h(speci\256e Vd)g X(using)f(the)h(structure)f(identi\256er)g(of)g(the)h(structure)f(that)g(it)g X(represents.)0 1653 y(The)i(error)f(code)h(=)g(1)f(if)g Fi(topid)h XFq(doesn')o(t)f(exist)g(and)g(=)h(2)f(if)g Fi(structid)h Fq(is)g(not)e(a)i X(node)f(in)g(the)g(topology)m(.)p 1250 1751 617 2 v 1250 1830 X2 80 v 1264 1804 a Fb(ptk_inqpostedtopologi)o(es)p 1864 1830 XV 1250 1832 617 2 v 0 1906 a Fq(void)f Fp(ptk_inqpostedtopologies)g XFq(\()j(Pint)e Fa(wsid)p Fq(,)j(Pint)d Fa(size)p Fq(,)i(Pintlst)e(*)p XFa(topids)p Fq(,)g(Pint)h(*)p Fa(totalsize)p Fq(,)f(Pint)528 X1956 y(*)p Fa(err)f Fq(\))25 2006 y(IN)91 b(Pint)120 b Fa(wsid)108 Xb Fq(workstation)10 b(identi\256er)n(.)25 2056 y(IN)91 b(Pint)120 Xb Fa(size)115 b Fq(size)12 b(of)f(buf)o(fer)n(.)25 2106 y(OUT)50 Xb(Pintlst)10 b(*)49 b Fa(topids)83 b Fq(list)11 b(of)g(posted)f(topologies.) X25 2155 y(OUT)50 b(Pint)10 b(*)89 b Fa(totalsize)47 b Fq(length)11 Xb(of)g(posted)f(topologies)g(list.)25 2205 y(OUT)50 b(Pint)10 Xb(*)89 b Fa(err)135 b Fq(error)11 b(indicator)n(.)0 2274 y(This)k(function)f X(may)i(be)g(used)g(to)f(obtain)f(a)i(list)e(of)h(all)h(the)f(topology)e X(diagrams)j(which)f(are)h(posted)f(to)g(the)g(workstation)0 X2324 y Fi(wsid)p Fq(.)0 2956 y(13th)22 b(May)m(,)12 b(1992)626 Xb(124)828 b(2.01)p eop X%%Page: 125 126 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1340 -19 527 2 v 1340 60 2 80 v 1354 35 a Fb(ptk_inqtopologyat)o X(trs)p 1864 60 V 1340 62 527 2 v 0 136 a Fq(void)10 b Fp X(ptk_inqtopologyattrs)f Fq(\()14 b(Pint)f Fa(topid)p Fq(,)g(Pint)g(*)p XFa(txfont)p Fq(,)g(Pint)g(*)p Fa(linecol)p Fq(,)g(Pint)g(*)p XFa(textcol)p Fq(,)f(Pint)470 186 y(*)p Fa(edgecol)p Fq(,)e(Pint)g(*)p XFa(intcol)p Fq(,)h(Pint)f(*)p Fa(htedgecol)p Fq(,)f(Pint)i(*)p XFa(htintcol)p Fq(,)e(Pint)470 236 y(*)p Fa(err)i Fq(\))25 286 Xy(IN)91 b(Pint)81 b Fa(topid)125 b Fq(topology)9 b(identi\256er)n(.)25 X336 y(OUT)50 b(Pint)10 b(*)50 b Fa(txfont)115 b Fq(label)11 Xb(text)g(font.)25 386 y(OUT)50 b(Pint)10 b(*)50 b Fa(linecol)101 Xb Fq(polyline)9 b(colour)i(index.)25 436 y(OUT)50 b(Pint)10 Xb(*)50 b Fa(textcol)99 b Fq(text)10 b(colour)h(index.)25 485 Xy(OUT)50 b(Pint)10 b(*)50 b Fa(edgecol)77 b Fq(edge)12 b(colour)e(index.)25 X535 y(OUT)50 b(Pint)10 b(*)50 b Fa(intcol)119 b Fq(interior)9 Xb(colour)i(index.)25 585 y(OUT)50 b(Pint)10 b(*)50 b Fa(htedgecol)d XFq(highlight)8 b(edge)k(colour)e(index.)25 635 y(OUT)50 b(Pint)10 Xb(*)50 b Fa(htintcol)89 b Fq(highlight)8 b(interior)i(colour)g(index.)25 X685 y(OUT)50 b(Pint)10 b(*)50 b Fa(err)159 b Fq(error)11 b(indicator)n(.)0 X754 y(This)j(function)f(may)i(be)g(used)f(to)g(obtain)f(the)h(text)g(font)f X(and)i(colour)e(attribute)g(values)h(of)g(a)h(topology)d(diagram.)25 Xb(The)15 b(er)o(-)0 803 y(ror)c(code)h(=)f(1)h(if)e Fi(topid)j XFq(doesn')o(t)e(exist.)p 1111 901 756 2 v 1111 980 2 80 v 1125 X954 a Fb(ptk_inqtopologyhi)o(ghli)o(ghtnod)o(e)p 1864 980 V X1111 982 756 2 v 0 1056 a Fq(void)f Fp(ptk_inqtopologyhighli)o(ghtnode)f XFq(\()i(Pint)f Fa(topid)p Fq(,)h(Pint)f(*)p Fa(topnodestid)o XFq(,)f(Pint)h(*)p Fa(err)h Fq(\))25 1145 y(IN)91 b(Pint)81 Xb Fa(topid)154 b Fq(topology)9 b(identi\256er)n(.)25 1194 y(OUT)50 Xb(Pint)10 b(*)50 b Fa(topnodestid)c Fq(topology)9 b(node)i(structure)g X(identi\256er)n(.)25 1244 y(OUT)50 b(Pint)10 b(*)50 b Fa(err)188 Xb Fq(error)11 b(indicator)n(.)0 1313 y(This)k(function)f(may)i(be)f(used)h X(to)e(obtain)h(the)g(structure)f(identi\256er)h(of)g(the)g(currently)f X(highlighted)e(topology)h(node.)28 b(The)0 1363 y(error)11 Xb(code)h(=)g(1)f(if)g Fi(topid)h Fq(doesn')o(t)f(exist)g(and)g(=)h(2)f(if)g X(there)g(is)g(no)g(highlighted)e(node.)p 1373 1460 494 2 v X1373 1539 2 80 v 1387 1514 a Fb(ptk_inqtopologyids)p 1864 1539 XV 1373 1541 494 2 v 0 1615 a Fq(void)h Fp(ptk_inqtopologyids)f XFq(\()i(Pint)g Fa(size)p Fq(,)f(Pintlst)g(*)p Fa(topids)p Fq(,)f(Pint)i(*)p XFa(totalsize)p Fq(,)e(Pint)h(*)p Fa(err)g Fq(\))25 1704 y(IN)91 Xb(Pint)120 b Fa(size)115 b Fq(size)12 b(of)f(buf)o(fer)n(.)25 X1754 y(OUT)50 b(Pintlst)10 b(*)49 b Fa(topids)83 b Fq(list)11 Xb(of)g(topology)e(identi\256ers.)25 1804 y(OUT)50 b(Pint)10 Xb(*)89 b Fa(totalsize)47 b Fq(length)11 b(of)g(topology)e(identi\256ers)h X(list.)25 1853 y(OUT)50 b(Pint)10 b(*)89 b Fa(err)135 b Fq(error)11 Xb(indicator)n(.)0 1922 y(This)g(function)f(may)i(be)f(used)h(to)f(obtain)f(a V) Xi(list)e(of)h(all)g(the)g(topology)e(diagrams)j(in)e(the)h(PHIGS)h(T)m X(oolkit)e(topology)f(store.)p 1313 2019 553 2 v 1313 2099 2 X80 v 1327 2073 a Fb(ptk_inqtopologynam)o(e)p 1864 2099 V 1313 X2101 553 2 v 0 2175 a Fq(void)h Fp(ptk_inqtopologyname)f Fq(\()i(Pint)g XFa(topid)p Fq(,)f(Pint)g(*)p Fa(name)p Fq(,)h(Pint)f(*)p Fa(err)h XFq(\))25 2263 y(IN)91 b(Pint)81 b Fa(topid)60 b Fq(topology)9 Xb(identi\256er)n(.)25 2313 y(OUT)50 b(Pint)10 b(*)50 b Fa(name)f XFq(topology)9 b(name)j(for)f(nameset)i(\256lters.)25 2363 y(OUT)50 Xb(Pint)10 b(*)50 b Fa(err)94 b Fq(error)11 b(indicator)n(.)0 X2432 y(This)k(function)f(may)h(be)h(used)f(to)f(obtain)g(the)h(topology)e X(name)j(for)f(use)g(in)g(the)g(pick)f(\256lter)n(.)27 b(When)15 Xb(a)h(topology)c(name)k(is)0 2482 y(added)c(to)e(the)h(pick)g(\256lter)g X(only)f(the)h(topology)f(nodes)h(are)h(pickable.)j(The)d(error)f(code)h(=)g X(1)f(if)g Fi(topid)h Fq(doesn')o(t)f(exist.)0 2956 y(13th)22 Xb(May)m(,)12 b(1992)626 b(125)828 b(2.01)p eop X%%Page: 126 127 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1263 -19 603 2 v 1263 60 2 80 v 1277 35 a Fb X(ptk_inqtopologystructi)o(d)p 1864 60 V 1263 62 603 2 v 0 136 Xa Fq(void)10 b Fp(ptk_inqtopologystructid)g Fq(\()h(Pint)f XFa(topid)p Fq(,)h(Pint)f(*)p Fa(topstid)p Fq(,)f(Pint)i(*)p XFa(err)f Fq(\))25 225 y(IN)91 b(Pint)81 b Fa(topid)76 b Fq(topology)9 Xb(identi\256er)n(.)25 275 y(IN)91 b(Pint)10 b(*)50 b Fa(topstid)e XFq(topology)9 b(structure)h(identi\256er)n(.)25 324 y(OUT)50 Xb(Pint)10 b(*)50 b Fa(err)110 b Fq(error)11 b(indicator)n(.)0 X393 y(This)16 b(function)f(may)i(be)f(used)h(to)f(obtain)f(the)h(structure)f X(identi\256er)h(of)g(the)g(topology)e(diagram)i Fi(topid)p XFq(.)32 b(In)16 b(the)g(case)i(of)0 443 y(the)12 b(BOX)h(topology)d(type)i X(the)g(diagram)h(is)f(a)i(single)d(PHIGS)i(structure)f(but)g(for)g(STRUCT)g X(and)h(STRUCTNET)g(type)g(dia-)0 493 y(grams)f(it)e(is)h(a)h(structure)f X(network.)k(The)d(error)f(code)g(=)h(1)f(if)g Fi(topid)h Fq(doesn')o(t)f X(exist.)p 1340 590 527 2 v 1340 669 2 80 v 1354 644 a Fb(ptk_inqtopologytyp) Vo X(e)p 1864 669 V 1340 671 527 2 v 0 745 a Fq(void)f Fp(ptk_inqtopologytype)f XFq(\()j(Pint)e Fa(topid)p Fq(,)g(ptketopologytyp)o(e)f(*)p XFa(toptype)p Fq(,)h(Pint)g(*)p Fa(err)g Fq(\))25 834 y(IN)91 Xb(Pint)305 b Fa(topid)87 b Fq(topology)9 b(identi\256er)n(.)25 X884 y(OUT)50 b(ptketopologyty)o(pe)9 b(*)50 b Fa(toptype)d XFq(topology)9 b(type.)25 934 y(OUT)50 b(Pint)10 b(*)274 b Fa(err)121 Xb Fq(error)11 b(indicator)n(.)0 1003 y(This)f(function)f(may)i(be)g(used)g X(to)f(obtain)f(the)i(type)f(of)g(a)h(topology)d(diagram.)15 Xb(The)d(possible)d(types)i(are)g(BOX,)f(STRUCT)h(and)0 1052 Xy(STRUCTNET)m(,)i(with)d(BOX)h(as)h(the)f(default.)k(The)d(error)f(code)h(=) Vg X(1)f(if)f Fi(topid)j Fq(doesn')o(t)e(exist.)p 1419 1150 447 X2 v 1419 1229 2 80 v 1434 1203 a Fb(ptk_posttopology)p 1864 X1229 V 1419 1231 447 2 v 0 1305 a Fq(void)f Fp(ptk_posttopology)f XFq(\()j(Pint)e Fa(wsid)p Fq(,)h(Pint)g Fa(topid)p Fq(,)f(P\257oat)h XFa(priority)f Fq(\))25 1394 y(IN)50 b(Pint)78 b Fa(wsid)85 Xb Fq(workstation)9 b(identi\256er)n(.)25 1443 y(IN)50 b(Pint)78 Xb Fa(topid)g Fq(topology)9 b(identi\256er)n(.)25 1493 y(IN)50 Xb(P\257oat)f Fa(priority)f Fq(display)10 b(priority)m(.)0 1562 Xy(This)h(function)f(posts)h(a)h(topology)d(diagram)i(structure)g(to)f(the)i X(workstation)d Fi(wsid)p Fq(.)p 1207 1659 660 2 v 1207 1738 X2 80 v 1221 1713 a Fb(ptk_restoretopologyl)o(ayou)o(t)p 1864 X1738 V 1207 1740 660 2 v 0 1814 a Fq(void)h Fp(ptk_r)o(estor)o X(etopologylayout)g Fq(\()i(FILE)g(*)p Fa(\256leptr)p Fq(,)d(Pint)i XFa(topid)f Fq(\))25 1903 y(OUT)50 b(FILE)12 b(*)50 b Fa(\256leptr)e XFq(pointer)10 b(to)g(\256le.)25 1953 y(IN)91 b(Pint)102 b Fa(topid)58 Xb Fq(topology)9 b(identi\256er)n(.)0 2028 y(This)i(function)e(reads)i(a)h X(topology)c(layout)i(from)g(a)h(text)f(\256le.)16 b(The)11 Xb(layout)f(is)g(used)h(to)f(reposition)f(the)i(nodes)g(of)f(the)h(topology)0 X2078 y(diagram)g Fi(topid)i Fq(but)d(will)g(only)g(really)h(make)i(sense)f X(if)f(the)g(layout)f(was)i(stored)f(originally)e(from)i(the)g(same)i X(topology)m(.)0 2956 y(13th)22 b(May)m(,)12 b(1992)626 b(126)828 Xb(2.01)p eop X%%Page: 127 128 Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235 Xb(PTK/100)p 1356 -19 510 2 v 1356 60 2 80 v 1370 35 a Fb(ptk_setnodeposition V) Xp 1864 60 V 1356 62 510 2 v 0 136 a Fq(void)10 b Fp(ptk_setnodeposition)h XFq(\()16 b(Pint)f Fa(topid)p Fq(,)g(Pint)g Fa(structid)p Fq(,)h(Ppoint)e(*)p XFa(nodept)p Fq(,)h(ptkenodetype)452 186 y Fa(nodetype)8 b Fq(\))25 X237 y(IN)50 b(Pint)205 b Fa(topid)117 b Fq(topology)9 b(identi\256er)n(.)25 X287 y(IN)50 b(Pint)205 b Fa(structid)79 b Fq(structure)11 b(identi\256er)n(. V) X25 336 y(IN)50 b(Ppoint)9 b(*)133 b Fa(nodept)85 b Fq(node)11 Xb(position.)25 386 y(IN)50 b(ptkenodetype)e Fa(nodetype)f Fq(type)11 Xb(of)g(node.)0 455 y(This)k(function)e(sets)j(the)f(position)e(of)h(a)i X(topology)d(node)i(or)f(group)g(of)h(nodes.)27 b(The)15 b(position)e(is)i X(given)g(in)f(the)h(range)g(`5B0,)0 505 y(1`5D.)23 b(The)15 b(node)e(is)h X(speci\256ed)h(using)e(the)g(structure)h(identi\256er)e(of)i(the)g(structure V) Xf(that)g(it)g(represents.)24 b(If)14 b(nodetype)f(is)h(set)g(to)0 X555 y(GROUP)d(then)g(all)g(descendent)h(nodes)f(of)g Fi(structid)i XFq(are)f(moved)f(relative)g(to)g(it.)p 1350 652 517 2 v 1350 X731 2 80 v 1364 706 a Fb(ptk_settopologyat)o(trs)p 1864 731 XV 1350 733 517 2 v 0 807 a Fq(void)f Fp(ptk_settopologyattrs)g XFq(\()20 b(Pint)f Fa(topid)p Fq(,)i(Pint)e Fa(txfont)p Fq(,)i(Pint)e XFa(linecol)p Fq(,)i(Pint)e Fa(textcol)p Fq(,)i(Pint)461 857 Xy Fa(edgecol)p Fq(,)9 b(Pint)i Fa(intcol)p Fq(,)f(Pint)g Fa(htedgecol)p XFq(,)f(Pint)h Fa(htintcol)f Fq(\))25 908 y(IN)50 b(Pint)e Fa(topid)125 Xb Fq(topology)9 b(identi\256er)n(.)25 958 y(IN)50 b(Pint)e XFa(txfont)115 b Fq(label)11 b(text)g(font.)25 1007 y(IN)50 Xb(Pint)e Fa(linecol)101 b Fq(polyline)10 b(colour)g(index.)25 X1057 y(IN)50 b(Pint)e Fa(textcol)99 b Fq(text)11 b(colour)f(index.)25 X1107 y(IN)50 b(Pint)e Fa(edgecol)77 b Fq(edge)12 b(colour)e(index.)25 X1157 y(IN)50 b(Pint)e Fa(intcol)119 b Fq(interior)10 b(colour)g(index.)25 X1207 y(IN)50 b(Pint)e Fa(htedgecol)f Fq(highlight)8 b(edge)k(colour)f(index. V) X25 1256 y(IN)50 b(Pint)e Fa(htintcol)89 b Fq(highlight)8 b(interior)i(colour V) Xh(index.)0 1325 y(This)16 b(function)f(sets)i(the)f(text)g(font)f(and)i X(colour)e(attribute)g(values)i(of)f(a)h(topology)d(diagram.)31 Xb(The)17 b(text)e(font)h(applies)g(to)0 1375 y(the)11 b(structure)g(names)h X(which)f(are)h(extracted)g(from)f(the)h(\310)-15 b(structureid)1011 X1365 y(\310)1008 1375 y(hashtable.)14 b(The)e(highlight)c(colour)j(indicies) Vf X(are)i(used)g(to)0 1425 y(highlight)c(a)k(single)f(topology)e(node)i(in)g X(the)g(function)f Fi(ptk_settopologyhighlight)q(node)p Fq(.)p X1121 1522 746 2 v 1121 1601 2 80 v 1135 1576 a Fb(ptk_settopologyhi)o(ghli)o X(ghtnod)o(e)p 1864 1601 V 1121 1603 746 2 v 0 1677 a Fq(void)g XFp(ptk_settopologyhighlightnode)f Fq(\()i(Pint)f Fa(topid)p XFq(,)g(Pint)h Fa(topnodestid)d Fq(\))25 1766 y(IN)50 b(Pint)e XFa(topid)154 b Fq(topology)10 b(identi\256er)n(.)25 1816 y(IN)50 Xb(Pint)e Fa(topnodestid)e Fq(topology)10 b(node)h(structure)f(identi\256er)n +-+-+-+-+-+-+-+- END OF PART 116 +-+-+-+-+-+-+-+-