Apple-2-Tools
/
AppleWin
mirror of https://github.com/AppleWin/AppleWin.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Help docs: updated for RGB card/monitor support

This commit is contained in:
tomcw 2020-10-15 21:41:14 +01:00
parent cfe482cd52
commit 4defaa80fb
5 changed files with 42 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
help/CommandLine.html
View File

@ -135,11 +135,28 @@
-alt-enter=&lt;toggle-full-screen|open-apple-enter&gt;<br>
Define the behavior of Alt+Enter:
<ul>
<li>Either: Toggle between windowed and full screen video modes (default).
<li>Or: Allow the emulated Apple II to read the Enter key state when Alt (Open Apple key) is pressed.
<li>Either: Toggle between windowed and full screen video modes (default).</li>
<li>Or: Allow the emulated Apple II to read the Enter key state when Alt (Open Apple key) is pressed.</li>
</ul>
-rgb-card-type &lt;apple|sl7|eve|feline&gt;<br>
<ul>
<li><i>apple</i> is the Extended 80-Column Text/AppleColor Adaptor Card (default).</li>
<li><i>sl7</i> is Video-7's RGB-SL7 card.</li>
<ul>
<li>NB. This card supports an extra foreground/background hi-res mode that can be triggered by AN3 switching, resulting in corrupt color graphics!
</ul>
<li><i>eve/feline</i> are Le Chat Mauve variants.</li>
</ul>
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.<br><br>
-rgb-card-foreground &lt;n&gt;<br>
-rgb-card-background &lt;n&gt;<br>
Where n is [0..15]. Defaults are foreground=15(White) and background=0(Black).<br>
The only supported DIPSW colors are: Black=0, Blue=6, Orange=9, Green=12, White=15<br>
NB. Only supported by '-rgb-card-type sl7'.<br>
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.<br><br>
-rgb-card-invert-bit7<br>
Force the RGB card (in "Color (RGB Monitor)" video mode) to invert bit7 in MIX mode. Enables the correct rendering for Dragon Wars.<br><br>
Force the RGB card to invert bit7 in MIX mode. Enables the correct rendering for Dragon Wars.<br>
Use in conjunction with the 'Color (RGB Card/Monitor)' video mode.<br><br>
-50hz<br>
Support 50Hz(PAL) video refresh rate and PAL 1.016MHz base CPU clock.<br><br>
-60hz<br>

7
help/Troubleshooting.html
View File

@ -52,5 +52,12 @@
<li>Try installing the Realtek-specific audio driver supplied by ASUS (as opposed to the default Win10 driver).</li>
</ul>
Color (RGB Card/Monitor) and title compatibility issues:
<ul>
<li>Dragon Wars: double hi-res bit7 needs inverting, so use the -rgb-card-invert-bit7 command line switch.</li>
<li>Prince of Persia: the hi-res graphics will switch to B&W hi-res during the title sequence.</li>
<li>Renegade: switches to 160x192 mode at the title screen and B&W hi-res during game play.</li>
<li>Video7's RGB-SL7 card: corruption for titles/demos that accidentally switch to foreground/background hi-res mode, eg. French Touch DIGIDREAM demo.</li>
</ul>
</body>
</html>

2
help/acknowledgements.html
View File

@ -24,6 +24,6 @@
<p style="MARGIN-LEFT: 40px">Andrea Odetti: numerous pull-requests</p>
<p style="MARGIN-LEFT: 40px">Iván Izaguirre: Taiwanese Copam Base64A Apple II clone</p>
<p style="MARGIN-LEFT: 40px">Arnaud C: debugger suggestions and help with 6502/6522/video timing issues</p>
<p style="MARGIN-LEFT: 40px">Cyril Lambin: debugger improvements</p>
<p style="MARGIN-LEFT: 40px">Cyril Lambin: RGB card/monitor rendering, debugger improvements</p>
</body>
</html>

10
help/cfg-config.html
View File

