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.12 by cebix, 2001-07-03T19:20:47Z

# 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 33 | Line 55 | enum video_depth {
55          VDEPTH_32BIT  // "Millions"
56   };
57  
58 < inline uint16 DepthToAppleMode(video_depth depth)
59 < {
60 <        return depth + 0x80;
61 < }
58 > // For compatibility reasons with older (pre-Display Manager) versions of
59 > // MacOS, the Apple modes must start at 0x80 and be contiguous. Therefore
60 > // we construct an array to map the depth codes to the corresponding Apple
61 > // mode. This array is initialized by video_init_depth_list() which must
62 > // be called by the platform-dependant VideoInit() routine after filling
63 > // the VideoModes array.
64 > extern uint16 apple_mode_for_depth[6];
65  
66 < inline video_depth AppleModeToDepth(uint16 mode)
66 > inline uint16 DepthToAppleMode(video_depth depth)
67   {
68 <        return video_depth(mode - 0x80);
68 >        return apple_mode_for_depth[depth];
69   }
70  
71   inline bool IsDirectMode(video_depth depth)
# Line 48 | Line 73 | inline bool IsDirectMode(video_depth dep
73          return depth == VDEPTH_16BIT || depth == VDEPTH_32BIT;
74   }
75  
76 < inline bool IsDirectMode(uint16 mode)
52 < {
53 <        return IsDirectMode(AppleModeToDepth(mode));
54 < }
55 <
76 > // Return the depth code that corresponds to the specified bits-per-pixel value
77   inline video_depth DepthModeForPixelDepth(int depth)
78   {
79          switch (depth) {
# Line 66 | Line 87 | inline video_depth DepthModeForPixelDept
87          }
88   }
89  
90 < // Return a bytes-per-row value that assumes no padding for specified depth and pixel width
90 > // Return a bytes-per-row value (assuming no padding) for the specified depth and pixel width
91   inline uint32 TrivialBytesPerRow(uint32 width, video_depth depth)
92   {
93          switch (depth) {
# Line 76 | Line 97 | inline uint32 TrivialBytesPerRow(uint32
97                  case VDEPTH_8BIT: return width;
98                  case VDEPTH_16BIT: return width * 2;
99                  case VDEPTH_32BIT: return width * 4;
100 +                default: return width;
101          }
102   }
103  
104 < // Description of one video mode
104 > /*
105 >   You are not completely free in your selection of depth/resolution
106 >   combinations:
107 >     1) the lowest supported color depth must be available in all
108 >        resolutions
109 >     2) if one resolution provides a certain color depth, it must also
110 >        provide all lower supported depths
111 >
112 >   For example, it is possible to have this set of modes:
113 >     640x480 @ 8 bit
114 >     640x480 @ 32 bit
115 >     800x600 @ 8 bit
116 >     800x600 @ 32 bit
117 >     1024x768 @ 8 bit
118 >
119 >   But this is not possible (violates rule 1):
120 >     640x480 @ 8 bit
121 >     800x600 @ 8 bit
122 >     1024x768 @ 1 bit
123 >
124 >   And neither is this (violates rule 2, 640x480 @ 16 bit is missing):
125 >     640x480 @ 8 bit
126 >     640x480 @ 32 bit
127 >     800x600 @ 8 bit
128 >     800x600 @ 16 bit
129 >     1024x768 @ 8 bit
130 > */
131 >
132 > // Description of a video mode
133   struct video_mode {
134          uint32 x;                               // X size of screen (pixels)
135          uint32 y;                               // Y size of screen (pixels)
# Line 94 | Line 144 | inline bool IsDirectMode(const video_mod
144   }
145  
146   // List of all supported video modes
147 < extern std::vector<video_mode> VideoModes;
147 > extern vector<video_mode> VideoModes;
148  
149   // Description for one (possibly virtual) monitor
150   struct monitor_desc {
# Line 102 | Line 152 | struct monitor_desc {
152          video_mode mode;                // Currently selected video mode description
153   };
154  
155 < extern monitor_desc VideoMonitor;       // Description of the main monitor, set by VideoInit()
155 > // Description of the main (and currently the only) monitor, set by VideoInit()
156 > extern monitor_desc VideoMonitor;
157  
158   extern int16 VideoDriverOpen(uint32 pb, uint32 dce);
159   extern int16 VideoDriverControl(uint32 pb, uint32 dce);
# Line 117 | Line 168 | extern void VideoQuitFullScreen(void);
168   extern void VideoInterrupt(void);
169   extern void VideoRefresh(void);
170  
171 + // Called by the video driver to switch the video mode
172   extern void video_switch_to_mode(const video_mode &mode);
173 < extern void video_set_palette(uint8 *pal);
173 >
174 > // Called by the video driver to set the color palette (in indexed modes)
175 > // or gamma table (in direct modes)
176 > extern void video_set_palette(uint8 *pal, int num);
177 >
178 > // Check whether a mode with the specified depth exists
179 > extern bool video_has_depth(video_depth depth);
180 >
181 > // Get bytes-per-row value for specified resolution/depth
182 > extern uint32 video_bytes_per_row(video_depth depth, uint32 id);
183 >
184 > // Initialize apple_mode_for_depth[] array from VideoModes list
185 > extern void video_init_depth_list(void);
186  
187   #endif

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines