From 99107903fcf9a368473a706892df8690c7fa1def Mon Sep 17 00:00:00 2001 From: Ozkan Sezer Date: Fri, 1 Jul 2016 07:00:02 +0000 Subject: [PATCH] minor doco edits git-svn-id: svn://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm@1327 af15c1b1-3010-417e-b628-4374ebc0bcbd --- Linux/sgml/Quakespasm.sgml | 12 ++-- Quakespasm.html | 12 ++-- Quakespasm.txt | 132 +++++++++++++++++-------------------- 3 files changed, 72 insertions(+), 84 deletions(-) diff --git a/Linux/sgml/Quakespasm.sgml b/Linux/sgml/Quakespasm.sgml index 58ceb22e..13bfe5ae 100644 --- a/Linux/sgml/Quakespasm.sgml +++ b/Linux/sgml/Quakespasm.sgml @@ -9,13 +9,13 @@ About

-is a modern, cross-platform, Quake 1 engine based on . +is a modern, cross-platform Quake 1 engine based on .

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.

-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. +Quakespasm utilizes either the SDL or SDL2 frameworks, so choose which one works best for you. +SDL is probably less buggy, but SDL2 has nicer features and smoother mouse input - though no CD support. Downloads

@@ -34,7 +34,7 @@ SDL is probably less buggy, but SDL 2 has nicer features and smoother mouse inpu Quakespasm's custom data is stored in "quakespasm.pak". Install this file alongside your id1 directory to enable the custom console background and other minor features. -For different sound drivers use "SDL_AUDIODRIVER=DRIVER ./quakespasm" +For different sound backend drivers use "SDL_AUDIODRIVER=DRIVER ./quakespasm" , where DRIVER may be alsa, dsp, pulse, esd ... Shift+Escape draws the Console. @@ -147,9 +147,9 @@ Some versions of Xorg and SDL have brightness issues. Try setting "export SDL_VIDEO_X11_NODIRECTCOLOR=1", or if you have Xorg >= 7.5 and broken brightness, these patched libSDL binaries may help. - -

diff --git a/Quakespasm.html b/Quakespasm.html index 96ebdd46..0e6a55d9 100644 --- a/Quakespasm.html +++ b/Quakespasm.html @@ -75,12 +75,12 @@

QuakeSpasm -is a modern, cross-platform, Quake 1 engine based on +is a modern, cross-platform Quake 1 engine based on FitzQuake.

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.

-

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.

+

Quakespasm utilizes either the SDL or SDL2 frameworks, so choose which one works best for you. +SDL is probably less buggy, but SDL2 has nicer features and smoother mouse input - though no CD support.

2. Downloads

