Difference between revisions of "0129"
Jump to navigation
Jump to search
(New page: {{OpCode | ini = 0129=4,%4d% %2d% %3o% %1d% | description = Creates a character in the driver seat of a vehicle | p1 = Existing vehicle handle | p2 = Ped type...) |
|||
| Line 1: | Line 1: | ||
| − | {{ | + | {{Icon|trilogy}} |
| − | + | <hr /> | |
| − | + | '''Description''' | |
| − | + | : Spawns a character in the driver seat of a vehicle | |
| − | + | '''Syntax''' | |
| − | + | : 0129: [''var''] = create_actor_pedtype [''int1''] model [''int2''] in_car [''car handle''] driverseat | |
| − | + | '''Parameter''' | |
| − | + | : [''var''] | |
| − | + | :: Variable to store the handle of the character | |
| − | + | : [''int1''] | |
| − | + | :: [[Ped type]] | |
| − | [[ | + | : [''int2''] |
| + | :: Valid character model ID number as defined in the [[PEDS|PEDS section]] of the [[IDE]] file; also acceptable is model's [[DFF]] name with a hash character | ||
| + | : [''car handle''] | ||
| + | :: The handle of the vehicle | ||
| + | '''Native analog''' | ||
| + | : [[CREATE_CHAR_INSIDE_CAR]] | ||
| − | + | This opcode spawns a character in the driver seat of a vehicle. Using this opcode requires an existing vehicle and opcode [[0247]] to load the character model or else the game could crash. | |
| − | |||
| − | |||
| − | |||
| − | ==Keywords== | + | == Example == |
| − | create, actor, character, pedtype, model, vehicle, car, driver | + | :''See also: [[Spawn a ped]]'' |
| + | The following example, using Sanny Builder, will spawn a ped in a car close to the player character. | ||
| + | <source lang="scm"> | ||
| + | // set constants | ||
| + | const | ||
| + | CHAR_MODEL = #BFORI | ||
| + | CAR_MODEL = #PONY | ||
| + | CHAR_HANDLE = 0@ | ||
| + | CAR_HANDLE = 1@ | ||
| + | X_POS = 2@ | ||
| + | Y_POS = 3@ | ||
| + | Z_POS = 4@ | ||
| + | end | ||
| + | |||
| + | // load model, required to prevent unnecessary crash! | ||
| + | 0247: request_model CHAR_MODEL | ||
| + | 0247: request_model CAR_MODEL | ||
| + | // check if model is loaded | ||
| + | repeat | ||
| + | wait 0 | ||
| + | if and | ||
| + | 0248: model CHAR_MODEL available | ||
| + | 0248: model CAR_MODEL available | ||
| + | then | ||
| + | break | ||
| + | end | ||
| + | until false | ||
| + | // spawn car | ||
| + | 00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS | ||
| + | X_POS += 4.0 | ||
| + | 00A5: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS | ||
| + | // spawn character | ||
| + | 0129: CHAR_HANDLE = create_actor_pedtype 4 model CHAR_MODEL in_car CAR_HANDLE driverseat | ||
| + | // cleanup | ||
| + | 0249: release_model CHAR_MODEL | ||
| + | 0249: release_model CAR_MODEL | ||
| + | 01C2: remove_references_to_actor CHAR_HANDLE | ||
| + | 01C3: remove_references_to_car CAR_HANDLE | ||
| + | </source> | ||
| + | |||
| + | == Keywords == | ||
| + | create, spawn, actor, ped, pedestrian, character, pedtype, model, vehicle, car, driver | ||
| + | |||
| + | [[Category:OpCodes]] | ||
Revision as of 00:06, 24 December 2011
Description
- Spawns a character in the driver seat of a vehicle
Syntax
- 0129: [var] = create_actor_pedtype [int1] model [int2] in_car [car handle] driverseat
Parameter
- [var]
- Variable to store the handle of the character
- [int1]
- [int2]
- Valid character model ID number as defined in the PEDS section of the IDE file; also acceptable is model's DFF name with a hash character
- [car handle]
- The handle of the vehicle
Native analog
This opcode spawns a character in the driver seat of a vehicle. Using this opcode requires an existing vehicle and opcode 0247 to load the character model or else the game could crash.
Example
- See also: Spawn a ped
The following example, using Sanny Builder, will spawn a ped in a car close to the player character.
// set constants
const
CHAR_MODEL = #BFORI
CAR_MODEL = #PONY
CHAR_HANDLE = 0@
CAR_HANDLE = 1@
X_POS = 2@
Y_POS = 3@
Z_POS = 4@
end
// load model, required to prevent unnecessary crash!
0247: request_model CHAR_MODEL
0247: request_model CAR_MODEL
// check if model is loaded
repeat
wait 0
if and
0248: model CHAR_MODEL available
0248: model CAR_MODEL available
then
break
end
until false
// spawn car
00A0: store_actor $PLAYER_ACTOR position_to X_POS Y_POS Z_POS
X_POS += 4.0
00A5: CAR_HANDLE = create_car CAR_MODEL at X_POS Y_POS Z_POS
// spawn character
0129: CHAR_HANDLE = create_actor_pedtype 4 model CHAR_MODEL in_car CAR_HANDLE driverseat
// cleanup
0249: release_model CHAR_MODEL
0249: release_model CAR_MODEL
01C2: remove_references_to_actor CHAR_HANDLE
01C3: remove_references_to_car CAR_HANDLEKeywords
create, spawn, actor, ped, pedestrian, character, pedtype, model, vehicle, car, driver