[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
DW BITMAPUTIL ; Bitmap Utilities Function Table
Input:
Nothing
Return:
ES:BX --> BitMap Utility Table.
The BITMAPUTIL vector loads a pointer into ES:BX, which is the base of a
table defining special case-entry points used for pixel manipulation.
These functions are currently only called by the ellipse emulation routines
that are in the BGI Kernel. If the device driver does not use emulation
for ellipses, this entry does not need to be implemented. This entry was
provided because some hardware requires additional commands to enter and
exit pixel mode, thus adding overhead to the GETPIXEL and SETPIXEL vectors.
This overhead affected the drawing speed of the ellipse emulation routines.
These entry points are provided so that the ellipse emulation routines can
enter pixel mode, and remain in pixel mode for the duration of the ellipse-
rendering process.
The format of the BITMAPUTIL table is as follows:
DW offset GOTOGRAPHIC ; Enter pixel mode on the graphics hardware
DW offset EXITGRAPHIC ; Leave pixel mode on the graphics hardware
DW offset PUTPIXEL ; Write a pixel to the graphics hardware
DW offset GETPIXEL ; Read a pixel from the graphics hardware
DW offset GETPIXBYTE ; Return a word containing the pixel depth
DW offset SET_DRAW_PAGE ; Select page in which to draw primitives
DW offset SET_VISUAL_PAGE ; Set the page to be displayed
DW offset SET_WRITE_MODE ; XOR Line Drawing Control
The parameters of these functions are as follows:
GOTOGRAPHIC ; Enter pixel mode on the graphics hardware
This function is used to enter the special Pixel Graphics mode.
EXITGRAPHIC ; Leave pixel mode on the graphics hardware
This function is used to leave the special Pixel Graphics mode.
PUTPIXEL ; Write a pixel to the graphics hardware
This function has the same format as the PUTPIXEL entry described
above.
GETPIXEL ; Read a pixel from the graphics hardware
This function has the same format as the GETPIXEL entry described
above.
GETPIXBYTE ; Return a word containing the pixel depth
This function returns the number of bits per pixel (color depth) of
the graphics hardware in the AX register.
SET_DRAW_PAGE ; Select alternate output graphics pages (if any)
This function take the desired page number in the AL register and
selects alternate graphics pages for output of graphics primitives.
SET_VISUAL_PAGE ; Select the visible alternate graphics pages (if any)
This function take the desired page number in the AL register and
selects alternate graphics for displaying on the screen.
SET_WRITE_MODE ; XOR Line drawing mode control. XOR Mode is selected
if the value in AX is one, and disabled if the value in AX is zero.
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson