Skip to content

Commit

Permalink
Docs: Small additions.
Browse files Browse the repository at this point in the history
"Bit depth" to the glossary, "Song Comments > Wrap text" to the settings, and a groove calculator link to grooves.
  • Loading branch information
ElectricKeet committed Dec 8, 2024
1 parent fd70c11 commit 8efca3c
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 3 deletions.
3 changes: 3 additions & 0 deletions doc/1-intro/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,9 @@

**bitbang**: to achieve PCM sound by sending a rapid stream of volume commands to a non-PCM channel.

**bit depth**: the number of bits used for each sample in a PCM stream. 16-bit is considered high quality; lower bit depths introduce more noise and distortion, especially for quieter samples.
- the "1-bit DPCM" sample type has 6-bit amplitude resolution, but each sample is represented by only 1 bit indicating whether its amplitude differs from the previous sample by one step up or down.

**bitmask**: a set of bits which represent individual single-bit toggles or groups representing small numbers. these are explained fully in the [hexadecimal primer](hex.md).

**BRR**: a lossy sample format used by the SNES. it has a fixed compression ratio; groups of 32 bytes (16 samples) are encoded in 9 bytes each.
Expand Down
4 changes: 4 additions & 0 deletions doc/2-interface/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -558,6 +558,10 @@ below all the binds, select a key from the dropdown list to add it. it will appe
- **Fill entire window**: removes the gap between the waveform and the edge of the window.
- **Waveform goes out of bounds**: allows the waveform to draw past the top and bottom of the oscilloscope.

### Song Comments

- **Wrap text**: visually breaks long lines at the width of the text box. does not affect the text itself.

### Windows

- **Rounded window corners**
Expand Down
4 changes: 1 addition & 3 deletions doc/8-advanced/grooves.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,7 @@ a single `09xx` command will switch to the matching numbered groove pattern.

## tempo

this is a non-exhaustive list of grooves and their equivalent tempo in BPM.

note: this table assumes a song's tick rate setting is left at its default value for the chosen engine speed: 60 for NTSC, or 50 for PAL.
this is a non-exhaustive list of grooves and their equivalent tempo in BPM when using NTSC or PAL tick rates (60 or 50) and row highlight values of 4 and 16. for more accurate tempos, differing tick rates, or differing row highlight values, use the [groove calculator](https://pineight.com/ft/calcgroove.html) (courtesy of Damian Yerrick).

BPM NTSC | BPM PAL | groove | | BPM NTSC | BPM PAL | groove
--------:|--------:|:-----------------------|-|---------:|--------:|:----------------------
Expand Down

0 comments on commit 8efca3c

Please sign in to comment.