Index

Numerics

4-bit deep screen format note	19

A

AddEnableDevice function	259
AggregatePlanes function	63
.....code example	64
.....default value	63
AssignTypeAndName function	259

C

CachedDrawCleanup function	215
CachedDrawInit function	213
ChokeFb function	220
CloseScreen function	23
CMAP library
.....introduction	105
.....allocating unique WIDs	138
.....allocating unique WIDs, examplecode	139
.....changing a colormap	135
.....changing a window's WID	134
.....colormap flashing reduction	110
.....controlling MHC's WIDs	130 to 133
.....initialization functions, list of	106
.....overloading WIDs	131
.....using WID	89
CmapClutPoolDesc structure	117
cmapGetColorData16 function	112
cmapGetColorData8 function	111
cmapMhcChangeFlavor function	136
cmapMhcForceOverload function	132
cmapMhcReleaseOverload function	133
cmapMhcWindowAttachWidfunction	134
cmapMhcWindowDetachWidfunction	135
CmapSetup function	222
color LUT pool description	116
colormap flashing reduction withCMAP	110
colormaps and DGA	229
control plane group device with OVL	70
CopyAreaAndPaintType function	78
CopyPaintType function	76
CopyPlanes function	62
.....code example	64
.....default value	63
CreateMultibuffer2 function	146
cursor
.....hardware	34 to 44
.....kernel tracking	41, 44
.....software	30 to 34

custom device with OVL	71

D

DBSetup function	216
DDX handler naming convention	10
DDX interface, basic functions	29
DDX versioning	9 to 11
debugging note	6
DestroyMultibuffer function	147
device self-identification	8
DeviceBellCtrlProc function	268
DeviceBellProc function	266
DeviceBlockHandlerProc function	266
DeviceChangeCoreKeyboardProcfunction	264
DeviceChangeDeviceControlProcfunction	264
DeviceControlProc function	260
.....DEVICE_CLOSE action	238
.....DEVICE_INIT action	237
.....DEVICE_OFF action	238
.....DEVICE_ON action	237
device-dependent initialization	17
DeviceEnqueueProc function	261
DeviceGetMotionProc function	265
DeviceHandlerCompatible function	260
DeviceIntegerCtrlProc function	268
DeviceKbdCtrlProc function	267
DeviceLedCtrlProc function	267
DeviceModifierCheckProc function	262
DevicePointerAxisChangeProcfunction	265
DevicePtrCtrlProc function	267
DeviceReadProc function	262
DeviceSetDeviceValuatorsProcfunction	263
DeviceSetModeProc function	263
DeviceStringCtrlProc function	268
DeviceWakeupHandlerProc function	266
DGA drawable client library
.....overview	153 to 158
......backing store	157, 182 to 188
......backing store and screendiagram	157
......clipping state	175 to 179
......compiling and linking	158
......cursor conflict	180 to 182
......DGA drawables	154
......drawable sites	170 to 175
......drawable types	154
......functions	159 to 205
......locking and change detection	162 to 166
......multibuffering grabber	192 to 201
......multibuffers destroyed note	205
......sites	156
......utility functions	166 to 170
DGA drawable DDX library
......caching functions	226 to 227
......device functions	211 to 222
......device information functions	228 to 229
......initialization	209 to 211
......server multibuffering functions	222 to 226
dga_cm_devfd function	190
dga_cm_devinfop function	190
dga_cm_get_client_infop function	191
dga_cm_grab function	189
dga_cm_set_client_infop function	191
dga_cm_ungrab function	189
dga_cm_write function	191
Dga_cur_memimage structure	181
Dga_cur_memimage structure, DGA_DRAW_MODIF note	182
dga_db_display function	197
dga_db_display_done function	200
dga_db_display_inquire function	199
dga_db_grab function	193
dga_db_interval function	198
dga_db_interval_check function	198
dga_db_interval_wait function	198
dga_db_read function	196
dga_db_read_inquire function	199

dga_db_ungrab function	194
dga_db_write function	195
dga_db_write_inquire function	199
dga_draw_address function	174
dga_draw_bbox function	176
dga_draw_bitsperpixel function	175
dga_draw_clipchg function	175
dga_draw_clipinfo function	178
dga_draw_curshandle function	181
dga_draw_depth function	168
dga_draw_devfd function	168
dga_draw_devinfo function	169
dga_draw_devname function	167
dga_draw_display function	166
dga_draw_empty function	177
dga_draw_get_client_infop function	169
dga_draw_id function	167
dga_draw_linebytes function	175
DGA_DRAW_LOCK macro	162
DGA_DRAW_LOCK_SRC_AND_DSTmacro	164
DGA_DRAW_MODIF macro	165
dga_draw_obscured function	179
dga_draw_rtnactive function	185
dga_draw_rtncached function	185
dga_draw_rtnchg function	184
dga_draw_rtndevinfop function	186
dga_draw_rtndevtype function	187
dga_draw_rtndimensions function	187
dga_draw_rtnpixels function	188
dga_draw_set_client_infop function	168
dga_draw_singlerect function	179
dga_draw_site function	173
dga_draw_sitechg function	170
dga_draw_sitegetnotify function	173
dga_draw_sitesetnotify function	172
dga_draw_type function	167
DGA_DRAW_UNLOCK macro	163
DGA_DRAW_UNLOCK_SRC_AND_DST macro	165
dga_draw_visibility function	177
dga_draw_visibility function,recommended use note	179
dga_draw_widinfop function	203
DGA_INIT macro	159
dga_win_dbinfop function	200
DgaAvail function	211
dgaCacheDescribeDev function	226
dgaCacheStateChange function	227
DgaDevFuncsDraw structure	210
dgaDevInfoChange function	229
dgaDevInfoGet function	228
dgaMbCrtSetInfo function	223
dgaMbGetBufferInfo function	226
dgaMbIsMultibuffer function	225
dgaMbSetBufViewability function	224
dgaMbSetDisplayBuf function	225
dgaScreenInit function	210
dgaSharedDataInfo function	227
direct color LUT, simulating indirect colorLUT	114
directAccessDPS function	275
directAccessEnd function	274
directAccessStart function	274
DisplayMultibuffer function	149
document conventions	xxi
drawable site types, definition	156
drawables, definition	154

E

export supported visuals	21
extensions
......requirements for dynamicallyloading	315 to 316

F

FcsSetup function	218
features, new this release	xxiii
firm_event structure	311 to 313
freeMpgInfo function	60

ftp program	xxxi

G

gamma-corrected visuals	24 to 27
GetClutInfos function	80
GetDevname macro	17
getMpgInfoFromVisual function	59
GrabDrawable function	212
GrabDrawable function, first grabnotes	212

H

hardware cursor	34 to 44
hardware window IDs	85 to 86
hardwareSpriteFuncs array	43

I

indirect color LUT, simulating direct colorLUT	114
InitBellFeedbackClassDeviceStructfunction	249
InitButtonClassDeviceStructfunction	244
InitFocusClassDeviceStruct function	246
initialization
.....device dependent	17
.....function	7
.....PowerPC example	8
.....SPARC example	8
.....steps	14
.....x86 example	8
InitIntegerFeedbackClassDeviceStructfunction	250
InitKbdFeedbackClassDeviceStructfunction	247
InitKeyboardDeviceStruct function	242
InitKeyClassDeviceStruct function	243
InitLedFeedbackClassDeviceStructfunction	248
initPixmap function	48
InitPointerDeviceStruct function	242
InitProximityClassDeviceStructfunction	246
InitPtrFeedbackClassDeviceStructfunction	247
InitStringFeedbackClassDeviceStructfunction	249
InitValuatorAxisStruct function	245
InitValuatorClassDeviceStructfunction	244
Input extension library
......overview	232
......adding a device	236 to 241
......block diagram	232
......close device	236
......debugging the device handler	240
......device control procedure	237
......device shared functions	260 to 268
......device-dependent procedures	240
......enqueue device procedure	239
......functions	241 to 268
......get device events procedure	238
......initialization	233
......open device	234
......OWconfig file entry	240
......prerequisite MIT documents	231
......reading devices data flowdiagram	235
......reading input data	234
......restart and shutdown	236
......STREAMS module	241
......VUID
............overview	309
............device controls	313
............firm events	311 to 313
............firm_event structure	311
............station codes	310
......writing the device handler	237 to 240
intended audience	xvii

