-+-+-+-+-+-+-+-+ START OF PART 122 -+-+-+-+-+-+-+-+
X1446 1593 420 2 v 1446 1672 2 80 v 1460 1647 a Fb(ptk_resetcamer)o(a)p
X1864 1672 V 1446 1674 420 2 v 0 1748 a Fq(void)f Fp(ptk_r)o(esetcamera)j
XFq(\()f(Pint)e Fa(windid)g Fq(\))25 1848 y(IN)50 b(Pint)e Fa(windid)h
XFq(window)10 b(identi\256er)n(.)0 1947 y(This)h(function)f(resets)i(the)f
X(camera)i(variables)f(to)e(their)h(default)g(values.)k(The)d(camera)h(view)f
X(volume)e(is)i(left)e(unchanged.)p 1230 2044 636 2 v 1230 2123
X2 80 v 1244 2098 a Fb(ptk_rotatecam)o(era)o(positi)o(on)p 1864
X2123 V 1230 2125 636 2 v 0 2199 a Fq(void)g Fp(ptk_r)o(otatecameraposition)h
XFq(\()g(Pint)f Fa(windid)p Fq(,)h(P\257oat)g Fa(angle)f Fq(\))25
X2288 y(IN)50 b(Pint)78 b Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25
X2338 y(IN)50 b(P\257oat)f Fa(angle)62 b Fq(rotation)10 b(angle)h(in)g
X(degrees.)0 2413 y(This)i(function)f(rotates)i(the)f(camera)j(position)11
Xb(in)i(a)h(circle)g(centred)g(at)f(the)h(point)e(of)h(interest)g(and)g(about
V)
Xg(the)g(axis)h(de\256ned)0 2463 y(by)d(the)g(function)e Fi
X(ptk_setpositionaxis)p Fq(.)19 b(The)12 b(amount)e(of)h(rotation)f(is)h
XFi(angle)h Fq(degrees)g(and)f(the)g(function)e(is)i(useful)g(for)0
X2513 y(rotating)f(around)g(an)i(object.)0 2956 y(13th)22 b(May)m(,)12
Xb(1992)626 b(150)828 b(2.01)p eop
X%%Page: 151 152
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1200 -19 666 2 v 1200 60 2 80 v 1215 35 a Fb(ptk_rotateca)o(me)o
X(rap)o(tint)o(ere)o(st)p 1864 60 V 1200 62 666 2 v 0 136 a
XFq(void)10 b Fp(ptk_r)o(otatecameraptinter)o(est)j Fq(\()e(Pint)f
XFa(windid)p Fq(,)h(P\257oat)h Fa(angle)d Fq(\))25 225 y(IN)50
Xb(Pint)78 b Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25
X275 y(IN)50 b(P\257oat)f Fa(angle)62 b Fq(rotation)10 b(angle)h(in)g
X(degrees.)0 350 y(This)j(function)e(rotates)h(the)h(camera)h(point)d(of)i
X(interest)f(in)g(a)h(circle)g(centred)g(at)f(the)h(camera)i(position)11
Xb(and)j(about)f(the)g(axis)0 400 y(de\256ned)e(by)g(the)f(function)g
XFi(ptk_setptinterestaxis)p Fq(.)19 b(The)11 b(amount)g(of)f(rotation)f(is)i
XFi(angle)h Fq(degrees)g(and)e(the)h(function)e(is)0 449 y(useful)i(for)g
X(panning)f(around)h(a)g(scene.)p 1214 547 653 2 v 1214 626
X2 80 v 1228 600 a Fb(ptk_rotateca)o(me)o(raupve)o(ct)o(or)p
X1864 626 V 1214 628 653 2 v 0 702 a Fq(void)f Fp(ptk_r)o(otatecameraupvector
V)
Xj Fq(\()e(Pint)f Fa(windid)p Fq(,)h(P\257oat)g Fa(angle)f Fq(\))25
X791 y(IN)50 b(Pint)78 b Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25
X840 y(IN)50 b(P\257oat)f Fa(angle)62 b Fq(rotation)10 b(angle)h(in)g
X(degrees.)0 915 y(This)k(function)e(rotates)i(the)g(camera)i(up)d(vector)h
X(about)f(the)h(axis)g(joining)d(the)j(camera)i(position)c(to)h(the)h(point)e
X(of)i(interest)0 965 y(by)c Fi(angle)h Fq(degrees.)p 1277 1062
X590 2 v 1277 1142 2 80 v 1291 1116 a Fb(ptk_rotateposit)o(ionxa)o(xis)p
X1864 1142 V 1277 1144 590 2 v 0 1218 a Fq(void)e Fp(ptk_r)o
X(otatepositionxaxis)f Fq(\()j(Pint)e Fa(windid)p Fq(,)h(P\257oat)g
XFa(angle)f Fq(\))25 1306 y(IN)50 b(Pint)78 b Fa(windid)49 b
XFq(window)10 b(identi\256er)n(.)25 1356 y(IN)50 b(P\257oat)f
XFa(angle)62 b Fq(rotation)10 b(angle)h(in)g(degrees.)0 1431
Xy(This)j(function)f(rotates)i(the)f(camera)j(position)12 b(in)i(a)h(circle)g
X(centred)g(at)f(the)h(point)e(of)h(interest)g(and)g(about)g(the)h(x)f(axis)g
X(of)h(a)0 1481 y(right-handed)10 b(coordinate)g(system)i(whose)f(z)h(axis)g
X(is)f(de\256ned)g(by)g(the)g(camera)j(position)9 b(point)h(of)h(interest.)p
X1277 1578 V 1277 1657 2 80 v 1291 1632 a Fb(ptk_rotateposit)o(ionya)o(xis)p
X1864 1657 V 1277 1659 590 2 v 0 1733 a Fq(void)f Fp(ptk_r)o
X(otatepositionyaxis)f Fq(\()j(Pint)e Fa(windid)p Fq(,)h(P\257oat)g
XFa(angle)f Fq(\))25 1822 y(IN)50 b(Pint)78 b Fa(windid)49 b
XFq(window)10 b(identi\256er)n(.)25 1872 y(IN)50 b(P\257oat)f
XFa(angle)62 b Fq(rotation)10 b(angle)h(in)g(degrees.)0 1947
Xy(This)j(function)f(rotates)i(the)f(camera)j(position)12 b(in)i(a)h(circle)g
X(centred)g(at)f(the)h(point)e(of)h(interest)g(and)g(about)g(the)h(y)f(axis)g
X(of)h(a)0 1997 y(right-handed)10 b(coordinate)g(system)i(whose)f(z)h(axis)g
X(is)f(de\256ned)g(by)g(the)g(camera)j(position)9 b(point)h(of)h(interest.)p
X1247 2094 620 2 v 1247 2173 2 80 v 1261 2148 a Fb(ptk_rotatepti)o(nter)o
X(estxa)o(xis)p 1864 2173 V 1247 2175 620 2 v 0 2249 a Fq(void)f
XFp(ptk_r)o(otateptinter)o(estxaxis)h Fq(\()h(Pint)e Fa(windid)p
XFq(,)h(P\257oat)g Fa(angle)f Fq(\))25 2338 y(IN)50 b(Pint)78
Xb Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25 2388 y(IN)50
Xb(P\257oat)f Fa(angle)62 b Fq(rotation)10 b(angle)h(in)g(degrees.)0
X2463 y(This)16 b(function)f(rotates)g(the)h(camera)i(point)d(of)h(interest)f
X(in)g(a)i(circle)f(centred)h(at)f(the)g(camera)i(position)c(and)i(about)f
X(the)h(x)0 2513 y(axis)11 b(of)g(a)h(right-handed)e(coordinate)g(system)i
X(whose)g(z)f(axis)h(is)f(de\256ned)g(by)g(the)g(camera)j(position)9
Xb(point)h(of)h(interest.)0 2956 y(13th)22 b(May)m(,)12 b(1992)626
Xb(151)828 b(2.01)p eop
X%%Page: 152 153
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1247 -19 620 2 v 1247 60 2 80 v 1261 35 a Fb(ptk_rotatepti)o
X(nter)o(estya)o(xis)p 1864 60 V 1247 62 620 2 v 0 136 a Fq(void)10
Xb Fp(ptk_r)o(otateptinter)o(estyaxis)h Fq(\()h(Pint)e Fa(windid)p
XFq(,)h(P\257oat)g Fa(angle)f Fq(\))25 225 y(IN)50 b(Pint)78
Xb Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25 275 y(IN)50
Xb(P\257oat)f Fa(angle)62 b Fq(rotation)10 b(angle)h(in)g(degrees.)0
X350 y(This)16 b(function)f(rotates)g(the)h(camera)i(point)d(of)h(interest)f
X(in)g(a)i(circle)f(centred)h(at)f(the)g(camera)i(position)c(and)i(about)f
X(the)h(y)0 400 y(axis)11 b(of)g(a)h(right-handed)e(coordinate)g(system)i
X(whose)g(z)f(axis)h(is)f(de\256ned)g(by)g(the)g(camera)j(position)9
Xb(point)h(of)h(interest.)p 1303 497 563 2 v 1303 576 2 80 v
X1317 551 a Fb(ptk_scaleviewwindow)p 1864 576 V 1303 578 563
X2 v 0 652 a Fq(void)f Fp(ptk_scaleviewwindow)h Fq(\()g(Pint)f
XFa(windid)p Fq(,)h(P\257oat)g Fa(scalefactor)d Fq(\))25 741
Xy(IN)50 b(Pint)78 b Fa(windid)120 b Fq(window)10 b(identi\256er)n(.)25
X791 y(IN)50 b(P\257oat)f Fa(scalefactor)e Fq(scale)12 b(factor)n(.)0
X866 y(This)h(function)e(scales)j(the)f(view)f(window)g(uniformly)f(by)h
XFi(scalefactor)p Fq(.)22 b(A)13 b(scalefactor)h(in)e(the)h(range)g(`5B0,)g(1
V`5D)g
X(will)e(scale)0 915 y(down)g(the)g(view)g(window)f(and)h(create)i(a)f
X(zoom-in)f(ef)o(fect.)16 b(A)11 b(scalefactor)h(greater)g(than)f(1.0)g(will)
Vf
X(give)h(a)h(zoom-out)f(ef)o(fect.)p 1410 1013 457 2 v 1410
X1092 2 80 v 1424 1066 a Fb(ptk_scanwindows)p 1864 1092 V 1410
X1094 457 2 v 0 1168 a Fq(ptkboolean)f Fp(ptk_scanwindows)h
XFq(\()17 b(Pint)f Fa(wsid)p Fq(,)j(ptksgeneralinput)c(*)p Fa(input)p
XFq(,)j(ptkswindowoutpu)o(t)521 1218 y(*)p Fa(output)9 b Fq(\))25
X1268 y(IN)50 b(Pint)323 b Fa(wsid)76 b Fq(workstation)10 b(identi\256er)n(.)
X25 1318 y(IN)50 b(ptksgeneralinput)9 b(*)82 b Fa(input)69 b
XFq(input)10 b(data.)25 1368 y(IN)50 b(ptkswindowoutp)o(ut)8
Xb(*)50 b Fa(output)d Fq(output)10 b(data.)0 1437 y(This)15
Xb(function)f(performs)i(a)g(scan)g(on)f(all)g(posted)g(windows)f(using)h
X(either)g(string,)h(pick)f(or)g(locator)g(data.)28 b(The)16
Xb(function)0 1487 y(returns)11 b(TRUE)g(if)g(a)h(window)e(has)i(been)g
X(selected,)g(otherwise)f(F)m(ALSE.)p 1400 1584 467 2 v 1400
X1663 2 80 v 1414 1638 a Fb(ptk_scrollterm)o(ina)o(l)p 1864
X1663 V 1400 1665 467 2 v 0 1739 a Fq(void)f Fp(ptk_scr)o(ollterminal)h
XFq(\()g(Pint)f Fa(windid)p Fq(,)h(Ptxpath)f Fa(scrolldir)p
XFq(,)g(Pint)g Fa(numlines)g Fq(\))25 1828 y(IN)74 b Fa(windid)90
Xb Fq(terminal)11 b(window)f(identi\256er)n(.)25 1878 y(IN)74
Xb Fa(scrolldir)67 b Fq(scroll)11 b(direction)f(\(up)h(or)g(down\).)25
X1928 y(IN)74 b Fa(numlines)48 b Fq(number)12 b(of)f(lines)f(to)h(scroll)g(by
V)
Xm(.)0 1996 y(This)g(function)f(scrolls)h(the)g(contents)g(of)g(the)g
X(TERMINAL)h(window)e(either)h(UP)g(or)g(DOWN)h(by)f Fi(numlines)p
XFq(.)p 1327 2094 540 2 v 1327 2173 2 80 v 1341 2147 a Fb(ptk_setbannerco)o
X(lours)p 1864 2173 V 1327 2175 540 2 v 0 2249 a Fq(void)f Fp(ptk_setbanner)o
X(colours)j Fq(\()e(Pint)g Fa(windid)p Fq(,)f(Pint)h Fa(bannercolo)o(ur)p
XFq(,)d(Pint)j Fa(titlecolour)d Fq(\))25 2338 y(IN)50 b(Pint)e
XFa(windid)155 b Fq(window)10 b(identi\256er)n(.)25 2387 y(IN)50
Xb(Pint)e Fa(bannercolou)o(r)f Fq(banner)11 b(colour)g(index.)25
X2437 y(IN)50 b(Pint)e Fa(titlecolour)102 b Fq(title)10 b(string)g(colour)g
X(index.)0 2506 y(This)k(function)f(sets)h(the)g(colour)f(indicies)h(of)g(a)g
X(window)f(banner)n(.)24 b(It)13 b(is)h(useful)g(for)g(highlighti)o(ng)d(a)k
X(current)e(window)m(,)i(for)0 2556 y(example)d(in)f(a)h(`60point)d(and)j
X(click')e(window)h(system.)0 2956 y(13th)22 b(May)m(,)12 b(1992)626
Xb(152)828 b(2.01)p eop
X%%Page: 153 154
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1353 -19 514 2 v 1353 60 2 80 v 1367 35 a Fb(ptk_setbannerheigh)
Vo
X(t)p 1864 60 V 1353 62 514 2 v 0 136 a Fq(void)10 b Fp(ptk_setbannerheight)i
XFq(\()g(Pint)e Fa(windid)p Fq(,)h(P\257oat)g Fa(bannerheigh)o(t)d
XFq(\))25 225 y(IN)50 b(Pint)78 b Fa(windid)155 b Fq(window)10
Xb(identi\256er)n(.)25 275 y(IN)50 b(P\257oat)f Fa(bannerheigh)o(t)e
XFq(height)10 b(of)h(banner)n(.)0 350 y(This)i(function)f(sets)i(the)g(height
V)
Xe(of)h(the)h(window)e(banner)i(to)f Fi(bannerheight)i Fq(which)e(is)h(given)
Vf
X(in)f(the)i(range)g(`5B0,)g(1`5D.)22 b(The)0 400 y(window)10 b(title)g(is)h
X(re-scaled)i(to)d(\256t)h(the)g(new)h(height.)p 1410 497 457
X2 v 1410 576 2 80 v 1424 551 a Fb(ptk_setbannerti)o(tl)o(e)p
X1864 576 V 1410 578 457 2 v 0 652 a Fq(void)e Fp(ptk_setbannertitle)i
XFq(\()f(Pint)f Fa(windid)p Fq(,)h(Pchar)h(*)p Fa(titlestring)c
XFq(\))25 741 y(IN)50 b(Pint)108 b Fa(windid)90 b Fq(window)10
Xb(identi\256er)n(.)25 791 y(IN)50 b(Pchar)11 b(*)50 b Fa(titlestring)d
XFq(title)10 b(string)g(of)h(window)f(banner)n(.)0 866 y(This)15
Xb(function)e(sets)i(the)g(title)f(string)f(of)i(a)g(window)m(.)25
Xb(The)16 b(title)d(is)i(displayed)f(in)g(the)h(window)f(banner)g(and)h(is)g
X(automati-)0 915 y(cally)c(scaled)h(to)f(\256t)g(inside)g(the)g(banner)g
X(area.)p 1356 1013 510 2 v 1356 1092 2 80 v 1371 1066 a Fb(ptk_setcame)o(ral
V)
Xo(imi)o(ts)p 1864 1092 V 1356 1094 510 2 v 0 1168 a Fq(void)f
XFp(ptk_setcameralimits)g Fq(\()i(Pint)e Fa(windid)p Fq(,)h(Plimit3)e(*)p
XFa(limits)p Fq(,)i(ptkboolean)f Fa(adjust)g Fq(\))25 1257 y(IN)50
Xb(Pint)166 b Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25
X1306 y(IN)50 b(Plimit3)9 b(*)80 b Fa(limits)69 b Fq(camera)13
Xb(viewing)d(limits)g(in)h(WC.)25 1356 y(IN)50 b(ptkboolean)e
XFa(adjust)54 b Fq(adjust)10 b(given)h(limits.)0 1425 y(This)h(function)e
X(sets)i(the)f(view)g(volume)h(of)f(the)g(camera)j(to)d(the)g(speci\256ed)i
X(bounding)c(box)i(given)g(in)g(W)m(orld)f(Coordinates.)15 b(If)0
X1475 y Fi(adjust)10 b Fq(is)f(set)h(to)f(TRUE)g(then)g(the)g(bounding)e(box)
Vi
X(will)f(be)h(adjusted)g(to)g(be)g(the)g(bounding)f(box)g(of)h(a)h(sphere)g
X(which)f(encloses)0 1525 y(the)i(original)f(box.)p 1300 1622
X567 2 v 1300 1701 2 80 v 1314 1676 a Fb(ptk_setcamera)o(positi)o(on)p
X1864 1701 V 1300 1703 567 2 v 0 1777 a Fq(void)g Fp(ptk_setcameraposition)h
XFq(\()g(Pint)f Fa(windid)p Fq(,)h(Ppoint3)f(*)p Fa(position)f
XFq(\))25 1866 y(IN)50 b(Pint)143 b Fa(windid)70 b Fq(window)10
Xb(identi\256er)n(.)25 1916 y(IN)50 b(Ppoint3)9 b(*)50 b Fa(position)d
XFq(camera)13 b(position.)0 1991 y(This)e(function)f(sets)i(the)f(camera)i
X(position)c(to)i Fi(position)i Fq(which)e(is)g(given)f(in)h(W)m(orld)f
X(Coordinates.)p 1293 2088 573 2 v 1293 2167 2 80 v 1308 2142
Xa Fb(ptk_setcame)o(rapro)o(jtyp)o(e)p 1864 2167 V 1293 2169
X573 2 v 0 2243 a Fq(void)g Fp(ptk_setcamerapr)o(ojtype)j Fq(\()e(Pint)f
XFa(windid)p Fq(,)h(Pprojtype)f Fa(proj)g Fq(\))25 2332 y(IN)50
Xb(Pint)143 b Fa(windid)49 b Fq(window)10 b(identi\256er)n(.)25
X2382 y(IN)50 b(Pprojtype)e Fa(proj)90 b Fq(camera)13 b(projection)d(type.)0
X2457 y(This)i(function)f(sets)i(the)f(projection)e(type)i(of)g(the)g(view)h
X(given)e(by)h(the)g(camera)j(to)c(P)l(ARALLEL)j(or)e(PERSPECTIVE.)i(The)0
X2507 y(default)d(is)g(P)l(ARALLEL.)0 2956 y(13th)22 b(May)m(,)12
Xb(1992)626 b(153)828 b(2.01)p eop
X%%Page: 154 155
Xbop 0 -137 a Fq(PHIGS)11 b(T)m(oolkit)f(User)i(Manual)1235
Xb(PTK/100)p 1270 -19 596 2 v 1270 60 2 80 v 1284 35 a Fb(ptk_setcamerap)o
X(tint)o(ere)o(st)p 1864 60 V 1270 62 596 2 v 0 136 a Fq(void)10
Xb Fp(ptk_setcameraptinter)o(est)j Fq(\()e(Pint)g Fa(windid)p
XFq(,)f(Ppoint3)g(*)p Fa(ptinterest)e Fq(\))25 225 y(IN)50 b(Pint)143
Xb Fa(windid)94 b Fq(window)10 b(identi\256er)n(.)25 275 y(IN)50
Xb(Ppoint3)9 b(*)50 b Fa(ptinterest)d Fq(point)9 b(of)i(interest.)0
X350 y(This)g(function)f(sets)i(the)f(camera)i(point)d(of)h(interest)f(to)h
XFi(ptinterest)i Fq(which)e(is)g(given)g(in)g(W)m(orld)f(Corrdinates.)p
X1383 447 484 2 v 1383 526 2 80 v 1397 501 a Fb(ptk_setcamera)o(stat)o(e)p
X1864 526 V 1383 528 484 2 v 0 602 a Fq(void)g Fp(ptk_setcamerastate)i
XFq(\()f(Pint)g Fa(windid)p Fq(,)g(ptkecamerastate)h Fa(cameraswitch)d
XFq(\))25 691 y(IN)50 b(Pint)249 b Fa(windid)164 b Fq(window)10
Xb(identi\256er)n(.)25 741 y(IN)50 b(ptkecamerastate)h Fa(cameraswitch)c
XFq(camera)13 b(on)e(or)g(of)o(f.)0 816 y(This)g(function)f(sets)i(the)f
X(camera)i(of)e(the)g(window)f Fi(windid)j Fq(to)e(ON)g(or)g(OFF)m(.)g(The)h
X(default)f(is)g(ON.)p 1353 913 513 2 v 1353 992 2 80 v 1367
X967 a Fb(ptk_setcameraworl)o(d)p 1864 992 V 1353 994 513 2
Xv 0 1068 a Fq(void)f Fp(ptk_setcameraworld)i Fq(\()f(Pint)g
XFa(windid)p Fq(,)f(Pintlst)g(*)p Fa(stids)g Fq(\))25 1157 y(IN)50
Xb(Pint)120 b Fa(windid)48 b Fq(window)11 b(identi\256er)n(.)25
X1207 y(IN)50 b(Pintlst)9 b(*)50 b Fa(stids)75 b Fq(structure)11
Xb(identi\256er)f(list.)0 1282 y(This)16 b(function)f(sets)h(the)g(view)g
X(volume)g(of)g(the)g(camera)i(so)e(that)g(it)f(contains)h(the)g(combined)g
X(bounding)e(box)i(of)g(all)f(the)0 1332 y(structures)c(and)g(structure)g
X(networks)f(in)h Fi(stids)p Fq(.)p 1240 1429 626 2 v 1240 1508
X2 80 v 1254 1483 a Fb(ptk_setcontentvie)o(wrang)o(e)p 1864
X1508 V 1240 1510 626 2 v 0 1584 a Fq(void)f Fp(ptk_setcontentviewrange)i
XFq(\()g(Pint)e Fa(windid)p Fq(,)h(Pint)f Fa(range1)p Fq(,)g(Pint)g
XFa(range2)f Fq(\))25 1673 y(IN)50 b(Pint)e Fa(windid)59 b Fq(window)10
Xb(identi\256er)n(.)25 1723 y(IN)50 b(Pint)e Fa(range1)g Fq(start)11
Xb(element)h(number)n(.)25 1772 y(IN)50 b(Pint)e Fa(range2)g
XFq(end)11 b(element)h(number)n(.)0 1841 y(This)f(function)f(sets)i(the)f
X(range)g(of)g(elements)h(of)f(a)h(structure)f(content)g(diagram)g(to)g(view)
Vg
X(in)g(a)g(CONTENT)h(window)m(.)p 1433 1938 434 2 v 1433 2018
X2 80 v 1447 1992 a Fb(ptk_setframesiz)o(e)p 1864 2018 V 1433
X2020 434 2 v 0 2094 a Fq(void)e Fp(ptk_setframesize)i Fq(\()g(Pint)e
XFa(windid)p Fq(,)h(Ppoint)f(*)p Fa(size)f Fq(\))25 2182 y(IN)50
+-+-+-+-+-+-+-+-  END  OF PART 122 +-+-+-+-+-+-+-+-