sar2 man page

sar2 — Air rescue flight simulator

Syntax

sar2 [options] [GUI_options]

Description

Helicopter based search and rescue flight simulator. Pilot a variety of user editable rescue aircraft through customizeable missions and rescue victims in distress. Uses OpenGL and glX for graphics, OpenAL for sounds and SDL_Joystick for support (2 devices maximum).

Options

--config <file>
Load configuration from <file>.
--rcfile
Same as --config.
-f
Same as --config.
--control <type>
Specify which controller to use at start up. <type> can be keyboard (default) or joystick.
-c
Same as --control.
--hardware_rendering
Use direct hardware rendering (default).
--software_rendering
Use software rendering instead of direct hardware rendering.
--full_menu_redraw
Always perform full (not partial) menu redraws (slow but required for certain accelerated video cards).
--display <address>
Specifies display address (UNIX/X version only).
--font <name>
Specifies the default font to use on GUI related outputs. Refer to your GUI manual for the proper font name formats.
--geometry <WxH+X+Y>
Specifies the geometry of the toplevel window, example "--geometry 640x480+100+120" to make the window 640 by 480 pixels in size and at coordinate position 100,120 (relative to the root window/desktop).
--fullscreen
Specifies to switch to full screen on startup, use this if and only if your GUI does not support manual switching to full screen. You may need to specify the --geometry argument to specify the size of the full screen resolution.
--aspect_offset <coeff>
Specifies a floating coefficient value to be applied to screen aspect calculations, example a value of -0.2 when your screen is 800 by 600 then the aspect would be 800/600 + (-0.2) = 1.333 - 0.2 = 1.133.
--recorder <address>
Specifies recorder address (UNIX/Y version only).
--nosound
Do not connect to sound server at startup (overrides the value set in the configuration).
--nomenubg
No menu background images (speeds up the redrawing when in the menus).
--console_quiet
Do not print routine messages to stdout.
--runtime_debug
Print debugging runtime detection of various resources to stdout. This may help detect points of failure or crash during startup or exiting.
--internal_debug
Print debugging of internal runtime information (messy and terse) to stdout. This will only print debugging information about internal resources belonging to the program.
--help
Prints (this) help screen and exits.
--version
Prints version information and exits.

Files

$HOME/.config/sar2/SearchAndRescue.ini
Local configuration file.
/usr/share/games/sar2/
Data directory for this program's proprietery data files.
/usr/share/games/sar2/human.ini
Preset values list for humanoid objects.
/usr/share/games/sar2/music.ini
List of music file referances for corresponding situations.
/usr/share/games/sar2/textures.ini
List of default textures to be loaded during simulation.
/usr/share/games/sar2/weather.ini
Preset weather values for a list of defined weather conditions.

Environment Variables

SEARCHANDRESCUE2_DATA Specifies alternate global data directory for this program.

DISPLAY
Specifies the address to the X display.
HOME
Specifies the home directory.
MESA_GAMMA
Specifies the gamma value, used only on software rendering with the Mesa3D library.

Examples

To run this program the standard way, type:

# sar2 &

To run in full screen mode at 640x480 resolution, type:

# sar2 --geometry "640x480" --fullscreen &

To specify the geometry and force software rendering, type:

# sar2 --geometry "640x480+240+350" --software_rendering &

Keyboard

General keys (can be used anywhere):

CTRL + F11
Toggles between full screen and windowed modes.
CTRL + ]
Increase resolution to the next step.
CTRL + [
Decrease resolution to the previous step.
CTRL + C
Screen shot. Saved as sar1.tga, sar2.tga, etc in directory from which SearchAndRescue is run.

Menu keys:

TAB
Focus next.
SHIFT + TAB
Focus previous.
CURSORS
Focus change/highlight/scroll.
ENTER
Activate focused.

Simulation keys:

F1
Display `quick help'.
F2
Switch to cockpit view.
F3
Spot view.
F4
Fly by tower view.
F5
Rescue basket view.
LEFT
Bank left.
RIGHT
Bank right.
DOWN
Pitch down.
UP
Pitch up.
CTRL + LEFT
Heading left.
CTRL + RIGHT
Heading right.
SHIFT + CURSORS
Change camera direction or position.
BACKSPACE
Normalize view.
PGUP
Increase throttle.
PGDN
Decrease throttle.
HOME
Elevator trim down or slew up in slew mode.
END
Elevator trim up or slew down in slew mode.
CTRL + HOME
Elevator trim center.
MINUS
Zoom out.
PLUS
Zoom in.
CTRL + MINUS
Rescue basket hoist out.
CTRL + PLUS
Rescue basket hoist in.
E
Start up engines.
SHIFT + E
Turn engines off.
Y
Tilt rotors/pitch engines.
G
Raise/lower landing gears (retractable gears only).
P
Select hoist deployment type.
D
Close/open door.
O
Toggle strobes (flashing lights).
L
Toggle lighting (including spot light).
SHIFT + L
Toggle spot light.
CTRL + L
Center spot light.
H
HUD and outside text brighten.
SHIFT + H
HUD and outside text darken.
A
Autopilot/autohover on/off.
M
Map view.
W
Select next way point.
SHIFT + W
Select previous way point.
I
FLIR (night vision).
F
Fuel status and aloft time left dependent of available fuel.
SHIFT + F
Transfer fuel from external fuel tanks.
CTRL + F
Jettison external fuel tanks.
S
Print scores, payload, occupancy, and mission status.
PERIOD Wheel brakes.
SHIFT + PERIOD
Parking brakes.
B
Deploy/retract air brakes.
R
Refuel and/or repair (only when landed on a helipad with refuel and/or repair facilities).
Z
Decelerate time (slow motion).
SHIFT + Z
Accelerate time (compress time).
CTRL + Z
Normalize time rate.
CTRL + W
Change weather.
CTRL + A
Slew/flight toggle.
/
Literal command.
T
Increase time of day (does not affect other timmings).
SHIFT + T
Decrease time of day (does not affect other timmings).
CTRL + D
Adjust flight physics difficulty.
CTRL + S
Adjust sound level.
CTRL + U
Change units.
F9
Toggle ground base texture (not objects or landmarks).
F10
Toggle atmosphere.
F11
Toggle object texturing.
F12
Toggle clouds and horizon.
SHIFT + F9
Toggle dual pass depth.
SHIFT + F10
Toggle celestial objects.
SHIFT + F11
Toggle smoke trails.
SHIFT + F12
Toggle rotor wash effects.

Joystick

In simulation joystick functions:

STICK AXIS XY
Bank and pitch (respectivly).
STICK AXIS Z
Heading/turning.
THROTTLE
Throttle/collective.
HAT
Camera direction/position.

Joystick button functions are mappable, see Options->Controller->Buttons.

Authors

Dan Stimits
Code design consultant and beta testing
Stefan Marion
Beta testing and aircraft design consultant
Capt Tara Milana
Head programmer, 3d models, flight dynamics, and scenery graphics artist
Joel Baker
Jesse Smith
Coding and patching
Hector Sanjuan
Coding and patching

Credits

Search And Rescue was originally developed at Wolfpack Entertainment. Search And Rescue II is a fork of Search and Rescue (searchandrescue.sf.net).

Bugs

Please report bugs to <hector@convivencial.org>.

See Also

Search and Rescue II homepage
http://sar2.sourceforge.net

Info

2.3 WolfPack Entertainment Flight Simulators