L

LastUpdateTime function	151
libraries
......colormap (CMAP)	105 to 140
......DGA drawable client	153 to 205

.....DGA drawable DDX	209 to 229
.....Input extension	231 to 268
.....MBX	141 to 151
.....multiple plane group (MPG)	45 to 64
.....overlay windows (OVL)	67 to 84
.....where to initialize	21
.....window ID (WID)	85 to 103
loadable DDX handler
.....device self-identification	8
.....initialization function	7
.....installation hints	303 to 304
.....packaging hints	304 to 307
.....versioning	9 to 11
loadable DDX interface
.....debugging note	6
.....how the server interfaces with	5

M

MakeAtom function	258
mapped-access devices	110
MBX library
.....functions	143 to 151
.....initialization function, last releasenote	143
.....multibuffer flip modes	142
.....windows and sets, definitions	141
MbxDevFuncs structure	144
MbxScreenInit function	143
miDC layer	30 to 32
mieqEnqueue function	254
mieqUpdateKbdPtr function	254
minimize window exposures, how to	61 to 64
miPointer layer	32 to 33
miPointerAbsoluteCursor function	256
miPointerDeltaCursor function	255
miPointerPosition function	255
miPointerScreenFuncs	32
miPointerSpriteFuncs	32
miPointerSpriteFuncs sample code	37 to 40
miSetZeroLineBias function	34
miSprite layer	33 to 34
MIT sample server, how to access	xx
MIT sample server, portinginformation	xx
MPG info, definition	46
MPG library
......architecture overview	45 to 48
......data structure initialization	47
......data structure initialization codeexample	48
......functions	48 to 64
......initialization order with DGAnote	58
......interface diagram	46
......macros	52
......plane group aliasing	53
......with WID	88, 89
MPG_DRAW, use with note	53
mpg_priv_scr macro	63
mpgChangeInfo function	59
mpgCopyPlanes function	62
mpgCursorInitialize function	60
mpgGetScreenState	49
mpgInfo, changing diagram	120
mpgInsertPlanegroup function	51
mpgScreenInit function	57
mpgSetCursorHasEnable function	61
mpgSetCursorValues	61
mpgSetScreenFuncs function	65
mpgVisInfo diagram	119
multibuffer flip modes	142
mutiple plane support	3

N

new features	xxiii
NextBlockHandler function	258
NextWakeupHandler function	257

O

other applicable documents	xix
overview

.....DDX Interface	2
.....utility libraries	2
OVL library
.....introduction	67
.....device setup	68 to 71
............control plane group	70
............custom	71
............shared	71
............transparent pixel	69
.....initialization	72 to 73
.....MPG dependency note	68
OvlDevFuncs structure	76
ovlGetPaintType function	75
ovlIsOverlay function	75
OvlPairs structure	73
ovlScreenInit function	73
ovlWrapDevFuncs function	74
OWconfig file
.....access method
............functions	297 to 300
............packaging	300
............typical usage	300
.....attributes, list of	290
.....file and module search paths	291
.....file format definition	289
.....PowerPC example file	288
.....SPARC example file	284
.....x86 example file	286
.....XDISPLAY class	292
.....XEXTENSION class	296
.....XSCREEN class	294
.....XSCREENCONFIG class	293
OWconfig file
.....search path, PowerPC	291
.....search path, SPARC	291
.....search path, x86	291
OWconfigFreeAttribute function	299
OWconfigFreeClassNames	298
OWconfigFreeClassNames function	298
OWconfigGetAttribute function	298
OWconfigGetClassNames	298
OWconfigGetClassNames function	298
OWconfigGetInstance function	299

