Index

Numerics

4-bit deep screen format note	17

A

AddEnableDevice function	251
AggregatePlanes function	59
.....code example	60
.....default value	59
AssignTypeAndName function	251

C

CachedDrawCleanup function	207
CachedDrawInit function	205
ChokeFb function	212
CloseScreen function	21
CMAP library
.....introduction	99
.....allocating unique WIDs	132
.....allocating unique WIDs, examplecode	133
.....changing a colormap	129
.....changing a window's WID	128
.....colormap flashing reduction	104
.....compiling and linking	101
.....controlling MHC's WIDs	124 to 127
.....initialization functions, list of	100
.....MHC functions, list of	100
.....MPG and WID initialization	101
.....overloading WIDs	125
.....using WID	83
CmapClutPoolDesc structure	111
CmapDevFuncs	103
cmapGetColorData16 function	106
cmapGetColorData8 function	105
cmapMhcChangeFlavor function	130
cmapMhcForceOverload function	126
cmapMhcReleaseOverload function	127
cmapMhcWindowAttachWidfunction	128
cmapMhcWindowDetachWidfunction	129
cmapScreenInit function	102
CmapSetup function	214
color LUT pool description	110
colormap flashing reduction withCMAP	104
control plane group device with OVL	64
CopyAreaAndPaintType function	72
CopyPaintType function	70
CopyPlanes function	58
.....code example	60
.....default value	59
CreateMultibuffer2 function	140

cursor
.....hardware	30 to 39
.....kernel tracking	36, 39
.....software	26 to 30
custom device with OVL	65

D

DBSetup function	208
DDX handler naming convention	9
DDX interface, basic functions	25
DDX versioning	8 to 10
debugging note	6
DestroyMultibuffer function	141
device self-identification	8
DeviceBellCtrlProc function	260
DeviceBellProc function	258
DeviceBlockHandlerProc function	258
DeviceChangeCoreKeyboardProcfunction	256
DeviceChangeDeviceControlProcfunction	256
DeviceControlProc function	252
.....DEVICE_CLOSE action	230
.....DEVICE_INIT action	229
.....DEVICE_OFF action	230
.....DEVICE_ON action	229
device-dependent initialization	14
DeviceEnqueueProc function	253
DeviceGetMotionProc function	257
DeviceHandlerCompatible function	252
DeviceIntegerCtrlProc function	260
DeviceKbdCtrlProc function	259
DeviceLedCtrlProc function	259
DeviceModifierCheckProc function	254
DevicePointerAxisChangeProcfunction	257
DevicePtrCtrlProc function	259
DeviceReadProc function	254
DeviceSetDeviceValuatorsProcfunction	255
DeviceSetModeProc function	255
DeviceStringCtrlProc function	260
DeviceWakeupHandlerProc function	258
DGA drawable client library
......overview	147 to 152
......backing store	151, 176 to 182
......backing store and screendiagram	151
......clipping state	169 to 173
......compiling and linking	152
......cursor conflict	174 to 176
......DGA drawables	148
......drawable sites	164 to 169
......drawable types	148
......functions	153 to 199
......locking and change detection	156 to 160
......multibuffering grabber	186 to 195
......multibuffers destroyed note	199
......mutual exclusion	149
......sites	150
......utility functions	160 to 164
DGA drawable DDX library
......caching functions	218 to 219
......device functions	203 to 214
......device information functions	220 to 221
......initialization	201 to 203
......server multibuffering functions	214 to 218
dga_cm_devfd function	184
dga_cm_devinfop function	184
dga_cm_get_client_infop function	185
dga_cm_grab function	183
dga_cm_read function	186
dga_cm_set_client_infop function	185
dga_cm_ungrab function	183
dga_cm_write function	185
Dga_cur_memimage structure	175
Dga_cur_memimage structure, DGA_DRAW_MODIF note	176
dga_db_display function	191
dga_db_display_done function	193
dga_db_display_inquire function	194

