Chapter 12. Plugins
127
the directory selected, or with the file selected in the file browser. You can then play
the file or do with it whatever you want. The file will not be “played” automatically.
If the
.link
file contains only one entry no list will be shown, you will directly jump
to that location. The file
shortcuts.link
in the root directory is an exception. After
“playing” it, the list will be shown even if the file contains just one entry.
If the list you are seeing is from
shortcuts.link
in the root directory, you can delete
the selected entry by pressing
Rec
. Deleting entries from other
.link
files is not possible.
Advanced Usage
Placing the line “#Display last path segments=n” (where n is a number) in the beginning
of a
.link
file will leave just the last n segments of the entries when they are shown. For
example, if n is chosen to be 1, then the entry
/MyMusic/collection/song.mp3
will be
shown as
song.mp3
. This allows you to hide common path prefixes.
You can also provide a custom display name for each entry individually. To do so,
append a tabulator character after the entry’s path followed by your custom name. That
name will then be used for showing the entry. For example:
Example
/MyMusic/collection/song.mp3<TAB>My favourite song!
12.3.2. Chip-8 Emulator
Chip8 is a kind of assembly language for a long-gone architecture. This plugin runs
games written using the chip8 instructions. To start a game open a
.ch8
file in the
File
Browser
There are lots of tiny Chip8 games (usually only about 256 bytes to a couple of KB)
which were made popular by the HP48 calculator’s emulator for them. The original
Chip8 had 64
×
32 pixel graphics, and the new superchip emulator supports 128
×
64
graphics.
The only problem is that they are based on a 4
×
4 keyboard, but since most games do
not use all of the buttons, this can easily be worked around.
To do this, one may put a
.c8k
file with the same name as the original program
which contains new key mappings (for
BLINKY.ch8
, one writes a
BLINKY.c8k
file). That
.c8k
file contains 16 characters describing the mapping from the Chip8 keyboard to
the default key mapping (that way, several Chip8 keys can be pressed using only one
Rockbox key). For example, a file containing the single line:
Code
0122458469ABCDEF
would correspond to the following non-default mappings:
3
→
2, 6
→
8, 7
→
4, 8
→
6.
The default keymappings are:
The Rockbox manual
(version 3.14)
Iaudio M5
