Command line switches

From ZCWiki
Jump to: navigation, search

Both ZC and ZQuest can be called with command line switches to influence their behaviour, like starting in windowed mode.

Using command line switches

If you know how to use a command line, enter them as usual. If you don't, here's some easier ways:

Windows 
Make a shortcut by right-clicking zelda-w.exe or zquest.w.exe and choose copy. Right click some empty space in the folder or on your desktop and choose paste shortcut. Right-click the shortcut and choose properties, in the command field add a space on the end and the switches after that. Now use your shortcut to start ZC/ZQ.

Some switches are remembered the next time you start ZC/ZQ without any switches, others are not. If you use a shortcut it'll always use the switches you set.

ZC switches

-fullscreen 
starts ZC in fullscreen mode.
-windowed 
starts ZC as a window.
-res xxx yyy 
sets the window resolution to xxx pixels width and yyy height. Replace these by sensible numbers like 640 480 or 800 600. These only influence the size of the window, not of the actual game.
-res xxx yyy big 
same, but makes the game run at 2x scale.
-s 
silent. Turns off all sound.
-nosound  
disable sound. Probably identical to -s.
-q 
cause program to quit immediately.
-fast 
skip the intro.
-console 
runs ZConsole in parallel. (Windows version, only.)
-standalone 
runs with a specific quest, skips intro. Toggles bool Standalone to true.
Format:
zelda-* -standalone <quest> -savefile <save>
-v0 
vsync off.
-v1 
vsync on


ZQ switches

-new 
Override automatic loading of last opened quest, and start a new project.
-fullscreen 
starts ZQ in fullscreen mode.
-windowed 
starts ZQ as a window.
-scale x 
Sets the scale, x can be 1 (normal), 2 or 3.
-large 
Opened the new, 2.5 style ZQuest view.
--> Verify this argument is still valid, without -scale and check for -small variant/default. 
-scale 1 -large 
Activates the new large mode. Despite its name, some features appear at 2x scale and the window takes up about 3x size.
-s 
silent. Turns off all sound.
--> Is there sound in ZQuest?
[ \filepath\filename.qst ] 
load filename.qst on start
--> If you use this, it must be the first argument that you pass.
    Example: zquest.exe C:\ZC\myquest.qst -windowed -scale 1 -large

Zelds lassic Launcher

There is also a program called ZLaunch, or ZC Launcher (ZLC) available that lets you set the switches and start ZC/ZQ at the touch of a button. ZLaunch is bundled with 2.50.0 and higher distributions of Zelda Classic.

--> -console is not available from ZLaunch.exe

Graphics Modes

You may select a graphics mode, when setting fullscreen, or windowed switches.

; -fullscreen [-directx [-soft | -safe] ]
; -windowed [-directx | -gdi]

Older ZC Versions

Earlier ZC releases, that run purely on DOS, use these options to set a graphics mode:

DOS MODE ONLY GRAPHICS MODES
-modex | -vesa1 | -vesa2b | -vesa2l | -vesa3