speed-dreams-code/doc/userman/how_to_drive.html

<!--
        file        : how_to_drive.html
        created     : Fri Aug  12 13:39:11 CET 2005
        copyright   : (C) 2005 by Eric Espie
        email       : torcs@free.fr
        version     : $Id: how_to_drive.html,v 1.1 2006/10/06 00:19:22 berniw Exp $

        Permission is granted to copy, distribute and/or modify this document
        under the terms of the GNU Free Documentation License, Version 1.2
        or any later version published by the Free Software Foundation;
        with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
        Texts.  A copy of the license is available at http://www.gnu.org/copyleft.
-->
	
	<h1>I want to drive!</h1>
	
	<p>
		Here is the manual for the players who want to drive in TORCS <b>1.3.0</b>.
	</p>
	
	<p>
		First of all you should install and run TORCS, for that see the
		<a href="http://torcs.org/sections.php?op=viewarticle&artid=3">installation manual</a>.
		After that you can drive a car with a joystick or a steering wheel, or the mouse or keyboard.
		To configure the player, go to the Player's Configuration menu.
	</p>
	
	<p>
		<img src="images/torcs-1.jpg">
	</p>
	
	<p>
		<img src="images/torcs-3.jpg">
	</p>
	
	<p>
		To select a player to configure, click in the "Players" zone on a player's name 
		or on "--- empty ---" if you want to create a new player. To delete a player, select it
		then use the "delete" button.
	</p> 
	
	<p>
		<img src="images/torcs-2.jpg">
	</p>
	
	<p>
		Here we have selected the player named "Player". In order to change its name,
		click in the "name" field and edit it. If you do not want to come back later to change
		the car create multiple players with different cars, this can safe quite some time.
	</p>
	
	<p>
		<img src="images/torcs-4.jpg">
	</p>
	
	<p>
		This configuration screen is also used to:
		<ul>
			<li>select the player's car:
				<ol>
					<li>First select the car's category you want:
						<ul>
							<li><b>Track-RWD-GrA</b>: Track rear wheel drive cars with more than 500 hp</li>
							<li><b>Track-RWD-GrB</b>: Track rear wheel drive cars with less than 500 hp</li>
							<li><b>Track-4WD-GrB</b>: Track all wheel drive cars with less than 500 hp</li>
							<li><b>Track-FWD-GrB</b>: Track front wheel drive cars with less than 500 hp</li>
							<li><b>Historic</b>: 60-70's cars</li>
							<li><b>Nascar</b>: Nascar cars</li>
							<li><b>Offroad-4WD-GrA</b>: Off-road all wheel drive cars (rally cars)</li>
							<li><b>Offroad-RWD-GrA</b>: Off-road rear wheel drive cars</li>
						</ul>
					</li>
					<li>Then select you car within the category.</li>
				</ol>
			</li>
			<li>Select the transmission mode (automatic or manual)</li>
			<li>Program the number of pit stops you want for the race, so the initial fuel amount is adjusted accordingly.</li>
			<li>Change the player's skill level:
				<ul>
					<li><b>Rookie</b>: no dammage (0%)- high traction (+40%)</li>
					<li><b>Amateur</b>: small damages (50%) - high traction (+35%)</li>
					<li><b>Semi-Pro</b>: normal damages (80%) - medium traction (+30%)</li>
					<li><b>Pro</b>: high damages (100%) - low traction (+0%)</li>
				</ul>
			</li>
			<li>Select the auto reverse function (engage automatically the reverse gear when the car is stopped and you continue to brake).</li>
			<li>Configure the controls</li>
		</ul>
	</p>
	
	
	
	<p>
		The player's control configuration is explained on next screen.
	</p>
	
	<!--pagebreak-->	
	
	<h1>Player's Control Configuration</h1>
	
	<p>
		To configure the controls click on the "Controls" button
	</p>
	
	<p>
		<img src="images/torcs-6.jpg">
	</p>
	
	<p>
		Now, click on the control you want to change
	</p>
	
	<p>
		<img src="images/torcs-7.jpg">
	</p>
	
	<p>
		And press the key you want to use to that control, or even move the mouse to use
		the mouse to control the car
	</p>
	
	<p>
		<img src="images/torcs-8.jpg">
	</p>
	
	<p>
		If your joystick is configured, you can also move the joystick to use it for that control.
		See <a href="http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/">the Vojtech Pavlik's joystick
		driver site</a> for more information on how you can have your joystick work under Linux.
		(see also <a href="http://www.icculus.org/lgfaq">Linux Gamers FAQ</a>).
	</p>
	
	<p>
		<img src="images/torcs-9.jpg">
	</p>
	
	<p>
		Proceed with all the controls you want to configure (you can also use joystick buttons),
		and calibrate the joystick. Beware, before you enter the calibration screen the axis
		should be centred.
	</p>
	
	<p>
		<img src="images/torcs-10.jpg">
	</p>
	
	<p>
		Then follow the calibration instructions
	</p>
	
	<p>
		<img src="images/torcs-11.jpg">
	</p>
	
	<p>
		When the calibration is done, press the "back" button. If something went wrong
		during the calibration process, don't panic, use the "reset" button to start over
		the calibration.
	</p>
	
	<p>
		<img src="images/torcs-12.jpg">
	</p>
	
	<p>
		You'll have to save the configuration before exiting
	</p>
	
	<p>
		<img src="images/torcs-13.jpg">
	</p>
	
	<!--pagebreak-->
	<h1>General Configuration Options</h1>
	
	<p>
		You can configure general options using the "Options" menu
	</p>
	
	<p>
		<img src="images/torcs-20.jpg">
	</p>
	
	<p>The Graphic parameters are located in the "Graphic" menu</p>
	<p>
		<img src="images/torcs-21.jpg">
	</p>
	
	<p>The following parameters are customisable:</p>
	<ul>
	<li><b>Visibility</b>: The depth of view factor (>0) can be reduced on less powerful systems or increased on more powerfull systems, you can go beyond 100%</li>
	<li><b>Smoke</b>: The number of smokes per car (>=0) can be reduced on less powerful systems or increased on more powerfull systems</li>
	<li><b>Skid Marks</b>: The number of skid marks per car (>=0) can be reduced on less powerful systems or increased on more powerful systems</li>
	<li><b>LOD Factor</b>: The cars LOD (Level Of Detail) threshold (>=0.0) can be reduced on less powerful systems or increased on more powerfull systems</li>
	</ul>
	
	<p>
		<img src="images/torcs-22.jpg">
	</p>
	
	<p>
		The display configuration is done in the "Display" menu
	</p>
	
	<p>
		<img src="images/torcs-23.jpg">
	</p>
	
	<p>
		You can adjust the screen resolution, the colour depth and the display mode
		(windowed or fullscreen) then apply to validate the modifications. <b>Note:</b> If the program
		does not start with the parameters you have chosen, don't panic, you just edit the
		"config/screen.xml" file and reset the values to a more conservative choice.
	</p>
	
	<p>
		<img src="images/torcs-24.jpg">
	</p>
	
	<p>
		If you are experiencing problems with the mouse cursor, you can try to launch TORCS with the option "-m".
		And if you have texture problems, you can try the "-s" option to run in single texture mode.
	</p>
	
	<!--pagebreak-->
	
	<h1>Racing</h1>
	
	<p>
		Go to the racing menu:
	</p>
	
	<p>
		<img src="images/torcs-30.jpg">
	</p>
	
	<p>
		Select one of the type of race:
	</p>
	
	<p>
		<img src="images/torcs-31.jpg">
	</p>
	
	<p>
		Configure it:
	</p>
	
	<p>
		<img src="images/torcs-32.jpg">
	</p>
	
	<p>
		Select the track:
	</p>
	
	<p>
		<img src="images/torcs-33.jpg">
	</p>
	
	<p>
		Select the drivers:
	</p>
	
	<p>
		<img src="images/torcs-34.jpg">
	</p>
	
	<p>
		Save the parameters:
	</p>
	
	<p>
		<img src="images/torcs-35.jpg">
	</p>
	
	<p>
		Configure the race length:
	</p>
	
	<p>
		<img src="images/torcs-36.jpg">
	</p>
	
	<p>
		Launch the race:
	</p>
	
	<p>
		<img src="images/torcs-37.jpg">
	</p>
	
	<!--pagebreak-->	
	
	<h1>Gentlemen Start Your Engine</h1>
	
	<p>
		<img src="images/torcs-40.jpg">
	</p>
	
	<p>
		Press <b>F2</b> to cycle through the driver views:
	</p>
	
	<p>
		<img src="images/torcs-41.jpg">
	</p>
	
	<p>
		<img src="images/torcs-42.jpg">
	</p>
	
	<p>
		<img src="images/torcs-43.jpg">
	</p>
	
	<p>
		Press <b>F1</b> to get the help about all the commands:
	</p>
	
	<p>
		<img src="images/torcs-42.jpg">
	</p>
	
	<p>
		<img src="images/torcs-43.jpg">
	</p>
	
	<p>
		Press <b>F1</b> to get the help about all the commands. Beware, most views, camera and the
		map keys are "modal", so if you hit them multiple times you will get different variations
		of the view/camera/map.
	</p>
	
	<p>
		<img src="images/torcs-44.jpg">
	</p>
	
	<h1>Now drive as fast as you can...</h1>