VsWiki - User contributions [en]

HowTo:Compile from SVN on Linux

2011-03-19T22:17:13Z

Greenfreedom10: /* Compiling */ peculiar word choice

{{NAV_Manual |
| previous=[[HowTo:Cygwin Compiling|Compiling with Cygwin]]
| up=[[HowTos]]
| next=[[HowTo:Compile_on_OSX|Compiling from SVN on Mac OSX]]
}}
----
How to compile from SVN under Linux.

''See also: [[HowTo:Cygwin Compiling]], [[HowTo:VCPP Compiling]], [[HowTo:Checkout SVN (Ubuntu Linux)]]''

==Getting the SVN-files==

* Checkout the following modules ...
** data package: '''data''' (repository link: https://vegastrike.svn.sourceforge.net/svnroot/vegastrike/trunk/data)
** code package: '''vegastrike''' (repository link: https://vegastrike.svn.sourceforge.net/svnroot/vegastrike/trunk/vegastrike)
* Visit [[HowTo:Checkout SVN]] to see how you check these modules out.

==Requirements==
In order to compile Vegastrike there are a few things to check:
* Make sure you have these packages installed ...
** '''make'''
** '''gcc'''
** '''automake''' at least version 1.6
** '''autoconf''' at least version 2.53
** '''X11'''...
** '''libpng''' + '''libpng-devel''' <-- libpng 3 is recommended.
** '''python''' and '''python-dev''' <-- 2.2.1
** '''expat''' + '''expat-devel'''
** '''(lib)jpeg''' + '''libjpeg-devel'''
** '''opengl''' (see below) (you probably already have it)
** '''glut''' + '''glut-devel'''
** '''openal''' + '''openal-devel'''
** '''libgtk2.0''' + '''libgtk2.0-devel'''

This probably should do the trick in debian/ubuntu (copy and paste the entire code into terminal):

<pre>
sudo apt-get install libpng12-0 libpng12-dev python-dev libexpat1-dev \
libjpeg62-dev glutg3-dev libopenal-dev libgtk2.0-dev libogg-dev libvorbis-dev \
build-essential libgl1-mesa-dev automake autoconf
</pre>

==Compiling==
The compile procedure should look like the following listing. Remember the configure part depends on above requirements. Though autoconf may not work, if so just skip it.
<pre>
cd ./vegastrike
./bootstrap-sh
./configure --enable-flags='-O3 -g' # or --enable-debug to disable optimization. -ffast-math will cause problems in code that checks for infinities. Note that in the first flag there's a capital 'o', not a zero.
make
make install # [AS ROOT]
</pre>

* To be sure '''set the data dir''' to your vs-data dir:
<pre>
./configure --with-data-dir=<DIR> ........
</pre>
* When using '''libpng 1.2''',
<pre>
--with-png-inc=<DIR>
</pre>
is needed. An example is
<pre>
--with-png-inc=/usr/include/libpng12/
</pre>
* If you don't want to compile with '''GTK''' just turn it off, however you will not get a setup program if you do this:
<pre>
./configure --disable-gtk ...........
</pre>
* If you only want the server, and want to disable all GUI components--This removes the dependency on X11, OpenGL, SDL, GLUT, OpenAL.
<pre>
./configure --disable-client ...........
</pre>
* See [http://vegastrike.sourceforge.net/forums/viewtopic.php?t=1147 this] thread about boost versions. Set this option to 1.28, 1.29, 1.33, or "system" if the default does not compile.
<pre>
./configure --with-boost=<VER> ...........
</pre>

You will likely receive some error messages during any of these stages, especially during the configure part. If they tell you that your system is missing some development libraries, install them. How this is done depends on your Linux distribution, but we will assist you in the [http://vegastrike.sourceforge.net/forums/viewforum.php?f=5 Compiling Problems forums]. You will be left with a file called "config.log" please attach that instead of copy-and-pasting thousands of lines of error messages. It's all in this file.

After you installed the missing libraries repeat the last (failed) step and continue.

'''Note:''' The configure script currently has a bug that can cause it to incorrectly report on the absence of GLUT. If you are sure you have installed glut-devel and are still seeing this error, check near the end of config.log to see if another library (such as libxmu or libxi) is the true culprit. [http://vegastrike.sourceforge.net/forums/viewtopic.php?t=7562]

===Make===
The final step for compiling is the make command. The Makefile should be able to compile most of the included utilities.

To compile mesher, for example, type:
<pre>make mesher</pre>
* Running
<pre>make all-am</pre>
reduces memory usage while compiling because there's only one instance of make instead of two. From [http://vegastrike.sourceforge.net/forums/viewtopic.php?t=9510 this forum thread].
* The step
<pre>
make install
</pre>
is optional as the program is quite happy running in userland.

If you receive error without any mention of missing library (or something like) after very long line about running g++, try to set proper permissions or simply force your way through it and see whether it's your problem (if you're superuser). It looks like that:
<pre>
collect2: ld returned 1 exit status
make[1]: *** [vegastrike] Error 1
make[1]: Leaving directory `/home/username/Games/VegaStrike/vegastrike'
make: *** [all] Error 2
~/Games/VegaStrike/vegastrike$ sudo make
</pre>

=See also=
* [http://vegastrike.sourceforge.net/forums/viewtopic.php?t=4185 "make clean/distclean" thread in the forum] - A quite helpful thread about the make process.
* [http://vegastrike.sourceforge.net/forums/viewtopic.php?f=2&t=10990 "Ubuntu problems" thread in the forum] - more about little troubles linuxoids can encounter.

----
{{NAV_Manual |
| previous=[[HowTo:Cygwin Compiling|Compiling with Cygwin]]
| up=[[HowTos]]
| next=[[HowTo:Compile_on_OSX|Compiling from SVN on Mac OSX]]
}}
[[Category:HowTos|Compile from CVS]]

Manual:Config:Advanced:Variables

2010-10-03T03:26:35Z

Greenfreedom10: /* Variables section */ add example

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
Each variable is set between the <code><variables></code> and the <code></variables></code> tags and inside its proper section tags, like this:

<pre>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</pre>

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>splash</code>" section==
{{FIXME}}

=="<code>graphics/general</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics/mesh</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

==="<code>hud</code>" subsection===
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>audio</code>" section==
{{FIXME}}

=="<code>unitaudio</code>" section==
{{FIXME}}

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.
{{FIXME}}

=="<code>keyboard</code>" section==
{{FIXME}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')
* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>general</code>" section==
{{FIXME}}

=="<code>AI</code>" section==
{{FIXME}}
==="<code>Targetting</code>" subsection===
{{FIXME}}
==="<code>Firing</code>" subsection===
{{FIXME}}

=="<code>cargo</code>" section==
{{FIXME}}

=="<code>physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>galaxy</code>" section==
{{FIXME}}

=="<code>player</code>" section==
{{FIXME}}

=="<code>server</code>" section==
{{FIXME}}

=="<code>network</code>" section==
{{FIXME}}

= See also =
For a complete list of variables visit [[CONFVAR]].

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Development:Realism vs Believability

2010-10-02T23:22:04Z

Greenfreedom10: /* Believability */ grammar

{{parent_link|parent=[[Development]]}}
----

There have been a number of discussions in the [http://vegastrike.sourceforge.net/forums forum] about the place of '''Realism''' in Vega Strike. This page has been added to summarize related topics and clear up some terms.

Much of the content of this article was inspired by a [http://vegastrike.sourceforge.net/forums/viewtopic.php?p=31090#31090 post] by [[User:Pincushionman|pincushionman]] (''thanks go to him'').

There are more topics in the forum about realism which have likely not been searched for. If you stumble over them please add them in the "See also" section for reference.

==The Developers' Perspectives==
The short version:
:Realism is not now, nor does it seem likely to ever be a primary goal of the Vega Strike project. Immersion is a primary goal. Immersion requires consistency, coherence, and from those, the ability to accept one's surroundings as a sufficiently believable universe. FACT: '''Reality is the most consistent, coherent and believable universe we know of''' (no matter what your friends in altered states may tell you). Reality, therefore, even if there is no goal to simulate it in accurate and robust detail, is a vital resource for two reasons: 1) anything that can be left as it is tends to not require additional effort to make it consistent with the rest of the universe, and 2) we already naturally expect many consequences of reality - via hardwiring and experience, we're driven to expect certain things to operate in particular fashions, it requires some fair amount of re-training to attain comfort with any other possible causal relations, and comfort is vital to immersiveness.

==General==
Many people have confused the concept of '''realism''' with that of '''believability''' (or credibility). They are '''not the same thing'''. Those people who keep saying "''I don't want realism because it isn't fun.''", while making a striking generalization of dubious accuracy, do, oddly enough, actually have an accurate idea which term means what.

==Realism==
Realism is bringing real-world concepts and processes into the world being created (in this case the game world, but it could also refer to a movie environment or a book). There is one big reason why realism is difficult to pull off, especially in games. We are immersed in reality all the time, and we know what is realistic, because we see it every day. You can tell a bad magician or a poorly-photoshopped image immediately because it just doesn't look right. In games it's even more difficult because we're still short on computing power needed to properly simulate a realistic environment. However, there is, of course, one enormous upsides to a realism based approach, if done well - the universe is guaranteed to be self-consistent.

==Believability==
Believability is much more ''forgiving'', and thus often allows for the construction of universes which are more fun to inhabit or visit. Concepts of realism can be incorporated into a believable environment, and often need to be, but only to the extent that they add to the immersion (most of us aren't up to spending too many hours in a shifting surrealist landscape - we're not biologically wired for it). Whenever reality intrudes on goals, plot, mechanism, or fancy, the particular stumbling blocks are ejected from the universe and new rules are written. This tends to make simulating a believable environment a much easier task, but at the expense of making the design of such an environment much more difficult to pull off properly - people tending to notice the places where new rules and reality have been stitched together, the gaps in the creator's reasoning, and other artifacts of the construction of the universe which have been insufficiently hidden or smoothed so as to not jar the observer.

===Examples===
If a person is shot in an action movie, the realistic result is he drops to the floor. But that's not fun to watch, so instead the bullet knocks them off into the water. To enhance the believability, that happens every time someone gets shot (consistency).

In space sims, we often need to get to a planet far away. Realism would say we need anywhere from decades to millenia, a fuel tank anywhere up to the size of the moon, and the cost could well bankrupt much of human civilization, but that's not any fun. So we make up a magic super-fast-and-efficient travel system, and use it all the time. And we make up fictional documentation to back up our absurd creation.

===Summary===
We still know it's not realistic, but we believe it anyway. Why? Because we want to, and, if the universe is well constructed, not only can we can believe it "exactly the same" every time (consistency) but the other causal consequences of this aberration will be ''plausible in context'' (coherence) - if one keeps having to add additional *magic* to explain a given necessary magical exception to reality, one might wish to reconsider the mechanics of the initial necessary magic. The real secret to making a believeable environment is to take advantage of just enough of what reality does give us to help our immersion, then make up stuff to keep people interested, and use that made-up stuff in a way that is consistent throughout the entire game experience, offer "believable" (again NOT realistic) explanations in case people DO question it, and use this made-up material in such a way that the people playing WANT TO BELEIVE IT.

It's called '''willing suspension of disbelief''', people. That's the secret. NOT realism (at least per se).

==End note==
There's another big strike against excessive realism and games -- real life is (most of the time) boring! People play games to get away from the dull regions of reality, not to become more immersed in them. Games must therefore have a "higher density" of non-dull than reality.

==See also==
* [http://vegastrike.sourceforge.net/forums/viewtopic.php?p=31090#31090 forum post] by [[User:Pincushionman|pincushionman]].

[[Category:Development|Realism vs Believability]]

Manual:Config:Advanced:Bindings:Joystick

2010-10-02T18:23:01Z

Greenfreedom10: /* See also */ spacing

{{Languages|En|Manual:Config:Advanced:Bindings:Joystick}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings:Mouse|Config:Advanced:Bindings:Mouse]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
----

==Joystick Configuration==

This page provides working examples of different joystick configurations, showing how each button has been bound to operate a single Vega Strike function.

If a Joystick Configuration matches your joystick, you can edit copy the configuration here into your vegastrike config file.

===JOYSTICK: bind===

====Sample====
<pre>
<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
</pre>

====Description====
* <code>joystick</code> - Number of the joystick.
* <code>player</code> - for which player is the command specified? (this is useful when you have more than one joystick that you wish to configure for the same user)
* <code>button</code> - Number of the button on the joystick.
* <code>modifier</code> - {{Fixme}} ''? no clue ?''
* <code>command</code> - Specify the command to start when the button is pressed here. See [[Manual:Keyboard layout|Keyboard layout]] for description and a list of commands.

===JOYSTICK: axis===

====Sample====
<pre>
<axis name="x" joystick="0" axis="0" inverse="false" />
</pre>

====Description====
* <code>name</code> - Name of the axis (in the game) to bind (<code>x,y,z,throttle</code>)
* <code>joystick</code> - Number of the joystick.
* <code>axis</code> - Number of axis of the joystick.
* <code>inverse</code> - Set this to <code>true</code> if you want to inverse the axis direction and to <code>false</code> if not.

===ANALOG COOLIHAT/HATSWITCH===
[http://vegastrike.sourceforge.net/forums/viewtopic.php?p=17017#17017 forum link 1]

====Sample====
<pre>
<axis name="hatswitch" nr="0" margin="0.15" joystick="1" axis="2">
<hatswitch value="-1.0"/>
<hatswitch value="-0.6"/>
<hatswitch value="-0.19"/>
<hatswitch value="0.1"/>
</axis>

<bind hatswitch="0" button="0" modifier="none" command="ABKey" />
<bind hatswitch="0" button="1" modifier="none" command="AccelKey" />
<bind hatswitch="0" button="2" modifier="none" command="DecelKey" />
<bind hatswitch="0" button="3" modifier="none" command="StopKey" />
</pre>

Once defined, analog hatswitches have their own number, and their "buttons" (positions) are defined independently of joysticks. When creating your <nowiki><bind></nowiki> tags, make sure you do not specify a joystick number (e.g. ''joystick="0"''); this will bind buttons on the joystick rather than positions on the hatswitch.

'' '''Note:''' Analog hatswitch support is not working as of the Vega Strike 0.4.3 release. This has been fixed in the CVS tree as of 2005-07-30. To add analog hatswitch support to Vega Strike 0.4.3, check out the "vegastrike_0_4_3" tag, then update the "in_sdl.cpp" file to CVS version 1.30.''

===DIGITAL COOLIHAT/HATSWITCH===
[http://vegastrike.sourceforge.net/forums/viewtopic.php?p=17017#17017 forum link]

====Sample====
<pre>
<bind joystick="0" digital-hatswitch="0" direction="up" command="ABKey"/>
</pre>

====Description====
* <code>joystick</code> - Number of the joystick.
* <code>digital-hatswitch</code> - Number of the digital hatswitch.
* <code>direction</code> - Direction (-button) of digital hatswitch.
**Possible values: "center", "up", "right", "left", "down", "rightup", "rightdown", "leftup", "leftdown"
* <code>command</code> - Specify the command to start when the button is pressed here. See [[Manual:Keyboard layout|Keyboard layout]] for description and a list of commands.

'' '''Note:''' Digital hatswitches will "chord". If you supply commands for "left", "up", and "leftup", moving the hatswitch to the upper left will activate all three commands.''

'' '''Note (2):''' Digital hatswitch support is disabled by default in the CVS tree. To enable it, edit your vegastrike.config and set "debug_digital_hatswitch" to "true". Be warned that this will send lots of debugging text to the console. Also, you cannot currently bind commands to "center". Both bugs have been submitted with a patch and may be resolved soon.''

===DIGITAL AXES/D-PAD AS HATSWITCH===
This can allow one to use a (usually digital) axis such as a D-Pad as button commands, such as camera keys, etc.

====Sample====
<pre>
<axis name="hatswitch" nr="0" margin="0.26" joystick="0" axis="2">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>
<axis name="hatswitch" nr="1" margin="0.26" joystick="0" axis="3">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>

<bind hatswitch="0" button="0" command="Cockpit::YawLeft" />
<bind hatswitch="0" button="1" command="Cockpit::YawRight" />
<bind hatswitch="1" button="0" command="Cockpit::PitchDown" />
<bind hatswitch="1" button="1" command="Cockpit::PitchUp" />
</pre>

====Description====
In <axis> tags:
* <code>axis</code> - Number of the joystick axes for up/down and left/right.
* <code>margin</code> - basically, you want this to include 1.0 and -1.0, but not 0.0 when adding hatswitch-value +/- margin
* <code>joystick</code> - 0=down/left, 1=up/right
In <bind> tags:
* <code>hatswitch</code> and <code>nr</code> - Number of the two defined "hatswitches".
* <code>button</code> - 0=down/left, 1=up/right
* <code>command</code> - Specify the command to start when the button is pressed here. See [[Manual:Keyboard layout|Keyboard layout]] for description and a list of commands.

==Joystick Examples==
'''Please insert your working configs here.'''

=== Microsoft SideWinder Force Feedback Pro ===
(may work for other sidewinder-joysticks as well)

==== Add the joystick-name to the dropdown menu ====
add <code>joy_ffp</code>
to the line
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev
</pre>
like this
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev joy_ffp
</pre>

==== Add the description text ====
<pre>
#desc joy_ffp Microsoft SideWinder Force Feedback Pro
</pre>

==== Make the joystick the current one ====
edit the <code>#set Joystick xxxx</code> line to
<pre>
#set Joystick joy_ffp
</pre>

==== Binding code ====
Place the code below above the <code></bindings></code> line in the <code>vegastrike.config</code> file.

{{Fixme}} ''Attention: This bindings may not work under linux ... at least it doesn't for me since i switched. Help is always welcome.''
<pre>



<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" /> 
<bind joystick="0" button="1" modifier="none" command="MissileKey" /> 
<bind joystick="0" button="2" modifier="none" command="TargetKey" /> 
<bind joystick="0" button="3" modifier="none" command="PickTargetKey" /> 
<bind joystick="0" button="4" modifier="none" command="ABKey" /> 
<bind joystick="0" button="5" modifier="none" command="MisSelKey" /> 
<bind joystick="0" button="6" modifier="none" command="WeapSelKey" /> 
<bind joystick="0" button="7" modifier="none" command="AccelKey" /> 
<bind joystick="0" button="8" modifier="none" command="SheltonKey" /> 
<bind joystick="0" button="9" modifier="none" command="DecelKey" /> 



<axis name="x" joystick="0" axis="0" inverse="false" /> 
<axis name="y" joystick="0" axis="1" inverse="false" /> 
<axis name="z" joystick="0" axis="3" inverse="true" /> 
 

<axis name="hatswitch" nr="0" margin="0.25" joystick="0" axis="2" inverse="false"> 
<hatswitch value="-1.0"/>
<hatswitch value="-0.5"/>
<hatswitch value="0.5"/>
<hatswitch value="1.0"/>
</axis>



<bind hatswitch="0" button="0" modifier="none" command="ABKey" />
<bind hatswitch="0" button="1" modifier="none" command="AccelKey" />
<bind hatswitch="0" button="2" modifier="none" command="DecelKey" />
<bind hatswitch="0" button="3" modifier="none" command="StopKey" />



<bind joystick="0" digital-hatswitch="0" direction="up" command="Cockpit::Inside"/>
<bind joystick="0" digital-hatswitch="0" direction="left" command="Cockpit::InsideLeft"/>
<bind joystick="0" digital-hatswitch="0" direction="center" command="Cockpit::Inside"/>
<bind joystick="0" digital-hatswitch="0" direction="right" command="Cockpit::InsideRight"/>
<bind joystick="0" digital-hatswitch="0" direction="down" command="Cockpit::InsideBack"/>



</pre>

=== Microsoft SideWinder Force Feedback 2 (USB) ===

==== Linux 2.4 ====
:''(tested kernels: 2.4.27)''

This model shows up in Linux as having 11 axes and 20 buttons, but only nine buttons and six axes are used, two of which are for the pseudo-analog hatstick (which is really effectively digital).

The hatswitch configuration is special here. The configuration below uses a "return to center" system, where releasing the hatswitch returns to standard cockpit view. Hence, the obvious way would be to define a centered axis (0) as returning to Cockpit::Inside. But when this was defined for ''both'' axes, it didn't work; pressing left or right would only flicker in that direction, instantly returning to center even if the hatswitch was held. This is because ''horizontal'' movement of the hatswitch (away from center) somehow also triggers ''vertical'' movement events, even if the vertical axis has not changed. The vertical centering was cancelling out the left-right movement.

By defining the return-to-center behaviour '''only''' on the horizontal movement, everything works perfectly: Horizontal movement is unimpeded by vertical movement events, and returning the vertical axis to center somehow also triggers a centered horizontal event, returning the view to the inside. The cause of this inconsistency is unknown, but the effect is exactly as desired.

Once the myriad axes are out of the way, the buttons are exceedingly simple; the first eight buttons (0 through 7) map directly to the stick buttons. Button #11 is a special virtual button that is "pressed" when the hand leaves the stick (via an optical sensor). Docking at a space station is the most logical use for this "button", since that's when the user will want to let go of the joystick anyway; aside from saving a keypress, it's also good for amazing any onlookers with the user's "magic" joystick.

<pre>


<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="2" modifier="none" command="TargetKey" />
<bind joystick="0" button="3" modifier="none" command="PickTargetKey" />
<bind joystick="0" button="4" modifier="none" command="MisSelKey" />
<bind joystick="0" button="5" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="6" modifier="none" command="SheltonKey" />
<bind joystick="0" button="7" modifier="none" command="ABKey" />

<bind joystick="0" button="11" modifier="none" command="DockKey" />


<axis joystick="0" axis="0" name="x" inverse="false" />
<axis joystick="0" axis="1" name="y" inverse="false" />
<axis joystick="0" axis="4" name="z" inverse="true" />
<axis joystick="0" axis="5" name="throttle" inverse="false" />


<axis joystick="0" axis="6" name="hatswitch" nr="0" margin="0.5" inverse="false">
<hatswitch value="-1.0"/>
<hatswitch value="1.0"/>
<hatswitch value="0"/>
</axis>
<bind hatswitch="0" button="0" modifier="none" command="Cockpit::InsideLeft" />
<bind hatswitch="0" button="1" modifier="none" command="Cockpit::InsideRight"/>
<bind hatswitch="0" button="2" modifier="none" command="Cockpit::Inside" />


<axis joystick="0" axis="7" name="hatswitch" nr="1" margin="0.5" inverse="false">
<hatswitch value="-1.0"/>
<hatswitch value="1.0"/>
</axis>
<bind hatswitch="1" button="0" modifier="none" command="Cockpit::Behind" />
<bind hatswitch="1" button="1" modifier="none" command="Cockpit::InsideBack" />

</pre>

==== Linux 2.6 ====
:''(tested kernels: 2.6.10, 2.6.11, 2.6.12)''

Things become much simpler in Linux 2.6. The hatswitch is actually recognised as a digital hatswitch, and the virtual "hand off joystick" button becomes button 8, right after the eight physical buttons. On the other hand, the throttle and twist axes numbers actually move to ''higher'' numbers. Still, things get simpler overall.

The stick's reported properties vary greatly between kernel versions:
* '''2.6.10:''' 18 axes, 15 buttons, 1 hat
* '''2.6.12:''' 12 axes, 9 buttons, 1 hat
Apparently, the device code is still being worked on, but it seems the detection is getting closer and closer to the truth.

Below is the exact same configuration as above, but adapted for the 2.6 series of kernels:

<pre>

<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="2" modifier="none" command="TargetKey" />
<bind joystick="0" button="3" modifier="none" command="PickTargetKey" />
<bind joystick="0" button="4" modifier="none" command="MisSelKey" />
<bind joystick="0" button="5" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="6" modifier="none" command="SheltonKey" />
<bind joystick="0" button="7" modifier="none" command="ABKey" />
<bind joystick="0" button="8" modifier="none" command="DockKey" />

<axis joystick="0" axis="0" name="x" inverse="false" />
<axis joystick="0" axis="1" name="y" inverse="false" />
<axis joystick="0" axis="5" name="z" inverse="true" />
<axis joystick="0" axis="6" name="throttle" inverse="false" />

<bind joystick="0" digital-hatswitch="0" direction="up" command="Cockpit::Behind"/>
<bind joystick="0" digital-hatswitch="0" direction="down" command="Cockpit::InsideBack"/>
<bind joystick="0" digital-hatswitch="0" direction="left" command="Cockpit::InsideLeft"/>
<bind joystick="0" digital-hatswitch="0" direction="right" command="Cockpit::InsideRight"/>
<bind joystick="0" digital-hatswitch="0" direction="center" command="Cockpit::Inside"/>

</pre>

=== Microsoft SideWinder Precision 2 (USB) ===
Tested under Windows XP Home. Digital coolihat/hatswitch left un-assigned.

==== Add the joystick-name to the dropdown menu ====
add <code>joy_msswp2</code>
like this
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev joy_msswp2
</pre>

==== Add the description text ====
<pre>
#desc joy_msswp2 Microsoft SideWinder Precision 2
</pre>

==== Make the joystick the current one ====
<pre>
#set Joystick joy_msswp2
</pre>

==== Binding code ====
Place the code below above the <code></bindings></code> line in the <code>vegastrike.config</code> file.

<pre>



<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="2" modifier="none" command="PickTargetKey" />
<bind joystick="0" button="3" modifier="none" command="LockTargetKey" />
<bind joystick="0" button="4" modifier="none" command="TargetKey" />
<bind joystick="0" button="5" modifier="none" command="MisSelKey" />
<bind joystick="0" button="6" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="7" modifier="none" command="SheltonKey" />



<axis name="x" joystick="0" axis="0" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="false" />
<axis name="z" joystick="0" axis="3" inverse="true" />
<axis name="throttle" joystick="0" axis="2"/>




</pre>

=== USB Saitek Cyborg 3D ===
4-axis/8-buttons/1-hatswitch stick + CH pedals on a gameport

http://vegastrike.sourceforge.net/forums/viewtopic.php?p=12580#12580
forum link

<pre>



<bind joystick="1" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="1" button="1" modifier="none" command="ABKey" />
<bind joystick="1" button="2" modifier="none" command="StopKey" />
<bind joystick="1" button="3" modifier="none" command="TargetKey" />
<bind joystick="1" button="4" modifier="none" command="PickTargetKey" />
<bind joystick="1" button="5" modifier="none" command="DecelKey" />
<bind joystick="1" button="6" modifier="none" command="SheltonKey" />
<bind joystick="1" button="7" modifier="none" command="AccelKey" />
<bind joystick="1" button="8" modifier="none" command="Cockpit::NavScreen" />
<bind joystick="1" button="9" modifier="none" command="MisSelKey" />
<bind joystick="1" button="10" modifier="none" command="Cockpit::Inside" />
<bind joystick="1" button="11" modifier="none" command="Cockpit::InsideLeft" />
<bind joystick="1" button="12" modifier="none" command="Cockpit::InsideRight" />
<bind joystick="1" button="13" modifier="none" command="Cockpit::InsideBack" />



<axis name="x" joystick="1" axis="0" inverse="false" />
<axis name="y" joystick="1" axis="1" inverse="false" />






<axis name="z" joystick="0" axis="3" inverse="true"/>



</pre>

=== USB Saitek Cyborg 3DII ===
This config has only been tested on Linux, but it is likely to work elsewhere.

From: http://vegastrike.sourceforge.net/forums/viewtopic.php?t=8620 (GordonShomway)

I have an old Saitek Cyborg 3DII USB. When I configured the Joystick as "2 axis and throttle" or "3 axis (and throttle)", the throttle was on the z-axis and the twist on the leaver for the throttle.

In order to fix this I had to change the number of the axis' as follows:

throttle from 2 to 3.

Here is the configuration for "3 axis and throttle"
<axis name="x" joystick="0" axis="0" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="false" />
<axis name="z" joystick="0" axis="2" inverse="false" />
<axis name="throttle" joystick="0" axis="3" inverse="false" />

=== USB Saitek AV8R-01 ===
4 axis/12 button/8-digital hatswitch/2 rotary control/dual throttle.

This is the configuration for pitch/roll on primary axes, yaw on "twist" control, and main throttle on left.
<pre>
<axis name="x" joystick="0" axis="3" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="false" />
<axis name="z" joystick="0" axis="0" inverse="true" />
<axis name="throttle" joystick="0" axis="2" />
</pre>

These are some good button controls
<pre>
<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="2" modifier="none" command="NearestDangerousHostileKey" />
<bind joystick="0" button="3" modifier="none" command="ABKey" />

<bind joystick="0" button="4" modifier="none" command="ThrustUp" />
<bind joystick="0" button="5" modifier="none" command="ThrustDown" />

<bind joystick="0" button="6" modifier="none" command="MissionTargetKey" />
<bind joystick="0" button="7" modifier="none" command="ThrustLeft" />

<bind joystick="0" button="8" modifier="none" command="SigTargetKey" />
<bind joystick="0" button="9" modifier="none" command="ThrustRight" />

<bind joystick="0" button="10" modifier="none" command="Cockpit::SwitchLVDU" />
<bind joystick="0" button="11" modifier="none" command="Cockpit::SwitchRVDU" />

<bind joystick="0" button="12" modifier="none" command="StopKey" />
<bind joystick="0" button="13" modifier="none" command="" />
</pre>

The following is a "sticky" hat control

<pre>
<bind joystick="0" digital-hatswitch="0" direction="up" command="Cockpit::Inside"/>
<bind joystick="0" digital-hatswitch="0" direction="left" command="Cockpit::InsideLeft"/>
<bind joystick="0" digital-hatswitch="0" direction="right" command="Cockpit::InsideRight"/>
<bind joystick="0" digital-hatswitch="0" direction="down" command="Cockpit::InsideBack"/>
</pre>

Add this to make the hat control return to norma view after it is released

<pre>
<bind joystick="0" digital-hatswitch="0" direction="center" command="Cockpit::NavScreen"/>
</pre>

=== USB Saitek X45 ===
4-axis/7-button/4-hatswitch/2 rotary control, 2 mode switch (M1,M2,M3 and AUX0-1) stick/flight control system.

3 of the 4 hatswitches could be called like buttons. So I configured them for Cockpit Display and Weapon Selection.
Until now the 2 rotary controls are unused.
The mode switches are configured for SPEC/cloak.

<pre>



<bind joystick="0" player="0" button="0" modifier="none" command="FireKey" />
<bind joystick="0" button="3" modifier="none" command="MissileKey" />
<bind joystick="0" button="4" modifier="none" command="ABKey" />
<bind joystick="0" button="5" modifier="none" command="Cockpit::SwitchRVDU" />
<bind joystick="0" button="1" modifier="none" command="UnitTargetKey" />
<bind joystick="0" button="2" modifier="none" command="SigTargetKey" />
<bind joystick="0" button="7" modifier="none" command="NearestTargetKey" />




<bind joystick="0" button="8" modifier="none" command="CloakKey" />
<bind joystick="0" button="9" modifier="none" command="CloakKey" />
<bind joystick="0" button="10" modifier="none" command="CloakKey" />

<bind joystick="0" button="11" modifier="none" command="ToggleWarpDrive" />
<bind joystick="0" button="12" modifier="none" command="ToggleWarpDrive" />
<bind joystick="0" button="13" modifier="none" command="ToggleWarpDrive" />


<bind joystick="0" button="14" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="15" modifier="none" command="MisSelKey" />
<bind joystick="0" button="16" modifier="none" command="ReverseWeapSelKey" />
<bind joystick="0" button="17" modifier="none" command="ReverseMisSelKey" />


<bind joystick="0" button="18" modifier="none" command="Cockpit::PitchDown" />
<bind joystick="0" button="19" modifier="none" command="Cockpit::YawLeft" />
<bind joystick="0" button="20" modifier="none" command="Cockpit::PitchUp" />
<bind joystick="0" button="21" modifier="none" command="Cockpit::YawRight" />


<bind joystick="0" button="22" modifier="none" command="Cockpit::InsideLeft" />
<bind joystick="0" button="23" modifier="none" command="Cockpit::Inside" />
<bind joystick="0" button="24" modifier="none" command="Cockpit::InsideRight" />
<bind joystick="0" button="25" modifier="none" command="Cockpit::InsideBack" />



<axis name="x" joystick="0" axis="0" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="false" />
<axis name="throttle" joystick="0" axis="4"/>
<axis name="z" joystick="0" axis="3"/>



</pre>

=== Logitech Dual Analog Gamepad ===

==== Add the joystick-name to the dropdown menu ====
add <code>joy_log_dual_gp</code>
to the line
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev
</pre>
like this
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev joy_log_dual_gp
</pre>

==== Add the description text ====
<pre>
#desc joy_log_dual_gp Logitech Dual Analog Gamepad
</pre>

==== Make the joystick the current one ====
edit the <code>#set Joystick xxxx</code> line to
<pre>
#set Joystick joy_log_dual_gp
</pre>

==== Binding code ====
Place the code below above the <code></bindings></code> line in the <code>vegastrike.config</code> file.
<pre>

<axis name="x" joystick="0" axis="0" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="true" />
<axis name="z" joystick="0" axis="2" inverse="true"/>



<axis name="hatswitch" nr="0" margin="0.26" joystick="0" axis="4">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>
<axis name="hatswitch" nr="1" margin="0.26" joystick="0" axis="5">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>

<bind hatswitch="0" button="0" command="ThrustLeft" />
<bind hatswitch="0" button="1" command="ThrustRight" />
<bind hatswitch="1" button="1" command="ThrustDown" />
<bind hatswitch="1" button="0" command="ThrustUp" />



<bind joystick="0" button="0" modifier="none" command="ABKey" />
<bind joystick="0" button="1" modifier="none" command="DecelKey" />
<bind joystick="0" button="2" modifier="none" command="DockKey" />
<bind joystick="0" button="3" modifier="none" command="AccelKey" />
<bind joystick="0" button="4" modifier="none" command="TargetKey" />
<bind joystick="0" button="5" player="0" modifier="none" command="FireKey" />
<bind joystick="0" button="6" modifier="none" command="PickTargetKey" />
<bind joystick="0" button="7" modifier="none" command="MissileKey" />
<bind joystick="0" button="8" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="9" modifier="none" command="AutoKey" />

</pre>

=== Playstation 2 controller (using a USB adaptor commonly available) ===

==== Add the joystick-name to the dropdown menu ====
add <code>joy_ps2</code>
to the line
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev
</pre>
like this
<pre>
#cat Joystick no_joy joy_normal joy_throttle joy_axis joy_throttle_and_axis joy_t_a_rev joy_ps2
</pre>

==== Add the description text ====
<pre>
#desc joy_ps2 Playstation 2 Joypad
</pre>

==== Make the joystick the current one ====
edit the <code>#set Joystick xxxx</code> line to
<pre>
#set Joystick joy_ps2
</pre>

==== Binding code ====
Place the code below above the <code></bindings></code> line in the <code>vegastrike.config</code> file.
<pre>

<axis name="x" joystick="0" axis="0" inverse="false" />
<axis name="y" joystick="0" axis="1" inverse="false" />
<axis name="z" joystick="0" axis="2" inverse="true" />

<axis name="hatswitch" nr="0" margin="0.26" joystick="0" axis="4">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>
<axis name="hatswitch" nr="1" margin="0.26" joystick="0" axis="5">
<hatswitch value="-0.75"/>
<hatswitch value="0.75"/>
</axis>

<bind hatswitch="0" button="0" command="ReverseTargetKey" />
<bind hatswitch="0" button="1" command="TargetKey" />
<bind hatswitch="1" button="1" command="DecelKey" />
<bind hatswitch="1" button="0" command="AccelKey" />

<bind joystick="0" button="0" modifier="none" command="JumpKey" />
<bind joystick="0" button="1" modifier="none" command="ToggleWarpDrive" />
<bind joystick="0" button="2" modifier="none" command="ABKey" />
<bind joystick="0" button="3" modifier="none" command="SwitchCombatMode" />
<bind joystick="0" button="4" modifier="none" command="MissileKey" />
<bind joystick="0" button="5" player="0" modifier="none" command="FireKey" />
<bind joystick="0" button="6" modifier="none" command="MisSelKey" />
<bind joystick="0" button="7" modifier="none" command="WeapSelKey" />
<bind joystick="0" button="8" modifier="none" command="PauseKey" />
<bind joystick="0" button="9" modifier="none" command="MissionTargetKey" />
<bind joystick="0" button="10" modifier="none" command="Cockpit::SwitchLVDU" />
<bind joystick="0" button="11" modifier="none" command="Cockpit::SwitchRVDU" />

</pre>

This maps the -

Left analogue stick to the attitude controls (Nose - up, down, left, right)

Right analogue stick to roll left and right (I didn't find a useful function for the analogue up / down on this stick so left it out)

R1 shoulder button = Cycle weapon select

R2 shoulder button = Fire selected weapons

L1 shoulder button = Missile select

L2 shoulder button = Fire selected missile

Triangle = Jump drive (if equipped)

Square = Switch combat mode (between combat speed and unlimited speed)

X = Afterburner

O = Toggle SPEC drive / Autopilot

Dpad (if the analogue light on your pad is off (digital mode) has the same function as the left analogue stick, otherwise -)

Up = Accelerate

Down = Decelerate

L & R = Cycle all in system targets

Select = Cycle mission target

Start = Pause

Clicking down on the joysticks

L3 (left joystick) = Cycle left HUD display

R3 (right joystick)= Cycle right HUD display

== Joystick probing ==

If you can't seem to properly bind your various joystick axes, buttons, and hatswitches, your joystick may be reporting its various functions in unexpected ways. Probing your joystick allows you to test each part of the joystick and see what events it sends to your computer.

=== Linux ===

To probe a joystick in Linux, you need the "jstest" utility. (In Debian, this is part of the "joystick" package.) Locate your joystick device (typically /dev/js0) and run "jstest" on it while not touching the joystick. You'll see a series of axis positions and button states.

Once "jstest" is running, grab the joystick and fiddle with whatever function you were unable to bind. Watch the readout and determine what axis or button your actions are triggering. With this knowledge, you should be able to use one of the recipes above (or an existing entry in the ''vegastrike.config'' file) to fully map your joystick.

Normally, "jstest" will show all information on a single line and keep updating that line in-place, without scrolling downwards. If it outputs multiple lines instead of updating the same line, you have a lot of axes and buttons (or a very narrow terminal window). Some USB joysticks may even output a couple of screens worth of lines without you even touching the joystick. Ignore everything until it stops scrolling — it's just the joystick "booting up". After that, you can grab the joystick and test as normal.

'''NOTE: If your joystick is at /dev/input/js0, you may need to create a symbolic link as follows:
'''ln -s /dev/input/js0 /dev/js0'''

==See also==
* Current [http://vegastrike.svn.sourceforge.net/svnroot/vegastrike/trunk/data/vegastrike.config vegastrike.config] in SVN.

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings:Mouse|Config:Advanced:Bindings:Mouse]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
[[Category:Manual|Config:Advanced:Bindings:Joystick]]

Manual:Config:Advanced:Bindings:Joystick

2010-10-02T18:21:00Z

Greenfreedom10: /* Joystick Examples */ match other config formatting

Manual:Config:Advanced:Bindings:Mouse

2010-10-02T18:19:43Z

Greenfreedom10: cleanup

{{Languages|En|Manual:Config:Advanced:Bindings:Mouse}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings:Keyboard|Config:Advanced:Bindings:Keyboard]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Bindings:Joystick|Config:Advanced:Bindings:Joystick]]
}}
----

