Text to Music Component Manual
| This page contains a transcript of ingame content. The following information supplements the rest of the wiki. It is kept for documentation purposes. |
This book is meant to give you an idea of how to work the Text to Music component.
Basics
It takes raw text that you input through the interface and turns it into notes!
A note will play approximately every half second.
There are three event types:
- Note
- Plays a music note
- Rest
- Like Note, but doesn't play any sound
- Timing
- Sets the timing for the component
- Must be the first event, it's not allowed anywhere else
MechComp Input/Configuration
- play
- Starts playing notes
- Does not work if the component is not anchored
- Flashes green
- set notes
- Sets the notes to be played
- set timing
- Sets the timing, in seconds, that the notes are played at
- Will not work while playing
- Changing the timing as a song is playing is not supported
- set instrument
- Sets the instrument to play
- Will not work while playing
- Changing the instrument as a song is playing is not supported
- stop
- Stops the song if it's currently playing
- Will always stop if the component is unwrenched
- The song will start at the beginning the next time it's played
- Flashes red on stop and when the song has ended
- unlink
- Unlinks this component from all other linked components
- Won't work while playing or processing
- Is not an input
- reset
- Will wipe all stored data, except for the instrument
- Flashes blue
- toggle rest on unavailable notes
- When the inputed note is not available for the current instrument, will rest instead of erroring
- Is not an input
- start autolinking
- See the Automatic Linking section below
- Is not an input
- view errors
- Anytime errors occur, they'll be logged into a viewable list
- Flashes magenta on any errors
- Only the last five errors can be viewed
- The component will flash red if an error occurred
- Is not an input
Format Details
Each event needs to be separated by a vertical pipe, like so: A,B,F,3|B,B,F,3.
Note
Has four parts, each separated by a comma.
A,B,F,3
Name,Accidentals,Dynamics,Octave[,Delay]
- Note Name
- A, B, C, D, E, F, or G
- Accidentals
- B for flat
- S for sharp
- N for natural
- Dynamics
- P for piano (quietest)
- MP for mezzo piano
- N for neutral
- MF for mezzo forte
- F for forte (loudest)
- Octave
- Goes from 1 to 7
- A0, B0, & C8 are exceptions
- Delay
- Optional
- How long the note should rest for after playing
- This is NOT the same as note length/duration
- 0 to play a concurrent note
- Defaults to 1
- Value goes from 0 to 100
Rest
R,R,R,R
R,R,R,R[,Delay]
- R
- Must be R, can't be another character
- Delay
- Optional
- How long to rest for
- Goes from 1 to 1000
- Defaults to 1
Timing
timing,15
timing,Timing
- timing
- Must be the literal word
timing - Timing
- The new timing
- Measured in centiseconds
- Must be between 10 and 50
Automatic Linking
Steps:
- Use a multitool on a anchored Text to Music component to start storing pianos.
- Then use it on anchored components that you want to link.
- Use the multitool in your hand to start linking, each link takes 0.1 seconds.
4 components have 7 links, so it takes 0.7 seconds.
Limitations
- You cannot change the duration of a note.
- You can only enter up to 1920 notes.