1
0
mirror of https://github.com/gryf/fs-uae-wrapper.git synced 2026-01-08 06:44:19 +01:00

README update

This commit is contained in:
2016-12-27 22:13:39 +01:00
parent c6522061c8
commit 6667f5c5be

View File

@@ -23,6 +23,11 @@ Requirements
============
- Python (2 or 3)
- `fs-uae`_ (obviously :)
Also, there should be at one of the (de)compression utility, for example:
- `7z`_ archiver
- `unrar`_
@@ -33,7 +38,7 @@ Just perform (preferably in ``virtualenv``) a command:
.. code:: shell-session
$ pip install fs-uae-wrapper
$ pip install fs-uae-wrapper (not there yet)
Usage
=====
@@ -79,11 +84,16 @@ executable as-is.
Modules
=======
For now, only for ``cd32`` module exists, but there are planned couple more.
For now, only ``plain`` and ``cd32`` modules exists, although there are planned
couple more.
plain
-----
Options used:
* None
``Plain`` module is kind of dummy or failsafe if you will, since all it do is
run ``fs-uae`` with provided configuration and command line options. It will be
chosen in case when there is no ``wrapper`` option provided neither via the
@@ -92,14 +102,23 @@ configuration file nor command line parameter.
cd32
----
There are few assumptions regarding file names and archives. Let's see some
sample config for a game, which is saved as ``ChaosEngine.fs-uae``:
Options used:
* ``wrapper`` (required) with ``cd32`` as an value
* ``wrapper_archive`` (required) path to the archive with CD32 iso/cue/wav
* ``wrapper_gui_msg`` (optional) if set to "1", will display a graphical
message during extracting files
There is one assumption regarding archives file. Let's see some sample config
for a game, which is saved as ``ChaosEngine.fs-uae``:
.. code:: ini
:number-lines:
[config]
wrapper = cd32
wrapper_archive = ChaosEngine.7z
wrapper_gui_msg = 1
amiga_model = CD32
title = The Chaos Engine CD32
@@ -111,11 +130,16 @@ sample config for a game, which is saved as ``ChaosEngine.fs-uae``:
joystick_port_1_mode = cd32 gamepad
platform = cd32
First assumption is that archive containing files for the game (here: *Chaos
Engine*) should not be in subdirectory. Second, archive name should be the same
as a cue file, so in this case it should be like ``Chaos Engine, The
(1994)(Renegade)(M4)[!][CDD3445].zip`` in case of zip archive. There are three
archive types supported: 7z, rar and zip.
Assumption is that archive containing files for the game (here: *Chaos
Engine*) should not be in subdirectory. In other words, all essential files
(like ``*.cue``, ``*.iso`` and ``*.wav`` files) should be located directly in
the archive, otherwise it might be impossible to create right configuration and
debugging such setup might be annoying.
There are several archive types which are supported, ranging from tar
(compressed with gzip, bzip2 and xz), 7z, rar, zip. lha and lzx. All of those
formats should have corresponding decompressors available in the system,
otherwise extracting will fail.
Next, the invocation of the wrapper would be as follows:
@@ -146,7 +170,7 @@ License
This work is licensed on 3-clause BSD license. See LICENSE file for details.
.. _FS-UAE: https://fs-uae.net/
.. _fs-uae: https://fs-uae.net/
.. _relative configuration file: https://fs-uae.net/configuration-files
.. _unrar: http://www.rarlab.com/rar_add.htm
.. _7z: http://p7zip.sourceforge.net/