graphics.hlp (
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
_getvideoconfig
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
The _getvideoconfig function returns the current graphics
environment configuration in a videoconfig structure (defined in
GRAPH.H).
The values returned reflect the currently active monitor and the
currently specified video mode.
The videoconfig structure contains the following elements:
Element Contents
numxpixels Number of pixels on the x axis
numypixels Number of pixels on the y axis
numtextcols Number of text columns available
numtextrows Number of text rows available
numcolors Number of actual colors available
bitsperpixel Number of bits per pixel
numvideopages Number of available video pages
mode Current video mode
adapter Active display adapter
monitor Active display monitor
memory Adapter video memory in kilobytes
The values for the adapter element of the videoconfig structure
are given by the manifest constants shown in the list below.
Note that for any applicable adapter (_CGA, _EGA, or _VGA), the
corresponding Olivetti(R) adapter (_OCGA, _OEGA, or _OVGA)
represents a superset of graphics capabilities.
Constant Meaning
_MDPA Monochrome Display Printer Adapter
_CGA Color Graphics Adapter
_OCGA Olivetti (AT&T) Color Graphics Adapter
_EGA Enhanced Graphics Adapter
_OEGA Olivetti (AT&T) Enhanced Graphics Adapter
_VGA Video Graphics Array
_OVGA Olivetti (AT&T) Video Graphics Array
_MCGA Multicolor Graphics Array
_HGC Hercules(R) Graphics Card
The values for the monitor element of the videoconfig structure
are given by the manifest constants listed below:
Constant Meaning
_MONO Monochrome monitor
_COLOR Color (or enhanced monitor emulating color)
_ENHCOLOR Enhanced color
_ANALOGMONO Analog (monochrome only)
_ANALOGCOLOR Analog (color only)
_ANALOG Analog (monochrome and color modes)
In every text mode, including monochrome, the _getvideoconfig
function returns the value 32 for the number of available colors.
The value 32 indicates the range of values (0-31) accepted by the
_settextcolor function. This includes sixteen normal colors (0-15)
and sixteen blinking colors (16-31). Blinking is selected by
adding 16 to the normal color value.
Monochrome text mode has fewer unique display attributes, so some
color values are redundant. However, because blinking is selected
in the same manner, monochrome text mode has the same range (0-31)
as other text modes.
Return Value
The _getvideoconfig function returns the video configuration in a
structure as noted above. There is no error return.
-♦-