dga_db_grab function	187
dga_db_interval function	190
dga_db_interval_check function	192
dga_db_interval_wait function	192
dga_db_read function	190
dga_db_read_inquire function	194
dga_db_ungrab function	188
dga_db_write function	189
dga_db_write_inquire function	193
dga_draw_address function	168
dga_draw_bbox function	170
dga_draw_bitsperpixel function	169
dga_draw_clipchg function	169
dga_draw_clipinfo function	172
dga_draw_curshandle function	175
dga_draw_depth function	162
dga_draw_devfd function	162
dga_draw_devinfo function	163
dga_draw_devname function	161
dga_draw_display function	160
dga_draw_empty function	171
dga_draw_get_client_infop function	163
dga_draw_id function	161
dga_draw_linebytes function	169
DGA_DRAW_LOCK macro	156
DGA_DRAW_LOCK_SRC_AND_DSTmacro	158
DGA_DRAW_MODIF macro	159
dga_draw_obscured function	173
dga_draw_rtnactive function	179
dga_draw_rtncached function	179
dga_draw_rtnchg function	178
dga_draw_rtndevinfop function	180
dga_draw_rtndevtype function	181
dga_draw_rtndimensions function	181
dga_draw_rtnpixels function	182
dga_draw_set_client_infop function	162
dga_draw_singlerect function	173
dga_draw_site function	167
dga_draw_sitechg function	164
dga_draw_sitegetnotify function	167
dga_draw_sitesetnotify function	166
dga_draw_type function	161
DGA_DRAW_UNLOCK macro	157
DGA_DRAW_UNLOCK_SRC_AND_DST macro	159
dga_draw_visibility function	171
dga_draw_visibility function,recommended use note	173
dga_draw_widinfop function	197
DGA_INIT macro	153
dga_win_dbinfop function	194
DgaAvail function	203
dgaCacheDescribeDev function	218
dgaCacheStateChange function	219
DgaDevFuncsDraw structure	202
dgaDevInfoChange function	221
dgaDevInfoGet function	220
dgaMbCrtSetInfo function	215
dgaMbGetBufferInfo function	218
dgaMbIsMultibuffer function	217
dgaMbSetBufViewability function	216
dgaMbSetDisplayBuf function	217
dgaScreenInit function	202
dgaSharedDataInfo function	219
direct color LUT, simulating indirect colorLUT	108
DisplayMultibuffer function	143
document conventions	xxi
drawable site types, definition	150
drawables, definition	148

E

export supported visuals	18
extensions
......requirements for dynamicallyloading	289 to 290

F

FcsSetup function	210

features, new this release	xxiii
firm_event structure	285 to 287
freeMpgInfo function	56
ftp program	xxxiv

G

gamma-corrected visuals	21 to 24
GetClutInfos function	74
GetDevname macro	15
getMpgInfoFromVisual function	55
GrabDrawable function	204
GrabDrawable function, first grabnotes	204

H

hardware cursor	30 to 39
hardware window IDs	79 to 80
hardwareSpriteFuncs array	39

I

indirect color LUT, simulating direct colorLUT	108
InitBellFeedbackClassDeviceStructfunction	241
InitButtonClassDeviceStructfunction	236
InitFocusClassDeviceStruct function	238
initialization
.....device dependent	14
.....function	7
.....SPARC example	7
.....steps	11 to 12
.....x86 example	7
InitIntegerFeedbackClassDeviceStructfunction	242
InitKbdFeedbackClassDeviceStructfunction	239
InitKeyboardDeviceStruct function	234
InitKeyClassDeviceStruct function	235
InitLedFeedbackClassDeviceStructfunction	240
initPixmap function	44
InitPointerDeviceStruct function	234
InitProximityClassDeviceStructfunction	238
InitPtrFeedbackClassDeviceStructfunction	239
InitStringFeedbackClassDeviceStructfunction	241
InitValuatorAxisStruct function	237
InitValuatorClassDeviceStructfunction	236
Input extension library
......overview	224
......adding a device	228 to 233
......block diagram	224
......close device	228
......debugging the device handler	232
......device control procedure	229
......device shared functions	252 to 260
......device-dependent procedures	232
......enqueue device procedure	231
......functions	233 to 260
......get device events procedure	230
......initialization	225
......open device	226
......OWconfig file entry	232
......prerequisite MIT documents	223
......reading devices data flowdiagram	227
......reading input data	226
......restart and shutdown	228
......STREAMS module	233
......VUID
............overview	283
............device controls	287
............firm events	285 to 287
............firm_event structure	285
............station codes	284
......writing the device handler	229 to 232
intended audience	xvii

