wqreadme.txt

quake1 dos源代码最新版本

MWAVE sound loses focus
-----------------------
We've had a report that on a ThinkPad with MWAVE sound, WQ loses
sound focus (and thus sound) every few seconds.


Desktop doesn't reset to proper resolution on WQ exit
-----------------------------------------------------
We've had a report that on exiting WQ, the desktop didn't reset
to the proper dimensions.  This may be a bug with the Matrox
drivers, but we're not sure.  If it's a problem and newer
drivers don't fix it, you can run -dibonly, which solves the
problem but can cost some performance.


Palette goes bad periodically on #9 Imagine card
------------------------------------------------
There's only one report of this, so maybe it's a flaky board,
or maybe it's a driver bug.  Newer drivers might help.


System with Packard Bell sound card III crashes on CapsLock
-----------------------------------------------------------
This appears to be the result of buggy DirectSound drivers;
-wavonly makes the problem go away.


Dvorak keyboard mapping ignored
-------------------------------
WQ is hardwired for QWERTY.


Cursor messed up after running WQ
---------------------------------
This is a Windows driver bug; the driver isn't restoring the
cursor properly on return from fullscreen WQ to the desktop.
Try newer drivers.


Dedicated server runs very slowly while typing at console
---------------------------------------------------------
When you type at a dedicated server's console, the game runs
very slowly for everyone who's connected.


Ctrl-Alt-Del on NT sometimes doesn't allow return to WQ
-------------------------------------------------------
This happens on some machines while running WQ fullscreen.
If you experience this problem, the only workaround is not
to press Ctrl-Alt-Del while fullscreen; Alt-Tab away first.


Many fast Alt-Tabs on Win95 sometimes disable WQ input
------------------------------------------------------
If you Alt-Tab fast lots of times on Win95 with WQ running
fullscreen, sometimes you end up in fullscreen WQ, with the
game not accepting any keyboard input (so there's no way to
exit).  The only workaround is to not do lots of fast
Alt-Tabs (why you'd want to, I'm not sure).



----------------------------------
| A bit about how WQ video works |
----------------------------------

WQ has the built-in ability to draw into windows (both normal, framed 
desktop windows and fullscreen, borderless windows).  It also has
built- in support for VGA 320x200 graphics, and supports DirectDraw,
VESA VBE 2.0 and VESA VBE/AF (Accelerator Functions) graphics modes,
if those are available.

WQ does not require DirectDraw, but in order for DirectDraw modes to
be available, you must have DirectDraw installed; some systems come
with it preinstalled, but if it's not on your system, you can download
it from http://www.microsoft.com/mediadev/download/directx.exe (the
exact URL may vary), and install it.

WQ does not require VESA VBE, but in order for VESA VBE modes to be
available, your graphics card must be VESA VBE 2.0 or VBE/AF
compliant; a VESA driver can either be built into the BIOS of your
graphics card, or loadable via software.  If you don't have a VESA VBE
driver, Scitech Display Doctor, available from Scitech Software, will
update most graphics cards to VESA VBE 2.0 and VBE/AF.


SciTech Display Doctor
----------------------
If you are having problems with your video drivers, or if you would
like to take a shot at improving your video performance in WQ, you may
want to try out SciTech Display Doctor (SDD).  SDD works on just about
any graphics card and it can do several things that can make WQ run
better on your system:

1. It will update your graphics card to be compatible with VESA VBE
2.0 and VESA VBE/AF (Accelerator Functions). These modes will usually
give you the best performance in WQ (which is often but not always
faster than your current performance).

2. It creates low-resolution modes on your graphics card.
Low-resolution video modes (such as 320x240, 400x300 and 512x384)
allow you to adjust the level of detail in WQ so you can get the best
balance between performance and image quality.

The latest version of SciTech Display Doctor can be obtained from the
following locations:

www: http://www.scitechsoft.com
ftp: ftp.scitechsoft.com
CIS: GO SCITECH
AOL: Keyword SciTech

SciTech can be contacted at:

email: [e-mail]

SciTech Software, Inc.
505 Wall Street
Chico, CA  95926-1989
916-894-8400
916-894-9069 FAX


Video modes supported in Win95
------------------------------
What all this means is that on Win95, WQ will always be able to run in
the following modes:

1)  in a window
2)  fullscreen 320x200 VGA mode 0x13
3)  fullscreen high-resolution of some sort

Category #3 can be any of several configurations.  On Win95, if either
DirectDraw or VESA VBE modes are available, then all the DirectDraw
and VESA modes will be presented as high-res choices.  (320x200 will
always default to VGA mode 0x13.)  In the case that a given resolution
is supported by both DirectDraw and VESA, the VESA mode will be used.
(However, the command-line switch -nowindirect can turn off VESA modes
entirely.)  If neither DirectDraw nor VESA modes are available, then
high-resolution modes will be provided by using fullscreen, borderless
windows in whatever resolutions the Windows driver supports, usually
starting at 640x480 and going up.


Video Modes Supported in Windows NT
-----------------------------------
NT is similar but not identical, because neither VESA VBE modes nor
VGA mode 0x13 are available.  On NT, WQ will always be able to run in
the following modes:

1)  in a window
2)  fullscreen high-resolution of some sort

