home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / prg / sphinx / vesa.h__ < prev    next >
Text File  |  1994-03-20  |  11KB  |  317 lines
  1. /*
  2.     SPHINX Programming (C) 1994.
  3.     NAME:  VESA.H--
  4.     DESCRIPTION:  This file contains some basic constant and procedure
  5.                   definitions for using VESA standard video modes.  VESA 1.0+
  6.                   video BIOS is required.
  7.     LAST MODIFIED:  20 Mar 1994
  8.     PROCEDURES DEFINED IN THIS FILE:
  9.         byte setVESAvideomode(VESAmode)
  10.       : byte SETVESA_MEMPOS(window_address,window_num)
  11. */
  12.  
  13.  
  14. /* VESA SuperVGA BIOS modes */
  15. enum { VESA_640x400_256=0x100, VESA_640x480_256,    VESA_800x600_16,
  16.        VESA_800x600_256,       VESA_1024x768_16,    VESA_1024x768_256,
  17.        VESA_1280x1024_16,      VESA_1280x1024_256,  VESA_text80x60,
  18.        VESA_text132x25,        VESA_text132x43,     VESA_text132x50,
  19.        VESA_text132x60,        VESA_320x200_32k,    VESA_320x200_64k,
  20.        VESA_320x200_16M,       VESA_640x480_32k,    VESA_640x480_64k,
  21.        VESA_640x480_16M,       VESA_800x600_32k,    VESA_800x600_64k,
  22.        VESA_800x600_16M,       VESA_1024x768_32k,   VESA_1024x768_64k,
  23.        VESA_1024x768_16M,      VESA_1280x1024_32k,  VESA_1280x1024_64k,
  24.        VESA_1280x1024_16M };
  25.  
  26.  
  27. /*** fields below are filled after each successful setVESAvideomode call ***/
  28. word vesa_mode_attr;    // info on selected mode 
  29. byte vesa_win_a_info;   /* window A attributes:
  30.                       bit 0: exists
  31.                 bit 1: readable
  32.                 bit 2: writable
  33.                 bits 3-7 reserved */
  34. byte vesa_win_b_info;   /* window B attributes:
  35.                       bit 0: exists
  36.                 bit 1: readable
  37.                 bit 2: writable
  38.                 bits 3-7 reserved */
  39. word vesa_win_gran;     // window granularity in KB
  40. word vesa_win_size;     // window size in KB
  41. word vesa_win_a_seg;    // start segment location of window A
  42. word vesa_win_b_seg;    // start segment location of window B
  43. dword vesa_pos_func;    /* FAR pointer to window position function
  44.                                 (equivalent to AX=4F05h, INT 0x10) */
  45. word vesa_bytes_scan;   // number of bytes per scan line
  46. /*** fields above are filled after each successful setVESAvideomode call ***/
  47.  
  48.  
  49. byte setVESAvideomode (word VESAmode) 
  50. /* set bit 15 in VESAmode to prevent clearing of video memory */
  51. /*
  52.    Returns 0 on success or non-0 on error.
  53. */
  54. byte vesabuf[256];
  55. {
  56. BX = VESAmode;
  57. AX = 0x4F02;
  58. $ INT 0x10      // set vesa video mode
  59. IF( AX != 0x004F )
  60.     return(1);  // error return
  61.  
  62. ES = SS;
  63. DI = #vesabuf;
  64. CX = VESAmode;
  65. AX = 0x4F01;
  66. $ INT 0x10      // get vesa video mode information
  67. IF( AX != 0x004F )
  68.     return(2);  // error return
  69.  
  70. vesa_mode_attr = SSWORD[#vesabuf[0]];
  71. vesa_win_a_info = vesabuf[2];
  72. vesa_win_b_info = vesabuf[3];
  73. vesa_win_gran = SSWORD[#vesabuf[4]];
  74. vesa_win_size = SSWORD[#vesabuf[6]];
  75. vesa_win_a_seg = SSWORD[#vesabuf[8]];
  76. vesa_win_b_seg = SSWORD[#vesabuf[0xA]];
  77. vesa_pos_func = SSDWORD[#vesabuf[0xC]];
  78. vesa_bytes_scan = SSWORD[#vesabuf[0x10]];
  79.  
  80. IF( vesa_mode_attr & 1 == 0 )  // check if mode supported
  81.     return(3);  // error return
  82.  
  83. IF( vesa_win_a_info & 0b111 != 0b111 )  // check if window A exists R/W
  84.     return(4);  // error return
  85.  
  86. return(0);
  87. }
  88.  
  89.  
  90. : byte SETVESA_MEMPOS ()   /* AX = window address in granularity units
  91.                               BX = window number (0 for A and 1 for B)
  92.                            */
  93. {
  94. DX = AX;
  95. AX = 0x4F05;
  96. // BH = 0;   <<<  BH is already zero so this line is not needed
  97.  
  98. $INT 0x10
  99. // $ CALL FAR vesa_pos_func
  100.  
  101. IF( AX == 0x004F )
  102.     AL = 0;
  103. ELSE AL = 1;
  104. } 
  105.  
  106.  
  107. /* end of VESA.H-- */
  108.  
  109. /*
  110.  
  111. BELOW is some information that might be used to enhance this file in the
  112. future.
  113.  
  114. --------V-104F00-----------------------------
  115. INT 10 - VESA SuperVGA BIOS - GET SuperVGA INFORMATION
  116.     AX = 4F00h
  117.     ES:DI -> 256-byte buffer for SuperVGA information (see below)
  118. Return: AL = 4Fh function supported
  119.     AH = status
  120.         00h successful
  121.         ES:DI buffer filled
  122.         01h failed
  123. Desc:    determine whether VESA BIOS extensions are present and the capabilities
  124.       supported by the display adapter
  125. SeeAlso: AX=4F01h,AX=7F00h
  126. Index:    installation check;VESA
  127.  
  128. Format of SuperVGA information:
  129. Offset    Size    Description
  130.  00h  4 BYTEs    signature ('VESA')
  131.  04h    WORD    VESA version number
  132.  06h    DWORD    pointer to OEM name
  133.         "761295520" for ATI
  134.  0Ah  4 BYTEs    capabilities
  135.  0Eh    DWORD    pointer to list of supported VESA and OEM video modes
  136.         (list of words terminated with FFFFh)
  137.  12h    WORD    total amount of video memory in 64K blocks
  138.  14h 236 BYTEs    reserved
  139. Notes:    the list of supported video modes is stored in the reserved portion of
  140.       the SuperVGA information record by some implementations, and it may
  141.       thus be necessary to either copy the mode list or use a different
  142.       buffer for all subsequent VESA calls
  143.     the 1.1 VESA document specifies 242 reserved bytes at the end, so the
  144.       buffer should be 262 bytes to ensure that it is not overrun
  145. --------V-104F01-----------------------------
  146. INT 10 - VESA SuperVGA BIOS - GET SuperVGA MODE INFORMATION
  147.     AX = 4F01h
  148.     CX = SuperVGA video mode
  149.     ES:DI -> 256-byte buffer for mode information (see below)
  150. Return: AL = 4Fh function supported
  151.     AH = status
  152.         00h successful
  153.         ES:DI buffer filled
  154.         01h failed
  155. Desc:    determine the attributes of the specified video mode
  156. SeeAlso: AX=4F00h,AX=4F02h
  157.  
  158. Format of mode information:
  159. Offset    Size    Description
  160.  00h    WORD    mode attributes
  161.         bit 0: mode supported
  162.         bit 1: optional information available
  163.         bit 2: BIOS output supported
  164.         bit 3: set if color, clear if monochrome
  165.         bit 4: set if graphics mode, clear if text mode
  166.  02h    BYTE    window A attributes
  167.         bit 0: exists
  168.         bit 1: readable
  169.         bit 2: writable
  170.         bits 3-7 reserved
  171.  03h    BYTE    window B attributes (as for window A)
  172.  04h    WORD    window granularity in KB
  173.  06h    WORD    window size in KB
  174.  08h    WORD    start segment of window A
  175.  0Ah    WORD    start segment of window B
  176.  0Ch    DWORD    -> FAR window positioning function (equivalent to AX=4F05h)
  177.  10h    WORD    bytes per scan line
  178. ---remainder is optional for VESA modes in v1.0/1.1, needed for OEM modes---
  179.  12h    WORD    width in pixels (graphics) or characters (text)
  180.  14h    WORD    height in pixels (graphics) or characters (text)
  181.  16h    BYTE    width of character cell in pixels
  182.  17h    BYTE    height of character cell in pixels
  183.  18h    BYTE    number of memory planes
  184.  19h    BYTE    number of bits per pixel
  185.  1Ah    BYTE    number of banks
  186.  1Bh    BYTE    memory model type (see below)
  187.  1Ch    BYTE    size of bank in KB
  188.  1Dh    BYTE    number of image pages
  189.  1Eh    BYTE    reserved (0)
  190. ---VBE v1.2+---
  191.  1Fh    BYTE    red mask size
  192.  20h    BYTE    red field position
  193.  21h    BYTE    green mask size
  194.  22h    BYTE    green field size
  195.  23h    BYTE    blue mask size
  196.  24h    BYTE    blue field size
  197.  25h    BYTE    reserved mask size
  198.  26h    BYTE    reserved mask position
  199.  27h    BYTE    direct color mode info
  200.  28h 216 BYTEs    reserved (0)
  201.  
  202. Values for memory model type:
  203.  00h    text
  204.  01h    CGA graphics
  205.  02h    HGC graphics
  206.  03h    16-color (EGA) graphics
  207.  04h    packed pixel graphics
  208.  05h    "sequ 256" (non-chain 4) graphics
  209.  06h    direct color (HiColor, 24-bit color)
  210.  07h    YUV (luminance-chrominance, also called YIQ)
  211.  08h-0Fh reserved for VESA
  212.  10h-FFh OEM memory models
  213. --------V-104F02-----------------------------
  214. INT 10 - VESA SuperVGA BIOS - SET SuperVGA VIDEO MODE
  215.     AX = 4F02h
  216.     BX = mode
  217.         bit 15 set means don't clear video memory
  218. Return: AL = 4Fh function supported
  219.     AH = status
  220.         00h successful
  221.         01h failed
  222. SeeAlso: AX=4F01h,AX=4F03h
  223. --------V-104F03-----------------------------
  224. INT 10 - VESA SuperVGA BIOS - GET CURRENT VIDEO MODE
  225.     AX = 4F03h
  226. Return: AL = 4Fh function supported
  227.     AH = status
  228.         00h successful
  229.         01h failed
  230.     BX = video mode (see AX=4F02h)
  231. SeeAlso: AX=4F02h
  232. --------V-104F04-----------------------------
  233. INT 10 - VESA SuperVGA BIOS - SAVE/RESTORE SuperVGA VIDEO STATE
  234.     AX = 4F04h
  235.     DL = subfunction
  236.         00h get state buffer size
  237.         Return: BX = number of 64-byte blocks needed
  238.         01h save video states
  239.         ES:BX -> buffer
  240.         02h restore video states
  241.         ES:BX -> buffer
  242.     CX = flags for states to save/restore
  243.         bit 0: video hardware state
  244.         bit 1: video BIOS data state
  245.         bit 2: video DAC state
  246.         bit 3: SuperVGA state
  247. Return: AL = 4Fh function supported
  248.     AH = status
  249.         00h successful
  250.         01h failed
  251. --------V-104F05-----------------------------
  252. INT 10 - VESA SuperVGA BIOS - CPU VIDEO MEMORY CONTROL
  253.     AX = 4F05h
  254.     BH = subfunction
  255.         00h select video memory window
  256.         DX = window address in video memory (in granularity units)
  257.         01h get video memory window
  258.         Return: DX = window address in video memory (in gran. units)
  259.     BL = window number
  260.         00h window A
  261.         01h window B
  262. Return: AL = 4Fh function supported
  263.     AH = status
  264.         00h successful
  265.         01h failed
  266. SeeAlso: AX=4F01h,AX=4F06h,AX=4F07h,AX=7000h/BX=0004h
  267. --------V-104F06-----------------------------
  268. INT 10 - VESA SuperVGA BIOS v1.1+ - GET/SET LOGICAL SCAN LINE LENGTH
  269.     AX = 4F06h
  270.     BL = function
  271.         00h set scan line length
  272.         CX = desired width in pixels
  273.         01h get scan line length
  274. Return: AL = 4Fh if function supported
  275.     AH = status
  276.         00h successful
  277.         01h failed
  278.     BX = bytes per scan line
  279.     CX = number of pixels per scan line
  280.     DX = maximum number of scan lines
  281. Notes:    if the desired width is not achievable, the next larger width will be
  282.       set
  283.     the scan line may be wider than the visible area of the screen
  284.     this function is valid in text modes, provided that values are
  285.       multiplied by the character cell width/height
  286. SeeAlso: AX=4F01h,AX=4F05h,AX=4F07h
  287. --------V-104F07BH00-------------------------
  288. INT 10 - VESA SuperVGA BIOS v1.1+ - GET/SET DISPLAY START
  289.     AX = 4F07h
  290.     BH = 00h (reserved)
  291.     BL = function
  292.         00h set display start
  293.         CX = leftmost displayed pixel in scan line
  294.         DX = first displayed scan line
  295.         01h get display start
  296.         Return: BH = 00h
  297.             CX = leftmost displayed pixel in scan line
  298.             DX = first displayed scan line
  299. Return: AL = 4Fh if function supported
  300.     AH = status
  301.         00h successful
  302.         01h failed
  303. Note:    this function is valid in text modes, provided that values are
  304.       multiplied by the character cell width/height
  305. SeeAlso: AX=4F01h,AX=4F05h,AX=4F06h
  306. --------V-104F08-----------------------------
  307. INT 10 - VESA SuperVGA BIOS v1.2+ - GET/SET DAC PALETTE CONTROL
  308.     AX = 4F08h
  309.     BL = function
  310.         00h set DAC palette width
  311.         BH = desired number of bits per primary color
  312.         01h get DAC palette width
  313. Return: AL = 4Fh if function supported
  314.     AH = status
  315.     BH = current number of bits per primary (06h = standard VGA)
  316. ---------------------------------------------
  317. */