L

LastUpdateTime function	145
libraries
.....short description table	2
.....colormap (CMAP)	99 to 134
.....DGA drawable client	147 to 199
.....DGA drawable DDX	201 to 221
.....Input extension	223 to 260
.....MBX	135 to 145
.....multiple plane group (MPG)	41 to 60
.....overlay windows (OVL)	61 to 78
.....where to initialize	19
.....window ID (WID)	79 to 97
loadable DDX handler
.....device self-identification	8
.....initialization function	7
.....installation hints	277 to 278
.....packaging hints	278 to 281
.....versioning	8 to 10
loadable DDX interface
.....debugging note	6
.....how the server interfaces with	5

M

MakeAtom function	250
mapped-access devices	104
MBX library
.....functions	137 to 145
.....initialization function, last releasenote	137
.....multibuffer flip modes	136
.....windows and sets, definitions	135
MbxDevFuncs structure	138
MbxScreenInit function	137
miDC layer	26 to 27
mieqEnqueue function	246
mieUpdateKbdPtr function	246
minimize window exposures, how to	57 to 60
miPointer layer	28 to 29
miPointerAbsoluteCursor function	248
miPointerDeltaCursor function	247
miPointerPosition function	247
miPointerScreenFuncs	28
miPointerSpriteFuncs	28
miPointerSpriteFuncs sample code	32 to 36
miSprite layer	29 to 30
MIT sample server, how to access	xx
MIT sample server, portinginformation	xx
MPG info, definition	42
MPG library
......architecture overview	41 to 44
......data structure initialization	43
......data structure initialization codeexample	44
......functions	44 to 60
......initialization order with DGAnote	54
......interface diagram	42
......macros	48
......plane group aliasing	49
......with WID	82, 83
MPG_DRAW, use with note	49
mpg_priv_scr macro	59
mpgChangeInfo function	55
mpgCopyPlanes function	58
mpgCursorInitialize function	56
mpgGetScreenState	45
mpgInfo, changing diagram	114
mpgInsertPlanegroup function	47
mpgScreenInit function	53
mpgSetCursorHasEnable function	57
mpgSetCursorValues	57
mpgVisInfo diagram	113
multibuffer flip modes	136
multiple-plane group support	3

N

new features	xxiii
NextBlockHandler function	250
NextWakeupHandler function	249

O

other applicable documents	xix
OVL library
.....introduction	61
.....device setup	62 to 65
............control plane group	64
............custom	65
............shared	65
............transparent pixel	63
.....initialization	66 to 67
.....MPG dependency note	62
OvlDevFuncs structure	70
ovlGetPaintType function	69
ovlIsOverlay function	69
OvlPairs structure	67
ovlScreenInit function	67
ovlWrapDevFuncs function	68
OWconfig file
.....access method	272 to 276
............database	272
............functions	273 to 275
............packaging	275
............typical usage	275
.....attributes, list of	266
.....file and module search paths	267
.....file format definition	266
.....SPARC example file	261
.....x86 example file	263
.....XDISPLAY class	268
.....XEXTENSION class	272
.....XINPUT class	271
.....XSCREEN class	270
.....XSCREENCONFIG class	269
OWconfig file
.....search path, SPARC	267
.....search path, x86	267
OWconfigFreeAttribute function	274
OWconfigFreeClassNames	273
OWconfigFreeClassNames function	273
OWconfigGetAttribute function	274
OWconfigGetClassNames	273
OWconfigGetClassNames function	273
OWconfigGetInstance function	274

