fte/quakespasm
2
0
Fork 0
mirror of https://github.com/Shpoike/Quakespasm.git synced 2025-02-13 15:31:28 +00:00
Code Issues Projects Releases Packages Wiki Activity

.. and html and txt files.

Browse source 
git-svn-id: svn+ssh://svn.code.sf.net/p/quakespasm/code/trunk@1326 af15c1b1-3010-417e-b628-4374ebc0bcbd
This commit is contained in:
stevenaaus 2016-07-01 05:02:55 +00:00
parent 46e1b237ac
commit 8b05d42508
2 changed files with 85 additions and 65 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
quakespasm/Quakespasm.html
View file

@ -1,17 +1,18 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML> <HTML>
<HEAD> <HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.69">
<TITLE>QuakeSpasm</TITLE> <TITLE>QuakeSpasm</TITLE>
</HEAD> </HEAD>
<BODY> <BODY>
<H1>QuakeSpasm</H1> <H1>QuakeSpasm</H1>
<H2></H2><P> <H2></H2>
<P>
<PRE> <PRE>
</PRE> </PRE>
</P> </P>
<P><EM>Page last edited: June 2016</EM></P> <P><EM>Page last edited: July 2016</EM></P>
<P> <P>
<H2><A NAME="toc1">1.</A> <A HREF="Quakespasm.html#s1">About </A></H2> <H2><A NAME="toc1">1.</A> <A HREF="Quakespasm.html#s1">About </A></H2>
@ -74,10 +75,12 @@
<P> <P>
<A HREF="http://quakespasm.sourceforge.net">QuakeSpasm</A> <A HREF="http://quakespasm.sourceforge.net">QuakeSpasm</A>
is a Quake 1 engine based on the SDL port of is a modern, cross-platform, Quake 1 engine based on
<A HREF="http://www.celephais.net/fitzquake">FitzQuake</A>.</P> <A HREF="http://www.celephais.net/fitzquake">FitzQuake</A>.</P>
<P>It includes support for 64 bit CPUs and custom music playback, and includes a new <P>It includes support for 64 bit CPUs and custom music playback, a new
sound driver, some graphical niceities, and numerous bug-fixes and other improvements.</P> sound driver, some graphical niceities, and numerous bug-fixes and other improvements.</P>
<P>Quakespasm utilizes either the SDL or SDL 2 frameworks, so choose which one works best for you.
SDL is probably less buggy, but SDL 2 has nicer features and smoother mouse input - though no CD support.</P>
<H2><A NAME="s2">2.</A> <A HREF="#toc2">Downloads </A></H2> <H2><A NAME="s2">2.</A> <A HREF="#toc2">Downloads </A></H2>
@ -637,7 +640,7 @@ these patched libSDL binaries may help.
<LI> <LI>
<A HREF="http://sourceforge.net/p/quakespasm/bugs/?source=navbar">Bug reports</A></LI> <A HREF="http://sourceforge.net/p/quakespasm/bugs/?source=navbar">Bug reports</A></LI>
<LI> <LI>
<A HREF="mailto:gmail - dot - com - username - sezeroz">Ozkan</A> (project leader), <A HREF="mailto:gmail - dot - com - username - sezeroz">Ozkan</A>,
<A HREF="mailto:gmail - dot - com - username - ewasylishen">Eric</A>, <A HREF="mailto:gmail - dot - com - username - ewasylishen">Eric</A>,
<A HREF="mailto:gmail - dot - com - username - a.h.vandijk">Sander</A>, <A HREF="mailto:gmail - dot - com - username - a.h.vandijk">Sander</A>,
<A HREF="mailto:yahoo - dot - com - username - stevenaaus">Stevenaaus</A></LI> <A HREF="mailto:yahoo - dot - com - username - stevenaaus">Stevenaaus</A></LI>

135
quakespasm/Quakespasm.txt
View file