On NT, category #2 can be one of two configurations.  If DirectDraw
modes are available, then those will be the high-res choices;
otherwise, fullscreen, borderless windows will be used in whatever
resolutions the driver supports, usually starting at 640x480 and going
up.  Because there is normally no low-resolution mode such as 320x200
or 320x240 on NT, a pseudo low-res mode is created by rendering at
320x240, then stretching the image by doubling it in each direction
while copying it to a 640x480 screen.  However, stretching performance
depends on the driver, and can be slow, so sometimes 640x480 is
actually faster than 320x240 on NT.

The bottom line here is that you can generally just use the Video menu
and pick one of the modes and be happy.  In some cases, though, you
may need to use command-line switches (described next) to get the
types of modes you want.  One useful tip is to go into the console and
do vid_describemodes, which lists all the modes WQ makes available on
your machine given the command-line switches you've used.  Each mode
is followed by the name of the internal WQ driver that supports it, so
you can tell which modes are DirectDraw, VESA, and so on, as follows:

WINDOWED: WQ runs in a normal window
FULLSCREEN DIB: fullscreen borderless window
FULLSCREEN VGA8.DRV: VGA 320x200 mode
FULLSCREEN DDRAW8.DRV: DirectDraw mode
FULLSCREEN LINEAR8.DRV: VESA VBE 2.0+ mode
FULLSCREEN ACCEL8.DRV: VESA VBE/AF (Accelerator Functions) mode
                       (note that WQ does not take advantage of
                       VBE/AF acceleration; so far as WQ is
                       concerned VBE/AF is the same as normal VBE)

You can use vid_mode from the console to set any of these modes.  So,
for example, if you see that there are two 320x200 modes (such as one
VGA mode 0x13, normally mode 3, and one VESA mode, normally mode 4),
you can choose the VESA mode, which will often be faster, with
vid_mode 4.  (You can make it the default by setting
_vid_default_mode_win to the mode number.)

There's more to the windowed modes than you might think.  320x240 is
just what you抎 expect, but 640x480 is actually rendered at 320x240
and stretched up to 640x480, because most machines can抰 handle the
performance demands of real 640x480 rendering.  Likewise, 800x600 is a
stretched 400x300.  Actually, though, vid_mode 2 (the 800x600 mode) is
a user-configurable mode.  By setting the following console variables,
you can change the characteristics of vid_mode 2:

vid_config_x: width of mode 2 window

vid_config_y: height of mode 2 window

vid_stretch_by_2: whether to render at half-resolution in each
direction and stretch up to the specified size in mode 2, or render at
full resolution.

After setting these variables in the console, do a vid_forcemode 2,
and you抣l have the window you specified.  Note that after making
these changes, the new resolution will show up as the third windowed
mode in the Video menu.

If you don't have WQ mouse play enabled in windowed mode, you can also
go from windowed to fullscreen mode simply by clicking on the maximize
button.  The mode switched to is controlled by the vid_fullscreen_mode
console variable, and defaults to mode 3.

Other video console commands include:

vid_fullscreen: switch to the mode specified by the
vid_fullscreen_mode console variable.

vid_windowed: switch to the mode specified by the vid_windowed_mode
console variable.

Vid_fullscreen and vid_windowed can be bound to keys, so it's possible
to flip between windowed and fullscreen with a single key press.

Also, vid_minimize minimizes the WinQuake window if and only if
WinQuake is running in a windowed mode.  You can bind a key to
the commands "vid_windowed; wait; vid_minimize" to minimize WQ
regardless of whether you're running in windowed or fullscreen mode.

You can turn off page flipping by setting the console variable
vid_nopageflip to 1, then setting a new mode.  (Note that the
vid_nopageflip setting does not take effect until the next mode set.)
Some systems run faster with page flipping turned off; also, page
flipping does not work properly on some adapters, and vid_nopageflip
is a workaround for this.  Note that vid_nopageflip is a persistent
variable; it retains its setting until it is explicitly changed again,
even across multiple WinQuake sessions.

The vid_forcemode console command sets the specified mode, even if
it's the same as the current mode (normally the mode set only happens
if the new mode differs from the current mode).  This is generally
useful only if you've modified the characteristics of video mode 2
(the configurable window) while you're in mode 2, and want to force
the new characteristics to take effect.

Whenever you switch to running WinQuake in a window, the window is
placed at the same location it was in the last time WinQuake ran
in a window.  You can reset the window position to the upper left
by using the -resetwinpos command-line switch.  The window position
is stored in the vid_window_x and vid_window_y console variables.



-------------------------------
| Video command-line switches |
-------------------------------

The full list of video-related command-line switches is:

-dibonly: WQ will use only windows (both normal, framed windows on the
desktop and fullscreen, borderless windows), not any direct hardware
access modes such as DirectDraw or VESA modes, or even VGA 320x200
mode.  This is the closest thing to a guaranteed-to-run fullscreen
mode WQ has.

-nowindirect: WQ will not try to use VESA VBE 2.0 modes, or VBE/AF
1.0 or later modes.  Note that if there are both DirectDraw and VESA
modes for a given resolution, WQ will normally use the VESA mode;
-nowindirect allows DirectDraw modes to be the preferred choice for
all resolutions except 320x200.  This can be useful if WQ is crashing
because of a buggy VESA driver.

-nodirectdraw: WQ will not try to use DirectDraw modes.  This can be
useful if WQ is crashing because of a buggy DirectDraw driver.