P

pixmap formats supported	16
plane group aliasing	49
prerequisite knowledge	xvii

R

ReadScreen function	76
ReadScreenInit function	75
ReadScreenUninit function	77
RegisterChangeDeviceControlProcfunction	244
RegisterFdIo function	242
RegisterHandlers function	248
RegisterModifierCheckProc function	243
RegisterSetDeviceValuatorsProcfunction	244
RegisterXKeyboardInterest	245
RegisterXPointerInterest function	245
ReigsterSetDeviceModeProcfunction	243
RemoveEnableDevice function	251
RemoveHandlers function	249
RepositionMultibuffer function	143
ResizeMultibuffer function	142

S

SaveScreen function	20
SaveScreen function, sample code	20
screen pixmap, definition	42
screenFuncs function	38
ScreenRec function	13
SetMultibufferVisible function	145
SetupMultibufferInvisible function	144
SetupScreen function	46
shared device with OVL	65
simple frame buffer support	3
software cursor	26 to 30
software WID object	80
StereoSetup function	211

storeColorsFunc example code	106
Sun mouse, server constraints note	26
sunGetDDKVersion function	12
sunGetMonitorRes function	17
sunGetVisualInfo function	18
sunHWCursor functions	37 to 39
sunHWCursor layer	36 to 39
sunInitBanner function	19
sunOpenFrameBuffer function, do not usenote	14
sunPutInHardware function	38
sunQueryBestSize function	38
sunSaveScreen function, do not usenote	20
sunScreenAllocate function	13
sunScreenInit function, do not usenote	19
sunScreenRec data structure, minimizedependencies note	15
sunSetPixmapFormat function	16
sunSprite layer	30 to 32
SwitchScreen function	54
SyncDrawable function	213

T

take_down_func structure	175
take_down_func structure, call note	176
transparent pixel device with OVL	63
TryMpg function	138

U

UngrabDrawable function	205
UngrabDrawable function, first grabnote	205
UnsyncDrawable function	213

V

virtual user input device (vuid)interface	283 to 287
visfunc function	191
vrtfunc function	188

W

WID library
......allocation function example code	95
......changing a WID with CMAP	128
......data types	84 to 86
......device-dependent allocation	94
......free functions	94, 96
......functions	87 to 94
......hardware	79 to 80
......how to access	82
......object attributes	80 to 82
......overloading WIDs with CMAPlibrary	125
......pixel attributes, definition	79
......using CMAP	83
......using MPG	82, 83
......with DDX handlers	82
widAllocate function	88
WidAllocFunc structure	85
widAllocObj function	93
widDecref function	89
WidFreeFunc structure	86
widFreeObj function	94
widGetColorLut function	92
widGetDevData function	91
widGetFlavor function	91
widGetNumber function	90
widGetScreen function	89
widGetUnique function	91
widGetValue function	90
widGetVisual function	89
widGetWindowWid function	93
widIncref function	88
WidPtr structure	84
widScreenClose function	87
widScreenInit function	87
widSetColorLut function	92
WidSetColorLutFunc structure	86
widSetDevData function	91
WidSetup function	209

widSetValue function	90, 93
widSetWindowWid function	92
widWinGetValue function	90
wx_dbuf structure, device-specificfield	208

X

XDgaDrawGrabFCS function	197
XDgaDrawGrabStereo function	198
XDgaDrawGrabWids function	196
XDgaGrabColormap function	182
XDgaGrabDrawable function	154
XDgaUnGrabColormap function	184
XDgaUnGrabDrawable function	155
XDISPLAY class	268
XEXTENSION class	272
XI_event structure withDeviceEnqueueProc functionnote	253
XINPUT class	271
XOvlClutInfo structure	70
XSCREEN class	270
XSCREENCONFIG class	269

Z

ZbufSetup function	211