mirror of
https://github.com/kichikuou/xsystem35-sdl2.git
synced 2026-09-22 22:48:08 +03:00
kichikuou
73b3377b77
Disabled by default; enable via the mute_on_unfocus rc setting or the -mute_on_unfocus flag. Fixes #37.
159 lines
4.9 KiB
Plaintext
159 lines
4.9 KiB
Plaintext
= xsystem35(6)
|
|
:doctype: manpage
|
|
:manmanual: xsystem35 manual
|
|
:mansource: xsystem35 {xsystem35-version}
|
|
|
|
== Name
|
|
|
|
xsystem35 - play System 3.x games
|
|
|
|
== SYNOPSIS
|
|
|
|
*xsystem35* [_OPTION_]...
|
|
|
|
== DESCRIPTION
|
|
|
|
This man page describes *xsystem35-sdl2*, a multi-platform port of the
|
|
AliceSoft's System3.5/3.6/3.8/3.9 game engine derived from the original
|
|
*xsystem35*.
|
|
|
|
`xsystem35` reads the game resource file from the path specified by the
|
|
`-gamefile` option, or from `xsystem35.gr` in the current directory if the
|
|
option is not specified. If the game resource file is not found, `xsystem35`
|
|
finds System 3.x game files (*.ALD) from the current directory.
|
|
|
|
== OPTIONS
|
|
|
|
*-gamefile* _file_::
|
|
Load game resouce file from _file_. See <<FILES>> section for details.
|
|
|
|
*-game* _game_::
|
|
Enables game-specific hacks. Usually auto-detected, but must be specified for
|
|
games with modified / translated titles. Possible values are: `toushin2`,
|
|
`rance2`, `rance3`, `rance3_eng`, `rance4_eng`, `rance4_v2`, `persiom`,
|
|
`agake`.
|
|
|
|
*-savedir* _dir_::
|
|
Directory to save game state files. If _dir_ begins with '~', it is expanded
|
|
to the user's home directory (`$HOME`).
|
|
|
|
*-saveformat* _fmt_::
|
|
The format when writing save files. Possible values are: `xsystem35`,
|
|
`system36`, `system39` (default).
|
|
|
|
*-texthook* _mode_::
|
|
Set the text hook mode. Possible values are: `none` (default), `print` (print
|
|
text to console), `copy` (copy text to clipboard).
|
|
|
|
*-texthook_suppress* _list_::
|
|
Suppress text hook on specified scenario pages. _list_ is a comma-separated
|
|
list of page numbers. Used to suppress system messages, etc.
|
|
|
|
*-censor* _file_::
|
|
Enable Streamer Mode, which mosaics specific images to make them safe for
|
|
streaming. The _file_ is a text file containing a list of image numbers
|
|
to censor, one per line. Lines starting with '#' are treated as comments.
|
|
|
|
*-renderer* _name_::
|
|
Use the SDL rendering driver named _name_.
|
|
|
|
*-playlist* _file_::
|
|
Load the CD playlist from _file_. The playlist is a text file with one
|
|
filename per line, in the order of CD tracks. See <<FILES>> section for details.
|
|
|
|
*-Me*::
|
|
Use SDL_mixer for MIDI playback.
|
|
|
|
**-Mp**_device_number_::
|
|
Use ALSA (via PortMidi) for MIDI playback.
|
|
|
|
*-M0*::
|
|
Disable MIDI playback.
|
|
|
|
*-devjoy* _device_index_::
|
|
Use the joystick device with the given index.
|
|
|
|
*-ttfont_mincho* _file_::
|
|
Use the given TrueType or OpenType font file for mincho (serif) text.
|
|
|
|
*-ttfont_gothic* _file_::
|
|
Use the given TrueType or OpenType font file for gothic (sans-serif) text.
|
|
|
|
*-debuglv* _level_::
|
|
Set the debug level to _level_. The higher the level, the more verbose
|
|
the debug output.
|
|
|
|
*-debug*::
|
|
Start with the debugger enabled.
|
|
|
|
*-noantialias*::
|
|
Disable text antialiasing.
|
|
|
|
*-fullscreen*::
|
|
Start in fullscreen mode.
|
|
|
|
*-integerscale*::
|
|
Use integer scaling for the window.
|
|
|
|
*-noimagecursor*::
|
|
Disable custom mouse cursor images.
|
|
|
|
*-mute_on_unfocus*::
|
|
Mute audio while the game window is not in focus.
|
|
|
|
*-version*::
|
|
Print the version number and exit.
|
|
|
|
*-h, --help*::
|
|
Print a help message and exit.
|
|
|
|
== FILES
|
|
|
|
*.xsys35rc*::
|
|
`xsystem35` reads its configuration from `${HOME}/.xsys35rc` and `.xsys35rc`
|
|
in the game directory. The latter takes precedence over the former, so you
|
|
can put general settings in `${HOME}/.xsys35rc` and game-specific settings in
|
|
`.xsys35rc` in the game directory. Options specified on the command line
|
|
override both. See xsys35rc.sample for the format of the configuration file.
|
|
|
|
*playlist.txt*::
|
|
`xsystem35` does not support playing BGM directly from a CD. Instead, it
|
|
supports playing BGM from audio files on your filesystem. `xsystem35` reads
|
|
the playlist from a file specified by the `-playlist` option, or from
|
|
`playlist.txt` in the game directory. The first line is the path to the audio
|
|
file for track 1, the second line is the path to the audio file for track 2,
|
|
and so on. The first line is usually empty, because track 1 is not an audio
|
|
track but a data track.
|
|
|
|
*xsystem35.gr*::
|
|
Game resource file which lists the locations of various files needed to run
|
|
a game. This is optional; `xsystem35` can automatically find the files it
|
|
needs when run inside a game directory. See
|
|
xref:xsystem35.gr.adoc[*xsystem35.gr(5)*] for the format of the game resource
|
|
file.
|
|
|
|
== KEYBOARD SHORTCUTS
|
|
|
|
System 3.x games basically only use the UP, DOWN, LEFT, RIGHT, SPACE, RET, ESC,
|
|
and TAB keys (some games use other keys). `xsystem35` uses the following
|
|
special key assignments:
|
|
|
|
*F1*::
|
|
Toggle message skip mode.
|
|
|
|
*F4*::
|
|
Toggle fullscreen mode.
|
|
|
|
Also, in some platforms, the middle mouse button opens the menu.
|
|
|
|
== HISTORY
|
|
|
|
*xsystem35* was originally developed by Masaki Chikama (Wren)
|
|
<masaki-c@is.aist-nara.ac.jp> between 1998 and 2006. The project was later
|
|
forked by Kichikuou <KichikuouChrome@gmail.com> as *xsystem35-sdl2* and ported
|
|
to SDL2.
|
|
|
|
== SEE ALSO
|
|
|
|
xsystem35-sdl2 project page: https://github.com/kichikuou/xsystem35-sdl2
|