Difference between revisions of "004F"
Jump to navigation
Jump to search
(page updates) |
|||
| Line 1: | Line 1: | ||
| − | {{Icon| | + | {{OpCode |
| − | + | | games = {{Icon|t}} | |
| − | + | | command = START_NEW_SCRIPT | |
| − | + | | description = Starts a [[Create a script|new script]] | |
| − | + | | syntax1 = 004F: create_thread [''label''] ( [''any''] | |
| − | + | | syntax2 = create_thread [''label''] ( [''any''] | |
| − | + | | p1t = [''label''] | |
| − | '' | + | | p1d = The position in the script it will go to, usually identified by a [[label]] |
| − | + | | p2t = [''any''] | |
| − | + | | p2d = Parameters if there are ones (optional), up to 16+2 for GTA III and Vice City, 32+2 for San Andreas | |
| − | + | | native = [[START_NEW_SCRIPT]] | |
| − | + | }} | |
| − | |||
| − | |||
| − | This | + | This opcode starts a new script and begins an execution from the label. It has a variable number of parameters. The first parameter of the opcode is required, with extra parameters depending on the scripter needs. The extra parameters set the values of the local variables of the new script. The first extra parameter (the second parameter of the opcode) sets the value for the new script's local variable <span style="color:blue">0@</span>, the second extra parameter sets the value for <span style="color:blue">1@</span>, and so forth. The total number of extra parameters varies from game to game: 16+2 for GTA III and Vice City, 32+2 for San Andreas. Opcodes [[004E]] or [[0459]] can be used to terminate the scripts. This opcode is similar to opcode [[00D7]] but the latter has only one parameter, without extra ones. |
| − | + | == Example == | |
| − | + | <syntaxhighlight lang="scm"> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | ==Example== | ||
| − | < | ||
$VAR = 10 | $VAR = 10 | ||
004F: create_thread @MONEY 10 $VAR | 004F: create_thread @MONEY 10 $VAR | ||
| Line 37: | Line 29: | ||
:EXIT | :EXIT | ||
004E: end_thread | 004E: end_thread | ||
| − | </ | + | </syntaxhighlight> |
When the game starts, it will execute this code and the player will receive 10 dollars. | When the game starts, it will execute this code and the player will receive 10 dollars. | ||
| − | ==Keywords== | + | == Keywords == |
thread, script, create, start | thread, script, create, start | ||
| − | ==See also== | + | == See also == |
| − | |||
| − | |||
| − | |||
* [[Create a thread]] | * [[Create a thread]] | ||
| − | + | * {{Icon|t}} [[00D7]], starts a new script with no parameters | |
| − | [[ | + | * {{Icon|t}} [[0417]], launches a mission |
| + | * {{Icon|t}} [[0A92]], starts a new [[CLEO]] script | ||
Revision as of 06:26, 27 January 2016
START_NEW_SCRIPT
- Description
- Starts a new script
- Syntax
- 004F: create_thread [label] ( [
- create_thread [label] ( [
- Parameter
- [label]
- The position in the script it will go to, usually identified by a label
- [any]
- Parameters if there are ones (optional), up to 16+2 for GTA III and Vice City, 32+2 for San Andreas
- Native analog
- START_NEW_SCRIPT
This opcode starts a new script and begins an execution from the label. It has a variable number of parameters. The first parameter of the opcode is required, with extra parameters depending on the scripter needs. The extra parameters set the values of the local variables of the new script. The first extra parameter (the second parameter of the opcode) sets the value for the new script's local variable 0@, the second extra parameter sets the value for 1@, and so forth. The total number of extra parameters varies from game to game: 16+2 for GTA III and Vice City, 32+2 for San Andreas. Opcodes 004E or 0459 can be used to terminate the scripts. This opcode is similar to opcode 00D7 but the latter has only one parameter, without extra ones.
Example
$VAR = 10
004F: create_thread @MONEY 10 $VAR
...
...
:MONEY
03A4: name_thread 'MONEY'
00D6: if 0
003B: 0@ == 1@
004D: jump_if_false @EXIT
0109: player $PLAYER_CHAR money += 0@
:EXIT
004E: end_threadWhen the game starts, it will execute this code and the player will receive 10 dollars.
Keywords
thread, script, create, start
See also
- Create a thread
- 00D7, starts a new script with no parameters
- 0417, launches a mission
- 0A92, starts a new CLEO script