==Mouse Configuration==

This page provides working examples of different mouse configurations, showing how each button has been bound to operate a single Vega Strike function.

If a Mouse Configuration matches your mouse, you can edit copy the configuration here into your vegastrike config file.

===MOUSE: bind===
====Sample====

<pre>
<bind mouse="0" button="2" modifier="none" command="ABKey" />
</pre>

==== Description ====
* <code>mouse</code> - Number of the mouse.
* <code>button</code> - Number of the mousebutton.
* <code>modifier</code> - Key, to be pressed at the same time (currently: alt or ctrl)
* <code>command</code> - Specify the command to start when the button is pressed here. See [[Manual:Keyboard layout|Keyboard layout]] for descriptions and a list of commands.

===MOUSE: axis===
====Sample====
<pre>
<axis name="x" mouse="0" axis="0" inverse="false" />
</pre>
====Description====
* <code>name</code> - Name of axis (in the game) to bind (<code>x,y,z</code>) ?throttle?
* <code>mouse</code> - Number of the mouse.
* <code>axis</code> - Number of the axis of the mouse.
* <code>inverse</code> - Set this to <code>true</code> if you want to inverse the axis direction else set it to <code>false</code>.

==Mouse Examples==
'''Please insert your working configs here.'''

===<insert mouse config here>===
<pre>