@@ -106,7 +106,7 @@ SDL is probably less buggy, but SDL 2 has nicer features and smoother mouse inpu
  • Quakespasm's custom data is stored in "quakespasm.pak". Install this file alongside your id1 directory to enable the custom console background and other minor features.
    • -
  • For different sound drivers use "SDL_AUDIODRIVER=DRIVER ./quakespasm" +
  • For different sound backend drivers use "SDL_AUDIODRIVER=DRIVER ./quakespasm" , where DRIVER may be alsa, dsp, pulse, esd ...
  • Shift+Escape draws the Console.
    • @@ -234,9 +234,9 @@ Try setting "export SDL_VIDEO_X11_NODIRECTCOLOR=1", or if you have Xorg >= 7.5 a these patched libSDL binaries may help.

    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 config.cfg or special settings in a quake.rc won't be loaded. The only workaround is launching the engine with the -game command-line switch instead of using the game console command. Or, after running the game command, you can run "exec quake.rc" by yourself (YMMV).

    diff --git a/Quakespasm.txt b/Quakespasm.txt index bba4090c..d1766986 100644 --- a/Quakespasm.txt +++ b/Quakespasm.txt @@ -4,7 +4,6 @@ Table of Contents - 1. About 2. Downloads 3. Hints @@ -49,48 +48,48 @@ 9. Contact 10. Links - ______________________________________________________________________ Page last edited: July 2016 + 1. About QuakeSpasm is a modern, cross- - platform, Quake 1 engine based on FitzQuake + platform Quake 1 engine based on FitzQuake . 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. - 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 + Quakespasm utilizes either the SDL or SDL2 frameworks, so choose + which one works best for you. SDL is probably less buggy, but SDL2 has nicer features and smoother mouse input - though no CD support. + 2. Downloads + o Project Downloads: http://quakespasm.sourceforge.net/download.htm - o Project Downloads + o Automatic Builds: http://quakespasm.ericwa.com/job/quakespasm-sdl2/ - o Automatic Builds 3. Hints Visit the FitzQuake homepage for a full run-down of the engine's commands and variables. - o To disable some changes, use "quakespasm -fitz" o Quakespasm's custom data is stored in "quakespasm.pak". Install this file alongside your id1 directory to enable the custom console background and other minor features. - o For different sound drivers use "SDL_AUDIODRIVER=DRIVER - ./quakespasm" , where DRIVER may be alsa, dsp, pulse, esd ... + o For different sound backend drivers use : + "SDL_AUDIODRIVER=DRIVER ./quakespasm" + where DRIVER may be alsa, dsp, pulse, esd ... o Shift+Escape draws the Console. @@ -126,7 +125,7 @@ o Use the "-noextmusic" option to disable this feature. - o See for more details. + o See Quakespasm-Music.txt for more details. 3.2. Controller Support @@ -137,13 +136,12 @@ the right for looking. If your controller doesn't work you can try placing this file - + https://raw.githubusercontent.com/gabomdq/SDL_GameControllerDB/master/gamecontrollerdb.txt in your Quake directory, it is a community-maintained database that adds support for more controllers to SDL2. 3.2.1. Cvars - o joy_deadzone - Fraction of the stick travel to be deadzone, between 0 and 1. Default 0.2. @@ -174,7 +172,6 @@ Some of the controller buttons are hardcoded to allow navigating the menu: - o Back - alias for TAB o Start - alias for ESC @@ -187,7 +184,6 @@ These buttons can be bound normally: - o LTRIGGER - Left trigger o RTRIGGER - Right trigger @@ -208,22 +204,23 @@ o YBUTTON - quakespasm.pak contains a default.cfg which has been updated to - give some default bindings. L/R shoulder buttons are bound to - weapon switching, and L/R triggers are jump and attack. + quakespasm.pak contains a default.cfg which has been updated to give + some default bindings. L/R shoulder buttons are bound to weapon + switching, and L/R triggers are jump and attack. The controller support started as Jeremiah Sypult's implementation in Quakespasm-Rift and also uses ideas and code from LordHavoc (DarkPlaces). + 4. Compiling and Installation Quakespasm's (optional) custom data is now stored in the file quakespasm.pak. This file should be placed alongside your quakespasm binary and id1 directory. - To checkout the latest version of QuakeSpasm, do: svn co - svn://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm + To checkout the latest version of QuakeSpasm, do: + svn co svn://svn.code.sf.net/p/quakespasm/code/trunk/quakespasm 4.1. Linux/Unix @@ -267,6 +264,7 @@ Alternatively, have a look at Makefile.darwin for more instructions on building from a console. + 5. Known Bugs Brightness issues should be fixed with GLSL gamma in 0.90.1, if your @@ -278,11 +276,10 @@ help. o Gamma patched libSDL (i686-linux) - + http://sf.net/projects/quakespasm/files/Support%20Files/libSDL_gamma_patched.tgz/download o Gamma patched libSDL (x86_64-linux) - + http://sf.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 being switched to. This means any custom key bindings in a mod's @@ -291,10 +288,11 @@ instead of using the game console command. Or, after running the game command, you can run "exec quake.rc" by yourself (YMMV). + 6. Changes - 6.1. Changes in 0.92.0 + 6.1. Changes in 0.92.0 o SDL2 Game Controller support. @@ -330,11 +328,11 @@ o Updated some of the third-party libraries. Other fixes/clean-ups. + 6.2. Changes in 0.91.0 6.2.1. Bugfixes - o Fix unwanted fog mode change upon video restart. o Work around Intel 855 bug in status bar drawing with "r_oldwater 0" @@ -371,7 +369,6 @@ 6.2.2. Visual improvements - o New cvars r_lavaalpha, r_slimealpha, r_telealpha for fine-tuning specific liquid opacities (from DirectQ/RMQEngine, non-archived, default to 0), and new worldspawn keys _wateralpha, _lavaalpha, @@ -383,7 +380,6 @@ 6.2.3. Interface improvements - o New r_pos command to show player position. o NaN detection in traceline with "developer 1" set now warns instead @@ -391,12 +387,10 @@ 6.2.4. Code cleanup / Other - o Update third-party libraries. 6.2.5. Raised limits - o Default max_edicts 8192 (was 2048) and no longer saved to config.cfg. @@ -406,18 +400,18 @@ o Raised MAX_SFX to 1024 (was 512). + 6.3. Changes in 0.90.1 6.3.1. Bugfixes - o Fix dynamic light artifact where changing lightmap are rendered one frame late (bug introduced in 0.90.0). 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) o Fix fullbrights turning black after "kill" command (bug introduced in 0.90.0). @@ -434,14 +428,12 @@ 6.3.2. Performance - o Use multithreaded OpenGL on OS X for better performance. o New, faster mdl renderer using GLSL. Disable with "-noglslalias". 6.3.3. Visual improvements - o New gamma correction implementation using GLSL. Fixes all known gamma issues (affecting the full display, persisting after quitting, or darkening the screen on OS X). Disable with @@ -456,7 +448,6 @@ 6.3.4. Interface improvements - o Support pausing demo playback with the "pause" command. o Autocompletion for "game", "record", "playdemo". @@ -474,18 +465,17 @@ 6.3.5. Code cleanup - o Clean up IDE project files to build on fresh systems. 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 Unix/Mac user directories support. Disabled by default, 'make - DO_USERDIRS=1' to enable it. + o Unix/Mac user directories support. Disabled by default, + 'make DO_USERDIRS=1' to enable it. o SDL2 support. Disabled by default, 'make USE_SDL2=1' to enable it. @@ -531,7 +521,7 @@ 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 - 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 to the OS (default 44100), setting it to 11025 reverts to 0.85.9 behaviour. New snd_filterquality cvar, value can be between 1 @@ -587,8 +577,8 @@ 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.) @@ -634,8 +624,8 @@ 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 properly. @@ -681,8 +671,8 @@ 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 @@ -707,8 +697,8 @@ 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 @@ -720,8 +710,8 @@ 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 to the console @@ -751,8 +741,8 @@ 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 @@ -779,8 +769,8 @@ 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 networking code (default) rather than SDL_net @@ -816,8 +806,8 @@ o Add a "-cd" option to let the CD Player work in dedicated mode, and 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 @@ -844,8 +834,8 @@ o Add OSX Makefile (tested?) - 6.13. Changes in 0.85.1 + 6.13. Changes in 0.85.1 o 64 bit CPU support @@ -882,50 +872,48 @@ o Changes to cvar persistence gl_flashblend (default 0), r_shadow, r_wateralpha, r_dynamic, r_novis - 7. Todo + 7. Todo o Add uHexen2's first person camera (and menu item) o Native CD audio support (if desired). cd_sdl.c doesn't have proper volume controls and SDL2 doesn't support CD audio + 8. Copyright - o Quake and Quakespasm are released under the GNU GENERAL PUBLIC - LICENSE Version 2 + LICENSE Version 2: http://www.gnu.org/licenses/gpl-2.0.html 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 + 9. Contact + o QuakeSpasm Project page: + http://sourceforge.net/projects/quakespasm - o QuakeSpasm Project page - + o Bug reports: + http://sourceforge.net/p/quakespasm/bugs/?source=navbar - o Bug reports - + o Ozkan + Eric + Sander + Stevenaaus - o Ozkan , Eric - , Sander - , Stevenaaus - 10. Links + o QuakeSpasm Homepage: http://quakespasm.sourceforge.net - o QuakeSpasm Homepage + o Downloads: http://quakespasm.sourceforge.net/download.htm - o Downloads - - o FitzQuake Homepage - - o Func Quakespasm forum - - - o Inside3D forums + 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