@ -4,6 +4,7 @@
Table of Contents Table of Contents
1. About 1. About
2. Downloads 2. Downloads
3. Hints 3. Hints
@ -48,35 +49,40 @@
9. Contact 9. Contact
10. Links 10. Links
______________________________________________________________________ ______________________________________________________________________
Page last edited: June 2016 Page last edited: July 2016
1. About 1. About
QuakeSpasm <http://quakespasm.sourceforge.net> is a Quake 1 engine QuakeSpasm <http://quakespasm.sourceforge.net> is a modern, cross-
based on the SDL port of FitzQuake platform, Quake 1 engine based on FitzQuake
<http://www.celephais.net/fitzquake>. <http://www.celephais.net/fitzquake>.
It includes support for 64 bit CPUs and custom music playback, and It includes support for 64 bit CPUs and custom music playback, a new
includes a new sound driver, some graphical niceities, and numerous sound driver, some graphical niceities, and numerous bug-fixes and
bug-fixes and other improvements. other improvements.
Quakespasm utilizes either the SDL or SDL 2 frameworks, so choose
which one works best for you. SDL is probably less buggy, but SDL 2
has nicer features and smoother mouse input - though no CD support.
2. Downloads 2. Downloads
o Project Downloads: http://quakespasm.sourceforge.net/download.htm
o Automatic Builds: http://quakespasm.ericwa.com/job/quakespasm-sdl2/ o Project Downloads <http://quakespasm.sourceforge.net/download.htm>
o Automatic Builds <http://quakespasm.ericwa.com/job/quakespasm-
sdl2/>
3. Hints 3. Hints
Visit the FitzQuake homepage <http://www.celephais.net/fitzquake> for Visit the FitzQuake homepage <http://www.celephais.net/fitzquake> for
a full run-down of the engine's commands and variables. a full run-down of the engine's commands and variables.
o To disable some changes, use "quakespasm -fitz" o To disable some changes, use "quakespasm -fitz"
o Quakespasm's custom data is stored in "quakespasm.pak". Install o Quakespasm's custom data is stored in "quakespasm.pak". Install
@ -120,7 +126,7 @@
o Use the "-noextmusic" option to disable this feature. o Use the "-noextmusic" option to disable this feature.
o See Quakespasm-Music.txt for more details. o See <Quakespasm-Music.txt> for more details.
3.2. Controller Support 3.2. Controller Support
@ -131,12 +137,13 @@
the right for looking. the right for looking.
If your controller doesn't work you can try placing this file If your controller doesn't work you can try placing this file
https://raw.githubusercontent.com/gabomdq/SDL_GameControllerDB/master/gamecontrollerdb.txt <https://raw.githubusercontent.com/gabomdq/SDL_GameControllerDB/master/gamecontrollerdb.txt>
in your Quake directory, it is a community-maintained database that in your Quake directory, it is a community-maintained database that
adds support for more controllers to SDL2. adds support for more controllers to SDL2.
3.2.1. Cvars 3.2.1. Cvars
o joy_deadzone - Fraction of the stick travel to be deadzone, between o joy_deadzone - Fraction of the stick travel to be deadzone, between
0 and 1. Default 0.2. 0 and 1. Default 0.2.
@ -167,6 +174,7 @@
Some of the controller buttons are hardcoded to allow navigating the Some of the controller buttons are hardcoded to allow navigating the
menu: menu:
o Back - alias for TAB o Back - alias for TAB
o Start - alias for ESC o Start - alias for ESC
@ -179,6 +187,7 @@
These buttons can be bound normally: These buttons can be bound normally:
o LTRIGGER - Left trigger o LTRIGGER - Left trigger
o RTRIGGER - Right trigger o RTRIGGER - Right trigger
@ -199,23 +208,22 @@
o YBUTTON o YBUTTON
quakespasm.pak contains a default.cfg which has been updated to give quakespasm.pak contains a default.cfg which has been updated to
some default bindings. L/R shoulder buttons are bound to weapon give some default bindings. L/R shoulder buttons are bound to
switching, and L/R triggers are jump and attack. weapon switching, and L/R triggers are jump and attack.
The controller support started as Jeremiah Sypult's implementation in The controller support started as Jeremiah Sypult's implementation in
Quakespasm-Rift and also uses ideas and code from LordHavoc Quakespasm-Rift and also uses ideas and code from LordHavoc
(DarkPlaces). (DarkPlaces).
4. Compiling and Installation 4. Compiling and Installation
Quakespasm's (optional) custom data is now stored in the file Quakespasm's (optional) custom data is now stored in the file
quakespasm.pak. This file should be placed alongside your quakespasm quakespasm.pak. This file should be placed alongside your quakespasm
binary and id1 directory. binary and id1 directory.
To checkout the latest version of QuakeSpasm, do: To checkout the latest version of QuakeSpasm, do: svn co
svn co svn://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm svn://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm
4.1. Linux/Unix 4.1. Linux/Unix
@ -259,7 +267,6 @@
Alternatively, have a look at Makefile.darwin for more instructions on Alternatively, have a look at Makefile.darwin for more instructions on
building from a console. building from a console.
5. Known Bugs 5. Known Bugs
Brightness issues should be fixed with GLSL gamma in 0.90.1, if your Brightness issues should be fixed with GLSL gamma in 0.90.1, if your
@ -271,10 +278,11 @@
help. help.
o Gamma patched libSDL (i686-linux) o Gamma patched libSDL (i686-linux)
http://sourceforge.net/projects/quakespasm/files/Support%20Files/libSDL_gamma_patched.tgz/download <http://sourceforge.net/projects/quakespasm/files/Support%20Files/libSDL_gamma_patched.tgz/download>
o Gamma patched libSDL (x86_64-linux) o Gamma patched libSDL (x86_64-linux)
http://sourceforge.net/projects/quakespasm/files/Support%20Files/libSDL_gamma_patched-AMD64.tgz/download <http://sourceforge.net/projects/quakespasm/files/Support%20Files/libSDL_gamma_patched-
AMD64.tgz/download>
The "game" command doesn't execute quake.rc in the new game directory The "game" command doesn't execute quake.rc in the new game directory
being switched to. This means any custom key bindings in a mod's being switched to. This means any custom key bindings in a mod's
@ -283,12 +291,11 @@
instead of using the game console command. Or, after running the game instead of using the game console command. Or, after running the game
command, you can run "exec quake.rc" by yourself (YMMV). command, you can run "exec quake.rc" by yourself (YMMV).
6. Changes 6. Changes
6.1. Changes in 0.92.0 6.1. Changes in 0.92.0
o SDL2 Game Controller support. o SDL2 Game Controller support.
o Contrast support with new "contrast" cvar, behaving the same as o Contrast support with new "contrast" cvar, behaving the same as
@ -323,11 +330,11 @@
o Updated some of the third-party libraries. Other fixes/clean-ups. o Updated some of the third-party libraries. Other fixes/clean-ups.
6.2. Changes in 0.91.0 6.2. Changes in 0.91.0
6.2.1. Bugfixes 6.2.1. Bugfixes
o Fix unwanted fog mode change upon video restart. o Fix unwanted fog mode change upon video restart.
o Work around Intel 855 bug in status bar drawing with "r_oldwater 0" o Work around Intel 855 bug in status bar drawing with "r_oldwater 0"
@ -364,6 +371,7 @@
6.2.2. Visual improvements 6.2.2. Visual improvements
o New cvars r_lavaalpha, r_slimealpha, r_telealpha for fine-tuning o New cvars r_lavaalpha, r_slimealpha, r_telealpha for fine-tuning
specific liquid opacities (from DirectQ/RMQEngine, non-archived, specific liquid opacities (from DirectQ/RMQEngine, non-archived,
default to 0), and new worldspawn keys _wateralpha, _lavaalpha, default to 0), and new worldspawn keys _wateralpha, _lavaalpha,
@ -375,6 +383,7 @@
6.2.3. Interface improvements 6.2.3. Interface improvements
o New r_pos command to show player position. o New r_pos command to show player position.
o NaN detection in traceline with "developer 1" set now warns instead o NaN detection in traceline with "developer 1" set now warns instead
@ -382,10 +391,12 @@
6.2.4. Code cleanup / Other 6.2.4. Code cleanup / Other
o Update third-party libraries. o Update third-party libraries.
6.2.5. Raised limits 6.2.5. Raised limits
o Default max_edicts 8192 (was 2048) and no longer saved to o Default max_edicts 8192 (was 2048) and no longer saved to
config.cfg. config.cfg.
@ -395,18 +406,18 @@
o Raised MAX_SFX to 1024 (was 512). o Raised MAX_SFX to 1024 (was 512).
6.3. Changes in 0.90.1 6.3. Changes in 0.90.1
6.3.1. Bugfixes 6.3.1. Bugfixes
o Fix dynamic light artifact where changing lightmap are rendered one o Fix dynamic light artifact where changing lightmap are rendered one
frame late (bug introduced in 0.90.0). frame late (bug introduced in 0.90.0).
o Fix texture memory leak when changing video modes with SDL2. o Fix texture memory leak when changing video modes with SDL2.
o Fix rare incorrect mdl lighting on 64-bit builds. (details here: o Fix rare incorrect mdl lighting on 64-bit builds. (details here.)
http://forums.insideqc.com/viewtopic.php?f=3&t=5620) <http://forums.insideqc.com/viewtopic.php?f=3&t=5620>
o Fix fullbrights turning black after "kill" command (bug introduced o Fix fullbrights turning black after "kill" command (bug introduced
in 0.90.0). in 0.90.0).
@ -423,12 +434,14 @@
6.3.2. Performance 6.3.2. Performance
o Use multithreaded OpenGL on OS X for better performance. o Use multithreaded OpenGL on OS X for better performance.
o New, faster mdl renderer using GLSL. Disable with "-noglslalias". o New, faster mdl renderer using GLSL. Disable with "-noglslalias".
6.3.3. Visual improvements 6.3.3. Visual improvements
o New gamma correction implementation using GLSL. Fixes all known o New gamma correction implementation using GLSL. Fixes all known
gamma issues (affecting the full display, persisting after gamma issues (affecting the full display, persisting after
quitting, or darkening the screen on OS X). Disable with quitting, or darkening the screen on OS X). Disable with
@ -443,6 +456,7 @@
6.3.4. Interface improvements 6.3.4. Interface improvements
o Support pausing demo playback with the "pause" command. o Support pausing demo playback with the "pause" command.
o Autocompletion for "game", "record", "playdemo". o Autocompletion for "game", "record", "playdemo".
@ -460,17 +474,18 @@
6.3.5. Code cleanup 6.3.5. Code cleanup
o Clean up IDE project files to build on fresh systems. o Clean up IDE project files to build on fresh systems.
o Update 3rd-party libraries. o Update 3rd-party libraries.
6.4. Changes in 0.90.0 6.4. Changes in 0.90.0
o Fix issues on Windows systems with DPI scaling. o Fix issues on Windows systems with DPI scaling.
o Unix/Mac user directories support. Disabled by default, o Unix/Mac user directories support. Disabled by default, 'make
'make DO_USERDIRS=1' to enable it. DO_USERDIRS=1' to enable it.
o SDL2 support. Disabled by default, 'make USE_SDL2=1' to enable it. o SDL2 support. Disabled by default, 'make USE_SDL2=1' to enable it.
@ -516,7 +531,7 @@
o Music and sfx now mixed at 44100 Hz to avoid downsampling music. o Music and sfx now mixed at 44100 Hz to avoid downsampling music.
Low-pass filter applied to the sfx if -sndspeed is 11025 (the Low-pass filter applied to the sfx if -sndspeed is 11025 (the
default), to preserve the same sound quality as 0.85.9. New default), to preserve the same sound quality as 0.85.9. New
-mixspeed option sets the rate for mixing sfx and music, and output -mixspeed option sets the rate for mixing sfx and music, and output
to the OS (default 44100), setting it to 11025 reverts to 0.85.9 to the OS (default 44100), setting it to 11025 reverts to 0.85.9
behaviour. New snd_filterquality cvar, value can be between 1 behaviour. New snd_filterquality cvar, value can be between 1
@ -572,9 +587,9 @@
o Other fixes and clean-ups. o Other fixes and clean-ups.
6.5. Changes in 0.85.9 6.5. Changes in 0.85.9
o Fixes for several undefined behaviors in C code (gcc-4.8 support.) o Fixes for several undefined behaviors in C code (gcc-4.8 support.)
o Implemented Hor+ style field of view (FOV) scaling, useful for o Implemented Hor+ style field of view (FOV) scaling, useful for
@ -619,9 +634,9 @@
o Several other minor fixes/cleanups. o Several other minor fixes/cleanups.
6.6. Changes in 0.85.8 6.6. Changes in 0.85.8
o Made Quake shareware 1.00 and 1.01 versions to be recognized o Made Quake shareware 1.00 and 1.01 versions to be recognized
properly. properly.
@ -666,9 +681,9 @@
o Miscellaneous source code cleanups. o Miscellaneous source code cleanups.
6.7. Changes in 0.85.7 6.7. Changes in 0.85.7
o Added support for cross-level demo playback o Added support for cross-level demo playback
o gl_texturemode is reimplemented as a cvar with a callback and the o gl_texturemode is reimplemented as a cvar with a callback and the
@ -692,9 +707,9 @@
o Several other small changes mostly invisible to the end-user o Several other small changes mostly invisible to the end-user
6.8. Changes in 0.85.6 6.8. Changes in 0.85.6
o More work for string buffer safety o More work for string buffer safety
o Reverted v0.85.5 change of not allowing deathmatch and coop cvars o Reverted v0.85.5 change of not allowing deathmatch and coop cvars
@ -705,9 +720,9 @@
o Minor SDL video fixes. o Minor SDL video fixes.
6.9. Changes in 0.85.5 6.9. Changes in 0.85.5
o SDL input driver updated adding native keymap and dead key support o SDL input driver updated adding native keymap and dead key support
to the console to the console
@ -736,9 +751,9 @@
o Several code updates from uHexen2 project, several code cleanups. o Several code updates from uHexen2 project, several code cleanups.
6.10. Changes in 0.85.4 6.10. Changes in 0.85.4
o Implement music (OGG, MP3, WAV) playback o Implement music (OGG, MP3, WAV) playback
o A better fix for the infamous SV_TouchLinks problem, no more hard o A better fix for the infamous SV_TouchLinks problem, no more hard
@ -764,9 +779,9 @@
o Other minor sound and cdaudio updates o Other minor sound and cdaudio updates
6.11. Changes in 0.85.3 6.11. Changes in 0.85.3
o Fix the "-dedicated" option (thanks Oz) and add platform specific o Fix the "-dedicated" option (thanks Oz) and add platform specific
networking code (default) rather than SDL_net networking code (default) rather than SDL_net
@ -801,9 +816,9 @@
o Add a "-cd" option to let the CD Player work in dedicated mode, and o Add a "-cd" option to let the CD Player work in dedicated mode, and
some other CD tweaks. some other CD tweaks.
6.12. Changes in 0.85.2 6.12. Changes in 0.85.2
o Replace the old "Screen size" slider with a "Scale" slider o Replace the old "Screen size" slider with a "Scale" slider
o Don't constantly open and close condebug log o Don't constantly open and close condebug log
@ -829,9 +844,9 @@
o Add OSX Makefile (tested?) o Add OSX Makefile (tested?)
6.13. Changes in 0.85.1 6.13. Changes in 0.85.1
o 64 bit CPU support o 64 bit CPU support
o Restructured SDL sound driver o Restructured SDL sound driver
@ -867,48 +882,50 @@
o Changes to cvar persistence gl_flashblend (default 0), r_shadow, o Changes to cvar persistence gl_flashblend (default 0), r_shadow,
r_wateralpha, r_dynamic, r_novis r_wateralpha, r_dynamic, r_novis
7. Todo 7. Todo
o Add uHexen2's first person camera (and menu item) o Add uHexen2's first person camera (and menu item)
o Native CD audio support (if desired). cd_sdl.c doesn't have proper o Native CD audio support (if desired). cd_sdl.c doesn't have proper
volume controls and SDL2 doesn't support CD audio volume controls and SDL2 doesn't support CD audio
8. Copyright 8. Copyright
o Quake and Quakespasm are released under the GNU GENERAL PUBLIC o Quake and Quakespasm are released under the GNU GENERAL PUBLIC
LICENSE Version 2: http://www.gnu.org/licenses/gpl-2.0.html LICENSE Version 2 <http://www.gnu.org/licenses/gpl-2.0.html>
o Quakespasm console background image by AAS, released under the o Quakespasm console background image by AAS, released under the
CREATIVE COMMONS PUBLIC LICENSE: CREATIVE COMMONS PUBLIC LICENSE
http://creativecommons.org/licenses/by/3.0/legalcode <http://creativecommons.org/licenses/by/3.0/legalcode>
9. Contact 9. Contact
o QuakeSpasm Project page:
http://sourceforge.net/projects/quakespasm
o Bug reports: o QuakeSpasm Project page
http://sourceforge.net/p/quakespasm/bugs/?source=navbar <http://sourceforge.net/projects/quakespasm>
o Ozkan <mailto:gmail - dot - com - username - sezeroz> (project o Bug reports
leader), Eric <mailto:gmail - dot - com - username - ewasylishen>, <http://sourceforge.net/p/quakespasm/bugs/?source=navbar>
Sander <mailto:gmail - dot - com - username - a.h.vandijk>,
Stevenaaus <mailto:yahoo - dot - com - username - stevenaaus>
o Ozkan <mailto:gmail - dot - com - username - sezeroz>, Eric
<mailto:gmail - dot - com - username - ewasylishen>, Sander
<mailto:gmail - dot - com - username - a.h.vandijk>, Stevenaaus
<mailto:yahoo - dot - com - username - stevenaaus>
10. Links 10. Links
o QuakeSpasm Homepage: http://quakespasm.sourceforge.net
o Downloads: http://quakespasm.sourceforge.net/download.htm o QuakeSpasm Homepage <http://quakespasm.sourceforge.net>
o FitzQuake Homepage: http://www.celephais.net/fitzquake o Downloads <http://quakespasm.sourceforge.net/download.htm>
o FitzQuake Homepage <http://www.celephais.net/fitzquake>
o Func Quakespasm forum
<http://www.celephais.net/board/view_thread.php?id=60452>
o Inside3D forums <http://forums.insideqc.com>
o Func Quakespasm forum:
http://www.celephais.net/board/view_thread.php?id=60452
o Inside3D forums: http://forums.insideqc.com