P

pixmap formats supported	19
plane group aliasing	53
prerequisite knowledge	xvii

R

ReadScreen function	82
ReadScreenInit function	81
ReadScreenUninit function	83
RegisterChangeDeviceControlProcfunction	252
RegisterFdIo function	250
RegisterHandlers function	256
RegisterModifierCheckProc function	251
RegisterSetDeviceModeProcfunction	251
RegisterSetDeviceValuatorsProcfunction	252
RegisterXKeyboardInterest	253
RegisterXPointerInterest function	253
RemoveEnableDevice function	259
RemoveHandlers function	257
RepositionMultibuffer function	149
ResizeMultibuffer function	148

S

SaveScreen function	22
SaveScreen function, sample code	23
screen pixmap, definition	46
screenFuncs function	43
ScreenRec function	15
SetMultibufferVisible function	151
SetupMultibufferInvisible function	150
SetupScreen function	50
shared device with OVL	71
ShmRegisterFbFuncs function	280
ShmRegisterFuncs function	281
ShmSetPixmapFormat function	281
simple frame buffer support	3

software cursor	30 to 34
software WID object	86
StereoSetup function	219
storeColorsFunc example code	112
Sun mouse, server constraints note	30
sunDPAAccessType function	273
sunGetDDKVersion function	15
sunGetMonitorRes function	20
sunGetVisualInfo function	20
sunHWCursor functions	42 to 44
sunHWCursor layer	41 to 44
sunInitBanner function	21
sunOpenFrameBuffer function, do not usenote	17
sunPutInHardware function	43
sunQueryBestSize function	42
sunSaveScreen function, do not usenote	23
sunScreenAllocate function	16
sunScreenInit function, do not usenote	22
sunScreenRec data structure, minimizedependencies note	18
sunSetPixmapFormat function	18
sunSprite layer	35 to 36
SwitchScreen function	58
SyncDrawable function	221

T

take_down_func structure	181
take_down_func structure, call note	182
transparent pixel device with OVL	69
TryMpg function	144

U

UngrabDrawable function	213
UngrabDrawable function, first grabnote	213
UnsyncDrawable function	221

V

virtual user input device (vuid)interface	309 to 313
visfunc function	197
vrtfunc function	194

W

WID library
......allocation function examplecode	101
......changing a WID with CMAP	134
......data types	90 to 92
......device-dependent allocation	100
......free functions	100, 102
......functions	93 to 100
......hardware	85 to 86
......how to access	88
......object attributes	86 to 88
......overloading WIDs with CMAPlibrary	131
......pixel attributes, definition	85
......using CMAP	89
......using MPG	88, 89
......with DDX handlers	88
widAllocate function	94
WidAllocFunc structure	91
widAllocObj function	99
widDecref function	95
WidFreeFunc structure	92
widFreeObj function	100
widGetColorLut function	98
widGetDevData function	97
widGetFlavor function	97
widGetNumber function	96
widGetScreen function	95
widGetUnique function	97
widGetValue function	96
widGetVisual function	95
widGetWindowWid function	99
widIncref function	94
WidPtr structure	90

widScreenClose function	93
widScreenInit function	93
widSetColorLut function	98
WidSetColorLutFunc structure	92
widSetDevData function	97
WidSetup function	217
widSetValue function	96, 99
widSetWindowWid function	98
widWinGetValue function	96
wx_dbuf structure, device-specificfield	216

X

XDgaDrawGrabFCS function	203
XDgaDrawGrabStereo function	204
XDgaDrawGrabWids function	202
XDgaGrabColormap function	188
XDgaGrabDrawable function	160
XDgaUnGrabColormap function	190
XDgaUnGrabDrawable function	161
XDISPLAY class	292
XEXTENSION class	296
XI_event structure withDeviceEnqueueProc functionnote	261
XOvlClutInfo structure	76
XSCREEN class	294
XSCREENCONFIG class	293

Z

ZbufSetup function	219