ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/src/include/video.h
(Generate patch)

Comparing BasiliskII/src/include/video.h (file contents):
Revision 1.8 by cebix, 2001-06-28T21:20:00Z vs.
Revision 1.11 by cebix, 2001-07-01T21:09:30Z

# Line 23 | Line 23
23  
24   #include <vector>
25  
26 + #ifndef NO_STD_NAMESPACE
27 + using std::vector;
28 + #endif
29 +
30 + /*
31 +   Some of the terminology here is completely frelled. In Basilisk II, a
32 +   "video mode" refers to a combination of resolution and color depth, and
33 +   this information is stored in a video_mode structure. In Apple
34 +   documentation, a "mode" historically refers to the color depth only
35 +   (because old Macs had fixed-frequency monitors and could not change the
36 +   resolution). These "modes" are assigned a number (0x80, 0x81, etc.),
37 +   which we here call "Apple mode". When Macs learned how to deal with
38 +   multiscan monitors, Apple introduced another type of "mode", also having
39 +   numbers starting from 0x80 but refrerring to the resolution and/or video
40 +   timing of the display (it's possible to have two modes with the same
41 +   dimension but different refresh rates). We call this a "resolution ID".
42 +   The combination of "Apple mode" and "ID" corresponds to a Basilisk II
43 +   "video mode". To make the confusion worse, the video driver control call
44 +   that sets the color depth is called "SetMode" while the one that sets
45 +   both depth and resolution is "SwitchMode"...
46 + */
47 +
48   // Color depth codes
49   enum video_depth {
50          VDEPTH_1BIT,  // 2 colors
# Line 53 | Line 75 | inline bool IsDirectMode(uint16 mode)
75          return IsDirectMode(AppleModeToDepth(mode));
76   }
77  
78 + // Return the depth code that corresponds to the specified bits-per-pixel value
79   inline video_depth DepthModeForPixelDepth(int depth)
80   {
81          switch (depth) {
# Line 66 | Line 89 | inline video_depth DepthModeForPixelDept
89          }
90   }
91  
92 < // Return a bytes-per-row value that assumes no padding for specified depth and pixel width
92 > // Return a bytes-per-row value (assuming no padding) for the specified depth and pixel width
93   inline uint32 TrivialBytesPerRow(uint32 width, video_depth depth)
94   {
95          switch (depth) {
# Line 76 | Line 99 | inline uint32 TrivialBytesPerRow(uint32
99                  case VDEPTH_8BIT: return width;
100                  case VDEPTH_16BIT: return width * 2;
101                  case VDEPTH_32BIT: return width * 4;
102 +                default: return width;
103          }
104   }
105  
106 < // Description of one video mode
106 > /*
107 >   You are not completely free in your selection of depth/resolution
108 >   combinations:
109 >     1) the lowest supported color depth must be available in all
110 >        resolutions
111 >     2) if one resolution provides a certain color depth, it must also
112 >        provide all lower supported depths
113 >
114 >   For example, it is possible to have this set of modes:
115 >     640x480 @ 8 bit
116 >     640x480 @ 32 bit
117 >     800x600 @ 8 bit
118 >     800x600 @ 32 bit
119 >     1024x768 @ 8 bit
120 >
121 >   But this is not possible (violates rule 1):
122 >     640x480 @ 8 bit
123 >     800x600 @ 8 bit
124 >     1024x768 @ 1 bit
125 >
126 >   And neither is this (violates rule 2, 640x480 @ 16 bit is missing):
127 >     640x480 @ 8 bit
128 >     640x480 @ 32 bit
129 >     800x600 @ 8 bit
130 >     800x600 @ 16 bit
131 >     1024x768 @ 8 bit
132 > */
133 >
134 > // Description of a video mode
135   struct video_mode {
136          uint32 x;                               // X size of screen (pixels)
137          uint32 y;                               // Y size of screen (pixels)
# Line 94 | Line 146 | inline bool IsDirectMode(const video_mod
146   }
147  
148   // List of all supported video modes
149 < extern std::vector<video_mode> VideoModes;
149 > extern vector<video_mode> VideoModes;
150  
151   // Description for one (possibly virtual) monitor
152   struct monitor_desc {
# Line 102 | Line 154 | struct monitor_desc {
154          video_mode mode;                // Currently selected video mode description
155   };
156  
157 < extern monitor_desc VideoMonitor;       // Description of the main monitor, set by VideoInit()
157 > // Description of the main (and currently the only) monitor, set by VideoInit()
158 > extern monitor_desc VideoMonitor;
159  
160   extern int16 VideoDriverOpen(uint32 pb, uint32 dce);
161   extern int16 VideoDriverControl(uint32 pb, uint32 dce);
# Line 117 | Line 170 | extern void VideoQuitFullScreen(void);
170   extern void VideoInterrupt(void);
171   extern void VideoRefresh(void);
172  
173 + // Called by the video driver to switch the video mode
174   extern void video_switch_to_mode(const video_mode &mode);
175 < extern void video_set_palette(uint8 *pal);
175 >
176 > // Called by the video driver to set the color palette (in indexed modes)
177 > // or gamma table (in direct modes)
178 > extern void video_set_palette(uint8 *pal, int num);
179  
180   #endif

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines