Difference between revisions of "Carrec"

From GTAMods Wiki
Jump to navigation Jump to search
(R3 file structure)
Line 2: Line 2:
 
Original San Andreas installation has 426 R3 paths. Maximum number of these paths is 475.
 
Original San Andreas installation has 426 R3 paths. Maximum number of these paths is 475.
  
==R3 file structure==
+
== The RRR file structure ==
 
An R3 file (<code>.rrr</code>) contains no header, only a binary data, being a set of structures of 32 bytes in length each, described separate path points. The data in each checkpoint structure goes as the following:
 
An R3 file (<code>.rrr</code>) contains no header, only a binary data, being a set of structures of 32 bytes in length each, described separate path points. The data in each checkpoint structure goes as the following:
  
Line 47: Line 47:
 
|}
 
|}
  
When the vehicle is moving along the path, its [[XYZ]] structure is filled with the information from the proper fields of checkpoint data.
+
When the vehicle is moving along the path, its XYZ structure is filled with the information from the proper fields of checkpoint data.
  
 
==Mission Script==
 
==Mission Script==
Line 78: Line 78:
 
[[SYNCH_RECORDING_WITH_WATER]]<br>
 
[[SYNCH_RECORDING_WITH_WATER]]<br>
  
==List==
+
== List of paths in San Andreas==
 
The following is a list of paths defined in the <code>carrec.img</code> file.
 
