curioustorvald/tsvm
1
0
Fork 0
mirror of https://github.com/curioustorvald/tsvm.git synced 2026-06-06 05:28:31 +09:00
Code Issues Packages Projects Releases Wiki Activity

more taut gui

Browse Source
This commit is contained in:
minjaesong
2026-04-24 02:17:41 +09:00
parent 8d28bde119
commit ea09065802
5 changed files with 46 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
terranmon.txt
View File

@@ -2178,7 +2178,7 @@ Tracker Note Effects has been moved to `TAUD_NOTE_EFFECTS.md`
**Taud serialisation format**
Created by CuriousTorvald on 2026-04-19
This is a file format for Taud tracker data.
This is a file format for Taud tracker data. Taud can be extended with project data in backward-and-forward-compatible manner.
Endianness: Little
@@ -2194,17 +2194,18 @@ Endianness: Little
[PATTERN BIN for SONG 2]
[CUE SHEET for SONG 2]
...
[PROJECT DATA] (optional)
## Header
Byte[8] Magic
Uint8 Format version (always 1)
Uint8 Number of songs in SONG TABLE
Uint32 Compressed size of SAMPLE+INST section (used to calculate offset to SONG TABLE)
Uint32 Reserved for Taud Project Format. Fill with zero
Uint32 Offset to Project Data. Zero if Project Data is nonexistent
Byte[14]Tracker/Converter signature
## SONG TABLE
Rows of 16 bytes:
## Song Table
* Rows of 16 bytes:
Uint32 Song offset
Uint8 Number of voices
Uint16 Number of patterns (0 is invalid. pattern bin length = numPats * 8 bytes)
@@ -2214,38 +2215,20 @@ Rows of 16 bytes:
Float32 Frequency at the base note. Default (A440) is 440.0. If zero, assume the default value
Byte[1] Reserved for future versions
Taud device can queue up to 2 "playdata" in its buffer, which can be interpreted as a song.
Taud device can queue up to 2 "playdata" in its buffer, which can be interpreted as a song.
--------------------------------------------------------------------------------
* Known standard tunings
A440. ISO standard. Tracker default
C256. Power of two
C311. East Asian tuning (ROK National Gugak Center standard)
**Taud Project Format** is an extension to Taud format
Created by CuriousTorvald on 2026-04-22
Endianness: Little
# File Structure
\x1F T S V M a u d
[HEADER] (modified)
[SAMPLE+INSTRUMENT BIN IMAGE (GZip or Zstd compressed. Read 4-byte magic to determine)]
[SONG TABLE]
[PATTERN BIN for SONG 0]
[CUE SHEET for SONG 0]
[PATTERN BIN for SONG 1]
[CUE SHEET for SONG 1]
[PATTERN BIN for SONG 2]
[CUE SHEET for SONG 2]
...
[PROJECT DATA] (new!)
## Header
Byte[8] Magic
Uint8 Format version (always 129; high-bit set and number 0x01)
Uint8 Number of songs in SONG TABLE
Uint32 Compressed size of SAMPLE+INST section (used to calculate offset to SONG TABLE)
Uint32 Offset to Project Data (low twobyte)
Byte[14]Tracker/Converter signature
## Pattern Bin and Cue Sheet
Raw Pattern Bin/Cue Sheet images
## Project Data
Project Data is just a concatenation of blocks identified by their FourCC.
Byte[8] Magic (\x1E T a u d P r J)
Byte[8] Reserved
* Repetition of
@@ -2278,6 +2261,15 @@ prefixes:
Uint8 Song index
Uint32 Size of this table following this field
Uint16 Notation used for this song (takes notation index)
0: raw numbers
10*n: TET-number times 10 (12-TET = 120)
* Following systems have alternative notation conventions:
531: 53-TET Pythagorean Notation
* Following list defines ethnic notations in 12-tone scale
10121: Pythagorean Diminished Fifth
10122: Pythagorean Augmented Fourth
10123: Shi'er lü (East Asian traditional tuning)
Byte[*] Song name, null terminated. Encoding: UTF-8
Byte[*] Song composer, null terminated. Encoding: UTF-8
Byte[*] Song copyright string, null terminated. Encoding: UTF-8
@@ -2299,7 +2291,14 @@ prefixes:
Note: custom notations will use internal index 65535 down to 65520 (index 0 = 65535, index 15 = 65520)
Note Tuning:
1. "Base Note at C3" will be derived using "Current Tuning Base Note" and "Frequency at the Base Note" from the song table. If the values are A3,440Hz, it will be converted to C3,261.6255653Hz
2. Frequency at C4 will be (Base Note at C3) × (Interval Size)
3. 4096 notes will be equidistance-distributed between (Frequency at C3) and (Frequency at C4), with logarithmic pitch progression; this builds the frequency-offset table
4. Frequency-Offset Table from the previous step will be applied against the "Base Note at C3" to construct the notes within the notation. Value at index zero of the Frequency Table must be 0
5. The progress will continue outside the "root interval" (C3..C4) to build a complete note-to-frequency table
Note: if your sample is pre-tuned for your system, keep the project setting as A4,440Hz. If you are not working with the conventional octave system, you still need to specify the Interval Size
--------------------------------------------------------------------------------