</pre>

==See also==

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings:Keyboard|Config:Advanced:Bindings:Keyboard]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Bindings:Joystick|Config:Advanced:Bindings:Joystick]]
}}
[[Category:Manual|Config:Advanced:Bindings:Mouse]]

Manual:Config:Advanced:Bindings:Keyboard

2010-10-02T18:17:26Z

Greenfreedom10: cleanup

{{Languages|En|Manual:Config:Advanced:Bindings:Keyboard}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Bindings:Mouse|Config:Advanced:Bindings:Mouse]]
}}
----
== Keyboard Configuration ==

This page provides working examples of different keyboard layouts, showing how each key (differentiating between lower and upper case) has been bound to operate a single Vega Strike function.

If a Keyboard Configuration matches your keyboard, you can edit copy the configuration here into your vegastrike config file.

=== KEYBOARD: bind ===

==== Sample ====
<pre>
<bind key="S" modifier="none" command="Cockpit::SkipMusicTrack" />
</pre>

==== Description ====

* <code>key</code> - Specify the key here ({{Fixme}} ''this is now a bit of a hassle for non-english keyboards'')
** lowercase letters/characters = without {{Key:EN:Shift left}}
** uppercase letters/characters = with {{Key:EN:Shift left}}
* <code>modifier</code> - Use a modifier key (case-sensitive)
** <code>none</code> - Don't use a modifier ({{Fixme}} same as without this tag?).
** <code>alt</code> - Require the {{Key:EN:Alt}} key.
** <code>ctrl</code> - Require the {{Key:EN:Ctrl}} key.
** <code>shift</code> - Require the {{Key:EN:Shift left}} key. Usually you cannot write symbols like uppercase space or keypad symbols in config.
* <code>command</code> - Specify the command to start when the button is pressed here.
** See [[Manual:Keyboard layout|Keyboard Layout]] for descriptions and a list of commands.

== Keyboard Examples ==
'''Please insert working keyboard configs here.'''

=== Old Style Mac keyboard ===
(the little one without a 'del' key among others)
<pre>
<bind key="S" modifier="none" command="Cockpit::SkipMusicTrack" />
<bind key="F" modifier="none" command="CommFormUp" />
<bind key="B" modifier="none" command="CommBreakForm" />
<bind key="H" modifier="none" command="CommHelpMeOut" />
<bind key="D" modifier="none" command="CommAttackTarget" />
<bind key="1" modifier="none" command="Comm1Key" />
<bind key="2" modifier="none" command="Comm2Key" />
<bind key="3" modifier="none" command="Comm3Key" />
<bind key="4" modifier="none" command="Comm4Key" />
<bind key="5" modifier="none" command="Comm5Key" />
<bind key="6" modifier="none" command="Comm6Key" />
<bind key="7" modifier="none" command="Comm7Key" />
<bind key="8" modifier="none" command="Comm8Key" />
<bind key="9" modifier="none" command="Comm9Key" />
<bind key="space" modifier="none" command="FireKey" />
<bind key="y" modifier="none" command="SwitchCombatMode" />
<bind key="j" modifier="none" command="JumpKey" />
<bind key="J" modifier="none" command="JoyStickToggleKey" />
<bind key="A" modifier="none" command="AutoKey" />
<bind key="a" modifier="none" command="AutoKey" />
<bind key="c" modifier="none" command="CloakKey" />
<bind key="E" modifier="none" command="EjectKey" />
<bind key="e" modifier="none" command="ECMKey" />
<bind key="Z" modifier="none" command="EjectCargoKey" />
<bind key="return" modifier="none" command="MissileKey" />
<bind key="keypad-enter" modifier="none" command="MissileKey" />
<bind key="g" modifier="none" command="WeapSelKey"/>
<bind key=";" modifier="none" command="Respawn"/>
<bind key="[" modifier="none" command="SwitchControl"/>
<bind key="]" modifier="none" command="TurretControl"/>
<bind key="d" modifier="none" command="DockKey"/>

<bind key="0" modifier="none" command="RequestClearenceKey"/>
<bind key="m" modifier="none" command="MisSelKey"/>
<bind key="t" modifier="none" command="TargetKey" />
<bind key="n" modifier="none" command="SigTargetKey" />
<bind key="b" modifier="none" command="SubUnitTargetKey"/>
<bind key="u" modifier="none" command="UnitTargetKey" />
<bind key="l" modifier="none" command="LockTargetKey" />
<bind key="p" modifier="none" command="PickTargetKey" />
<bind key="h" modifier="none" command="NearestTargetKey" />
<bind key="T" modifier="none" command="ReverseTargetKey" />
<bind key="P" modifier="none" command="TurretTargetKey" />
<bind key="o" modifier="none" command="TurretAIKey" />
<bind key="H" modifier="none" command="ReverseNearestTargetKey" />
<bind key="N" modifier="none" command="ReverseSigTargetKey" />
<bind key="U" modifier="none" command="ReverseUnitTargetKey" />
<bind key="`" modifier="none" command="SheltonKey" />
<bind key="-" modifier="none" command="DecelKey"/>
<bind key="+" modifier="none" command="AccelKey" />
<bind key="keypad-minus" modifier="none" command="DecelKey"/>
<bind key="keypad-plus" modifier="none" command="AccelKey" />
<bind key="=" modifier="none" command="AccelKey"/>
<bind key="/" modifier="none" command="RollLeftKey"/>
<bind key="*" modifier="none" command="RollRightKey"/>
<bind key="keypad-divide" modifier="none" command="RollLeftKey"/>
<bind key="keypad-multiply" modifier="none" command="RollRightKey"/>

<bind key="'" modifier="none" command="StopKey"/>
<bind key="\" modifier="none" command="StartKey"/>
<bind key="tab" modifier="none" command="ABKey" />
<bind key="!" modifier="none" command="SuicideKey"/>
<bind key="cursor-up" modifier="none" command="UpKey"/>
<bind key="cursor-down" modifier="none" command="DownKey"/>
<bind key="cursor-left" modifier="none" command="RightKey"/>
<bind key="cursor-right" modifier="none" command="LeftKey"/>
<bind key="cursor-insert" modifier="none" command="RollLeftKey"/>

<bind key="keypad-8" modifier="none" command="UpKey"/>
<bind key="keypad-2" modifier="none" command="DownKey"/>
<bind key="keypad-5" modifier="none" command="DownKey"/>
<bind key="keypad-4" modifier="none" command="RightKey"/>
<bind key="keypad-6" modifier="none" command="LeftKey"/>
<bind key="M" modifier="none" command="Cockpit::MapKey"/>
<bind key="function-1" modifier="none" command="Cockpit::Inside"/>
<bind key="function-2" modifier="none" command="Cockpit::InsideLeft"/>
<bind key="function-3" modifier="none" command="Cockpit::InsideRight"/>
<bind key="function-4" modifier="none" command="Cockpit::InsideBack"/>
<bind key="." command="VolumeInc"/>
<bind key="," command="VolumeDec"/>
<bind key="greater-than" command="MusicVolumeInc"/>
<bind key="less-than" command="MusicVolumeDec"/>
<bind key="function-5" modifier="none" command="Cockpit::Behind"/>
<bind key="function-6" modifier="none" command="Cockpit::Pan"/>
<bind key="function-9" modifier="none" command="TimeInc"/>
<bind key="|" modifier="none" command="PauseKey"/>
<bind key="pause" modifier="none" command="PauseKey"/>
<bind key="function-10" modifier="none" command="TimeReset"/>
<bind key="function-7" modifier="none" command="Cockpit::OutsideTarget"/>
<bind key="function-8" modifier="none" command="Cockpit::PanTarget"/>
<bind key="function-11" modifier="none" command="Cockpit::ZoomIn"/>
<bind key="function-12" modifier="none" command="Cockpit::ZoomOut"/>
<bind key="w" modifier="none" command="Cockpit::SwitchLVDU"/>
<bind key="v" modifier="none" command="Cockpit::SwitchRVDU"/>
<bind key="q" modifier="none" command="Cockpit::PitchDown"/>
<bind key="z" modifier="none" command="Cockpit::PitchUp"/>
<bind key="s" modifier="none" command="Cockpit::YawLeft"/>
<bind key="f" modifier="none" command="Cockpit::YawRight"/>
<bind key="cursor-pagedown" modifier="none" command="Cockpit::ScrollDown"/>
<bind key="cursor-pageup" modifier="none" command="Cockpit::ScrollUp"/>
<bind key="keypad-3" modifier="none" command="Cockpit::ScrollDown"/>
<bind key="keypad-9" modifier="none" command="Cockpit::ScrollUp"/>
<bind key="cursor-home" modifier="none" command="SetVelocityRefKey"/>

<bind key="cursor-delete" modifier="none" command="SetVelocityNullKey"/>
<bind key="keypad-7" modifier="none" command="SetVelocityRefKey"/>
<bind key="keypad-1" modifier="none" command="SetVelocityNullKey"/>
<bind key="esc" modifier="none" command="Cockpit::Quit"/>
</pre>

=== Keypad Thrusters ===
(helps a lot on ships with decent orthogonal acceleration - mostly fighters)
<pre>
<bind key="keypad-8" modifier="none" command="ThrustUp"/>
<bind key="keypad-2" modifier="none" command="ThrustDown"/>
<bind key="keypad-4" modifier="none" command="ThrustLeft"/>
<bind key="keypad-6" modifier="none" command="ThrustRight"/>
<bind key="keypad-5" modifier="none" command="StopKey"/> 
<bind key="keypad-9" modifier="none" command="ThrustFront"/>
<bind key="keypad-3" modifier="none" command="ThrustBack"/>
<bind key="keypad-7" modifier="none" command="SetVelocityRefKey" />
<bind key="keypad-1" modifier="none" command="SetVelocityNullKey" />
<bind key="keypad-0" modifier="none" command="Flight::Mode::InertialToggle" />
<bind key="keypad-period" modifier="none" command="SwitchCombatMode" />
</pre>

=== Keypad View Switch ===
(more geometrically obvious binding for those who have no proper HAT switch)
<pre>
<bind key="keypad-8" modifier="shift" command="Cockpit::Inside"/>
<bind key="keypad-2" modifier="shift" command="Cockpit::InsideBack"/>
<bind key="keypad-4" modifier="shift" command="Cockpit::InsideLeft"/>
<bind key="keypad-6" modifier="shift" command="Cockpit::InsideRight"/>
<bind key="keypad-5" modifier="shift" command="Cockpit::ViewTarget"/>
<bind key="keypad-9" modifier="shift" command="Cockpit::Pan"/>
<bind key="keypad-3" modifier="shift" command="Cockpit::Behind"/>
<bind key="keypad-7" modifier="shift" command="Cockpit::PanTarget"/>
<bind key="keypad-1" modifier="shift" command="Cockpit::OutsideTarget"/>
<bind key="keypad-0" modifier="shift" command="Cockpit::ZoomOut"/>
<bind key="keypad-period" modifier="shift" command="Cockpit::ZoomIn"/>
</pre>

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| next=[[Manual:Config:Advanced:Bindings:Mouse|Config:Advanced:Bindings:Mouse]]
}}
[[Category:Manual|Config:Advanced:Bindings:Keyboard]]

Manual:Config:Advanced

2010-10-02T18:08:07Z

Greenfreedom10: /* Configuration file structure */ Mention XML

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----

=Configuration file structure=
The VegaStrike configuration file <code>vegastrike.config</code> is in an XML style as follows:
<pre>
<vegaconfig>


