XGL Device Pipeline Porting Guide
  Search only this book
Download this book in PDF

Index

A

accumulation buffer53, 56
addPickToBuffer()127
assignCurStrokeAsEdge()128
assignCurStrokeAsLine()128
assignCurStrokeAsMarker()128
assignCurStrokeAsSurfBack()129
assignCurStrokeAsSurfFront()128
assignCurStrokeAsText()128

B

backing store
.....and double buffering67
.....device pipeline support65
.....overview10

C

changedComposite()164
checkLastPick()128
clearComposite()165
clip lists186, 191
clipChanged()198
Color Map object
.....object interfaces146
Context object
.....getting attribute values123
.....object interfaces127
context switching9, 115
coordinate systems154, 168, 180
.....See alsoderived data
copyBuffer()40
copyConvert()143
createDpCtx()39
createDpDev()37
current coordinate system180
current stroke pointer109

D

data storage
.....accessing data at LI-175
.....accessing data at LI-282
.....conic data85 to 89
.....facet data76
.....in the software pipeline79
.....level data80
.....overview74
.....pixel data89 to 94
.....point data82 to 84
.....rectangle data85 to 89
dbDisplayComplete()198
dbDisplayWait()198
dbGetWid()198
dbUnGrab()203
DC offset values112
DDK (Device Driver's Kit)8
deallocate()93
Denizen test suite20
depth cue reference planes175
derived data
.....changes of derived items164
.....coordinate systems154
.....design goals151
.....eye vector156
.....getting boundaries170
.....getting eye vector173
.....getting lights172
.....getting model clip planes174
.....getting transforms169
.....lights156, 172
.....transforms154
.....view cache object157
.....view clip bounds156
.....view concern object158
.....view group configuration object157
.....view group interface object158
.....view model150
Device Driver's Kit (DDK)8
Device object29
.....initialization42
.....object interfaces131
device orientation52
device pipeline
.....accessing point data at LI-175
.....accessing point data at LI-282
.....adding member data to a class61
.....error reporting23 to 27
.....getting attribute values120
.....getting model clip planes174
.....getting transforms169
.....getting view clip bounds170
.....locking the window forrendering186, 192
.....managing clip list changes186
.....managing window systemresources195
.....multiple frame buffers34
......multiple windows38
......naming conventions51
......pipeline context class (XglDpCtx)43 to 66
......pipeline device class (XglDpDev)38 to 42, 52 to 57
......pipeline initialization42, 190
......pipeline library class (XglDpLib)33 to 35
......pipeline loading58
......pipeline manager class(XglDpMgr)36 to 37
......required classes30
......return values66
......summary of functions68
......xgl_create_PipeLib()32
DGA9, 184
......winBboxinfop()205
......winDbInfop()205
dithering
......lookUpDitherValue()146
......lookUpInternalDitherAddress()146
......lookUpInternalDitherValue()146
dlsym()32
DMA devices78
double buffering, in hardware195
dynamic linking2
......dlsym()32

E

error reporting23 to 27
external files21
eye vector156
eye vectors173

F

fast clear sets200
fillRectangle()92
fonts
......stroke font object interfaces136
frame buffers, multiple34, 36

G

gamma values131
getAccumBufferDepth()54
getAccumBufferPixRect()136
getActualData()132
getActualDataSize()132
getActualDescription()133
getActualOffset()133
getApiData()75
getBackTexturing()130
getBbox()88
getCenterPtr()88
getClass()203
getClipStat()198
getCmap()145
getCmapDrawable()146
getColorTable()146
getConicDataType()88
getConicType()88
getCosAngle2()132
getCurCoordSys()180
getCurrentLevel()84, 88
getCurrentLevelData()84, 88
getCurrentStroke()128, 129
getDcOrientation()52, 131
getDepth()
.....in XglDpDevWinRas54
.....in XglPixRect92
getDescriptor()203
getDescriptors()130, 134
getDevFd()198
getDevice()198
getDeviceName()198
getDoPixelMapping()134
getDpDev()131
getDpMgr()34
getDrawable()131
getElement()133
getExpectedFlagValue()112
getFaceAttrs()84
getFacetList()84
getFlag()137, 142
getFlagMask()112
getFlagPtr()88
getFrontTexturing()129
getGammaInversePowerTable()131
getGammaPowerTable()131
getGammaValue()52, 131
getHeight()92
getImageBufferPixRect()135
getImgBufLineBytes()136
getInverseMapperHasBeenSet()147
getIsFontLoaded()136
getIsotropicScale()143
getLength()133
getLevelData()84, 88
getLineBytes()93
getLockType()203
getMajorAxisPtr()88
getMapperHasBeenSet()147
getMatrix()143
getMatrixDouble()143
getMatrixFloat()142
getMatrixInt()143
getMaxZ()52
getMemberRecord()138, 142
getMemoryAddress()93
getMergeClipList()199
getMergeClipListCount()199
getMergeClipMask()199
getMinorAxisPtr()88
getNegDirection()132
getNewFramePlaneMask()127
getNorm()143
getNormInverse()143
getNumConics()88
getNumPointLists()84
getNumRects()89
getParallelProj()171
getPipeName()203
getPlaneMaskMask()146
getPointLists()84
getProcessFlags()84
getRadiusPtr()88
getRealColorType()54, 199
getRealPlaneMask()127
getRealRenderBuffer()127
getRenderFlags()84
getRotAnglePtr()88
getSfontData()136
getSfontInst()136
getStartAnglePtr()88
getStartPointPtr()89
getStartSeg()133
getStartSegRemain()133
getStopAnglePtr()89
getStopPointPtr()89
getSurfAttr()127
getSurfBackAttr3d()129
getSurfBackFaceAttr()129
getSurfBackFaceAttr3d()129
getSurfFrontAttr3d()129
getSurfFrontFaceAttr()127
getSurfFrontFaceAttr3d()129
getSwAccumBuffer()56, 135
getSwp()128
getSwZBuffer()56, 135
getType()203
getUserClipList()200
getUserClipListCount()200
getValue()92
getValueByPointer()92
getViewCanonical()171
getViewGrp()128
getWid()199
getWidth()92
getWindowDepth()199
getWindowHeight()199
getWindowWidth()199
getWindowX()199
getWindowY()199
getWrapOriginX()92
getWrapOriginY()92
getWrappedValue()92
getWsClipList()200
getWsClipListCount()199
getZBufferPixRect()135
global state object34, 58
grabDrawable()204
grabFCS()200
grabRetainedWindow()203
grabStereo()201
grabWids()200
grabZbuf()200

I

inquire()37
isMemory()92

L

lights156, 172
line patterns132
line-specific attributes106
linking, dynamic2
lock functions191
lookUpDitherValue()146
lookUpInternalDitherAddress()146
lookUpInternalDitherValue()146

M

markers133
matchDesc()204
matrices
......getMatrix()143
......getMatrixDouble()143
......getMatrixFloat()142
......getMatrixInt()143
messageReceive()105
model clip planes174
multipolylines
.....expected flag value111
.....flag mask111
.....primitives rendering as106
.....stroke types106

N

naming conventions51
naming conventions for internalattributes121
needRtnDevice()56
normals143

O

objectSet()70, 110, 122
ops_vector function array21, 44, 45
opsVecDiDefault function array48

P

performance tuning
.....different performance tools412
.....find the performance criticalpaths410
.....selecting good benchmarks413
.....suggested techniques for fastercode416
.....tuning the performance criticalpaths415
picking
.....addPickToBuffer()127
.....checkLastPick()128
pipeline, Seedevice pipeline or softwarepipeline
pixel data89
.....XglPixRect90
popCurCoordSys()180
porting
.....choosing an interface layer14
.....implementing an LI-1 primitive16
.....testing the implementation20
possible()204
pushCurCoordSys()180

R

reallocate()93
reassign()94
receive()128
resize()
......in XglDpDevWinRas54
......in XglDrawble204

S

setBackingStore()54
setBufDisplay()55
setBufDraw()55
setBuffersRequested()54
setBufMinDelay()55
setCmap()
......in XglDpDevMemRas57
......in XglDpDevWinRas55
setComposite()165
setCurCoordSys()180
setCursorRopFunc()201
setDisplayBuffer()201
setDoPixelMapping()134
setImageBufferAddr()57
setLineBytes()57
setNumConics()88
setNumRects()89
setPixelMapping()55
setReadBuffer()202
setRectList()53, 204
setRectNum()53, 204
setSourceBuffer()53
setStereoMode()56
setSwAccumBuffer()53
setSwZBuffer()53
setValue()92
setValueByPointer()92
setWrapOriginX()92
setWrapOriginY()92
setWriteBuffer()202
setZBufferAddr()57
shared memory191, 205
software cursors196, 201
software pipeline
.....derived data150
.....level data79
state changes
.....overview96
.....stroke groups106
stereo imaging195
stroke attributes110
stroke group106
.....DC offset112
.....example109
.....expected flag value111
.....flag mask111
stroke group attributes125
syncRtnDevice()54, 136

T

texture mapping
.....lighting coefficients83
.....object interfaces130, 134
Transform object
.....flag data137
.....getting object handle125
.....matrices143
.....member record137
.....object interfaces142
transforms154, 169
.....See also derived data
transNormal()144
transPt()143
transPtList()144
transUnitNormal()144
transUnitNormalDouble()144

U

unGrabDrawable()204
unGrabRetainedWindow()204
update table
.....design issues114
.....stroke groups106

V

view clip bounds156, 170
view concern objects159
view model150
......See alsoderived data
VIS_GETIDENTIFIER58

W

WIN_LOCK()187, 192, 197
WIN_UNLOCK()192, 198
winBboxinfop()205
winDbInfop()205
window locking187
......asynchronous devices188
......immediate-rendering hardware188
......performance implications192
window system
......See alsoXglDrawable
......clip list191
......clip list updates191
......creation of the XglDrawable186
......fast clear sets205
......locking the window186, 187
......window ID198, 199
windowIsClipped()202
windowIsObscured()202
winLock()187, 197
winUnLock()197

X

XGL architecture
......and the device pipelines11
......overview11
xgl_create_PipeLib()32
XglCmap
......getColorTable()146
......getPlaneMaskMask()146
......lookUpDitherValue()146
......lookUpInternalDitherAddress()146
XglConicData85 to 89
......getCurrentLevel()88
.....getCurrentLevelData()88
.....getLevelData()88
XglContext
.....addPickToBuffer()127
.....checkLastPick()128
.....getNewFramePlaneMask()127
.....getRealPlaneMask()127
.....getRealRenderBuffer()127
.....getSurfAttr()127
.....getSurfFrontFaceAttr()127
XglContext2d
.....assignCurStrokeAs...()128
.....getCurrentStroke()128
.....getViewGrp()128
XglContext3d
.....assignCurStrokeAs...()129
.....getBackTexturing()130
.....getCurrentStroke()129
.....getFrontTexturing()129
.....getSurfBackFaceAttr()129
.....getSurfBackFaceAttr3d()129
.....getSurfFrontFaceAttr3d()129
XglDevice
.....getCmap()145
.....getDpDev()131
.....getDrawable()131
.....getGammaInversePowerTable()131
.....getGammaPowerTable()131
.....getGammaValue()131
XglDmapTexture
.....getDescriptors()130, 134
XglDpCtx43 to 66
.....getting Context attribute values123
.....summary of interfaces68
XglDpDev38 to 42
.....accessing the Device object145
.....and the XglDrawable186
.....copyBuffer()39
.....createDpCtx()39
.....getDcOrientation()52
.....getGammaValue()52
.....getMaxZ()52
.....summary of interfaces68
XglDpDevMemRas
......getAccumBufferDepth()57
......getAccumBufferPixRect()57
......getImageBufferPixRect()56
......getZBufferPixRect()57
......setCmap()57
......setImageBufferAddr()57
......setLineBytes()57
......setZBufferAddr()57
XglDpDevRaster
......setRectList()53
......setRectNum()53
......setSourceBuffer()53
......setSwAccumBuffer()53
......setSwZBuffer()53
......syncRtnDevice()54
XglDpDevWinRas
......getAccumBufferDepth()54
......getDepth()54
......getRealColorType()54
......getSwAccumBuffer()56
......getSwZBuffer()56
......need RtnDevice()56
......resize()54
......setBackingStore()54
......setBufDisplay()55
......setBufDraw()55
......setBuffersRequested()54
......setBufMinDelay()55
......setCmap()55
......setPixelMapping()55
......setStereoMode()56
XglDpLib33 to 35
......getDpMgr()34
XglDpMgr36 to 37
......and the XglDrawable186
......createDpDev()37
......inquire()37
XglDrawable
......clipChanged()198
......creation186
......dbDisplayComplete()198
......dbGetWid()198
......dbUnGrab()203
......dpDisplayWait()198
......getClass()203
.....getClipStat()198
.....getDescriptor()203
.....getDevFd()198
.....getDevice()198
.....getDeviceName()198
.....getLockType()203
.....getMergeClipList()199
.....getMergeClipListCount()199
.....getMergeClipMask()199
.....getPipeName()203
.....getRealColorType()199
.....getType()203
.....getUserClipList()200
.....getUserClipListCount()200
.....getWid()199
.....getWindowDepth()199
.....getWindowHeight()199
.....getWindowWidth()199
.....getWindowX()199
.....getWindowY()199
.....getWsClipList()200
.....getWsClipListCount()199
.....grabDrawable()204
.....grabFCS()200
.....grabRetainedWindow()203
.....grabStereo()201
.....grabWids200
.....grabZbuf()200
.....matchDesc()204
.....possible()204
.....rendering186
.....resize()204
.....services provided185
.....setCursorRopFunc()201
.....setDisplayBuffer()201
.....setReadBuffer()202
.....setRectList()204
.....setRectNum()204
.....setWriteBuffer()202
.....software cursors196
.....subclasses184
.....synchonizing window access191
.....unGrabDrawable()204
.....unGrabRetainedWindow()204
.....WIN_LOCK()197
.....WIN_UNLOCK()198
......windowIsClipped()202
......windowIsObscured()202
......winLock()197
......winUnLock()197
XGLHOME environment variable21
XGLI_DC_OFFSET_BACK113
XGLI_DC_OFFSET_FRONT113
XGLI_DC_OFFSET_NONE112
XGLI_PIPELINE_CHECK_VERSION()65
XGLI_TRANS_INVERSE_VALID137
XGLI_TRANS_SINGULAR137
XglLevel79 to 83
......getFaceAttrs()84
......getFacetList()84
......getNumPointLists()84
......getPointLists()84
......getRenderFlags()84
XglLight
......getCosAngle2132
......getNegDirection()132
XglLinePattern
......getActualData()132
......getActualDataSize()132
......getActualOffset()133
......getLength()133
......getStartSeg()133
......getStartSegRemain()133
XglListOfDpMgr190
XglMarker
......getActualDescription()133
XglMipMapTexture
......getElement()133
XglPixRect89 to 94
XglPrimData82 to 84
......getApiData()75
......getCurrentLevel()84
......getCurrentLevelData()84
......getLevelData()84
......getProcessFlags()84
XglRaster
......getDoPixelMapping()134
......setDoPixelMapping()134
XglRasterWin
.....getSwAccumBuffer()135
.....getSwZBuffer()135
XglRectData85 to 89
XglSfont
.....getIsFontLoaded()136
.....getSfontData()136
.....getSfontInst()136
XglTransform
.....getFlag()142
.....getIsoTropicScale()143
.....getMatrix()143
.....getMatrixDouble()143
.....getMatrixFloat()142
.....getMatrixInt()143
.....getMemberRecord()142
.....getNorm()143
.....getNormInverse()143
.....transNormal()144
.....transPt()143
.....transPtList()144
.....transUnitNormal()144
.....transUnitNormalDouble()144
XglViewCache2d157
XglViewCache3d157
XglViewConcern2d157
XglViewConcern3d157
XglViewGrp2dConfig157
XglViewGrp2dItf157
XglViewGrp3dConfig157
XglViewGrp3dItf157

Z

Z-buffers, hardware195