@ -36,9 +36,11 @@
<ul>
<li><strong>Monochrome (custom) :</strong>&nbsp;This mode emulates a monochrome monitor.<br>
You can choose your monochrome color from the <em>Monochrome Color</em> button described below.
<li><strong>Color (RGB Monitor) :</strong>&nbsp;This mode emulates a standard RBG color monitor.
<br>Text is sharp like a white monochrome monitor. Color graphics has only 16 colors (with no blurring or ringing).
<li><strong>Color (NTSC Monitor) :</strong>&nbsp;This mode emulates a standard NTSC color monitor.
<li><strong>Color (Composite Idealized) :</strong>&nbsp;This mode emulates an <i>idealized</i> composite color monitor.
<br>Text is sharp like a white monochrome monitor. Color graphics has only 16 colors (with no blurring or ringing). This is the only mode that supports vertical blend.
<li><strong>Color (RGB Card/Monitor) :</strong>&nbsp;This mode emulates a standard RGB card and monitor.
<br>Text is sharp like a white monochrome monitor. Color graphics has only 16 colors (with no blurring or ringing). Double hi-res is 140x192 chunky pixels (or software selectable as: B&W or mixed Color/B&W). From the <a href="CommandLine.html">command line</a> you can specify the RGB card, the default is the Extended 80-Column Text/AppleColor Adaptor Card. Some double hi-res titles may have compatibility issues. See <a href="Troubleshooting.html">troubleshooting</a>.
<li><strong>Color (Composite Monitor) :</strong>&nbsp;This mode emulates a standard NTSC (or PAL) color monitor.
<br>Text is sharp, but contains color artifacts. Color graphics has visible alternating color and black pixels.
<li><strong>Color TV :</strong>&nbsp;This mode emulates an NTSC color TV.
<br>All text and color graphics modes are blurry and have visible ringing.
@ -55,7 +57,7 @@
<br>
<strong>Vertical blend:</strong><br>
When video mode is 'Color (RGB Monitor)' then vertically blend the hires screen.<br>
When video mode is 'Color (Composite Idealized)' then vertically blend the hi-res screen.<br>
<br>
<strong>Full-Screen: Show drive/keyboard status:</strong><br>

16
source/Applewin.cpp
View File

@ -1299,12 +1299,12 @@ static bool CheckOldAppleWinVersion(void)
static void ExceptionHandler(const char* pError)
{
MessageBox( g_hFrameWindow,
pError,
TEXT("Runtime Exception"),
MB_ICONEXCLAMATION | MB_SETFOREGROUND);
MessageBox( g_hFrameWindow,
pError,
TEXT("Runtime Exception"),
MB_ICONEXCLAMATION | MB_SETFOREGROUND);
LogFileOutput("Runtime Exception: %s\n", pError);
LogFileOutput("Runtime Exception: %s\n", pError);
}
//---------------------------------------------------------------------------
@ -1821,7 +1821,7 @@ static bool ProcessCmdLine(LPSTR lpCmdLine)
}
else if (strcmp(lpCmdLine, "-rgb-card-type") == 0)
{
// RGB video card valide types are: "apple", "sl7", "eve", "feline"
// RGB video card valid types are: "apple", "sl7", "eve", "feline"
lpCmdLine = GetCurrArg(lpNextArg);
lpNextArg = GetNextArg(lpNextArg);
@ -1838,14 +1838,14 @@ static bool ProcessCmdLine(LPSTR lpCmdLine)
}
else if (strcmp(lpCmdLine, "-rgb-card-foreground") == 0)
{
// Default hardware-defined Text foreground color, for some RGB cards only
// Default hardware-defined Text foreground color, for Video-7's RGB-SL7 card only
lpCmdLine = GetCurrArg(lpNextArg);
lpNextArg = GetNextArg(lpNextArg);
g_cmdLine.rgbCardForegroundColor = atoi(lpCmdLine);
}
else if (strcmp(lpCmdLine, "-rgb-card-background") == 0)
{
// Default hardware-defined Text background color, for some RGB cards only
// Default hardware-defined Text background color, for Video-7's RGB-SL7 card only
lpCmdLine = GetCurrArg(lpNextArg);
lpNextArg = GetNextArg(lpNextArg);
g_cmdLine.rgbCardBackgroundColor = atoi(lpCmdLine);