<bindings>
<bind key="i" modifier="none" command="Screenshot" />
</bindings>

<colors>
<section name="unit">
<color name="ship_ambient" r="0.3" g="0.3" b="0.3" a="1.0"/>
</section>
</colors>

<variables>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</variables>

</vegaconfig>
</pre>

As you can see, the configuration is separated into 3 parts: <code>bindings</code>, <code>colors</code>, and <code>variables</code>. The <code>colors</code> and <code>variables</code> parts are each divided into sections. Learn more from the following pages:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= See also =
* Find a simple configuration variable listing at the [[CONFVAR]] page.

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]

Manual

2010-10-02T18:06:32Z

Greenfreedom10: /* Installation */ removed Manual:Config subpage references to simplify upkeep

{{Languages|En|Manual}}
{{Wiki_Nav_Index}}
{|width="100%"
|valign="top"|__TOC__
|valign="top" align="right"|http://vegastrike.sourceforge.net/albums/wiki_manual/cleaned3_shot_016_02_A5.png
|}

=Dedication=
This Player’s Guide is dedicated to Daniel ‘Hellcatv’ Horn and the Vega Strike development team for bringing us the Vega Strike game; to the coders, artists, designers and play-testers willing to devote their own time and effort to the creation of a great game; and of course to the players of Vega Strike, without whom this whole thing would be a pointless exercise.

=Introduction=

<big>'''''WELCOME''''' to ''Vega Strike'', a 3d OpenGL spaceflight simulator being developed for multi-platform play.</big>

Vega Strike allows players to explore a vastly dynamic universe where frontiers collide and you're just a pilot trying to make ends meet. How? That's your decision. Vega Strike is designed as a non-linear gaming experience, where you choose what action you want to take.

Vega Strike features a dynamic trading economy, allowing your character to operate as a merchant. Discover what trade routes bring in the most profit, what commodities make you the most money given your ship's cargo space limitations, accept cargo [[Manual:Computer:Missions_screen|missions]] and learn to avoid areas of danger (repairs eat into your profits!).

If you are tired of making money on milk runs, or want to try something different, then there are other paths to success. Vega Strike features a mission generator, providing multiple missions to the experienced (and not so experienced) pilots. Engage in bounty hunts, patrols, battles and escort missions. Feel like travelling? Explore the dynamic universe and see the farthest reaches of known space. Want a walk on the wild side? You could always turn pirate! Just be prepared for the consequences.

Your ship just not doing the job you want it to? Vega Strike gives you the ability to purchase from a wide variety of ships capable of doing different jobs. Want to haul cargo? Fight battles? There's a ship for you. Your ship is fully customizable, so if you've got the [[Terminology:Credits|credit]], outfit your craft with the right tools for the job at hand.

Have a chat with the [[Manual:Location:Bar|bartender]] or view the [[Manual:Computer:News_screen|news broadcasts ]]to find out what's going on in the universe. While you're there, talk to the fixers, they may have a job that only you can do. But be warned, you never know where it may lead ...

* [[Vegastrike:License|License]] The license Vega Strike is released under (please do not edit)
* [[Vegastrike:Mission|Mission]] The Vega Strike Mission Statement (what it's all about)
* [[Vegastrike:Features|Features]] Why Vega Strike is the best game ever made
* [[Vegastrike:Credits|Credits]] The people who are making it happen

Winner of the Jeux (games) category of the Trophees Du Libre 2003. [http://vegastrike.sourceforge.net/index.php?prevnext=10 Link]

=Installation=
{|
|valign=top|Your guides on how to install, configure and start playing Vega Strike.
If you're new to Vegastrike you can also follow the [[Manual:New users|New users]] guide.

* [[Manual:Install|Installation of Vegastrike]]
* [[Manual:Running Vegastrike|Running Vegastrike]]
* [[Manual:Save and load|Saving and loading]]
* [[Manual:Config|Configure Vegastrike (Setup)]]

|valign=top|
{||
|<center>http://vegastrike.sourceforge.net/gallery/main.php?g2_view=core.DownloadItem&g2_itemId=5814&g2_serialNumber=2&ext=.png</center>
|<center>http://vegastrike.sourceforge.net/gallery/main.php?g2_view=core.DownloadItem&g2_itemId=5881&g2_serialNumber=2&ext=.png</center>
|-
|
|<center>http://vegastrike.sourceforge.net/albums/wiki_manual/config_code.png</center>
|}
|}

=Tutorial=
* [[Manual:New users|New users]] - Tips and tricks for new users.
* [[Manual:Tutorial|Tutorial]] - Starting a new game - making a few credits.
* [[Manual:Gameplay Tactics|Gameplay Tactics]] - Advanced game tactics.

=Play=
How to Interact with Vega Strike.
{|
|valign=top width=33%| 
==Interface==
http://vegastrike.sourceforge.net/gallery2/main.php?g2_view=core.DownloadItem&g2_itemId=6619&g2_serialNumber=2&ext=.png

*Directory
** [[Manual:Location|Locations]]
** [[Manual:Computer|Computers]]
* [[Manual:Location:Hangar|Hangar]] - Yes, that's your ship.
* [[Manual:Location:Concourse|Concourse]] - Access All Areas.
** [[Manual:Computer:Mission computer|Mission Computer]] - Your location access point.
*** [[Manual:Computer:Missions screen|Missions Screen]] - Have we got the mission for you!
*** [[Manual:Computer:News screen|News Screen]] - what's up?
*** [[Manual:Computer:Info screen|Pilot Information Screen]] - its all about you isn't it?
*** [[Manual:Computer:Game menu|Game Menu]] - Game file interaction.
* [[Manual:Location:Bar|The Bar]] - Come on in, have a drink!
* [[Manual:Location:Transit| Transit System]] - Going somewhere?
* [[Manual:Location:Cargobay|The Cargobay]] - where to go to buy or sell.
** [[Manual:Computer:Cargo computer|Cargo Computer]] - And how to do so.
* [[Manual:Location:Shipyards|Shipyards]] - Your one stop killer ship shop.
** [[Manual:Computer:Upgrades screen|Upgrades Screen]] - How do I obtain new upgrades?
** [[Manual:Computer:Ships screen|Ships Screen]] - How do I obtain new ships?
|valign=top|

==Inflight==
{|
|valign=top|
===Flying & Navigation===
http://vegastrike.sourceforge.net/gallery2/main.php?g2_view=core.DownloadItem&g2_itemId=5444&g2_serialNumber=2&ext=.png
* [[Manual:Basic flight|Basic flight]] techniques.
* [[Manual:Advanced flight|Advanced flight]] techniques.
** [[Manual:Match velocity|Match velocity]] with a [[Manual:Targeting|target]].
** [[Manual:Docking|Docking]] to a planet or a [[Vessels & Installations|capship]].
** [[Manual:Insystem travel|Insystem travel]]
** [[Manual:Interstellar travel|Interstellar travel]] (Jump drive).
* [[Manual:Targeting|Targeting]] - How to use targeting.
* [[Manual:Views|Views]] - Cockpit and camera views - what are they and how do they work.
* [[Manual:HUD|HUD]] - Explanation of the HUD layout.
* [[Manual:Map|Map]] - How the ingame map system works.
** [[Manual:Statistical Mode|Statistical Mode]] - What do all these numbers mean?
** [[Manual:Map Mode|Map Mode]] - Exploring the Universe.
** [[Manual:Navigation Computer|Navigation Computer]] - Using the Navigation computer.

===Communication===
http://vegastrike.sourceforge.net/gallery2/main.php?g2_view=core.DownloadItem&g2_itemId=6617&g2_serialNumber=2&ext=.png
* [[Manual:Communication|Communication]] - How to communicate with other [[Vessels & Installations|ships/stations]].
* [[Manual:Wingmen|Wingmen]] - Communicating / using Wingmen
|valign=top|

===Combat===
http://vegastrike.sourceforge.net/gallery2/main.php?g2_view=core.DownloadItem&g2_itemId=5079&g2_serialNumber=2&ext=.png
* [[Manual:Combat|Combat]] - How to fight your enemies.
** [[Manual:Combat:Guns|Guns]] - What are they and how do they work.
** [[Manual:Combat:Missiles|Missiles]] - When you need that extra firepower.
** [[Manual:Combat:Target tracking|Target tracking]] - What is ITTS and how is it used.
** [[Manual:Combat:Counter measures|Counter measures]] - ECM stops those missiles - dead!
** [[Manual:Combat:Cloaking|Cloaking]] - What is the device, and how to use it.
** [[Manual:Combat:Turrets|Turrets]] - Pilot turrets.
** [[Manual:Combat:Death|Death]] is not forever!
** [[Manual:Combat:Wingmen|Ordering wingmen]] - In space you are not alone!
** [[Manual:Combat:Tractor beam|Tractor beam]] - Grabbing the booty!

===and more===
* [[Manual:Tractor beam|Tractor beam]] - What is it and how to use it.
* [[Manual:Gameplay functions|Gameplay functions]] - Miscellaneous gameplay commands.
* [[Manual:Dynamic Universe|Dynamic Universe]] - How the universe works.
|}
|}

=Appendix=
* [[Manual:Keyboard layout|Keyboard Layout]] - The default keyboard layout reference for Vega Strike.
* [[Manual:Music|Using Your Own Music]] - How to use your own music files in Vegastrike.
* [[FAQ]] - Vegastrike FAQs
* [[Manual:Cheats|Cheats]] - Cheating the game - Note: contains spoilers.

==Database==
For information about species/factions/ships/terms please refer to the online [[Database]]
{{Database_Overview}}

==Printable version of the manual==

There is a v 0.4.3 PDF version of the information on this site (with some additional info too) available for download by clicking on the link below (current size 1.3 MB): 
CVS (deprecated) [http://cvs.sourceforge.net/viewcvs.py/*checkout*/vegastrike/data4.x/documentation/Vega_Strike_Players_Guide.pdf Vega Strike Player's Guide (PDF)]

SVN [http://vegastrike.svn.sourceforge.net/viewvc/*checkout*/vegastrike/trunk/data/documentation/Vega_Strike_Players_Guide.pdf Vega Strike Player's Guide (PDF)]

==Links==
* The [http://vegastrike.sourceforge.net/manual/00_fullmanual/index.html original (but outdated) manual] (pure HTML)
* The [http://vegastrike.sourceforge.net/phpwiki/index.php/VegastrikeManual manual in the old wiki] (phpWiki)
* If you read this manual ''offline'', you can find the most recent version ''online'' at [http://vegastrike.sourceforge.net/wiki/Manual http://vegastrike.sourceforge.net/wiki/Manual]
* See also the [[Links]] page of the Vegastrike Wiki.

=Manual notes=
As you read through this manual, you will note references to various keys. These key references appear as: {{Key:EN:W}} referring to the w key; {{Key:EN:Shift left}} + {{Key:EN:W}} referring to the capitalized letter W. {{Key:EN:Ctrl}} + {{Key:EN:W}} refers to pressing both the Control and w key simultaneously.

References to '''[KP]''' refer to using the buttons on the '''KeyPad'''. Buttons appearing onscreen are noted in a similar fashion.

If there are no key graphics available (yet ;) ) the keys will be represented by something like this: '''[Shift]'''+'''[W]'''

----

{{NAV_Manual | previous=[[Vegastrike]]
| up=[[Vegastrike]]
| next=[[Vegastrike:License|License]]
}}

[[Category:Manual]]

Talk:CONFVAR

2010-09-29T23:58:31Z

Greenfreedom10:

Are the values listed here the defaults (with a skeleton config file)? - [[User:Greenfreedom10|Greenfreedom10]] 23:55, 29 September 2010 (UTC)

Talk:Manual:Config:Advanced:Variables

2010-09-29T23:57:28Z

Greenfreedom10:

In the config file I see:
<pre>
<section name="graphics/mesh">
</section>
</pre>
as well as:
<pre>
<section name="ai">
<section name="targetting">
</section>
</section>
</pre>
Are the 2 styles interchangeable? - [[User:Greenfreedom10|Greenfreedom10]] 22:06, 29 September 2010 (UTC)

Talk:Manual:Config:Advanced:Bindings

2010-09-29T23:57:00Z

Greenfreedom10:

Where can I find a list of binding variables? I don't see anything about bindings in [[CONFVAR]]. - [[User:Greenfreedom10|Greenfreedom10]] 19:40, 29 September 2010 (UTC)

Talk:CONFVAR

2010-09-29T23:55:56Z

Greenfreedom10: default values?

Are the values listed here the defaults (with a skeleton config file)? [[User:Greenfreedom10|Greenfreedom10]] 23:55, 29 September 2010 (UTC)

Manual:Config:Advanced:Variables

2010-09-29T22:11:30Z

Greenfreedom10: /* See also */

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set in their respective sections between the <code><variables></code> and the <code></variables></code> tags.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>splash</code>" section==
{{FIXME}}

=="<code>graphics/general</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics/mesh</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

==="<code>hud</code>" subsection===
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>audio</code>" section==
{{FIXME}}

=="<code>unitaudio</code>" section==
{{FIXME}}

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.
{{FIXME}}

=="<code>keyboard</code>" section==
{{FIXME}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')
* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>general</code>" section==
{{FIXME}}

=="<code>AI</code>" section==
{{FIXME}}
==="<code>Targetting</code>" subsection===
{{FIXME}}
==="<code>Firing</code>" subsection===
{{FIXME}}

=="<code>cargo</code>" section==
{{FIXME}}

=="<code>physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>galaxy</code>" section==
{{FIXME}}

=="<code>player</code>" section==
{{FIXME}}

=="<code>server</code>" section==
{{FIXME}}

=="<code>network</code>" section==
{{FIXME}}

= See also =
For a complete list of variables visit [[CONFVAR]].

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Variables

2010-09-29T22:07:59Z

Greenfreedom10: /* "graphics/mesh" section */ empty config section?

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set in their respective sections between the <code><variables></code> and the <code></variables></code> tags.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>splash</code>" section==
{{FIXME}}

=="<code>graphics/general</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics/mesh</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

==="<code>hud</code>" subsection===
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>audio</code>" section==
{{FIXME}}

=="<code>unitaudio</code>" section==
{{FIXME}}

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.
{{FIXME}}

=="<code>keyboard</code>" section==
{{FIXME}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')
* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>general</code>" section==
{{FIXME}}

=="<code>AI</code>" section==
{{FIXME}}
==="<code>Targetting</code>" subsection===
{{FIXME}}
==="<code>Firing</code>" subsection===
{{FIXME}}

=="<code>cargo</code>" section==
{{FIXME}}

=="<code>physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>galaxy</code>" section==
{{FIXME}}

=="<code>player</code>" section==
{{FIXME}}

=="<code>server</code>" section==
{{FIXME}}

=="<code>network</code>" section==
{{FIXME}}

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Variables

2010-09-29T22:07:42Z

Greenfreedom10: /* "graphics/general" section */ empty config section?

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set in their respective sections between the <code><variables></code> and the <code></variables></code> tags.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>splash</code>" section==
{{FIXME}}

=="<code>graphics/general</code>" section==
{{FIXME}} ''Empty section? Nothing in SVN <code>vegastrike.config</code>''

=="<code>graphics/mesh</code>" section==
{{FIXME}}

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

==="<code>hud</code>" subsection===
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>audio</code>" section==
{{FIXME}}

=="<code>unitaudio</code>" section==
{{FIXME}}

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.
{{FIXME}}

=="<code>keyboard</code>" section==
{{FIXME}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')
* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>general</code>" section==
{{FIXME}}

=="<code>AI</code>" section==
{{FIXME}}
==="<code>Targetting</code>" subsection===
{{FIXME}}
==="<code>Firing</code>" subsection===
{{FIXME}}

=="<code>cargo</code>" section==
{{FIXME}}

=="<code>physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>galaxy</code>" section==
{{FIXME}}

=="<code>player</code>" section==
{{FIXME}}

=="<code>server</code>" section==
{{FIXME}}

=="<code>network</code>" section==
{{FIXME}}

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Talk:Manual:Config:Advanced:Variables

2010-09-29T22:06:36Z

Greenfreedom10: subsections

In the config file I see:
<pre>
<section name="graphics/mesh">
</section>
</pre>
as well as:
<pre>
<section name="ai">
<section name="targetting">
</section>
</section>
</pre>
Are the 2 styles interchangeable? [[User:Greenfreedom10|Greenfreedom10]] 22:06, 29 September 2010 (UTC)

Manual:Config:Advanced:Variables

2010-09-29T22:02:34Z

Greenfreedom10: Add more sections and subsections

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set in their respective sections between the <code><variables></code> and the <code></variables></code> tags.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>splash</code>" section==
{{FIXME}}

=="<code>graphics/general</code>" section==
{{FIXME}}

=="<code>graphics/mesh</code>" section==
{{FIXME}}

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

==="<code>hud</code>" subsection===
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>audio</code>" section==
{{FIXME}}

=="<code>unitaudio</code>" section==
{{FIXME}}

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.
{{FIXME}}

=="<code>keyboard</code>" section==
{{FIXME}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')
* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>general</code>" section==
{{FIXME}}

=="<code>AI</code>" section==
{{FIXME}}
==="<code>Targetting</code>" subsection===
{{FIXME}}
==="<code>Firing</code>" subsection===
{{FIXME}}

=="<code>cargo</code>" section==
{{FIXME}}

=="<code>physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>galaxy</code>" section==
{{FIXME}}

=="<code>player</code>" section==
{{FIXME}}

=="<code>server</code>" section==
{{FIXME}}

=="<code>network</code>" section==
{{FIXME}}

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Colors

2010-09-29T21:42:13Z

Greenfreedom10: /* "default" section */ clarify space_background description

{{Languages|En|Manual:Config:Advanced:Colors}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
----
= Color variables =
The color variables are set in their respective sections between the <code><colors></code> and the <code></colors></code> tags.

The color variables look like this:
<pre><color name="NAME" r="NUM" g="NUM" b="NUM" a="NUM" /></pre>
or like this, if referring to a color in another section:
<pre><color name="NAME" section="SECTION" ref="NAME" /></pre>

{{FIXME}} ''Are the 2 types interchangeable (for the same variable)?''

== "<code>nav</code>" section ==
* <code>'''destination_system'''</code> [rgba] - {{FIXME}}

== "<code>absolute</code>" section ==
Sets absolute colors used for reference? {{FIXME}} ''Add defaults.''

* <code>'''red'''</code> [rgba]
* <code>'''green'''</code> [rgba]
* <code>'''blue'''</code> [rgba]
* <code>'''yellow'''</code> [rgba]
* <code>'''black'''</code> [rgba]
* <code>'''white'''</code> [rgba]
* <code>'''grey'''</code> [rgba]
* <code>'''light-grey'''</code> [rgba]
* <code>'''pink'''</code> [rgba]
* <code>'''dark-red'''</code> [rgba]
* <code>'''dark-blue'''</code> [rgba]

== "<code>unit</code>" section ==
Light to use for ships.

* <code>'''ship_ambient'''</code> [rgba] - Ambient light used for ship model rendering?
* <code>'''engine'''</code> [rgba] - Engine color?

== "<code>terrain</code>" section ==
* <code>'''terrain_ambient'''</code> [rgba] - Ambient light used for terrain rendering (what terrain)?

== "<code>default</code>" section ==
Colors to use in radar/target rectangles.

* <code>'''enemy'''</code> [ref] - Enemy ship, based on player stats faction<0?
* <code>'''friend'''</code> [ref] - Friend ship, based on player stats faction>0?
* <code>'''neutral'''</code> [ref] - Neutral ship, based on player stats faction=0?
* <code>'''attacking_ship'''</code> [ref] - Ship attacking you.
* <code>'''locking_ship'''</code> [ref] - Ship with missiles locked on?
* <code>'''targetting_ship'''</code> [ref] - Ship targetting you?
* <code>'''target'''</code> [ref] - Target, whether ship or planet, etc.?
* <code>'''planet'''</code> [ref] - Any planet?
* <code>'''docking_box'''</code> [ref] - Docking boxes for showing available docking areas.
* <code>'''black_and_white'''</code> [ref] - {{FIXME}}
* <code>'''planet_ambient'''</code> [rgba] - Ambient light used when rendering planets?
* <code>'''planet_mat_ambient'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_diffuse'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_specular'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_emmissive'''</code> [rgba] - {{FIXME}}
* <code>'''space_background'''</code> [ref] - The color of the void of space.
** set this to "dark-blue" to get the real spacey feeling

Manual:Config:Advanced:Colors

2010-09-29T21:41:40Z

Greenfreedom10: fix section quotes

{{Languages|En|Manual:Config:Advanced:Colors}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
----
= Color variables =
The color variables are set in their respective sections between the <code><colors></code> and the <code></colors></code> tags.

The color variables look like this:
<pre><color name="NAME" r="NUM" g="NUM" b="NUM" a="NUM" /></pre>
or like this, if referring to a color in another section:
<pre><color name="NAME" section="SECTION" ref="NAME" /></pre>

{{FIXME}} ''Are the 2 types interchangeable (for the same variable)?''

== "<code>nav</code>" section ==
* <code>'''destination_system'''</code> [rgba] - {{FIXME}}

== "<code>absolute</code>" section ==
Sets absolute colors used for reference? {{FIXME}} ''Add defaults.''

* <code>'''red'''</code> [rgba]
* <code>'''green'''</code> [rgba]
* <code>'''blue'''</code> [rgba]
* <code>'''yellow'''</code> [rgba]
* <code>'''black'''</code> [rgba]
* <code>'''white'''</code> [rgba]
* <code>'''grey'''</code> [rgba]
* <code>'''light-grey'''</code> [rgba]
* <code>'''pink'''</code> [rgba]
* <code>'''dark-red'''</code> [rgba]
* <code>'''dark-blue'''</code> [rgba]

== "<code>unit</code>" section ==
Light to use for ships.

* <code>'''ship_ambient'''</code> [rgba] - Ambient light used for ship model rendering?
* <code>'''engine'''</code> [rgba] - Engine color?

== "<code>terrain</code>" section ==
* <code>'''terrain_ambient'''</code> [rgba] - Ambient light used for terrain rendering (what terrain)?

== "<code>default</code>" section ==
Colors to use in radar/target rectangles.

* <code>'''enemy'''</code> [ref] - Enemy ship, based on player stats faction<0?
* <code>'''friend'''</code> [ref] - Friend ship, based on player stats faction>0?
* <code>'''neutral'''</code> [ref] - Neutral ship, based on player stats faction=0?
* <code>'''attacking_ship'''</code> [ref] - Ship attacking you.
* <code>'''locking_ship'''</code> [ref] - Ship with missiles locked on?
* <code>'''targetting_ship'''</code> [ref] - Ship targetting you?
* <code>'''target'''</code> [ref] - Target, whether ship or planet, etc.?
* <code>'''planet'''</code> [ref] - Any planet?
* <code>'''docking_box'''</code> [ref] - Docking boxes for showing available docking areas.
* <code>'''black_and_white'''</code> [ref] - {{FIXME}}
* <code>'''planet_ambient'''</code> [rgba] - Ambient light used when rendering planets?
* <code>'''planet_mat_ambient'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_diffuse'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_specular'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_emmissive'''</code> [rgba] - {{FIXME}}
* <code>'''space_background'''</code> [ref] - The color of the void.
** set this to "dark-blue" to get the real spacey feeling

Manual:Config:Advanced:Colors

2010-09-29T20:29:16Z

Greenfreedom10: Add a bunch of content based on current SVN vegastrike.config uncommented variables

{{Languages|En|Manual:Config:Advanced:Colors}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
----
= Color variables =
The color variables are set in their respective sections between the <code><colors></code> and the <code></colors></code> tags.

The color variables look like this:
<pre><color name="NAME" r="NUM" g="NUM" b="NUM" a="NUM" /></pre>
or like this, if referring to a color in another section:
<pre><color name="NAME" section="SECTION" ref="NAME" /></pre>

{{FIXME}} ''Are the 2 types interchangeable (for the same variable)?''

== "<code>nav</code> section" ==
* <code>'''destination_system'''</code> [rgba] - {{FIXME}}

== "<code>absolute</code> section" ==
Sets absolute colors used for reference? {{FIXME}} ''Add defaults.''

* <code>'''red'''</code> [rgba]
* <code>'''green'''</code> [rgba]
* <code>'''blue'''</code> [rgba]
* <code>'''yellow'''</code> [rgba]
* <code>'''black'''</code> [rgba]
* <code>'''white'''</code> [rgba]
* <code>'''grey'''</code> [rgba]
* <code>'''light-grey'''</code> [rgba]
* <code>'''pink'''</code> [rgba]
* <code>'''dark-red'''</code> [rgba]
* <code>'''dark-blue'''</code> [rgba]

== "<code>unit</code> section" ==
Light to use for ships.

* <code>'''ship_ambient'''</code> [rgba] - Ambient light used for ship model rendering?
* <code>'''engine'''</code> [rgba] - Engine color?

== "<code>terrain</code> section" ==
* <code>'''terrain_ambient'''</code> [rgba] - Ambient light used for terrain rendering (what terrain)?

== "<code>default</code> section" ==
Colors to use in radar/target rectangles.

* <code>'''enemy'''</code> [ref] - Enemy ship, based on player stats faction<0?
* <code>'''friend'''</code> [ref] - Friend ship, based on player stats faction>0?
* <code>'''neutral'''</code> [ref] - Neutral ship, based on player stats faction=0?
* <code>'''attacking_ship'''</code> [ref] - Ship attacking you.
* <code>'''locking_ship'''</code> [ref] - Ship with missiles locked on?
* <code>'''targetting_ship'''</code> [ref] - Ship targetting you?
* <code>'''target'''</code> [ref] - Target, whether ship or planet, etc.?
* <code>'''planet'''</code> [ref] - Any planet?
* <code>'''docking_box'''</code> [ref] - Docking boxes for showing available docking areas.
* <code>'''black_and_white'''</code> [ref] - {{FIXME}}
* <code>'''planet_ambient'''</code> [rgba] - Ambient light used when rendering planets?
* <code>'''planet_mat_ambient'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_diffuse'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_specular'''</code> [rgba] - {{FIXME}}
* <code>'''planet_mat_emmissive'''</code> [rgba] - {{FIXME}}
* <code>'''space_background'''</code> [ref] - The color of the void.
** set this to "dark-blue" to get the real spacey feeling

Manual:Config:Advanced:Colors

2010-09-29T20:01:56Z

Greenfreedom10: add note in intro about sections

Manual:Config:Advanced:Variables

2010-09-29T19:59:28Z

Greenfreedom10: add note in intro about sections

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set in their respective sections between the <code><variables></code> and the <code></variables></code> tags.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>Physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

=="<code>hud</code>" section==
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')

* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.

= Example =
{{Fixme}} ''Insert a very short example code showing a variable definition (and subsections).''

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Bindings

2010-09-29T19:57:20Z

Greenfreedom10: bindings part has no sections

{{Languages|En|Manual:Config:Advanced:Bindings}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
}}
----
= Key and button bindings =
The bindings are set between the <code><bindings></code> and the <code></bindings></code> tags in the <code>vegastrike.config</code> file. This first part of the config file is not separated into sections, though the bindings do divide nicely into these subsections based on the different devices:
* [[Manual:Config:Advanced:Bindings:Keyboard|Keyboard bindings]]
* [[Manual:Config:Advanced:Bindings:Mouse|Mouse bindings]]
* [[Manual:Config:Advanced:Bindings:Joystick|Joystick bindings]]

= Example =
<pre>
<bind key="d" modifier="none" command="DockKey"/>
<bind mouse="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="3" modifier="none" command="TargetKey" />
</pre>

= See also =
* [[Manual:Keyboard layout]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
}}
[[Category:Manual|Config:Advanced:Bindings]]

Manual:Config:Advanced:Variables

2010-09-29T19:52:50Z

Greenfreedom10: Add a bit of an intro

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Variables section =
The variables are set between the <code><variables></code> and the <code></variables></code> tags in the <code>vegastrike.config</code> file.

{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>Physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

=="<code>hud</code>" section==
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')

* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.

= Example =
{{Fixme}} ''Insert a very short example code showing a variable definition (and subsections).''

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced

2010-09-29T19:49:15Z

Greenfreedom10: Use <code> tags

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----

=Configuration file structure=
The basic structure of the <code>vegastrike.config</code> file is as follows:
<pre>
<vegaconfig>


<bindings>
<bind key="i" modifier="none" command="Screenshot" />
</bindings>

<colors>
<section name="unit">
<color name="ship_ambient" r="0.3" g="0.3" b="0.3" a="1.0"/>
</section>
</colors>

<variables>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</variables>

</vegaconfig>
</pre>

As you can see, the configuration is separated into 3 parts: <code>bindings</code>, <code>colors</code>, and <code>variables</code>. The <code>colors</code> and <code>variables</code> parts are each divided into sections. Learn more from the following pages:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= See also =
* Find a simple configuration variable listing at the [[CONFVAR]] page.

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]

Manual:Config:Advanced:Colors

2010-09-29T19:47:03Z

Greenfreedom10: fix heading, add a bit of an intro

Manual:Config:Advanced:Bindings

2010-09-29T19:44:49Z

Greenfreedom10: /* Example */ add example, remove fixme

{{Languages|En|Manual:Config:Advanced:Bindings}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
}}
----
= Key and button bindings =
The bindings are set between the <code><bindings></code> and the <code></bindings></code> tags in the <code>vegastrike.config</code> file.

Please see the specific subsections on the different devices:
* [[Manual:Config:Advanced:Bindings:Keyboard|Keyboard bindings]]
* [[Manual:Config:Advanced:Bindings:Mouse|Mouse bindings]]
* [[Manual:Config:Advanced:Bindings:Joystick|Joystick bindings]]

= Example =
<pre>
<bind key="d" modifier="none" command="DockKey"/>
<bind mouse="0" button="1" modifier="none" command="MissileKey" />
<bind joystick="0" button="3" modifier="none" command="TargetKey" />
</pre>

= See also =
* [[Manual:Keyboard layout]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Colors|Config:Advanced:Colors]]
}}
[[Category:Manual|Config:Advanced:Bindings]]

Talk:Manual:Config:Advanced:Bindings

2010-09-29T19:40:36Z

Greenfreedom10: binding variables list?

Where can I find a list of binding variables? I don't see anything about bindings in [[CONFVAR]]. [[User:Greenfreedom10|Greenfreedom10]] 19:40, 29 September 2010 (UTC)

Manual:Config:Advanced

2010-09-29T19:32:07Z

Greenfreedom10: rearrange page contents to improve readability

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----

=Configuration file structure=
The basic structure of the vegastrike.config file is as follows:
<pre>
<vegaconfig>


<bindings>
<bind key="i" modifier="none" command="Screenshot" />
</bindings>

<colors>
<section name="unit">
<color name="ship_ambient" r="0.3" g="0.3" b="0.3" a="1.0"/>
</section>
</colors>

<variables>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</variables>

</vegaconfig>
</pre>

As you can see, the configuration is separated into 3 parts, "bindings", "colors", and "variables". The "colors" and "variables" parts are each divided into sections. Learn more from the following pages:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= See also =
* Find a simple configuration variable listing at the [[CONFVAR]] page.

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]

Manual:Config:Advanced:Variables

2010-09-29T13:47:19Z

Greenfreedom10: /* Configuration variables */ simplify fixme

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Configuration variables =
{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>Physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

=="<code>hud</code>" section==
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')

* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.

= Example =
{{Fixme}} ''Insert a very short example code showing a variable definition (and subsections).''

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Colors

2010-09-29T13:46:52Z

Greenfreedom10: /* Configuration variables */ simplify fixme

= Configuration variables =
{{Fixme}} ''Syntax of the color section variables and where to put them.''

Manual:Config:Advanced:Bindings

2010-09-29T13:46:15Z

Greenfreedom10: /* Example */ fixme clarity

{{Languages|En|Manual:Config:Advanced:Bindings}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
----
= Key and button bindings =
The bindings are set between the <code><bindings></code> and the <code></bindings></code> tags in the <code>vegastrike.config</code> file.

Please see the specific subsections on the different devices:
* [[Manual:Config:Advanced:Bindings:Keyboard|Keyboard bindings]]
* [[Manual:Config:Advanced:Bindings:Mouse|Mouse bindings]]
* [[Manual:Config:Advanced:Bindings:Joystick|Joystick bindings]]

= Example =
{{Fixme}} ''Insert a very short example showing all three binding types.''

= See also =
* [[Manual:Keyboard layout]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced|Config:Advanced]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced:Variables|Config:Advanced:Variables]]
}}
[[Category:Manual|Config:Advanced:Bindings]]

Manual:Config:Advanced

2010-09-29T02:41:23Z

Greenfreedom10: moved the config file example down to the example section where it should be

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----

=Advanced configuration=

See the specific sections inside the config file:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= Example =
The basic structure of the config file:
<pre>
<vegaconfig>



<bindings>
<bind key="i" modifier="none" command="Screenshot" />


</bindings>

<colors>
<section name="unit">
<color name="ship_ambient" r="0.3" g="0.3" b="0.3" a="1.0"/>
<color name="engine" r="1" g="1" b="1" a="1"/>
</section>
</colors>

<variables>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</variables>

</vegaconfig>
</pre>

= See also =

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]

Manual:Config:Advanced

2010-09-29T02:39:42Z

Greenfreedom10: Add config file structure example; remove fixme

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----
The basic structure of the config file:
<pre>
<vegaconfig>



<bindings>
<bind key="i" modifier="none" command="Screenshot" />


</bindings>

<colors>
<section name="unit">
<color name="ship_ambient" r="0.3" g="0.3" b="0.3" a="1.0"/>
<color name="engine" r="1" g="1" b="1" a="1"/>
</section>
</colors>

<variables>
<section name="data">
<var name="usingtemplates" value="false"/>
</section>
</variables>

</vegaconfig>
</pre>

=Advanced configuration=

See the specific sections inside the config file:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= Example =
{{Fixme}} ''Insert a very short example code showing the layout of a complete config file.''

= See also =

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]

Manual:Config

2010-09-29T02:24:40Z

Greenfreedom10: config file structure is in Advanced pages; remove FIXME

{{Languages|En|Manual:Config}}
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
----

=The Setup Application=
<table style="float: top;"><tr><td>http://vegastrike.sourceforge.net/albums/wiki_manual/options.jpg</td></tr></table>

==Where to Find the Setup Application==

===MacOS X Users===
There is now a Vega Strike Setup.app application included.
* Click to open.
** If you do not have GTK and X11 installed then you will see a console interface with arrow keys.
** If you have GTK and X11, then you will be presented with the window seen here.
If it does not work:
* ctrl-clicking or right-clicking the Vega Strike application
* choose ''Show Package Contents''
* navigate to the Contents/Resources/data/ subdirectory.
* It's useful to drag an alias of this directory to your desktop while you're editing Vega Strike.

===Linux/Unix Users===
Configuration is accessed in three ways:
* Opening vslauncher and selecting GAME SETTINGS; OR
* By directly opening the file vssetup;
* Direct editing of the vegastrike.config file.
** There are multiple vegastrike.config files, the correct one to edit is located in a hidden home directory: ~/.vegastrike/vegastrike.config

===Windows Users===
Configuration is accessed in three ways:
* Run the program Launcher.exe and select GAME SETTINGS; OR
* Run directly by opening the file setup.exe (Setup in the Start Menu);
* Direct editing of the vegastrike.config file.

==Configuration Settings==

===Computer===
* '''<256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''512 Mb RAM + 256 Mb Swap'''
** Max Single Sounds: 8; Max Total Sounds: 24
** Systems retained in RAM: 2
** Old systems data saved for reuse: 3
* '''512 Mb RAM + 1Gb Swap'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 4
* '''1024 Mb RAM'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 15

===Optimized===
* '''Vertex Arrays''' Vertex (drawing) data is stored in an array (record). OpenGL need only call on the array, rather than execute every command in the array. In effect, OpenGL draws a starship each time one is needed - need five, draw five times.
* '''Compiled Vertex Arrays''' Vertex data in an array can be locked down when it is expected to be used multiple times. In effect, OpenGL does not recompute the locked array data until all surfaces using that data have been drawn. OpenGL copies a starship only when the vertex array is compiled ... if more than one ship is on screen then it will only need to download it the first time to the card.
* '''Display Lists''' This setting takes vertex commands and stores them for later execution - that is, define your drawing for multiple execution later. While vertex arrays can do this with a lesser amount of memory, display lists can operate faster. Graphics hardware may store display lists in dedicated memory, therefore increasing speed and efficiency, as well as offsetting the need for extra memory. So this setting will download a starship to the video card when the starship is drawn ... being much faster than copying it each time it is drawn. Recommend do not use this setting if you do not have a graphics hardware card.

===Difficulty===
* '''Decelerated Gameplay'''
** Game Speed is .5 normal
** Game Acceleration 1.0625x times normal
* '''Relaxing Gameplay'''
** Game Speed is normal
** Game Acceleration is normal
* '''Moderate Gameplay'''
** Game Speed is 2 times normal
** Game Acceleration is normal
* '''Hasty Gameplay'''
** Game Speed is 4 times normal
** Game Acceleration 0.9x normal
* '''Insane Gameplay'''
** Game Speed is 8 times normal
** Game Acceleration 0.96x normal
* '''Impossible Gameplay'''
** Game Speed is 16 times normal
** Game Acceleration 0.725x normal

===Sound===
* '''No Sound''' - No sound files played. This option is suggested when game performance is slow.
* '''My Sound Only''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Sound''' - AI sound is activated
* '''My Linux Sound''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Linux Sound''' - AI sound is activated

===Music and Volume===
The initial setting for your music volume. This setting can be adjusted ingame.
* '''High Volume''' - To give you loud, dramatic music!
* '''Medium Volume''' - For enjoying the music but without it being intrusive.
* '''Low Volume''' - Suitable setting for having music playing in the background.
* '''Music Off''' - Does not load soundserver to play music. This option is suggested when game performance is slow.

===Video===
This selection determines the level of visual detail Vega Strike projects to your monitor. These settings affect smoothness and rounding of objects, font style and anti-aliasing, sun halos, maximum texture size capability and whether reflection capability is available.
* '''Extreme Detail''' Highest detailing available including full smoothing, halo, texturing and reflection capability available. Cockpits can be activated. Only high end video cards can operate at this setting without affecting performance.
* '''Very High Detail''' The main difference is a large reduction in the level of visual detail.
* '''High Detail''' Further reduction in visual detail, and reduced lighting capability.
* '''Medium Detail''' Visual detail reduced with nebula fog disabled.
* '''Low Detail''' Reduced visual detail with no background detailing (black only) and cockpits no longer available. All script is in reduced font size with no color differentiation. Light reflection is disabled with no haloing effects.
* '''Retro Detail''' Lowest detail with no texture usage (wireframe only).

===Resolution===

This selection sets the Video Resolution for Vega Strike to use. Please note the larger the resolution, the greater the processing power is needed.

* '''512x384''' - {{Fixme}}
* '''640x480''' - xxx
* '''800x600''' - xxx
* '''1024x768''' - xxx
* '''1280x1024''' - xxx
* '''1600x1200''' - xxx

Only standard 4:3 resolutions are supported. Wide screens (3:2, 16:9, etc) will display stretched or pillarboxed depending on your local drivers. Multiple monitors are not supported.

===Per Pixel Lighting===
====Definitions====
*'''Separate Specular Color''' Vertex Lighting. Identifies the bright specular highlights that occur when light hits an object's surface and projects onto your ship's reflectivity analysis of the surface. In effect, you get a shine effect on an object that changes depending on where both the viewer and the sun is.
*''' Per Pixel Lighting''' Per-pixel lighting offers the ability to calculate lighting effects at the pixel level, greatly increasing precision and realism in a scene. In effect, making the lighting effects sharper, more defined. Per pixel specular lighting is best with a pixel shader - not truly necessary, but you suffer a big performance hit otherwise. GeForce3, Radeon 8500 and later video cards have this shader. Where game performance is slow or you have an older generation card, do not select an option with Per Pixel Lighting.
*'''Reflection''' Is an environment map (picture of background). This map is used where the visual mesh is declared to be specular and is projected onto your reflectivity analysis of the surface (your view). One result is that objects become capable of reflecting light and can act like a mirror surface.

====Options====
* '''No Specular Lighting''' - This option is suggested when game performance is slow.
** separate specular color: no
** per pixel lighting: no
** reflection: no
* '''Specular Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: no
* '''Specular Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: no
** per pixel lighting: yes
** reflection: no
* '''Reflective Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: yes
* '''Reflective Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: yes
** per pixel lighting: yes
** reflection: yes

===Color===
This selection determines whether the game uses full 32 bit color or the more limited 16 bit color range. It also determines whether the game runs in full screen mode (uses your whole screen limited by your resolution setting) or is windowed (appears as a window in your monitor allowing access other programs).
* '''32 bit Fullscreen''' - 32 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''16 bit Fullscreen''' - Reduced 16 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''32 bit Windowed''' - 32 bit color with the game viewed in a window.
* '''16 bit Windowed''' - Reduced 16 bit color with the game viewed in a window.

===Mouse===
====Definitions====
This selection determines your mouse control during flight operations. A mouse with multiple buttons default to the button selection below.

* '''button 0''' = Fire Weapon
* '''button 1''' = Fire Missile
* '''button 2''' = Afterburner
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticule)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''Mouse Warping''' "Drag to Steer". Your craft turns in the direction of the mouse movement, but the turn only continues while you mouse moves. To continue a turn, you need to continue scrolling your mouse in the desired direction.
* '''Inv Mouse Warp''' Inverts the direction of "Mouse Warping"
* '''Mouse Glide''' Provides a 'ghost' targeting reticle that is movable around the screen. When moved away from center, your ship will turn in the direction of the reticle. Recenter reticle to cease turning. This option does not require mouse scrolling to continue a turn.
* '''Inv Mouse Glide''' Inverts the up/down direction of "Mouse Glide"
* '''No Mouse''' No mouse flight.

===Mouse Cursor===
* '''Software Cursor''' - This should be the default setting. Cursor should appear at bases, and disappear in flight.
* '''Hardware Cursor''' - Select this option where the cursor is not appearing when at a base at all.

===Joystick===

====Definitions====
This selection configures your joystick for flight control. Joysticks can also be programmed by directly editing the <code>vegastrike.config</code> file recommended for advanced use only. Joysticks with multiple buttons default to the button selection below.

* '''x axis''' = changes direction of pitch. Imagine holding your arms out sideways from your body and your hands holding on to something. You then swing your feet up and down. You are rotating on your arms (x axis).
* '''y asis''' = changes direction of yaw. Imagine standing upright, then turning in place to the left or right.
* '''z axis''' = changes direction of roll. Imagine standing upright, holding on to a pole above you running from forwards to backwards. You then swing from left to right. You are 'rolling' around the pole.
* '''button 0''' = Fire Weapon
* '''button 1''' = Afterburner
* '''button 2''' = Fire Missile
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticle)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''No Joystick''' - No joystick flight enabled.
* '''2 Axis Joystick''' Enables a standard 2 axis (x,y) joystick with two buttons (0,1).
* '''2 Axis Joystick And Throttle''' - Enables movement in the x,y directions only. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''3 Axis Joystick''' - Enables movement in all three directions.
* '''3 Axis Joystick and Throttle''' - Enables movement in all three directions, plus the use of a throttle. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''Joystick and Throttle Reversed''' - Reverses the setting of third axis and throttle.

= See also =
* See [[Manual:Config:Advanced|Advanced Configuration]] for information about editing the config file (vegastrike.config) directly.

----
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
[[Category:Manual|Config]]
'''Bold text'''

Manual:Config

2010-09-29T02:23:41Z

Greenfreedom10: add space after seealso section

{{Languages|En|Manual:Config}}
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
----
{{Fixme}} ''Add general description of the config file syntax+structure''

=The Setup Application=
<table style="float: top;"><tr><td>http://vegastrike.sourceforge.net/albums/wiki_manual/options.jpg</td></tr></table>

==Where to Find the Setup Application==

===MacOS X Users===
There is now a Vega Strike Setup.app application included.
* Click to open.
** If you do not have GTK and X11 installed then you will see a console interface with arrow keys.
** If you have GTK and X11, then you will be presented with the window seen here.
If it does not work:
* ctrl-clicking or right-clicking the Vega Strike application
* choose ''Show Package Contents''
* navigate to the Contents/Resources/data/ subdirectory.
* It's useful to drag an alias of this directory to your desktop while you're editing Vega Strike.

===Linux/Unix Users===
Configuration is accessed in three ways:
* Opening vslauncher and selecting GAME SETTINGS; OR
* By directly opening the file vssetup;
* Direct editing of the vegastrike.config file.
** There are multiple vegastrike.config files, the correct one to edit is located in a hidden home directory: ~/.vegastrike/vegastrike.config

===Windows Users===
Configuration is accessed in three ways:
* Run the program Launcher.exe and select GAME SETTINGS; OR
* Run directly by opening the file setup.exe (Setup in the Start Menu);
* Direct editing of the vegastrike.config file.

==Configuration Settings==

===Computer===
* '''<256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''512 Mb RAM + 256 Mb Swap'''
** Max Single Sounds: 8; Max Total Sounds: 24
** Systems retained in RAM: 2
** Old systems data saved for reuse: 3
* '''512 Mb RAM + 1Gb Swap'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 4
* '''1024 Mb RAM'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 15

===Optimized===
* '''Vertex Arrays''' Vertex (drawing) data is stored in an array (record). OpenGL need only call on the array, rather than execute every command in the array. In effect, OpenGL draws a starship each time one is needed - need five, draw five times.
* '''Compiled Vertex Arrays''' Vertex data in an array can be locked down when it is expected to be used multiple times. In effect, OpenGL does not recompute the locked array data until all surfaces using that data have been drawn. OpenGL copies a starship only when the vertex array is compiled ... if more than one ship is on screen then it will only need to download it the first time to the card.
* '''Display Lists''' This setting takes vertex commands and stores them for later execution - that is, define your drawing for multiple execution later. While vertex arrays can do this with a lesser amount of memory, display lists can operate faster. Graphics hardware may store display lists in dedicated memory, therefore increasing speed and efficiency, as well as offsetting the need for extra memory. So this setting will download a starship to the video card when the starship is drawn ... being much faster than copying it each time it is drawn. Recommend do not use this setting if you do not have a graphics hardware card.

===Difficulty===
* '''Decelerated Gameplay'''
** Game Speed is .5 normal
** Game Acceleration 1.0625x times normal
* '''Relaxing Gameplay'''
** Game Speed is normal
** Game Acceleration is normal
* '''Moderate Gameplay'''
** Game Speed is 2 times normal
** Game Acceleration is normal
* '''Hasty Gameplay'''
** Game Speed is 4 times normal
** Game Acceleration 0.9x normal
* '''Insane Gameplay'''
** Game Speed is 8 times normal
** Game Acceleration 0.96x normal
* '''Impossible Gameplay'''
** Game Speed is 16 times normal
** Game Acceleration 0.725x normal

===Sound===
* '''No Sound''' - No sound files played. This option is suggested when game performance is slow.
* '''My Sound Only''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Sound''' - AI sound is activated
* '''My Linux Sound''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Linux Sound''' - AI sound is activated

===Music and Volume===
The initial setting for your music volume. This setting can be adjusted ingame.
* '''High Volume''' - To give you loud, dramatic music!
* '''Medium Volume''' - For enjoying the music but without it being intrusive.
* '''Low Volume''' - Suitable setting for having music playing in the background.
* '''Music Off''' - Does not load soundserver to play music. This option is suggested when game performance is slow.

===Video===
This selection determines the level of visual detail Vega Strike projects to your monitor. These settings affect smoothness and rounding of objects, font style and anti-aliasing, sun halos, maximum texture size capability and whether reflection capability is available.
* '''Extreme Detail''' Highest detailing available including full smoothing, halo, texturing and reflection capability available. Cockpits can be activated. Only high end video cards can operate at this setting without affecting performance.
* '''Very High Detail''' The main difference is a large reduction in the level of visual detail.
* '''High Detail''' Further reduction in visual detail, and reduced lighting capability.
* '''Medium Detail''' Visual detail reduced with nebula fog disabled.
* '''Low Detail''' Reduced visual detail with no background detailing (black only) and cockpits no longer available. All script is in reduced font size with no color differentiation. Light reflection is disabled with no haloing effects.
* '''Retro Detail''' Lowest detail with no texture usage (wireframe only).

===Resolution===

This selection sets the Video Resolution for Vega Strike to use. Please note the larger the resolution, the greater the processing power is needed.

* '''512x384''' - {{Fixme}}
* '''640x480''' - xxx
* '''800x600''' - xxx
* '''1024x768''' - xxx
* '''1280x1024''' - xxx
* '''1600x1200''' - xxx

Only standard 4:3 resolutions are supported. Wide screens (3:2, 16:9, etc) will display stretched or pillarboxed depending on your local drivers. Multiple monitors are not supported.

===Per Pixel Lighting===
====Definitions====
*'''Separate Specular Color''' Vertex Lighting. Identifies the bright specular highlights that occur when light hits an object's surface and projects onto your ship's reflectivity analysis of the surface. In effect, you get a shine effect on an object that changes depending on where both the viewer and the sun is.
*''' Per Pixel Lighting''' Per-pixel lighting offers the ability to calculate lighting effects at the pixel level, greatly increasing precision and realism in a scene. In effect, making the lighting effects sharper, more defined. Per pixel specular lighting is best with a pixel shader - not truly necessary, but you suffer a big performance hit otherwise. GeForce3, Radeon 8500 and later video cards have this shader. Where game performance is slow or you have an older generation card, do not select an option with Per Pixel Lighting.
*'''Reflection''' Is an environment map (picture of background). This map is used where the visual mesh is declared to be specular and is projected onto your reflectivity analysis of the surface (your view). One result is that objects become capable of reflecting light and can act like a mirror surface.

====Options====
* '''No Specular Lighting''' - This option is suggested when game performance is slow.
** separate specular color: no
** per pixel lighting: no
** reflection: no
* '''Specular Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: no
* '''Specular Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: no
** per pixel lighting: yes
** reflection: no
* '''Reflective Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: yes
* '''Reflective Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: yes
** per pixel lighting: yes
** reflection: yes

===Color===
This selection determines whether the game uses full 32 bit color or the more limited 16 bit color range. It also determines whether the game runs in full screen mode (uses your whole screen limited by your resolution setting) or is windowed (appears as a window in your monitor allowing access other programs).
* '''32 bit Fullscreen''' - 32 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''16 bit Fullscreen''' - Reduced 16 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''32 bit Windowed''' - 32 bit color with the game viewed in a window.
* '''16 bit Windowed''' - Reduced 16 bit color with the game viewed in a window.

===Mouse===
====Definitions====
This selection determines your mouse control during flight operations. A mouse with multiple buttons default to the button selection below.

* '''button 0''' = Fire Weapon
* '''button 1''' = Fire Missile
* '''button 2''' = Afterburner
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticule)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''Mouse Warping''' "Drag to Steer". Your craft turns in the direction of the mouse movement, but the turn only continues while you mouse moves. To continue a turn, you need to continue scrolling your mouse in the desired direction.
* '''Inv Mouse Warp''' Inverts the direction of "Mouse Warping"
* '''Mouse Glide''' Provides a 'ghost' targeting reticle that is movable around the screen. When moved away from center, your ship will turn in the direction of the reticle. Recenter reticle to cease turning. This option does not require mouse scrolling to continue a turn.
* '''Inv Mouse Glide''' Inverts the up/down direction of "Mouse Glide"
* '''No Mouse''' No mouse flight.

===Mouse Cursor===
* '''Software Cursor''' - This should be the default setting. Cursor should appear at bases, and disappear in flight.
* '''Hardware Cursor''' - Select this option where the cursor is not appearing when at a base at all.

===Joystick===

====Definitions====
This selection configures your joystick for flight control. Joysticks can also be programmed by directly editing the <code>vegastrike.config</code> file recommended for advanced use only. Joysticks with multiple buttons default to the button selection below.

* '''x axis''' = changes direction of pitch. Imagine holding your arms out sideways from your body and your hands holding on to something. You then swing your feet up and down. You are rotating on your arms (x axis).
* '''y asis''' = changes direction of yaw. Imagine standing upright, then turning in place to the left or right.
* '''z axis''' = changes direction of roll. Imagine standing upright, holding on to a pole above you running from forwards to backwards. You then swing from left to right. You are 'rolling' around the pole.
* '''button 0''' = Fire Weapon
* '''button 1''' = Afterburner
* '''button 2''' = Fire Missile
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticle)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''No Joystick''' - No joystick flight enabled.
* '''2 Axis Joystick''' Enables a standard 2 axis (x,y) joystick with two buttons (0,1).
* '''2 Axis Joystick And Throttle''' - Enables movement in the x,y directions only. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''3 Axis Joystick''' - Enables movement in all three directions.
* '''3 Axis Joystick and Throttle''' - Enables movement in all three directions, plus the use of a throttle. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''Joystick and Throttle Reversed''' - Reverses the setting of third axis and throttle.

= See also =
* See [[Manual:Config:Advanced|Advanced Configuration]] for information about editing the config file (vegastrike.config) directly.

----
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
[[Category:Manual|Config]]
'''Bold text'''

Manual:Config

2010-09-29T02:22:27Z

Greenfreedom10: /* Advanced configuration */ delete section; advancedconfiguration has its own pages

Manual:Config

2010-09-29T02:20:52Z

Greenfreedom10: /* See also */

{{Languages|En|Manual:Config}}
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
----
{{Fixme}} ''Add general description of the config file syntax+structure''

=The Setup Application=
<table style="float: top;"><tr><td>http://vegastrike.sourceforge.net/albums/wiki_manual/options.jpg</td></tr></table>

==Where to Find the Setup Application==

===MacOS X Users===
There is now a Vega Strike Setup.app application included.
* Click to open.
** If you do not have GTK and X11 installed then you will see a console interface with arrow keys.
** If you have GTK and X11, then you will be presented with the window seen here.
If it does not work:
* ctrl-clicking or right-clicking the Vega Strike application
* choose ''Show Package Contents''
* navigate to the Contents/Resources/data/ subdirectory.
* It's useful to drag an alias of this directory to your desktop while you're editing Vega Strike.

===Linux/Unix Users===
Configuration is accessed in three ways:
* Opening vslauncher and selecting GAME SETTINGS; OR
* By directly opening the file vssetup;
* Direct editing of the vegastrike.config file.
** There are multiple vegastrike.config files, the correct one to edit is located in a hidden home directory: ~/.vegastrike/vegastrike.config

===Windows Users===
Configuration is accessed in three ways:
* Run the program Launcher.exe and select GAME SETTINGS; OR
* Run directly by opening the file setup.exe (Setup in the Start Menu);
* Direct editing of the vegastrike.config file.

==Configuration Settings==

===Computer===
* '''<256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''512 Mb RAM + 256 Mb Swap'''
** Max Single Sounds: 8; Max Total Sounds: 24
** Systems retained in RAM: 2
** Old systems data saved for reuse: 3
* '''512 Mb RAM + 1Gb Swap'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 4
* '''1024 Mb RAM'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 15

===Optimized===
* '''Vertex Arrays''' Vertex (drawing) data is stored in an array (record). OpenGL need only call on the array, rather than execute every command in the array. In effect, OpenGL draws a starship each time one is needed - need five, draw five times.
* '''Compiled Vertex Arrays''' Vertex data in an array can be locked down when it is expected to be used multiple times. In effect, OpenGL does not recompute the locked array data until all surfaces using that data have been drawn. OpenGL copies a starship only when the vertex array is compiled ... if more than one ship is on screen then it will only need to download it the first time to the card.
* '''Display Lists''' This setting takes vertex commands and stores them for later execution - that is, define your drawing for multiple execution later. While vertex arrays can do this with a lesser amount of memory, display lists can operate faster. Graphics hardware may store display lists in dedicated memory, therefore increasing speed and efficiency, as well as offsetting the need for extra memory. So this setting will download a starship to the video card when the starship is drawn ... being much faster than copying it each time it is drawn. Recommend do not use this setting if you do not have a graphics hardware card.

===Difficulty===
* '''Decelerated Gameplay'''
** Game Speed is .5 normal
** Game Acceleration 1.0625x times normal
* '''Relaxing Gameplay'''
** Game Speed is normal
** Game Acceleration is normal
* '''Moderate Gameplay'''
** Game Speed is 2 times normal
** Game Acceleration is normal
* '''Hasty Gameplay'''
** Game Speed is 4 times normal
** Game Acceleration 0.9x normal
* '''Insane Gameplay'''
** Game Speed is 8 times normal
** Game Acceleration 0.96x normal
* '''Impossible Gameplay'''
** Game Speed is 16 times normal
** Game Acceleration 0.725x normal

===Sound===
* '''No Sound''' - No sound files played. This option is suggested when game performance is slow.
* '''My Sound Only''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Sound''' - AI sound is activated
* '''My Linux Sound''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Linux Sound''' - AI sound is activated

===Music and Volume===
The initial setting for your music volume. This setting can be adjusted ingame.
* '''High Volume''' - To give you loud, dramatic music!
* '''Medium Volume''' - For enjoying the music but without it being intrusive.
* '''Low Volume''' - Suitable setting for having music playing in the background.
* '''Music Off''' - Does not load soundserver to play music. This option is suggested when game performance is slow.

===Video===
This selection determines the level of visual detail Vega Strike projects to your monitor. These settings affect smoothness and rounding of objects, font style and anti-aliasing, sun halos, maximum texture size capability and whether reflection capability is available.
* '''Extreme Detail''' Highest detailing available including full smoothing, halo, texturing and reflection capability available. Cockpits can be activated. Only high end video cards can operate at this setting without affecting performance.
* '''Very High Detail''' The main difference is a large reduction in the level of visual detail.
* '''High Detail''' Further reduction in visual detail, and reduced lighting capability.
* '''Medium Detail''' Visual detail reduced with nebula fog disabled.
* '''Low Detail''' Reduced visual detail with no background detailing (black only) and cockpits no longer available. All script is in reduced font size with no color differentiation. Light reflection is disabled with no haloing effects.
* '''Retro Detail''' Lowest detail with no texture usage (wireframe only).

===Resolution===

This selection sets the Video Resolution for Vega Strike to use. Please note the larger the resolution, the greater the processing power is needed.

* '''512x384''' - {{Fixme}}
* '''640x480''' - xxx
* '''800x600''' - xxx
* '''1024x768''' - xxx
* '''1280x1024''' - xxx
* '''1600x1200''' - xxx

Only standard 4:3 resolutions are supported. Wide screens (3:2, 16:9, etc) will display stretched or pillarboxed depending on your local drivers. Multiple monitors are not supported.

===Per Pixel Lighting===
====Definitions====
*'''Separate Specular Color''' Vertex Lighting. Identifies the bright specular highlights that occur when light hits an object's surface and projects onto your ship's reflectivity analysis of the surface. In effect, you get a shine effect on an object that changes depending on where both the viewer and the sun is.
*''' Per Pixel Lighting''' Per-pixel lighting offers the ability to calculate lighting effects at the pixel level, greatly increasing precision and realism in a scene. In effect, making the lighting effects sharper, more defined. Per pixel specular lighting is best with a pixel shader - not truly necessary, but you suffer a big performance hit otherwise. GeForce3, Radeon 8500 and later video cards have this shader. Where game performance is slow or you have an older generation card, do not select an option with Per Pixel Lighting.
*'''Reflection''' Is an environment map (picture of background). This map is used where the visual mesh is declared to be specular and is projected onto your reflectivity analysis of the surface (your view). One result is that objects become capable of reflecting light and can act like a mirror surface.

====Options====
* '''No Specular Lighting''' - This option is suggested when game performance is slow.
** separate specular color: no
** per pixel lighting: no
** reflection: no
* '''Specular Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: no
* '''Specular Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: no
** per pixel lighting: yes
** reflection: no
* '''Reflective Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: yes
* '''Reflective Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: yes
** per pixel lighting: yes
** reflection: yes

===Color===
This selection determines whether the game uses full 32 bit color or the more limited 16 bit color range. It also determines whether the game runs in full screen mode (uses your whole screen limited by your resolution setting) or is windowed (appears as a window in your monitor allowing access other programs).
* '''32 bit Fullscreen''' - 32 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''16 bit Fullscreen''' - Reduced 16 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''32 bit Windowed''' - 32 bit color with the game viewed in a window.
* '''16 bit Windowed''' - Reduced 16 bit color with the game viewed in a window.

===Mouse===
====Definitions====
This selection determines your mouse control during flight operations. A mouse with multiple buttons default to the button selection below.

* '''button 0''' = Fire Weapon
* '''button 1''' = Fire Missile
* '''button 2''' = Afterburner
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticule)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''Mouse Warping''' "Drag to Steer". Your craft turns in the direction of the mouse movement, but the turn only continues while you mouse moves. To continue a turn, you need to continue scrolling your mouse in the desired direction.
* '''Inv Mouse Warp''' Inverts the direction of "Mouse Warping"
* '''Mouse Glide''' Provides a 'ghost' targeting reticle that is movable around the screen. When moved away from center, your ship will turn in the direction of the reticle. Recenter reticle to cease turning. This option does not require mouse scrolling to continue a turn.
* '''Inv Mouse Glide''' Inverts the up/down direction of "Mouse Glide"
* '''No Mouse''' No mouse flight.

===Mouse Cursor===
* '''Software Cursor''' - This should be the default setting. Cursor should appear at bases, and disappear in flight.
* '''Hardware Cursor''' - Select this option where the cursor is not appearing when at a base at all.

===Joystick===

====Definitions====
This selection configures your joystick for flight control. Joysticks can also be programmed by directly editing the <code>vegastrike.config</code> file recommended for advanced use only. Joysticks with multiple buttons default to the button selection below.

* '''x axis''' = changes direction of pitch. Imagine holding your arms out sideways from your body and your hands holding on to something. You then swing your feet up and down. You are rotating on your arms (x axis).
* '''y asis''' = changes direction of yaw. Imagine standing upright, then turning in place to the left or right.
* '''z axis''' = changes direction of roll. Imagine standing upright, holding on to a pole above you running from forwards to backwards. You then swing from left to right. You are 'rolling' around the pole.
* '''button 0''' = Fire Weapon
* '''button 1''' = Afterburner
* '''button 2''' = Fire Missile
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticle)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''No Joystick''' - No joystick flight enabled.
* '''2 Axis Joystick''' Enables a standard 2 axis (x,y) joystick with two buttons (0,1).
* '''2 Axis Joystick And Throttle''' - Enables movement in the x,y directions only. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''3 Axis Joystick''' - Enables movement in all three directions.
* '''3 Axis Joystick and Throttle''' - Enables movement in all three directions, plus the use of a throttle. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''Joystick and Throttle Reversed''' - Reverses the setting of third axis and throttle.

=[[Manual:Config:Advanced|Advanced configuration]]=
Instead of using the setup application you can edit the config file (<code>vegastrike.config</code>) directly. And you can add further options to the file so it is accessible from the setup application.

The pages below describe the various settings in the config file.
* [[Manual:Config:Advanced|Advanced configuration]]
** [[Manual:Config:Advanced:Bindings|Bindings]]
*** [[Manual:Config:Advanced:Bindings:Mouse|Mouse]]
*** [[Manual:Config:Advanced:Bindings:Joystick|Joystick]]
*** [[Manual:Config:Advanced:Bindings:Keyboard|Keyboard]]
** [[Manual:Config:Advanced:Variables|Variables]]

= See also =
* See [[Manual:Config:Advanced|Advanced Configuration]] for information about editing the config file (vegastrike.config) directly.

----
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
[[Category:Manual|Config]]
'''Bold text'''

Manual:Config

2010-09-29T02:19:57Z

Greenfreedom10: /* See also */ advanced configuration reference

{{Languages|En|Manual:Config}}
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
----
{{Fixme}} ''Add general description of the config file syntax+structure''

=The Setup Application=
<table style="float: top;"><tr><td>http://vegastrike.sourceforge.net/albums/wiki_manual/options.jpg</td></tr></table>

==Where to Find the Setup Application==

===MacOS X Users===
There is now a Vega Strike Setup.app application included.
* Click to open.
** If you do not have GTK and X11 installed then you will see a console interface with arrow keys.
** If you have GTK and X11, then you will be presented with the window seen here.
If it does not work:
* ctrl-clicking or right-clicking the Vega Strike application
* choose ''Show Package Contents''
* navigate to the Contents/Resources/data/ subdirectory.
* It's useful to drag an alias of this directory to your desktop while you're editing Vega Strike.

===Linux/Unix Users===
Configuration is accessed in three ways:
* Opening vslauncher and selecting GAME SETTINGS; OR
* By directly opening the file vssetup;
* Direct editing of the vegastrike.config file.
** There are multiple vegastrike.config files, the correct one to edit is located in a hidden home directory: ~/.vegastrike/vegastrike.config

===Windows Users===
Configuration is accessed in three ways:
* Run the program Launcher.exe and select GAME SETTINGS; OR
* Run directly by opening the file setup.exe (Setup in the Start Menu);
* Direct editing of the vegastrike.config file.

==Configuration Settings==

===Computer===
* '''<256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''256 Mb RAM'''
** Max Single Sounds: 5; Max Total Sounds: 16
** Systems retained in RAM: 2
** Old systems data saved for reuse: 2
* '''512 Mb RAM + 256 Mb Swap'''
** Max Single Sounds: 8; Max Total Sounds: 24
** Systems retained in RAM: 2
** Old systems data saved for reuse: 3
* '''512 Mb RAM + 1Gb Swap'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 4
* '''1024 Mb RAM'''
** Max Single Sounds: 12; Max Total Sounds: 32
** Systems retained in RAM: 3
** Old systems data saved for reuse: 15

===Optimized===
* '''Vertex Arrays''' Vertex (drawing) data is stored in an array (record). OpenGL need only call on the array, rather than execute every command in the array. In effect, OpenGL draws a starship each time one is needed - need five, draw five times.
* '''Compiled Vertex Arrays''' Vertex data in an array can be locked down when it is expected to be used multiple times. In effect, OpenGL does not recompute the locked array data until all surfaces using that data have been drawn. OpenGL copies a starship only when the vertex array is compiled ... if more than one ship is on screen then it will only need to download it the first time to the card.
* '''Display Lists''' This setting takes vertex commands and stores them for later execution - that is, define your drawing for multiple execution later. While vertex arrays can do this with a lesser amount of memory, display lists can operate faster. Graphics hardware may store display lists in dedicated memory, therefore increasing speed and efficiency, as well as offsetting the need for extra memory. So this setting will download a starship to the video card when the starship is drawn ... being much faster than copying it each time it is drawn. Recommend do not use this setting if you do not have a graphics hardware card.

===Difficulty===
* '''Decelerated Gameplay'''
** Game Speed is .5 normal
** Game Acceleration 1.0625x times normal
* '''Relaxing Gameplay'''
** Game Speed is normal
** Game Acceleration is normal
* '''Moderate Gameplay'''
** Game Speed is 2 times normal
** Game Acceleration is normal
* '''Hasty Gameplay'''
** Game Speed is 4 times normal
** Game Acceleration 0.9x normal
* '''Insane Gameplay'''
** Game Speed is 8 times normal
** Game Acceleration 0.96x normal
* '''Impossible Gameplay'''
** Game Speed is 16 times normal
** Game Acceleration 0.725x normal

===Sound===
* '''No Sound''' - No sound files played. This option is suggested when game performance is slow.
* '''My Sound Only''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Sound''' - AI sound is activated
* '''My Linux Sound''' - AI sound is deactivated; Only sound from you and your ship.
* '''All Linux Sound''' - AI sound is activated

===Music and Volume===
The initial setting for your music volume. This setting can be adjusted ingame.
* '''High Volume''' - To give you loud, dramatic music!
* '''Medium Volume''' - For enjoying the music but without it being intrusive.
* '''Low Volume''' - Suitable setting for having music playing in the background.
* '''Music Off''' - Does not load soundserver to play music. This option is suggested when game performance is slow.

===Video===
This selection determines the level of visual detail Vega Strike projects to your monitor. These settings affect smoothness and rounding of objects, font style and anti-aliasing, sun halos, maximum texture size capability and whether reflection capability is available.
* '''Extreme Detail''' Highest detailing available including full smoothing, halo, texturing and reflection capability available. Cockpits can be activated. Only high end video cards can operate at this setting without affecting performance.
* '''Very High Detail''' The main difference is a large reduction in the level of visual detail.
* '''High Detail''' Further reduction in visual detail, and reduced lighting capability.
* '''Medium Detail''' Visual detail reduced with nebula fog disabled.
* '''Low Detail''' Reduced visual detail with no background detailing (black only) and cockpits no longer available. All script is in reduced font size with no color differentiation. Light reflection is disabled with no haloing effects.
* '''Retro Detail''' Lowest detail with no texture usage (wireframe only).

===Resolution===

This selection sets the Video Resolution for Vega Strike to use. Please note the larger the resolution, the greater the processing power is needed.

* '''512x384''' - {{Fixme}}
* '''640x480''' - xxx
* '''800x600''' - xxx
* '''1024x768''' - xxx
* '''1280x1024''' - xxx
* '''1600x1200''' - xxx

Only standard 4:3 resolutions are supported. Wide screens (3:2, 16:9, etc) will display stretched or pillarboxed depending on your local drivers. Multiple monitors are not supported.

===Per Pixel Lighting===
====Definitions====
*'''Separate Specular Color''' Vertex Lighting. Identifies the bright specular highlights that occur when light hits an object's surface and projects onto your ship's reflectivity analysis of the surface. In effect, you get a shine effect on an object that changes depending on where both the viewer and the sun is.
*''' Per Pixel Lighting''' Per-pixel lighting offers the ability to calculate lighting effects at the pixel level, greatly increasing precision and realism in a scene. In effect, making the lighting effects sharper, more defined. Per pixel specular lighting is best with a pixel shader - not truly necessary, but you suffer a big performance hit otherwise. GeForce3, Radeon 8500 and later video cards have this shader. Where game performance is slow or you have an older generation card, do not select an option with Per Pixel Lighting.
*'''Reflection''' Is an environment map (picture of background). This map is used where the visual mesh is declared to be specular and is projected onto your reflectivity analysis of the surface (your view). One result is that objects become capable of reflecting light and can act like a mirror surface.

====Options====
* '''No Specular Lighting''' - This option is suggested when game performance is slow.
** separate specular color: no
** per pixel lighting: no
** reflection: no
* '''Specular Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: no
* '''Specular Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: no
** per pixel lighting: yes
** reflection: no
* '''Reflective Lighting'''
** separate specular color: yes
** per pixel lighting: no
** reflection: yes
* '''Reflective Per Pixel Lighting''' - Recommend a high end graphics card.
** separate specular color: yes
** per pixel lighting: yes
** reflection: yes

===Color===
This selection determines whether the game uses full 32 bit color or the more limited 16 bit color range. It also determines whether the game runs in full screen mode (uses your whole screen limited by your resolution setting) or is windowed (appears as a window in your monitor allowing access other programs).
* '''32 bit Fullscreen''' - 32 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''16 bit Fullscreen''' - Reduced 16 bit color viewed in a full screen. Note that eMac users might not be able to use this setting.
* '''32 bit Windowed''' - 32 bit color with the game viewed in a window.
* '''16 bit Windowed''' - Reduced 16 bit color with the game viewed in a window.

