241 lines
6.1 KiB
Groff
241 lines
6.1 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.TH "XKEGS" 6 "2023-09-18" "1.29" "SlackBuilds.org"
|
|
.SH NAME
|
|
xkegs \- Apple IIgs emulator
|
|
.\" RST source for xkegs(6) man page. Convert with:
|
|
.
|
|
.\" rst2man.py man/xkegs.rst > man/xkegs.6
|
|
.
|
|
.SH SYNOPSIS
|
|
.sp
|
|
\fBxkegs\fP [\-skip \fInum\fP] [\-audio [\fI0|1\fP] [\-arate \fInum\fP] [\-dhr140] [\-15] [\-16] [\-24] [\-display \fIxdisplay\fP] [\-noshm]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
KEGS (Kent\(aqs Emulated GS) is an Apple IIgs emulator for Mac OS X,
|
|
Linux, and Win32. The Apple IIgs was the most powerful computer in the
|
|
Apple II line. It first was sold in 1986. An Apple IIgs has the
|
|
capability to run almost all Apple II, Apple IIe, and Apple IIc
|
|
programs.
|
|
.sp
|
|
xkegs is the KEGS binary, compiled for Linux and X\-Window support.
|
|
.sp
|
|
This manual page only documents the command\-line options
|
|
and key mappings. For the full documentation, see
|
|
/usr/doc/kegs\-1.29/README.kegs.txt (and the other files in the
|
|
same directory).
|
|
.sp
|
|
Note: There is no way to specify disk or ROM images on the command
|
|
line. Use the configuration menu (F4) from within the emulator to select images.
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-skip \fInum\fP
|
|
KEGS will "skip" that many screen redraws between refreshes.
|
|
\-skip 0 will do 60 frames per second, \-skip 1 will do 30 fps,
|
|
\-skip 5 will do 10 fps.
|
|
.TP
|
|
.B \-audio \fI0|1\fP
|
|
Forces audio [off/on]. By default, audio is on unless the X
|
|
display is a remote machine or shared memory is off. This
|
|
switch can override the default. \-audio 0 causes KEGS to not
|
|
fork the background audio process, but Ensoniq emulation is
|
|
still 100% accurate, just the sound is not sent to the workstation
|
|
speaker.
|
|
.TP
|
|
.B \-arate \fInum\fP
|
|
Forces audio sample rate to [num]. 44100 and 48000 are usual,
|
|
you can try 22050 to reduce KEGS\(aqs overhead. On a reasonably
|
|
fast machine (>250MHz or so), you shouldn\(aqt need to mess with
|
|
this.
|
|
.TP
|
|
.B \fB\-dhr140\fP
|
|
Will use the old Double\-hires color algorithm that results in
|
|
exactly 140 colors across the screen, as opposed to the blending
|
|
being done by default.
|
|
.TP
|
|
.B \-15
|
|
KEGS will only look for a 15\-bit X\-Window display.
|
|
.TP
|
|
.B \-16
|
|
KEGS will only look for a 16\-bit X\-Window display (not tested, probably
|
|
will get red colors wrong).
|
|
.TP
|
|
.B \-24
|
|
KEGS will only look for a 24\-bit X\-Window display.
|
|
.TP
|
|
.B \-display \fIxdisplay\fP
|
|
Same as setting the environment variable DISPLAY. Sends X display to [xdisplay]
|
|
.TP
|
|
.B \fB\-noshm\fP
|
|
KEGS will not try to used shared memory for the X graphics
|
|
display. This will make KEGS much slower on graphics\-intensive
|
|
tasks, by as much as a factor of 10! By default, \-noshm causes
|
|
an effective \-skip of 3 which is 15 fps. You can override this
|
|
default by specifying a \-skip explicitly.
|
|
.UNINDENT
|
|
.SH KEY BINDINGS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B F1
|
|
Alias of Command
|
|
.TP
|
|
.B F2
|
|
Alias of Option
|
|
.TP
|
|
.B F3
|
|
Alias of ESC for OS/2 compatibility.
|
|
.TP
|
|
.B F4
|
|
Configuration Panel
|
|
.TP
|
|
.B F6
|
|
Toggle through the 4 speeds: Unlimited, 1MHz, 2.8MHz, 8.0MHz
|
|
.TP
|
|
.B Shift\-F6
|
|
Enter KEGS debugger (can also be done by center\-clicking the
|
|
mouse on the xkegs window).
|
|
The debugger is X\-based, and runs in a separate window.
|
|
.TP
|
|
.B F7
|
|
Toggle fast_disk_emul on/off
|
|
.TP
|
|
.B F8
|
|
Toggle pointer hiding on/off.
|
|
.TP
|
|
.B F9
|
|
Invert the sense of the joystick.
|
|
.TP
|
|
.B Shift\-F9
|
|
Swap x and y joystick/paddle axes.
|
|
.TP
|
|
.B F10
|
|
Attempt to change the a2vid_palette (only useful on 256\-color displays)
|
|
.TP
|
|
.B F11
|
|
Full screen mode (only on Mac OS X).
|
|
.TP
|
|
.B F12
|
|
Alias of Pause/Break which is treated as Reset
|
|
.TP
|
|
.B F2, Alt_R, Meta_r, Menu, Print, Mode_switch, Option
|
|
Option key
|
|
.TP
|
|
.B F1, Alt_L, Meta_L, Cancel, Scroll_lock, Command
|
|
Command key
|
|
.TP
|
|
.B Num_Lock
|
|
Keypad "Clear".
|
|
.TP
|
|
.B F12, Pause, Break
|
|
Reset
|
|
.TP
|
|
.B Home
|
|
Alias for "=" on the keypad
|
|
.UNINDENT
|
|
.SH FILES
|
|
.INDENT 0.0
|
|
.TP
|
|
.B ~/.config.kegs
|
|
The KEGS configuration file. This can be directly edited if necessary,
|
|
but normally is changed by using the configuration menu
|
|
(F4) from within KEGS. To return to the default configuration,
|
|
you may remove this file.
|
|
.TP
|
|
.B /usr/share/kegs/rom03 (or /usr/share/kegs/rom01)
|
|
The Apple IIgs BIOS ROM image. If KEGS can\(aqt find this ROM, it
|
|
will start up with a black display, full of white @ characters.
|
|
Press F4 for the config menu and use the UI to select the correct
|
|
ROM image file.
|
|
.sp
|
|
For reference, the ROM image details are:
|
|
.TS
|
|
center;
|
|
|l|l|l|.
|
|
_
|
|
T{
|
|
Filename
|
|
T} T{
|
|
Size (bytes)
|
|
T} T{
|
|
md5sum
|
|
T}
|
|
_
|
|
T{
|
|
rom03
|
|
T} T{
|
|
262144
|
|
T} T{
|
|
ba89edf2729a28a17cd9e0f7a0ac9a39
|
|
T}
|
|
_
|
|
T{
|
|
rom01
|
|
T} T{
|
|
131072
|
|
T} T{
|
|
20a0334c447cb069a040ae5be1d938df
|
|
T}
|
|
_
|
|
.TE
|
|
.sp
|
|
Other versions of the IIgs ROMs may exist (this author isn\(aqt aware of
|
|
any), but these two images are known to work.
|
|
.TP
|
|
.B /usr/bin/xkegs
|
|
Wrapper script. xkegs will fail to run if it can\(aqt find its config
|
|
file, so this script creates one in the user\(aqs home directory
|
|
if necessary, then runs the real xkegs binary.
|
|
.TP
|
|
.B /usr/libexec/xkegs
|
|
Actual xkegs binary. Shouldn\(aqt be run directly (use the wrapper
|
|
instead).
|
|
.TP
|
|
.B /usr/share/kegs/config.kegs.default
|
|
Copied to \fB~/.config.kegs\fP by the wrapper script, if \fB~/.config.kegs\fP
|
|
doesn\(aqt already exist. Can be used to set system\-wide
|
|
defaults (such as the path to the ROM image).
|
|
.UNINDENT
|
|
.SH AUTHORS
|
|
.sp
|
|
KEGS is by Kent Dickey <\fI\%kadickey@alumni.princeton.edu\fP>.
|
|
.sp
|
|
This manual page was written by B. Watson <\fI\%urchlay@slackware.uk\fP> for
|
|
the SlackBuilds.org project, but may be used by anyone for any purpose.
|
|
.sp
|
|
Wrapper script also by B. Watson.
|
|
.SH SEE ALSO
|
|
.sp
|
|
Full KEGS docs in /usr/doc/kegs\-1.29/
|
|
.sp
|
|
KEGS homepage at \fI\%http://kegs.sourceforge.net/\fP
|
|
.\" Generated by docutils manpage writer.
|
|
.
|