-+-+-+-+-+-+-+-+ START OF PART 115 -+-+-+-+-+-+-+-+
Xb(function)d(using)g(a)i Fi(Ppoint)h Fq(datatype)e(instead)g(of)g
XFi(Pvector)p Fq(.)p 1469 491 397 2 v 1469 570 2 80 v 1483 544
Xa Fb(ptk_ptranslate3)p 1864 570 V 1469 572 397 2 v 0 646 a
XFq(void)f Fp(ptk_ptranslate3)h Fq(\()g(Ppoint3)f(*)p Fa(tranpt)p
XFq(,)g(Pint)g(*)p Fa(err)p Fq(,)h(Pmatrix3)f Fa(mat)h Fq(\))25
X735 y(IN)91 b(Ppoint3)10 b(*)49 b Fa(tranpt)f Fq(translation)10
Xb(vector)n(.)25 784 y(OUT)50 b(Pint)10 b(*)112 b Fa(err)96
Xb Fq(error)11 b(indicator)n(.)25 834 y(OUT)50 b(Pmatrix3)58
Xb Fa(mat)81 b Fq(4x4)11 b(matrix.)0 903 y(This)g(function)f(performs)h(the)g
X(TRANSLA)-5 b(TE3)13 b(function)d(using)g(a)i Fi(Ppoint3)h
XFq(datatype)e(instead)g(of)g Fi(Pvector3)p Fq(.)0 2956 y(13th)22
Xb(May)m(,)12 b(1992)627 b(1)n(17)829 b(2.01)p eop
X%%Page: 118 119
Xbop 0 349 a Fj(Chapter)24 b(19)0 585 y Fs(Phinter)29 b(functions)p
X1476 800 391 2 v 1476 879 2 80 v 1490 854 a Fb(ptk_callphinte)o(r)p
X1864 879 V 1476 881 391 2 v 0 956 a Fq(void)10 b Fp(ptk_callphinter)h
XFq(\()g(void)22 b(\))0 1105 y(This)15 b(function)f(provides)h(an)g(interface
V)
Xh(to)f(phinter)f(and)h(its)g(related)h(functions.)26 b(The)16
Xb(available)g(commands)g(are)g(as)g(fol-)0 1155 y(lows:)0 1238
Xy Fp(help)21 b Fq(output)9 b(this)i(list.)0 1321 y Fp(interactive)21
Xb Fq(call)11 b(phinter)f(with)g(stdin)h(for)f(input)g(script.)0
X1404 y Fp(stringinput)20 b Fq(call)11 b(phinter)g(using)f(string)g(device)i
X(for)e(input)g(and)i(terminal)e(windows)h(for)f(output.)0 1487
Xy Fp(r)o(ead)22 b Fq(call)11 b(phinter)f(with)g(a)i(given)f(input)f(script.)
V0
X1570 y Fp(output\256le)20 b Fq(set)12 b(output)e(script)g(\256lename.)0
X1653 y Fp(inform\256le)20 b Fq(set)12 b(information)d(\256lename.)0
X1736 y Fp(outputterm)21 b Fq(set)11 b(output)f(terminal)g(window)h
X(identi\256er)n(.)0 1819 y Fp(informterm)20 b Fq(set)12 b(information)d
X(terminal)i(window)f(identi\256er)n(.)0 1902 y Fp(writestruct)22
Xb Fq(write)10 b(contents)h(of)g(structures)g(to)g(output)e(\256le.)0
X1985 y Fp(writestruct)22 b Fq(write)10 b(contents)h(of)g(structure)g
X(networks)f(to)h(output)f(\256le.)0 2068 y Fp(writestruct)22
Xb Fq(write)10 b(contents)h(of)g(all)g(structures)g(to)g(output)e(\256le.)0
X2151 y Fp(quit)i(or)h(exit)20 b Fq(leave)12 b(callphinter)n(.)903
X2956 y(1)n(18)p eop
X%%Page: 119 120
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_elemco)o(nten)o
X(t)p 1864 60 V 1439 62 427 2 v 0 136 a Fq(ptkboolean)10 b Fp(ptk_elemcontent
V)
Xh Fq(\()h(Pint)e Fa(stid)p Fq(,)h(Pint)f Fa(elemid)p Fq(,)h(Pint)f
XFa(termid)p Fq(,)h(Pint)f(*)p Fa(error)g Fq(\))25 225 y(IN)91
Xb(Pint)83 b Fa(stid)98 b Fq(structure)11 b(identi\256er)n(.)25
X275 y(IN)91 b(Pint)83 b Fa(elemid)49 b Fq(element)12 b(number)n(.)25
X324 y(IN)91 b(Pint)83 b Fa(termid)55 b Fq(terminal)11 b(window)f
X(identi\256er)n(.)25 374 y(OUT)50 b(PInt)11 b(*)49 b Fa(error)78
Xb Fq(error)11 b(code.)0 443 y(This)k(function)f(writes)h(the)h(contents)f(of
V)
Xg(an)h(element)g(in)e(a)j(terminal)d(window)m(.)28 b(If)15
Xb(the)g(element)h(is)f(an)h(output)e(primitive)0 493 y(then)c(it)g(is)g
X(inserted)g(into)f(the)i(currently)e(open)h(structure)g(at)h(the)f(current)g
X(editing)f(position)g(and)h(the)h(function)d(returns)i(TRUE,)0
X543 y(otherwise)h(F)m(ALSE.)p 1562 640 304 2 v 1562 719 2 80
Xv 1576 694 a Fb(ptk_phinter)p 1864 719 V 1562 721 304 2 v 0
X795 a Fq(void)f Fp(ptk_phinter)i Fq(\()f(FILE)h(*)p Fa(input)p
XFq(,)e(FILE)i(*)p Fa(output)p Fq(,)e(FILE)i(*)p Fa(inform)e
XFq(\))25 884 y(IN)91 b(FILE)12 b(*)50 b Fa(input)70 b Fq(\256le)11
Xb(pointer)f(for)h(input)f(script.)25 934 y(OUT)50 b(FILE)12
Xb(*)50 b Fa(output)e Fq(\256le)11 b(pointer)f(for)h(output)e(script.)25
X984 y(OUT)50 b(FILE)12 b(*)50 b Fa(inform)f Fq(\256le)11 b(pointer)f(for)h
X(information)e(such)j(as)g(results)f(of)g(inquiry)e(calls..)0
X1052 y(This)16 b(function)e(reads)j(a)g(PHIGS)f(script)f(from)h(a)h(\256le)f
X(or)g(from)g(standard)f(input.)28 b(If)16 b Fi(stdin)h Fq(is)f(passed)h(as)g
X(the)f(input)e(\256le)0 1102 y(pointer)d(then)g(phinter)g(becomes)i
X(interactive)e(and)h(prompts)f(are)h(given)g(for)f(function)f(parameters.)19
Xb(The)12 b(other)f(\256le)h(pointers)0 1152 y(are)g(used)g(for)e(writing)g
X(an)h(output)f(script)h(and)g(for)g(writing)e(data)j(which)e(results)h(from)
Vg
X(inquiry)f(calls)h(and)h(so)f(on.)p 1513 1249 354 2 v 1513
X1328 2 80 v 1527 1303 a Fb(ptk_readelem)p 1864 1328 V 1513
X1330 354 2 v 0 1404 a Fq(void)f Fp(ptk_r)o(eadelem)i Fq(\()g(Pint)e
XFa(ws)p Fq(,)i(Plimit)e(*)p Fa(echoarea)p Fq(,)e(Peltype)j
XFa(eltype)f Fq(\))25 1493 y(IN)50 b(Pint)115 b Fa(wsid)137
Xb Fq(workstation)9 b(identi\256er)n(.)25 1543 y(IN)50 b(Plimit)9
Xb(*)50 b Fa(echo)9 b(area)49 b Fq(echo)12 b(area)g(for)f(string)f(device.)25
X1593 y(IN)50 b(Peltype)58 b Fa(eltype)112 b Fq(element)12 b(type)e(to)h(read
V)
Xh(in.)0 1662 y(This)i(function)e(reads)i(the)g(contents)f(of)g(a)i(PHIGS)f
X(element)g(from)f(the)h(PHIGS)g(string)e(device)i(\(number)g(1\).)22
Xb(Prompts)13 b(are)0 1712 y(given)f(for)h(the)f(required)h(data)g(depending)
Vf
X(on)g(the)h(element)g(type.)20 b(An)13 b(element)g(with)f(the)g(input)g(data
V)
Xh(is)f(inserted)h(into)e(the)0 1761 y(currently)f(open)h(structure)g(at)g
X(the)h(current)f(editing)e(position.)p 1327 1858 540 2 v 1327
X1938 2 80 v 1341 1912 a Fb(ptk_readphinte)o(rscrip)o(t)p 1864
X1938 V 1327 1940 540 2 v 0 2014 a Fq(ptkboolean)h Fp(ptk_r)o
X(eadphinterscript)j Fq(\()e(Pchar)h(*)p Fa(scriptname)p Fq(,)d(FILE)j(*)p
XFa(output)p Fq(,)e(FILE)i(*)p Fa(inform)e Fq(\))25 2102 y(IN)91
Xb(Pchar)12 b(*)50 b Fa(scriptname)d Fq(script)11 b(\256lename.)25
X2152 y(OUT)50 b(FILE)12 b(*)57 b Fa(output)122 b Fq(output)9
Xb(script)i(\256le)h(pointer)n(.)25 2202 y(OUT)50 b(FILE)12
Xb(*)57 b Fa(inform)123 b Fq(information)9 b(script)i(\256le)g(pointer)n(.)0
X2271 y(This)k(function)e(reads)i(a)h(PHIGS)f(script)f(from)g(the)h(\256le)g
X(speci\256ed)g(by)g Fi(scriptname)p Fq(.)27 b(The)16 b(\256le)f(is)f
X(automatically)g(opened)0 2321 y(and)d(closed)h(and)f(the)g(function)f
X(returns)h(TRUE)h(if)e(a)i(PHIGS)g(script)e(has)i(been)g(successfully)f
X(read.)0 2956 y(13th)22 b(May)m(,)12 b(1992)627 b(1)n(19)829
Xb(2.01)p eop
X%%Page: 120 121
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1503 -19 364 2 v 1503 60 2 80 v 1517 35 a Fb(ptk_strphinter)p
X1864 60 V 1503 62 364 2 v 0 136 a Fq(void)10 b Fp(ptk_strphinter)i
XFq(\()g(Pint)f Fa(wsid)p Fq(,)h(Plimit)f(*)p Fa(echoarea)o
XFq(,)f(Pint)h Fa(outputterminal)o Fq(,)f(Pint)h Fa(in-)357
X186 y(formterminal)f Fq(\))25 236 y(IN)50 b(Pint)115 b Fa(wsid)202
Xb Fq(workstation)10 b(identi\256er)n(.)25 286 y(IN)50 b(Plimit)9
Xb(*)50 b Fa(echo)9 b(area)114 b Fq(echo)12 b(area)h(for)e(string)f(device.)2
V5
X336 y(IN)50 b(Pint)115 b Fa(outputterminal)46 b Fq(terminal)11
Xb(window)f(identi\256er)h(for)f(writing)g(output)f(script)i(to.)25
X386 y(IN)50 b(Pint)115 b Fa(informterminal)47 b Fq(terminal)11
Xb(window)f(identi\256er)h(for)f(writing)g(information)f(data.)0
X455 y(This)15 b(function)f(redirects)i(the)f(input)f(of)h(phinter)f(to)h(the
V)
Xg(PHIGS)h(string)e(device)i(\(number)f(1\).)27 b(Strphinter)14
Xb(is)h(always)h(in-)0 505 y(teractive)e(and)f(output)f(is)h(directed)g(to)g
X(terminal)g(windows)g(instead)g(of)g(\256les)h(so)g(that)f(it)f(may)i(be)g
X(displayed)f(in)g(the)g(PHIGS)0 554 y(workstation)c(window)m(.)p
X1416 651 450 2 v 1416 731 2 80 v 1430 705 a Fb(ptk_writeallstruc)o(t)p
X1864 731 V 1416 733 450 2 v 0 807 a Fq(void)h Fp(ptk_writeallstruct)h
XFq(\()g(FILE)h(*)p Fa(\256leptr)e Fq(\))25 906 y(OUT)50 b(FILE)12
Xb(*)50 b Fa(\256leptr)e Fq(pointer)10 b(to)g(\256le.)0 1006
Xy(This)15 b(function)e(writes)h(the)g(contents)g(of)h(all)f(the)g(structures
V)
Xg(in)g(the)h(PHIGS)f(CSS)h(to)f(a)h(\256le.)26 b(The)15 b(structures)f(are)i
X(written)0 1056 y(in)11 b(the)g(PHIGS)g(script)g(format)g(so)g(that)g(they)g
X(may)h(be)f(read)h(in)f(again)g(using)g Fi(ptk_phinter)p Fq(.)p
X1476 1153 391 2 v 1476 1232 2 80 v 1490 1207 a Fb(ptk_writestruct)p
X1864 1232 V 1476 1234 391 2 v 0 1308 a Fq(void)f Fp(ptk_writestruct)i
XFq(\()g(FILE)g(*)p Fa(\256leptr)p Fq(,)d(Pintlst)h(*)p Fa(stids)g
XFq(\))25 1397 y(OUT)50 b(FILE)12 b(*)68 b Fa(\256leptr)48 b
XFq(pointer)10 b(to)h(\256le.)25 1447 y(IN)91 b(Pintlst)10 b(*)49
Xb Fa(stids)62 b Fq(structure)11 b(identi\256er)f(list.)0 1522
Xy(This)i(function)g(writes)g(the)g(contents)g(of)g(a)i(list)d(of)h
X(structures)g(to)g(a)h(\256le.)20 b(The)13 b(structures)f(are)i(written)d(in
V)
Xh(the)g(PHIGS)h(script)0 1572 y(format)e(so)g(that)g(they)g(may)h(be)f(read)
Vh
X(in)f(again)g(using)g Fi(ptk_phinter)p Fq(.)p 1403 1669 464
X2 v 1403 1748 2 80 v 1417 1722 a Fb(ptk_writestructne)o(t)p
X1864 1748 V 1403 1750 464 2 v 0 1824 a Fq(void)f Fp(ptk_writestructnet)j
XFq(\()e(FILE)h(*)p Fa(\256leptr)p Fq(,)e(Pintlst)f(*)p Fa(stids)h
XFq(\))25 1913 y(OUT)50 b(FILE)12 b(*)68 b Fa(\256leptr)48 b
XFq(pointer)10 b(to)h(\256le.)25 1962 y(IN)91 b(Pintlst)10 b(*)49
Xb Fa(stids)62 b Fq(structure)11 b(network)f(identi\256er)h(list.)0
X2038 y(This)17 b(function)e(writes)h(the)h(contents)f(of)h(a)g(list)f(of)g
X(structure)g(networks)h(to)f(a)h(\256le.)32 b(The)18 b(structures)e(are)i
X(written)d(in)h(the)0 2087 y(PHIGS)11 b(script)g(format)g(so)g(that)g(they)g
X(may)h(be)f(read)h(in)f(again)g(using)g Fi(ptk_phinter)p Fq(.)0
X2956 y(13th)22 b(May)m(,)12 b(1992)626 b(120)828 b(2.01)p eop
X%%Page: 121 122
Xbop 0 349 a Fj(Chapter)24 b(20)0 585 y Fs(Structur)n(e)30 b(content)f
X(functions)p 1164 800 703 2 v 1164 879 2 80 v 1178 854 a Fb
X(ptk_inqstructcont)o(ent)o(ele)o(mpt)o(r)p 1864 879 V 1164
X881 703 2 v 0 956 a Fq(void)10 b Fp(ptk_inqstructcontentelemptr)j
XFq(\()e(Pint)f Fa(contentstid)p Fq(,)f(Pint)h(*)p Fa(elemptr)p
XFq(,)g(Pint)g(*)p Fa(err)h Fq(\))25 1044 y(IN)91 b(Pint)81
Xb Fa(contentstid)46 b Fq(content)11 b(structure)g(identi\256er)n(.)25
X1094 y(OUT)50 b(Pint)10 b(*)50 b Fa(elemptr)101 b Fq(element)12
Xb(pointer)n(.)25 1144 y(OUT)50 b(Pint)10 b(*)50 b Fa(err)176
Xb Fq(error)11 b(indicator)n(.)0 1213 y(This)f(function)f(may)h(be)h(used)f
X(to)g(obtain)f(the)h(element)g(number)g(pointed)f(to)h(by)f(the)h(element)h
X(arrow)f(in)f(the)h(structure)g(content)0 1263 y(diagram.)16
Xb(The)c(error)f(code)g(=)h(1)f(if)g Fi(contentstid)j Fq(is)d(not)f(a)i
X(structure)f(content)f(diagram.)p 1214 1360 653 2 v 1214 1439
X2 80 v 1228 1414 a Fb(ptk_inqstructcont)o(ent)o(rang)o(e)p
X1864 1439 V 1214 1441 653 2 v 0 1515 a Fq(void)g Fp
X(ptk_inqstructcontentrange)j Fq(\()e(Pint)f Fa(contentstid)p
XFq(,)f(Pint)h(*)p Fa(\256rstel)p Fq(,)g(Pint)g(*)p Fa(lastel)p
XFq(,)g(Pint)g(*)p Fa(err)h Fq(\))25 1604 y(IN)91 b(Pint)81
Xb Fa(contentstid)46 b Fq(content)11 b(structure)g(identi\256er)n(.)25
X1654 y(OUT)50 b(Pint)10 b(*)50 b Fa(\256rstel)134 b Fq(element)12
Xb(pointer)n(.)25 1703 y(OUT)50 b(Pint)10 b(*)50 b Fa(lastel)136
Xb Fq(element)12 b(pointer)n(.)25 1753 y(OUT)50 b(Pint)10 b(*)50
Xb Fa(err)176 b Fq(error)11 b(indicator)n(.)0 1822 y(This)k(function)e(may)j
X(be)f(used)g(to)g(obtain)e(the)i(element)h(range)f(which)f(appears)i(in)f
X(the)f(structure)h(content)f(diagram.)27 b(The)0 1872 y(error)11
Xb(code)h(=)g(1)f(if)g Fi(contentstid)i Fq(is)e(not)f(a)i(structure)f(content
V)
Xg(diagram.)p 1174 1969 693 2 v 1174 2048 2 80 v 1188 2023 a
XFb(ptk_setstructcont)o(ent)o(ele)o(mpt)o(r)p 1864 2048 V 1174
X2050 693 2 v 0 2124 a Fq(void)f Fp(ptk_setstructcontentelemptr)j
XFq(\()e(Pint)g Fa(contentstid)o Fq(,)e(Pint)i Fa(elemptr)f
XFq(\))25 2213 y(IN)50 b(Pint)e Fa(contentstid)f Fq(content)10
Xb(structure)h(identi\256er)n(.)25 2263 y(IN)50 b(Pint)e Fa(elemptr)102
Xb Fq(element)12 b(pointer)n(.)0 2338 y(This)f(function)f(draws)i(an)f(arrow)
Vg
X(pointing)e(the)i(element)h Fi(elemptr)h Fq(in)d(the)i(structure)e(content)h
X(diagram.)902 2956 y(121)p eop
X%%Page: 122 123
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1423 -19 444 2 v 1423 60 2 80 v 1437 35 a Fb(ptk_structconten)o
X(t)p 1864 60 V 1423 62 444 2 v 0 136 a Fq(void)10 b Fp(ptk_structcontent)j
XFq(\()g(Pint)f Fa(wsid)p Fq(,)i(Pint)e Fa(stid)p Fq(,)h(Pint)f
XFa(\256rstel)p Fq(,)g(Pint)h Fa(lastel)p Fq(,)f(Pint)g Fa(elemptr)p
XFq(,)413 186 y(Pint)e Fa(font)p Fq(,)h(Pint)f(*)p Fa(error)g
XFq(\))25 236 y(IN)91 b(Pint)81 b Fa(wsid)96 b Fq(workstation)10
Xb(identi\256er)n(.)25 286 y(IN)91 b(Pint)81 b Fa(stid)111 b
XFq(structure)11 b(identi\256er)n(.)25 336 y(IN)91 b(Pint)81
Xb Fa(\256rstel)g Fq(\256rst)11 b(element)h(in)f(range.)25 386
Xy(IN)91 b(Pint)81 b Fa(lastel)i Fq(last)11 b(element)h(in)f(range.)25
X436 y(IN)91 b(Pint)81 b Fa(elemptr)48 b Fq(element)12 b(pointer)n(.)25
X485 y(IN)91 b(Pint)81 b Fa(font)107 b Fq(text)11 b(font.)25
X535 y(OUT)50 b(Pint)10 b(*)50 b Fa(error)91 b Fq(error)11 b(code.)0
X604 y(This)f(function)f(inserts)g(a)i(diagram)f(of)g(the)g(contents)g(of)g
X(the)g(structure)f Fi(stid)i Fq(in)f(the)g(currently)f(open)h(structure)f(at
V)
Xi(the)f(current)0 654 y(editing)e(position.)13 b(The)d(diagram)g(consists)f
X(of)h(a)g(table)f(of)h(elements)g(represented)g(by)f(rectangles)h(and)g
X(labelled)f(with)g(element)0 704 y(type)h(and)h(number)n(.)k(The)c(table)f
X(has)h(a)g(heading)f(with)g(the)g(format:)k Fi("structure)20
Xb(N)e("name")h(\(M)f(elements\)")13 b Fq(where)e(N)f(is)0 754
Xy(the)i(structure)f(identi\256er)n(,)h(name)h(is)f(the)g(structure)g(name)h
X(extracted)f(from)g(the)g("structureid")e(hashtable)i(and)g(M)h(is)e(the)h
X(total)0 803 y(number)i(of)f(elements)h(in)f(the)h(structure.)22
Xb(The)14 b(error)g(code)g(=)g(1)f(if)h(there)f(is)h(no)f(open)h(structure)f
X(and)g(=)i(2)e(if)g Fi(stid)i Fq(doesn')o(t)0 853 y(exist.)g(This)c(function
V)
Xf(requires)h(hashtable)g("label".)0 2956 y(13th)22 b(May)m(,)12
Xb(1992)626 b(122)828 b(2.01)p eop
X%%Page: 123 124
Xbop 0 349 a Fj(Chapter)24 b(21)0 585 y Fs(T)-10 b(opology)27
Xb(Functions)0 855 y Fr(21.1)59 b(Data)17 b(types)54 977 y Fi(typedef)i(enum)
X108 1027 y(`7B)126 1076 y(PTKESINGLE,)126 1126 y(PTKEGROUP)108
X1176 y(`7D)f(ptkenodetype;)54 1276 y(typedef)h(enum)108 1325
Xy(`7B)126 1375 y(PTKEBOXTOPOLOGY,)126 1425 y(PTKESTRUCTTOPOLOGY,)126
X1475 y(PTKESTRUCTNETTOPOLOG)q(Y)108 1525 y(`7D)f(ptketopologytype;)54
X1624 y(typedef)h(struct)g(ptkstopologydata)108 1674 y(`7B)126
X1724 y(ptketopologytype)i(topologytype;)126 1774 y(Pint)e(topologyname;)126
X1824 y(Pint)g(topologystid;)108 1873 y(`7D)f(ptkstopologydata;)0
X2042 y Fr(21.2)59 b(Functions)p 1376 2133 490 2 v 1376 2212
X2 80 v 1390 2187 a Fb(ptk_createtopol)o(ogy)p 1864 2212 V 1376
X2214 490 2 v 0 2288 a Fq(void)10 b Fp(ptk_cr)o(eatetopology)h
XFq(\()g(Pint)g Fa(topid)p Fq(,)f(Pint)g Fa(root)p Fq(,)h(Pint)f(*)p
XFa(err)h Fq(\))25 2377 y(IN)91 b(Pint)81 b Fa(topid)48 b Fq(topology)9
+-+-+-+-+-+-+-+-  END  OF PART 115 +-+-+-+-+-+-+-+-