===Mouse===
====Definitions====
This selection determines your mouse control during flight operations. A mouse with multiple buttons default to the button selection below.

* '''button 0''' = Fire Weapon
* '''button 1''' = Fire Missile
* '''button 2''' = Afterburner
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticule)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''Mouse Warping''' "Drag to Steer". Your craft turns in the direction of the mouse movement, but the turn only continues while you mouse moves. To continue a turn, you need to continue scrolling your mouse in the desired direction.
* '''Inv Mouse Warp''' Inverts the direction of "Mouse Warping"
* '''Mouse Glide''' Provides a 'ghost' targeting reticle that is movable around the screen. When moved away from center, your ship will turn in the direction of the reticle. Recenter reticle to cease turning. This option does not require mouse scrolling to continue a turn.
* '''Inv Mouse Glide''' Inverts the up/down direction of "Mouse Glide"
* '''No Mouse''' No mouse flight.

===Mouse Cursor===
* '''Software Cursor''' - This should be the default setting. Cursor should appear at bases, and disappear in flight.
* '''Hardware Cursor''' - Select this option where the cursor is not appearing when at a base at all.

===Joystick===

====Definitions====
This selection configures your joystick for flight control. Joysticks can also be programmed by directly editing the <code>vegastrike.config</code> file recommended for advanced use only. Joysticks with multiple buttons default to the button selection below.

* '''x axis''' = changes direction of pitch. Imagine holding your arms out sideways from your body and your hands holding on to something. You then swing your feet up and down. You are rotating on your arms (x axis).
* '''y asis''' = changes direction of yaw. Imagine standing upright, then turning in place to the left or right.
* '''z axis''' = changes direction of roll. Imagine standing upright, holding on to a pole above you running from forwards to backwards. You then swing from left to right. You are 'rolling' around the pole.
* '''button 0''' = Fire Weapon
* '''button 1''' = Afterburner
* '''button 2''' = Fire Missile
* '''button 3''' = Target (cycle all available targets)
* '''button 4''' = Target (target nearest targeting reticle)
* '''button 5''' = Deceleration (decrease speed)
* '''button 6''' = Perform a Shelton Slide
* '''button 7''' = Acceleration (increase speed)
* '''button 8''' = Cycle through guns
* '''button 9''' = Cycle through missiles

====Options====
* '''No Joystick''' - No joystick flight enabled.
* '''2 Axis Joystick''' Enables a standard 2 axis (x,y) joystick with two buttons (0,1).
* '''2 Axis Joystick And Throttle''' - Enables movement in the x,y directions only. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''3 Axis Joystick''' - Enables movement in all three directions.
* '''3 Axis Joystick and Throttle''' - Enables movement in all three directions, plus the use of a throttle. Currently, throttle control gives acceleration and deceleration, not speed control. Result: set speed is either maximum or zero.
* '''Joystick and Throttle Reversed''' - Reverses the setting of third axis and throttle.

=[[Manual:Config:Advanced|Advanced configuration]]=
Instead of using the setup application you can edit the config file (<code>vegastrike.config</code>) directly. And you can add further options to the file so it is accessible from the setup application.

The pages below describe the various settings in the config file.
* [[Manual:Config:Advanced|Advanced configuration]]
** [[Manual:Config:Advanced:Bindings|Bindings]]
*** [[Manual:Config:Advanced:Bindings:Mouse|Mouse]]
*** [[Manual:Config:Advanced:Bindings:Joystick|Joystick]]
*** [[Manual:Config:Advanced:Bindings:Keyboard|Keyboard]]
** [[Manual:Config:Advanced:Variables|Variables]]

= See also =
* [[Manual:Config:Advanced|Advanced Configuration]]

----
{{NAV_Manual |
| previous=[[Manual:Save and load|Save and Load]]
| up=[[Manual]]
| next=[[Manual:Location|Locations]]
}}
[[Category:Manual|Config]]
'''Bold text'''

Manual:Config:Advanced:Variables

2010-09-29T02:11:58Z

Greenfreedom10: /* Configuration variables */

{{Languages|En|Manual:Config:Advanced:Variables}}
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
----
= Configuration variables =
{{Fixme}} ''<Variables>''
{{Fixme}} ''Syntax of the variables and where to put them.''

=="<code>data</code>" section==
* <code>'''hqtextures'''</code> [string] - enables the ''hqtextures'' directory

=="<code>Physics</code>" section==
* <code>'''collision_inertial_time'''</code> [float] - {{Fixme}}
** <code>1.25</code> (default)
* <code>'''game_speed'''</code> [float]- Changed by setup program, depends on difficulty setting.
** <code>1</code> (default)
* <code>'''game_speed_lying'''</code> [boolean] - {{Fixme}}
** <code>true</code>
** <code>false</code> (default)
* <code>'''reduce_beam_ammo'''</code> [boolean] - If set, beam weapons with ammo will expend it (currently only Jackhammer).
** <code>true</code>
** <code>false</code> (default)
* <code>'''gun_speed_adjusted_game_speed'''</code> [boolean] - Turns on a correction of <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]] for all weapons toward the medium values (for <code>'''gun_speed'''</code>=1 <code>speed</code> <1000 is raised, otherwise lowered; <code>range</code> dropped to 1/8 of the value in <code>weapon_list.xml</code>).
** <code>true</code> (in default vegastrike.config)
** <code>false</code> (default)
* <code>'''gun_speed'''</code> [float] - The adjustment factor for weapons' <code>speed</code> and <code>range</code> [[HowTo:Make_Weapons|attributes]]. Both values are multiplied by this if <code>'''gun_speed_adjusted_game_speed'''</code>=<code>false</code>, otherwise adjustments are more complex.
** <code>1</code> (default)
* <code>'''special_and_normal_gun_combo'''</code> [boolean] - If set, the weapon group of all guns including "Special" ones can be toggled when cycling through guns.
** <code>true</code> (default)
** <code>false</code>

=="<code>graphics</code>" section==
* <code>'''head_lag'''</code> [integer] - Head lag (in frames). When you turn, the cockpit is displayed as if you were overcoming the inertia of the turn. This value determines how much this 'overcoming' is in frames. Practically it affects how much the cockpit is shifted on-screen.
** <code>10</code> (default)
* <code>'''pan_on_auto'''</code> [boolean] - Sets if there should be an camera switch + flyby on autopilot activation. {{Fixme}} ''No longer used?''
** <code>true</code> (default)
** <code>false</code>
* <code>'''shake_speed'''</code> [float] - {{Fixme}}
** <code>50</code> (default)
* <code>'''shake_reduction'''</code> [float] - Cockpit shake reduction amount.
** <code>8</code> (default)
* <code>'''shove_camera_down'''</code> [float] - {{Fixme}}
** <code>.3</code> (default)
* <code>'''shield_texture'''</code> [string/file] - Shield effect texture, expected to be in the textures directory. It is alpha blended, so blackness = transparency in-game.
** <code>shield.bmp</code> (default)
* <code>'''reflectivity'''</code> [float] - {{Fixme}} ''What does the next line mean?''
** <code>.2</code> (default): (0.0-1.0) default reflection level (1.0 = very shiny).
* <code>'''star_shine'''</code> [string/file] - List of .ani files for a sun's flare effect separated by single spaces.
** <code>shine.ani</code> (default)
* <code>'''num_messages'''</code> [float] - Sets the maximum number of communication messages shown at the same time.
** <code>2</code> (default)
* <code>'''last_message_time'''</code> [float] - Sets the minimum time (in seconds) that a message is shown before scrolled up.
** <code>5</code> (default)
* <code>'''camera_pan_speed'''</code> [float, default:0.0001] - sets the speed of camera panning and yawing
* <code>'''draw_arrow_to_target'''</code> [boolean, default:true] - generally toggles the display of target arrow for all cameras
* <code>'''draw_arrow_on_chasecam'''</code> [boolean, default:true] - disables/enables target arrow display on chase camera (default key '5')
* <code>'''draw_arrow_on_pancam'''</code> [boolean, default:false] - disables/enables target arrow display on pan camera (default key '6')
* <code>'''draw_arrow_on_pantgt'''</code> [boolean, default:false] - disables/enables target arrow display on target camera (default key '8')
* <code>'''draw_unit_on_chasecam'''</code> [boolean, default:true] - disables/enables own vessel display on chase camera (default key '5')
* <code>'''weapon_gamma'''</code> [float] - affects all weapon effects' [[HowTo:Make_Weapons|appearance]], if >0.
** <code>1.35</code> (default)
* <code>'''StretchBolts'''</code> [float] - If > 0, Bolts (only) will appear stretched to this fraction of the distance they traveled since the last calculation - i.e. if set to 1, a bolt's tail will be where its head was in the previous frame, its own Length being compensated for.
** <code>0</code> (default)
* <code>'''draw_weapons'''</code> [boolean] - Whether to draw mounts.
** <code>true</code>
** <code>false</code> (default)

=="<code>hud</code>" section==
* <code>'''radarType'''</code>
** <code>WC</code> (default) - Display two radars in the bottom screen. The left one is the front radar, the right one is the rear radar.
** <code>Elite</code> - Display only one radar. Units are displayed with a dot and a vertical line. Units are projected on a horizontal plane (from your ship view). The dot is the position of the unit on that plane, and the height of the line is the height of the unit above/below that plane. Does not seem to work (on 3rd March 2004).
* <code>'''min_target_box_size'''</code>
** <code>.01</code> (default) - Minimum target box size.
* <code>'''DrawTargettingBoxes'''</code>
** <code>true</code> (default) - Enable box display. Allow <code>drawAllTargetBoxes</code>, <code>drawLineToTarget</code>, <code>drawLineToTargetsTarget</code>, <code>drawAlwaysITTS</code> .
** <code>false</code> - Does not display any target box or docking box.
* <code>'''drawAllTargetBoxes'''</code>
** <code>true</code> - Display every units in boxes (not planets, jumps).
** <code>false</code> (default) - Does not display units in boxes except the selected one.
* <code>'''drawLineToTarget'''</code>
** <code>true</code> - Draw a line between your ship and the selected target. Allow drawLineToTargetsTarget. Does not seem to work (on 4rd March 2004).
** <code>false</code> - Disable the line.
* <code>'''drawLineToTargetsTarget'''</code>
** <code>true</code> - Disable the line.
** <code>false</code> - Draw a line between your target and the target of your target. Does not seem to work (on 4th March 2004).
* <code>'''drawLineToITTS'''</code>
** <code>true</code> - Draw [[Terminology:ITTS|ITTS]] line.
** <code>false</code> (default) - {{Fixme}}
* <code>'''drawAlwaysITTS'''</code>
** <code>true</code> - Force [[Terminology:ITTS|ITTS]] drawing.
** <code>false</code> (default) - {{Fixme}}
* <code>'''DrawTheirRelationColor'''</code> - Determines the box color of the selected target.
** <code>true</code> (default) - The box color corresponds to the target relation towards you.
** <code>false</code> - The box color corresponds to your relation towards the target.
* <code>'''drawNavSymbol'''</code> - Does not seem to work (on 7th March 2004). {{Fixme}}
** <code>true</code> - {{Fixme}}
** <code>false</code> (default) - {{Fixme}}

=="<code>joystick</code>" section==
* <code>'''mouse_cursor'''</code> - This parameter is set to <code>true</code> when [Mouse glide] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse glide]. When enabled, <code>warp_mouse</code> must be set to <code>false</code>.
** <code>false</code> (default) - Set when no mouse support is required or when <code>warp_mouse</code> is set to <code>true</code>.
* <code>'''mouse_cursor_chasecam'''</code> [default:true] (false, true) - disables/enables cursor display on chase camera (default key '5')
* <code>'''mouse_cursor_pancam'''</code> [default:false] (false, true) - disables/enables cursor display on pan camera (default key '6')
* <code>'''mouse_cursor_pantgt'''</code> [default:false] (false, true) - disables/enables cursor display on target camera (default key '8')

* <code>'''mouse_crosshair'''</code> - Mouse cursor appearance when [Mouse glide] is selected (when <code>mouse_cursor</code> is <code>true</code>).
* '''<code>crosshairs.spr</code>''' (default) - If <code>mouse_cursor</code> is <code>true</code>, this file contains the image to be used as cursor. This file must be located in the <code>./sprites</code> directory. See the .spr file format [[HowTo:Edit HUDs]].
* <code>'''warp_mouse'''</code> This parameter is set to true when [Mouse warp] control is selected in setup.
** <code>true</code> - In-flight control using [Mouse warp]. When enabled, mouse_cursor must be set to false.
** <code>false</code> - Set when no mouse support is required or when mouse_cursor is set to true.
** Note: if no in-flight mouse control is needed, both mouse_cursor and warp_mouse must be set to false.
* <code>'''reverse_mouse_spr'''</code> Used when [Mouse glide] control is selected in setup (see mouse_cursor).
** <code>true</code> (default) - Invert vertical mouse axis.
** <code>false</code> - Does not invert vertical mouse axis.
* <code>'''draw_rendered_crosshairs'''</code>
** <code>true</code> (default) - Draw basic crosshairs using lines whatever the cockpit type is.
** <code>false</code> - Use a sprite to draw the hud crosshairs. See cockpit file format [[HowTo:Edit HUDs]]. Each cockpit type might have its own crosshairs.
* <code>'''draw_vdus_from_chase_cam'''</code>
** <code>true</code> - Display the hud when chase view is active.
** <code>false</code> (default) - does not display the hud when chase view is active.
* <code>'''draw_vdus_from_panning_cam'''</code>
** <code>true</code> - Display the hud when panning view is active.
** <code>false</code> (default) - Does not display the hud when panning view is active.
* <code>'''draw_vdus_from_target_cam'''</code>
** <code>true</code> - Display the hud when target view is active.
** <code>false</code> (default) - does not display the hud when target view is active.

=="<code>cockpitaudio</code>" section==
This section contains names of wave files that happen on these events.

= Example =
{{Fixme}} ''Insert a very short example code showing a variable definition (and subsections).''

= See also =
For a complete list of ''vegastrike.config'' variables visit [[CONFVAR]]

----
{{NAV_Manual |
| previous=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
| up=[[Manual:Config:Advanced|Config:Advanced]]
| next=[[Manual:Config:Advanced|Config:Advanced]]
}}
[[Category:Manual|Config:Advanced:Variables]]

Manual:Config:Advanced:Colors

2010-09-29T02:11:48Z

Greenfreedom10: stub

= Configuration variables =
{{Fixme}} ''<Colors>''
{{Fixme}} ''Syntax of the color section variables and where to put them.''

Manual:Config:Advanced

2010-09-29T02:09:59Z

Greenfreedom10: /* Advanced configuration */ added colors section to match config file

{{Languages|En|Manual:Config:Advanced}}
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
----
{{Fixme}} ''Add general description of the config file syntax+structure''

=Advanced configuration=

See the specific sections inside the config file:
* [[Manual:Config:Advanced:Bindings|Bindings]]
* [[Manual:Config:Advanced:Colors|Colors]]
* [[Manual:Config:Advanced:Variables|Variables]]

= Example =
{{Fixme}} ''Insert a very short example code showing the layout of a complete config file.''

= See also =

----
{{NAV_Manual |
| previous=[[Manual:Config|Config]]
| up=[[Manual:Config|Config]]
| next=[[Manual:Config:Advanced:Bindings|Config:Advanced:Bindings]]
}}
[[Category:Manual|Config:Advanced]]