Difference between revisions of "01C3"
(todo: make lists instead) |
|||
| Line 3: | Line 3: | ||
'''Description''' | '''Description''' | ||
: Removes references to a vehicle | : Removes references to a vehicle | ||
| − | ''' | + | '''Syntax''' |
| − | + | : 01C3: [''car handle''] | |
| − | + | : Car.RemoveReferences( [''car handle''] ) | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
'''Parameter''' | '''Parameter''' | ||
: [''car handle''] | : [''car handle''] | ||
| Line 22: | Line 13: | ||
This opcode will mark the vehicle as no longer needed. The vehicle will no longer be remembered by the game and treated similarly to traffic vehicles. If you want your vehicle to disappear after it is destroyed or after you are finished with it, use this opcode to make it into a traffic vehicle so it will disappear like a traffic vehicle. This opcode should be used if the vehicle is spawned ([[00A5]], etc.) or grabbed from the streets ([[0327]], etc.). This opcode should not be used for other cases ([[03C0]], etc.). Using this with disregard will cause problems with other scripts trying to recognize a nonexistent vehicle. | This opcode will mark the vehicle as no longer needed. The vehicle will no longer be remembered by the game and treated similarly to traffic vehicles. If you want your vehicle to disappear after it is destroyed or after you are finished with it, use this opcode to make it into a traffic vehicle so it will disappear like a traffic vehicle. This opcode should be used if the vehicle is spawned ([[00A5]], etc.) or grabbed from the streets ([[0327]], etc.). This opcode should not be used for other cases ([[03C0]], etc.). Using this with disregard will cause problems with other scripts trying to recognize a nonexistent vehicle. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
== Example == | == Example == | ||
Revision as of 06:48, 16 August 2011
Description
- Removes references to a vehicle
Syntax
- 01C3: [car handle]
- Car.RemoveReferences( [car handle] )
Parameter
- [car handle]
- The handle of a vehicle; vehicle does not have to exist
Native analog
This opcode will mark the vehicle as no longer needed. The vehicle will no longer be remembered by the game and treated similarly to traffic vehicles. If you want your vehicle to disappear after it is destroyed or after you are finished with it, use this opcode to make it into a traffic vehicle so it will disappear like a traffic vehicle. This opcode should be used if the vehicle is spawned (00A5, etc.) or grabbed from the streets (0327, etc.). This opcode should not be used for other cases (03C0, etc.). Using this with disregard will cause problems with other scripts trying to recognize a nonexistent vehicle.
Example
The following example, using Sanny Builder, will spawn a Pony close to the player character. A number is displayed on the screen to show the existence of the Pony; 0 means it does not exist and 1 means it does. Pressing the CAMERA key will mark the Pony as no longer needed. After that, if left alone, the Pony will disappear like normal traffic vehicles.
// set constants
const
SPAWNED_CAR = 0@
X_POS = 1@
Y_POS = 2@
Z_POS = 3@
PONY_EXISTS = 4@
CAR_MODEL = #PONY
end
// spawn pony
0247: request_model CAR_MODEL
repeat
wait 0
if
0248: model CAR_MODEL available
then
break
end
until false
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
X_POS += 4.0
00A5: SPAWNED_CAR = create_car CAR_MODEL at X_POS Y_POS Z_POS
0249: release_model CAR_MODEL
PONY_EXISTS = true // pony exists
// check the existence of and remove references to pony
while true
wait 10
if
00E1: key_pressed 0 13 // camera key
then
01C3: remove_references_to_car SPAWNED_CAR
end
if
0119: car SPAWNED_CAR wrecked
then
PONY_EXISTS = false // pony does not exist
end
// display existence of pony as a number onscreen
01E5: text_1number_highpriority 'NUMBER' PONY_EXISTS 10 ms 1
endKeywords
remove, cleanup, reference, references, car, vehicle
