FF7/Field/Script/Opcodes/5B SMTRA - Revision history

BukTop: 6 revisions imported

2019-05-23T02:17:29Z

6 revisions imported

my_wiki>BukTop: 5 revisions imported

2018-04-04T09:34:39Z

5 revisions imported

my_wiki>Synergy Blades at 14:20, 14 September 2006

2006-09-14T14:20:16Z

my_wiki>Synergy Blades: /* Description */

2006-09-07T23:33:05Z

‎Description

my_wiki>Synergy Blades: /* Description */

2006-09-07T23:31:19Z

‎Description

my_wiki>Synergy Blades at 23:29, 7 September 2006

2006-09-07T23:29:45Z

my_wiki>Synergy Blades at 23:28, 7 September 2006

2006-09-07T23:28:47Z

New page

* Opcode: '''0x5B'''
* Short name: '''SMTRA'''
* Long name: Set Materia

==== Memory layout ====
{| border="1" cellspacing="1" cellpadding="3" style="border: 1px solid black; border-collapse: collapse;"
! width="40" | 0x5B
! width="50" | ''B1 / B2''
! width="40" | ''B3 / B4''
! width="40" | ''T''
! width="40" | ''AP''
|}

==== Arguments ====

* '''const Bit[4]''' ''B1'': Source bank 1.
* '''const Bit[4]''' ''B2'': Source bank 2.
* '''const Bit[4]''' ''B3'': Source bank 3.
* '''const Bit[4]''' ''B4'': Source bank 4.
* '''const UByte''' ''T'': [[FF7/Field/Script/Materia ID|Type of materia]] to add, or source address 1.
* '''const UByte[3]''' ''AP'': Amount of AP the newly added materia will have, or source addresses 2, 3 and 4.

==== Description ====

Adds a new piece of materia to the materia inventory. This is either done by explicitly providing the materia type and AP value, in which case the first two bytes are zero, or by retrieving these values from memory. If ''B1'' is non-zero, then ''T'' specifies the address to be used with ''B1'' to find the value for materia type. If ''B2'', ''B3'' or ''B4'' are non-zero, these three bytes specify the addresses to retrieve the values for this unit. ''B2'' and the first AP byte specifies the lowest-unit (16^1) hex value to retrieve, corresponding to 0-16 gil; ''B3'' and the second AP byte specifies the middle-unit (16^2) hex value to retrieve; ''B4'' and the third AP byte the highest-unit (16^3) hex value.

==== Example ====

The following example adds a piece of Slash All materia (ID: 0xE) using the following parameters:

* Materia ID retrieved from memory bank 6, address 1D;
* 16^1 set explicitly with a constant value;
* 16^2 set explicitly with a constant value;
* 16^3 retrieved from memory bank 6, address 1B.

SETWORD(60,1B,1,0)
SETWORD(60,1D,E,0)
SMTRA(60,06,1D,3,2,1B)

This equates to: (3*16^1) + (2*16^2) + (1*16^3) == 0x010203 == 66051 AP.

@@ Line 9: / Line 9: @@
 ! width="50" | ''B3 / B4''
 ! width="40" | ''T''
-! width="40" | ''AP''
+! width="120" | ''AP''
 |}

@@ Line 23: / Line 23: @@
 ==== Description ====
-Adds a new piece of materia to the materia inventory. This is either done by explicitly providing the materia type and AP value, in which case the first two bytes are zero, or by retrieving these values from memory. Both setting the values explicitly and retrieving from memory can be used together in one call by setting the correct bytes to zero.
+Adds a new piece of materia to the materia inventory. This is either done by explicitly providing the materia type and AP value, in which case the first two bytes are zero, or by retrieving these values from memory. Both setting the values explicitly and retrieving from memory can be used together in one call by setting the correct bytes to zero; to see an example, please check below.
 If ''B1'' is non-zero, then ''T'' specifies the address to be used with ''B1'' to find the value for materia type.

← Older revision	Revision as of 02:17, 23 May 2019
(No difference)

← Older revision	Revision as of 09:34, 4 April 2018
(No difference)

@@ Line 7: / Line 7: @@
 ! width="40" | 0x5B
 ! width="50" | ''B1 / B2''
-! width="40" | ''B3 / B4''
+! width="50" | ''B3 / B4''
 ! width="40" | ''T''
 ! width="40" | ''AP''
@@ Line 14: / Line 14: @@
 ==== Arguments ====
-* '''const Bit[4]''' ''B1'': Source bank 1.
+* '''const Bit[4]''' ''B1'': Source bank 1, or zero if ''T'' is set as a constant value.
-* '''const Bit[4]''' ''B2'': Source bank 2.
+* '''const Bit[4]''' ''B2'': Source bank 2, or zero if this unit of ''AP'' is set as a constant value.
-* '''const Bit[4]''' ''B3'': Source bank 3.
+* '''const Bit[4]''' ''B3'': Source bank 3, or zero if this unit of ''AP'' is set as a constant value.
-* '''const Bit[4]''' ''B4'': Source bank 4.
+* '''const Bit[4]''' ''B4'': Source bank 4, or zero if this unit of ''AP'' is set as a constant value.
 * '''const UByte''' ''T'': [[FF7/Field/Script/Materia ID|Type of materia]] to add, or source address 1.
 * '''const UByte[3]''' ''AP'': Amount of AP the newly added materia will have, or source addresses 2, 3 and 4.