The following is a list of paths defined in the <code>carrec.img</code> file.
{|
+
{| {{Prettytable}} class="collapsible"
 
! ID
 
! ID
 
! Description
 
! Description
Line 281: Line 281:
 
More to come soon. The last ID is 834.
 
More to come soon. The last ID is 834.
  
==External Links==
+
{{incomplete}}
*[http://sannybuilder.com/files/R3D.rar R3D v0.2] - the .RRR-files editor by Sanchez (SA and GTA 4 supported).
 
*[http://cleo.sannybuilder.com/scripts/carrec.rar Carrec.cs] - a [[CLEO]]-script to generate an .rrr file directly in the game, made by [[User:Seemann|Seemann]]
 
*[http://www.gtaforums.com/index.php?showtopic=297295 The R3 format explanation] @ GTAForums.com
 
  
{{GTA4-navi}}
+
== External Links ==
{{Sa-navi|state=collapsed}}
+
* [http://sannybuilder.com/files/R3D.rar R3D v0.2] - the .RRR-files editor by Sanchez (SA and GTA 4 supported).
 +
* [http://cleo.sannybuilder.com/scripts/carrec.rar Carrec.cs] - a [[CLEO]]-script to generate an .rrr file directly in the game, made by [[User:Seemann|Seemann]]
 +
* {{GTAF|297295|The R3 format explanation}}
  
[[Category:Map Formats]][[Category:GTA SA]][[Category:GTA 4]][[Category:File Formats]]
+
 
 +
{{GTA4-navi|state=autocollapse}}
 +
{{SA-navi|state=autocollapse}}
 +
 
 +
[[Category:Map Formats]][[Category:File Formats]]

Revision as of 08:29, 30 January 2009

The carrec.img file stores a set of R3 files (files with an extension .rrr). These files contain path information used by the mission script for San Andreas and GTA 4. The paths are predefined and look unnatural during gameplay because the movement of the vehicle is very rigid. The paths ignore many stuff in the game including gravity and obstacles. Original San Andreas installation has 426 R3 paths. Maximum number of these paths is 475.

The RRR file structure

An R3 file (.rrr) contains no header, only a binary data, being a set of structures of 32 bytes in length each, described separate path points. The data in each checkpoint structure goes as the following:

OFFSET TYPE DESCRIPTION
00 dword time
04 word velocity in direction X * 16383.5
06 word velocity in direction Y * 16383.5
08 word velocity in direction Z * 16383.5
10 byte XYZ.right.x * 127.0
11 byte XYZ.right.y * 127.0
12 byte XYZ.right.z * 127.0
13 byte XYZ.top.x * 127.0
14 byte XYZ.top.y * 127.0
15 byte XYZ.top.z * 127.0
16 byte Steering Angle * 20.0
17 byte Gas Pedal Power * 100.0
18 byte Break Pedal Power * 100.0
19 byte Handbrake used flag
20 float XYZ.pos.x
24 float XYZ.pos.y
28 float XYZ.pos.z
32 end

When the vehicle is moving along the path, its XYZ structure is filled with the information from the proper fields of checkpoint data.

Mission Script

San Andreas

You can use the following opcodes to do stuff to your paths.
07C0 - Loads the path
07C1 - Checks if the path has been loaded
0873 - Releases the path from memory
05EB - Assigns a vehicle to the path
0705 - Assigns a vehicle to the path
085E - Assigns a vehicle to a looped path
05EC - Releases the vehicle from a path
05ED - Freezes the vehicle along the path
05EE - Unfreezes the vehicle along the path
06FD - Sets the speed multiplier of the vehicle along the path
0706 - Advances the vehicle along the path
060E - Checks if a path is assigned to the vehicle
If you load a non-existant path to a vehicle, path 1 will be loaded instead.

GTA 4

Use the following native functions:
REQUEST_CAR_RECORDING
HAS_CAR_RECORDING_BEEN_LOADED
REMOVE_CAR_RECORDING
FIND_POSITION_IN_RECORDING
FIND_TIME_POSITION_IN_RECORDING
GET_POSITION_OF_CAR_RECORDING_AT_TIME
GET_TOTAL_DURATION_OF_CAR_RECORDING
SET_RECORDING_TO_POINT_NEAREST_TO_COORS
SYNCH_RECORDING_WITH_WATER

List of paths in San Andreas

The following is a list of paths defined in the carrec.img file.

ID Description
1 Driving School The 360
2 Driving School The 180
3 Unused Driving School unknown test
4 Driving School Whip and Terminate
5 Driving School Pop and Control
7 Driving School Burn and Lap
9 Driving School Cone Coil
10 Driving School The '90'
11 Driving School Wheelie Weave
13 Driving School Spin and Go
14 Driving School P. I. T. Maneuver
15 Driving School Alley Oop
16 Driving School City Slicking
21 Unused Test Drive Cesar's Savanna, most likely used in beta version of game
22 House Party Sweet's Greenwod
23 House Party GSF's Voodoo
24 Unused path, could have been used in Big Smoke, most likely used in beta version of game
25 The Da Nang Thang Triad's Maverick
27 Pier 69 enemy's Pony
28 Pier 69 Toreno's helicopter
30 OG Loc Freddy's PCJ 600 path 1 (beginning)
31 OG Loc Freddy's PCJ 600 path 2
32 OG Loc Freddy's PCJ 600 path 3
33 OG Loc Freddy's PCJ 600 path 4
34 OG Loc Freddy's PCJ 600 path 5
35 OG Loc Freddy's PCJ 600 path 6
36 OG Loc Freddy's PCJ 600 path 7
37 OG Loc Freddy's PCJ 600 path 8
38 OG Loc Freddy's PCJ 600 path 9
39 OG Loc Freddy's PCJ 600 path 10
40 OG Loc Freddy's PCJ 600 path 11 (end)
41 unused Los Santos to San Fierro AT 400, most likely used in beta version of game
42 Los Santos to San Fierro AT 400
43 Las Venturas to San Fierro AT 400
44 San Fierro to Las Venturas AT 400
46 Los Santos to Las Venturas AT 400
48 Las Venturas to Los Santos AT 400
49 San Fierro to Los Santos AT 400
50 OG Loc highway NPC 1
51 OG Loc highway NPC 2
52 OG Loc highway NPC 3
53 OG Loc highway NPC 4
54 OG Loc highway NPC 5
55 OG Loc highway NPC 6
56 OG Loc highway NPC 7
57 OG Loc highway NPC 8
58 OG Loc highway NPC 9
59 OG Loc highway NPC 10
60 OG Loc highway NPC 11
65 Test Drive Cesar's Elegy path enter alley
66 Test Drive cop 1 path enter alley
67 Test Drive cop 2 path enter alley
70 Test Drive Tram path 1
71 Test Drive outside Otto's Autos NPC 1
72 Test Drive outside Otto's Autos NPC 2
73 Test Drive outside Otto's Autos NPC 3
74 Test Drive outside Otto's Autos NPC 4
75 Test Drive outside Otto's Autos NPC 5
76 Test Drive outside Otto's Autos NPC 6
77 Test Drive Tram path 2
78 Test Drive Tram path 3
79 Test Drive Cesar's Elegy path 1
80 Test Drive Tram path 3
81 Test Drive Cesar's Elegy path 2
82 Unused Test Drive path

More to come soon. The last ID is 834.

This section is incomplete. You can help by fixing and expanding it.

External Links