SCM Language: Difference between revisions

|align=center|Pre{{ref|preinc|[*]}}

|align=center|Pre{{ref|preinc|[*]}}

:{{note|preinc}} Pre and post increments have no difference unlike what you would expect.

Yet, you can put the ''assignment'' and ''algebric'' operators together inline as follows:

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''+''' expr2</code>

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''-''' expr2</code>

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''*''' expr2</code>

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''/''' expr2</code>

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''+@''' expr2</code>

|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''-@''' expr2</code>

:{{note|expr01}} ''expr1'' can represent ''expr0'' too.

!<{{ref|inverr|[*]}}

!<={{ref|inverr|[*]}}

:{{note|inverr}} As a result of a critical bug, R* compiler mistakenly applies the operator inversion.

An ''alternator'' is a set of alternative and akin commands chosen specifically during the compilation on the basis of the multiple implementations of the commands binded to the reference set, according to the different argument data types but NOT the [http://en.wikipedia.org/wiki/Arity arity]. The aforementioned sets are listed below:

** '''START_CUTSCENE'''{{ref|depcnt|[*]}}

** '''SET_PROGRESS_TOTAL'''{{ref|thgtot|[*]}}

** '''REGISTER_MISSION_GIVEN'''{{ref|depcnt|[*]}}

** '''SET_TOTAL_NUMBER_OF_MISSIONS'''{{ref|thgtot|[*]}}

** '''SET_COLLECTABLE1_TOTAL'''{{ref|thgtot|[*]}}

** '''SAVE_VAR_TEXT_LABEL'''{{ref|thgtot|[*]}}

:{{note|thgtot}} The argument of these commands must be set respectively according to:

:* The sum of '''PLAYER_MADE_PROGRESS''' values;

:* The amount of '''REGISTER_MISSION_PASSED''' (those that don't have an immediate value are excluded) and '''REGISTER_ODDJOB_MISSION_PASSED''';

:* The amount of '''CREATE_COLLECTABLE1'''.

:If the argument of the listed commands differs from what expected, a 0-value must be passed;

:{{note|depcnt}} This command was intended to be counted originally but its counter got deprecated.

A ''constant'' is a ''symbolic name'' associated to a specific [[#Value|value]]. When compiling, their caption is converted to the assigned value. Since {{icon|vc}}, names and identifiers of objects within [[OBJS]] and [[TOBJ]] blocks are loaded from every ''IDE'' file defined into [[gta.dat|gta_vc.dat]], then those of vehicles and pedestrians within [[PEDS]] and [[CARS]] blocks are retrieved from [[default.ide]]. In {{icon|sa}}, they are listed into ''TXT'' files, whose name follows the [[Wikipedia:CamelCase|Pascal Case]] (eg. ''AudioEvents.txt''). These files respect the syntax below:

A ''command ID'' is a ''16-bit signed integer'' internal and progressive identifier, somehow referred to as part of the hexadecimal representation of an [http://en.wikipedia.org/wiki/Opcode opcode], which identifies the command to execute at runtime, forming the game's script [http://en.wikipedia.org/wiki/Bytecode bytecode]. The maximum number of available commands is ''32767'' (''0x7FFF''), since the least significant bit (''0x8000'') is set whenever they are used as ''negative conditions'' (those with the '''NOT''' [[#Logical|logical operator]], just to clear things up).

The limitation of the amount of arguments a [http://en.wikipedia.org/wiki/Variadic_function variadic] command can pass is game specific:

!colspan=2|MISSION_START{{ref|misdef|[*]}}

!colspan=2|GOTO{{ref|statem|[*]}}

!colspan=2|GOTO_IF_FALSE{{ref|statem|[*]}}

!colspan=2|START_NEW_SCRIPT{{ref|undarg|[*]}}

!colspan=2|VAR_INT{{ref|defvar|[*]}}

!colspan=2|VAR_FLOAT{{ref|defvar|[*]}}

!colspan=2|LVAR_INT{{ref|defvar|[*]}}

!colspan=2|LVAR_FLOAT{{ref|defvar|[*]}}

!colspan=2|{{{ref|embdsc|[*]}}

!colspan=2|}{{ref|embdsc|[*]}}

!colspan=2|IF{{ref|statem|[*]}}

!colspan=2|ELSE{{ref|statem|[*]}}

!colspan=2|ENDIF{{ref|statem|[*]}}

!colspan=2|WHILE{{ref|statem|[*]}}

!colspan=2|ENDWHILE{{ref|statem|[*]}}

!colspan=2|ANDOR{{ref|statem|[*]}}

!colspan=2|REPEAT{{ref|statem|[*]}}

!colspan=2|ENDREPEAT{{ref|statem|[*]}}

!colspan=2|GOTO_IF_TRUE{{ref|statem|[*]}}

!colspan=2|IFNOT{{ref|statem|[*]}}

!colspan=2|WHILENOT{{ref|statem|[*]}}

!colspan=2|VAR_TEXT_LABEL{{ref|defvar|[*]}}

!colspan=2|LVAR_TEXT_LABEL{{ref|defvar|[*]}}

!colspan=2|VAR_TEXT_LABEL16{{ref|defvar|[*]}}

!colspan=2|LVAR_TEXT_LABEL16{{ref|defvar|[*]}}

!rowspan=4|IS_EMPTY{{ref|likely|[*]}}!!IS_VAR_TEXT_LABEL_EMPTY

!colspan=2|SWITCH{{ref|statem|[*]}}

!colspan=2|ENDSWITCH{{ref|statem|[*]}}

!colspan=2|CASE{{ref|statem|[*]}}

!colspan=2|DEFAULT{{ref|statem|[*]}}

!colspan=2|BREAK{{ref|statem|[*]}}

!rowspan=4 colspan=2|SWITCH_START{{ref|statem|[*]}}

!rowspan=2 colspan=2|SWITCH_CONTINUED{{ref|statem|[*]}}

!rowspan=6|IS_BIT_SET{{ref|likely|[*]}}!!IS_GLOBAL_VAR_BIT_SET_CONST

!rowspan=6|SET_BIT{{ref|likely|[*]}}!!SET_GLOBAL_VAR_BIT_CONST

!rowspan=6|CLEAR_BIT{{ref|likely|[*]}}!!CLEAR_GLOBAL_VAR_BIT_CONST

!rowspan=2|STRING_CAT{{ref|likely|[*]}}!!STRING_CAT16

!colspan=2|SWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ENDSWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|CASE{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|DEFAULT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|BREAK{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ANDOR{{ref|statem|[*]}}

!colspan=2|SAVE_VAR_INT{{ref|defvar|[*]}}

!colspan=2|SAVE_VAR_FLOAT{{ref|defvar|[*]}}

!rowspan=2 colspan=2|CALL{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}

!rowspan=2 colspan=2|CALLNOT{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}

!rowspan=7|=<br/>SET!!SET_INT{{ref|likely|[*]}}

!SET_FLOAT{{ref|likely|[*]}}

!SET_TEXT_LABEL{{ref|likely|[*]}}

!SET_INT_TO_INT{{ref|likely|[*]}}

!SET_FLOAT_TO_FLOAT{{ref|likely|[*]}}

!SET_TEXT_LABEL_TO_TEXT_LABEL{{ref|likely|[*]}}

!SET_INT_TO_CONSTANT{{ref|likely|[*]}}

!rowspan=4|+=<br/>+<br/>ADD_THING_TO_THING!!ADD_VAL_TO_INT{{ref|likely|[*]}}

!ADD_VAL_TO_FLOAT{{ref|likely|[*]}}

!ADD_INT_TO_INT{{ref|likely|[*]}}

!ADD_FLOAT_TO_FLOAT{{ref|likely|[*]}}

!rowspan=4|-=<br/>-<br/>SUB_THING_FROM_THING!!SUB_VAL_FROM_INT{{ref|likely|[*]}}

!SUB_VAL_FROM_FLOAT{{ref|likely|[*]}}

!SUB_INT_FROM_INT{{ref|likely|[*]}}

!SUB_FLOAT_FROM_FLOAT{{ref|likely|[*]}}

!rowspan=4|*=<br/>*<br/>MULT_THING_BY_THING!!MULT_INT_BY_VAL{{ref|likely|[*]}}

!MULT_FLOAT_BY_VAL{{ref|likely|[*]}}

!MULT_INT_BY_INT{{ref|likely|[*]}}

!|MULT_FLOAT_BY_FLOAT{{ref|likely|[*]}}

!rowspan=4|/=<br/>/<br/>DIV_THING_BY_THING!!DIV_INT_BY_VAL{{ref|likely|[*]}}

!DIV_FLOAT_BY_VAL{{ref|likely|[*]}}

!DIV_INT_BY_INT{{ref|likely|[*]}}

!DIV_FLOAT_BY_FLOAT{{ref|likely|[*]}}

!rowspan=8|><br/><=<br/>IS_THING_GREATER_THAN_THING!!IS_INT_GREATER_THAN_NUMBER{{ref|likely|[*]}}

!IS_NUMBER_GREATER_THAN_INT{{ref|likely|[*]}}

!IS_INT_GREATER_THAN_INT{{ref|likely|[*]}}

!IS_FLOAT_GREATER_THAN_NUMBER{{ref|likely|[*]}}

!IS_NUMBER_GREATER_THAN_FLOAT{{ref|likely|[*]}}

!IS_FLOAT_GREATER_THAN_FLOAT{{ref|likely|[*]}}

!IS_INT_GREATER_THAN_CONSTANT{{ref|likely|[*]}}

!IS_CONSTANT_GREATER_THAN_INT{{ref|likely|[*]}}

!rowspan=8|>=<br/><<br/>IS_THING_GREATER_OR_EQUAL_TO_THING!!IS_INT_GREATER_OR_EQUAL_TO_NUMBER{{ref|likely|[*]}}

!IS_NUMBER_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}

!IS_INT_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}

!IS_FLOAT_GREATER_OR_EQUAL_TO_NUMBER{{ref|likely|[*]}}

!IS_NUMBER_GREATER_OR_EQUAL_TO_FLOAT{{ref|likely|[*]}}

!IS_FLOAT_GREATER_OR_EQUAL_TO_FLOAT{{ref|likely|[*]}}

!IS_INT_GREATER_OR_EQUAL_TO_CONSTANT{{ref|likely|[*]}}

!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}

!rowspan=7|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_EQUAL_TO_NUMBER{{ref|likely|[*]}}

!IS_INT_EQUAL_TO_INT{{ref|likely|[*]}}

!IS_FLOAT_EQUAL_TO_NUMBER{{ref|likely|[*]}}

!IS_FLOAT_EQUAL_TO_FLOAT{{ref|likely|[*]}}

!IS_TEXT_LABEL_EQUAL_TO_STRING{{ref|likely|[*]}}

!IS_TEXT_LABEL_EQUAL_TO_TEXT_LABEL{{ref|likely|[*]}}

!IS_INT_EQUAL_TO_CONSTANT{{ref|likely|[*]}}

!colspan=2|GOTO_IF_TRUE{{ref|statem|[*]}}

!colspan=2|GOTO_IF_FALSE{{ref|statem|[*]}}

!colspan=2|START_NEW_SCRIPT{{ref|undarg|[*]}}

!rowspan=2|+=@<br/>+@<br/>ADD_THING_TO_THING_TIMED!!ADD_TIMED_VAL_TO_FLOAT{{ref|likely|[*]}}

!ADD_TIMED_FLOAT_TO_FLOAT{{ref|likely|[*]}}

!rowspan=2|-=@<br/>-@<br/>SUB_THING_FROM_THING_TIMED!!SUB_TIMED_VAL_FROM_FLOAT{{ref|likely|[*]}}

!SUB_TIMED_FLOAT_FROM_FLOAT{{ref|likely|[*]}}

!rowspan=2|=#<br/>CSET!!CSET_INT_TO_FLOAT{{ref|likely|[*]}}

!CSET_FLOAT_TO_INT{{ref|likely|[*]}}

!rowspan=2|ABS!!ABS_INT{{ref|likely|[*]}}

!ABS_FLOAT{{ref|likely|[*]}}

!colspan=2|VAR_INT{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|VAR_FLOAT{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|LVAR_INT{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|LVAR_FLOAT{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|VAR_TEXT_LABEL{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|LVAR_TEXT_LABEL{{ref|defvar|[*]}}{{ref|posngs|[*]}}

!colspan=2|{{{ref|embdsc|[*]}}{{ref|posngs|[*]}}

!colspan=2|}{{ref|embdsc|[*]}}{{ref|posngs|[*]}}

!colspan=2|IF{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|IFNOT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ELSE{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ENDIF{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|WHILE{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|WHILENOT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ENDWHILE{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|REPEAT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ENDREPEAT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|SWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ENDSWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|CASE{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|DEFAULT{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|BREAK{{ref|statem|[*]}}{{ref|posngs|[*]}}

!colspan=2|ANDOR{{ref|statem|[*]}}

!colspan=2|SAVE_VAR_INT{{ref|defvar|[*]}}

!colspan=2|SAVE_VAR_FLOAT{{ref|defvar|[*]}}

!colspan=2|SAVE_VAR_TEXT_LABEL{{ref|defvar|[*]}}

!rowspan=2 colspan=2|CALL{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}

!rowspan=2 colspan=2|CALLNOT{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}

:{{note|misdef}} A special [[#Mission scripts|mission]] directive which is never compiled;

:{{note|statem}} It is used to build the various [[#Control flows|control flows]] internally;

:{{note|defvar}} It is used to declare one or more variables;

:{{note|embdsc}} It embeds a variable scope;

:{{note|undarg}} It has an undefined amount of arguments;

:{{note|likely}} It is a likely definition of the standard command;

:{{note|posngs}} It should exist but its position is purely guessed;

:{{note|argvar}} Arguments amount varies when compiling.

* [[SCRambl]] - an open-source tool provided by {{U|Deji}}

*{{icon|3}} [http://pastebin.com/Pfwscpeh GTA III unofficial main.sc] - Reconstruction of main.sc, missing from the iOS source code, by {{U|Link2012}}

*{{icon|3}} {{icon|vc}} [http://pastebin.com/raw.php?i=T73rCdDd GTA III/VC unavailable script commands (possibly NOP'd)] - some sort of information by {{U|Wesser}} as a result of the reverse-engineering applied to the [http://www.rockstargames.com/ Rockstar Games]' official '''GTA3 Script Compiler V413'''

*{{icon|3}} {{icon|vc}} [http://pastebin.com/raw.php?i=Pjb0Ezkx GTA3 Script Compiler V413 Compilation Strings] - a list by {{U|Wesser}} of all the error messages the compiler can throw and more

*{{icon|sa}} [http://pastebin.com/raw.php?i=Ra9JLLeN GTA SA PC/PS2/XBOX script commands], [http://pastebin.com/raw.php?i=kCwS6rdG GTA SA Mobile script commands] - taken directly from the ''Android'' application and rearranged by {{U|Wesser}}

*{{GTAF|441362|Reconstructing the III .sc language}} &ndash; a post by {{U|NTAuthority}}