home *** CD-ROM | disk | FTP | other *** search
/ Fractal Creations (Second Edition) / FRACTALS_2E.iso / frasrc.exe / YOURVID.C < prev    next >
Text File  |  1992-07-10  |  4KB  |  141 lines

  1. /*
  2.  
  3.     Roll-Your-Own video mode (DOTMODE 19) routines.
  4.  
  5. Even if you don't have an assembler, you can add your own video-mode
  6. routines to FRACTINT by adding a video mode of the appropriate resolution
  7. to FRACTINT.CFG that uses dotmode 19 (which calls these routines to
  8. perform all the dirty work) and modifying these routines accordingly.
  9. The four routines are:
  10.  
  11.  startvideo()     Do whatever you have to do to throw your adapter into
  12.          the appropriate video mode (in case it can't be accomplished
  13.          the "normal" way, with INT 10H and the AX/BX/CX/DX values
  14.          available via FRACTINT.CFG or FARVIDEO.ASM).  This routine
  15.          will typically be empty (in which case the AX/BX/CX/DX values
  16.          in FRACTINT.CFG or FARVIDEO.ASM must be encoded appropriately
  17.          to accomplish the task), but some adapters like the 8514/A
  18.          and TARGA need special handling which would go here.
  19.          If you DO have to put something here, you should encode
  20.          AX = 0xFF so as to effectively convert the regular
  21.          video-switching code inside VIDEO.ASM to use
  22.          an invalid INT 10H call - "do-nothing" logic.
  23.  
  24.  endvideo()     do whatever you have to do to get it out of that
  25.          special video mode (in case 'setvideo(3,0,0,0)'
  26.          won't do it) - this routine will typically be empty,
  27.          but some adapters like the 8514/A and TARGA need
  28.          special handling which would go here.
  29.  
  30.  writevideo(int x, int y, int color)  write a pixel using color number
  31.          'color' at screen coordinates x,y (where 0,0 is the
  32.          top left corner, and sxdots,0 is the top right corner)
  33.  
  34.  int readvideo(int x, int y)  return the color number of pixel x,y
  35.          using the same coordinate logic as 'writevideo()'
  36.  
  37.  int readvideopalette() read the contents of the adapter's video
  38.          palette into the 'BYTE dacbox[256][3]' array
  39.          (up to 256 R/G/B triplets, each with values from 0 to 63).
  40.          Set dacbox[0][0] = 255 if there is no such palette.
  41.          Return a -1 if you want the normal internal EGA/VGA
  42.          routines to handle this function.
  43.  
  44.  int writevideopalette() write the contents of the adapter's video
  45.          palette from the 'BYTE dacbox[256][3]' array
  46.          (up to 256 R/G/B triplets, each with values from 0 to 63).
  47.          Return a -1 if you want the normal internal EGA/VGA
  48.          routines to handle this function.
  49.  
  50. Finally, note that, although these example routines are written in "C",
  51. they could just as easily (or maybe more easily!) have been written
  52. in assembler.
  53.  
  54. */
  55.  
  56. #include <dos.h>
  57. #include "port.h"
  58. #include "prototyp.h"
  59.  
  60. /* external variables (set in the FRACTINT.CFG file, but findable here */
  61.  
  62. extern    int    dotmode;        /* video access method (= 19)       */
  63. extern    int    sxdots, sydots;     /* total # of dots on the screen   */
  64. extern    int    colors;         /* maximum colors available       */
  65.  
  66. /* the video-palette array (named after the VGA adapter's video-DAC) */
  67.  
  68. extern BYTE dacbox[256][3];
  69.  
  70. /* for demo purposes, these routines use VGA mode 13h - 320x200x256 */
  71.  
  72. int startvideo()
  73. {
  74.  
  75. /* assume that the encoded values in FRACTINT.CFG or FARVIDEO.ASM
  76.    have been set to accomplish this (AX = 0x13, BX = CX = DX = 0)  */
  77.  
  78. return(0);                /* set flag: video started */
  79.  
  80. /*   or, we could have done this instead and encoded AX = 0xFF
  81.      in FRACTINT.CFG/FARVIDEO.ASM:
  82.  
  83. union REGS regs;
  84.  
  85. regs.x.ax = 0x13;
  86. int86(0x10,®s,®s);
  87.  
  88. */
  89.  
  90. }
  91.  
  92. int endvideo()
  93. {
  94.  
  95. return(0);                /* set flag: video ended */
  96.  
  97. }
  98.  
  99. void writevideo(int x, int y, int color)
  100. {
  101.  
  102. union REGS regs;
  103.  
  104. regs.h.ah = 0x0c;            /* invoke INT 10H with AH = 0CH */
  105. regs.h.al = color;
  106. regs.x.bx = 0;
  107. regs.x.cx = x;
  108. regs.x.dx = y;
  109. int86(0x10,®s,®s);
  110.  
  111. }
  112.  
  113. int readvideo(int x, int y)
  114. {
  115.  
  116. union REGS regs;
  117.  
  118. regs.x.ax = 0x0d00;            /* invoke INT 10H with AH = 0DH */
  119. regs.x.bx = 0;
  120. regs.x.cx = x;
  121. regs.x.dx = y;
  122. int86(0x10,®s,®s);
  123.  
  124. return((unsigned int)regs.h.al);    /* return pixel color */
  125.  
  126. }
  127.  
  128. int readvideopalette()
  129. {
  130.  
  131. return (-1);                /* let the internal routines do it */
  132.  
  133. }
  134.  
  135. int writevideopalette()
  136. {
  137.  
  138. return (-1);                /* let the internal routines do it */
  139.  
  140. }
  141.