FF7/PSX/Sound/AKAO sequence - Revision history

Myst6re at 19:24, 31 October 2020

2020-10-31T19:24:18Z

2020-10-29T09:14:02Z

‎Channel Info (size: 4 bytes + 2 bytes * )

2020-07-30T09:36:58Z

Fix AkaoChannelInfo mask bits

2020-07-11T22:11:32Z

Channel Pitch LFO -> Vibrato, Channel Volume LFO -> Tremolo

2020-06-20T14:41:36Z

2020-06-07T14:06:15Z

2020-06-06T14:51:01Z

2020-06-05T21:08:59Z

2020-06-05T20:30:30Z

Remove wrong explanation of opcode 0xF3. I was reading a wrong structure.

2020-06-05T13:53:07Z

@@ Line 659: / Line 659: @@
 |[[FF7/PSX/Sound/Opcodes/0xfe|0xFE]]
 |Measure Number
-|2
+|3
-|measure: byte
+|measure: short
+|
 |-

@@ Line 43: / Line 43: @@
+  {
     uint32_t mask;                         // represents bitmask of used channels in this song
-    uint32_t start_offsets[num_channels];  // offsets to channel opcode data
+    uint16_t start_offsets[num_channels];  // offsets to channel opcode data
   };
@@ Line 54: / Line 54: @@
 After this bitmask, there is <channels count> offsets to channel opcode data counting from current offset. Each offsets is a relative offset based on the address *next to* the offset itself. (This is a general rule for early versions of AKAO to interpret relative offsets.)
 === Channel Commands [AKAO Opcodes] ===

@@ Line 47: / Line 47: @@
   int num_channels = 0;
-  while (int bit = 0; ((info.mask & 0xFFFFFF) & (1 << bit)) != 0; bit++)
+  while (int bit = 0; bit < 24; bit++)
-   num_channels++;
+   if ((info.mask & 0xFFFFFF) & (1 << bit)) != 0)
 First there is 32-bit number (offset 0x10), which represents bitmask of used channels in this song.

@@ Line 256: / Line 256: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb4b5|0xB4]]
-|Channel Pitch LFO (Vibrato)
+|Vibrato (Channel Pitch LFO)
 |4
 |delay: byte, rate: byte, type: byte (0-15)
@@ Line 262: / Line 262: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb4b5|0xB5]]
-|Channel Pitch LFO Depth
+|Vibrato Depth
 |2
 |depth: byte
@@ Line 272: / Line 272: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb4b5|0xB6]]
-|Turn Off Channel Pitch LFO
+|Turn Off Vibrato
 |1
+|
@@ Line 284: / Line 284: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb8b9|0xB8]]
-|Channel Volume LFO (Tremolo)
+|Tremolo (Channel Volume LFO)
 |4
 |delay: byte, rate: byte, type: byte (0-15)
@@ Line 290: / Line 290: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb8b9|0xB9]]
-|Channel Volume LFO Depth
+|Tremolo Depth
 |2
 |depth: byte
@@ Line 296: / Line 296: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb8b9|0xBA]]
-|Turn Off Channel Volume LFO
+|Turn Off Tremolo
 |1
+|
@@ Line 508: / Line 508: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xdd|0xDD]]
-|Channel Pitch LFO Depth Slide
+|Vibrato Depth Slide
 |3
 |length: byte, depth: byte
@@ Line 514: / Line 514: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xde|0xDE]]
-|Channel Volume LFO Depth Slide
+|Tremolo Depth Slide
 |3
 |length: byte, depth: byte

@@ Line 144: / Line 144: @@
 |Load Instrument
 |2
-|instrument: byte
+|instrument: byte (0-127)
+|
 |-

@@ Line 20: / Line 20: @@
 === Header (size: 16 bytes) ===
-  struct AkaoHeader
+  struct AkaoSeqHeader
+  {
     static const uint8_t magic[4];  // "AKAO" C-string
@@ Line 26: / Line 26: @@
     uint16_t length;                // data length - sizeof(header)
     uint16_t reverb_type;           // reverb type (range from 0 to 9)
-    struct AkaoTimeStamp
+    struct AkaoTimeStamp timestamp; // creation time
+ };
-     uint8_t year_bcd;             // year (in binary coded decimal)
-     uint8_t month_bcd;            // month (in binary coded decimal, between 0x01 - 0x12)
+ struct AkaoTimeStamp
-     uint8_t day_bcd;              // day (in binary coded decimal, between 0x01 - 0x31)
-     uint8_t hours_bcd;            // hours (in binary coded decimal, between 0x00 - 0x23)
+   uint8_t year_bcd;               // year (in binary coded decimal)
-     uint8_t minutes_bcd;          // minutes (in binary coded decimal, between 0x00 - 0x59)
+   uint8_t month_bcd;              // month (in binary coded decimal, between 0x01 - 0x12)
-     uint8_t seconds_bcd;          // seconds (in binary coded decimal, between 0x00 - 0x59)
+   uint8_t day_bcd;                // day (in binary coded decimal, between 0x01 - 0x31)
-   } timestamp;
+   uint8_t hours_bcd;              // hours (in binary coded decimal, between 0x00 - 0x23)
   };

@@ Line 62: / Line 62: @@
 The table consists of a repetition of 5-byte items.
-  struct AkaoDrumNoteAttr
+  struct AkaoDrumKeyAttr
+  {
     uint8_t instrument;   // corresponding to opcode 0xA1

@@ Line 603: / Line 603: @@
 |1
+|
+|There is no actual use in music.
 |-
 |[[FF7/PSX/Sound/Opcodes/0xf4f5|0xF4]]

@@ Line 258: / Line 258: @@
 |delay: byte, rate: byte, type: byte (0-15)
 |When <code>rate</code> is 0, it will be translated to 256 ticks.
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb4b5|0xB5]]
@@ Line 287: / Line 286: @@
 |delay: byte, rate: byte, type: byte (0-15)
 |When <code>rate</code> is 0, it will be translated to 256 ticks.
 |-
 |[[FF7/PSX/Sound/Opcodes/0xb8b9|0xB9]]
@@ Line 602: / Line 600: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xf3|0xF3]]
-|Use No Delay for Channel Pitch/Volume LFO
+|Unknown
 |1
+|
-|Specific to FF7. This instruction changes the interpretation of the 0xB4 and 0xB8 parameters. There is no actual use in music.
 |-
 |[[FF7/PSX/Sound/Opcodes/0xf4f5|0xF4]]

@@ Line 621: / Line 621: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xf4f5|0xF6]]
-|Volume Balance of Overlay Voice
+|Overlay Volume Balance
 |2
 |balance: byte (0-127)
@@ Line 627: / Line 627: @@
 |-
 |[[FF7/PSX/Sound/Opcodes/0xf4f5|0xF7]]
-|Volume Balance Slide of Overlay Voice
+|Overlay Volume Balance Slide
 |3
 |length: byte, balance: byte (0-127)