
FPSE linux (yet another) 31.aug.2000

Status: usable for public

Authors: Igor Wronsky <iwronsky@yahoo.com>
	 Linuzappz <linuzappz@hotmail.com>
         Frodo <l41273@alfa.ist.utl.pt>
         (append your name here)

IMPORTANT! We don't need several different linux ports. 
We need one version that works well. Please, everyone who
works on a linux port, contant me. We should organize to
do just one port and distribute the work load.


Requires
--------

X-Windows, Svgalib, SDL or AAlib.

Compiling
---------
At this moment, the source compiles by (edit it first)

> make -f makes/linux.mak

PITFALL: Linux gcc doesn't like dos-format text files. If 
and when(!) you get obscure errors when compiling, convert all 
source files to UNIX LF format, and remove trailing CTRL-Z characters. 
You can use some CR/LF => LF converter, or in "vim" editor, 
the command is "set fileformat=unix".


Using
-----

Edit fpse.ini, change bios and other things you want.
For Gpu:
##
[GPULSOFT]
FullScreen=On/Off
FpsCount=On/Off
FrameSkip=0/1/2...
##
If you are using X-Windows use 16 bpp, others are unworking or untested.
GPU Rend keys:
ESC: Quit.
F5: To get a ScreenShot.
F6: Changes between fullscreen an windowed mode.
F7: Toggles On/Off the FpsCounter.
F8: Stops/Starts rendering. 
-:  FrameSkip - 1.
+:  FrameSkip + 1.

If you want to change the displays compiled by './configure' at 
'system/linux/plugin/gpu', enter this directory, check './configure --help'
and the './configure [options]'.
To use the fpsecfg go to 'system/linux/fpsecfg', call 'make', then copy 'fpsecfg'
to where you have 'fpse' ('.')

Code 
----

Here's some important parts and their status as it seems to me.

Done:

    - Linux-specific #includes for the main code compilation 
      in "include/fpse.h". STATUS: Complete.

    - Screen open / redraw routines in "system/linux/plugin/gpu/wingpu.c"
      STATUS: Working

    - Bare-bones plugins and their Makefiles
      STATUS: Exist

    - Plguins can compile alone
      STATUS: Done

    - CD-ROM routines in "system/linux/plugin/cd/"
      STATUS: Working

    - ISO image routines in "system/linux/plugin/cdiso/"
      STATUS: Working

    - Joystick (keyboard) routines in "system/linux/plugin/joy/"
      STATUS: Working

Undone:

    - Audio in /dev/null :)
      STATUS: Missing
