| Björn Stenberg | dcfc20f | 2002-10-10 14:05:34 +0000 | [diff] [blame] | 1 | Custom CFG |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 2 | File Format Specifications |
| 3 | |
| 4 | Description / General Info |
| 5 | -------------------------- |
| Björn Stenberg | dcfc20f | 2002-10-10 14:05:34 +0000 | [diff] [blame] | 6 | * The .cfg file is used on both the Rockbox Player and Recorder, in order to |
| 7 | load custom settings. |
| 8 | * Currently, only sound settings are supported but this will change in the |
| 9 | future. |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 10 | |
| 11 | File Location |
| 12 | ------------- |
| 13 | The files may reside anywhere on the hard disk. The only restriction is that |
| Björn Stenberg | dcfc20f | 2002-10-10 14:05:34 +0000 | [diff] [blame] | 14 | the filename must end in .cfg |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 15 | |
| 16 | Format Rules |
| 17 | ------------ |
| Björn Stenberg | 0e6088f | 2002-10-02 16:33:26 +0000 | [diff] [blame] | 18 | * Each setting must have it's own line. |
| 19 | * Lines starting with # are ignored. |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 20 | * If a value is out of the acceptable range for the device, which can vary |
| Björn Stenberg | 0e6088f | 2002-10-02 16:33:26 +0000 | [diff] [blame] | 21 | depending on the model, the value will be set to its default value. |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 22 | |
| 23 | Example File |
| 24 | ------------ |
| Björn Stenberg | 0e6088f | 2002-10-02 16:33:26 +0000 | [diff] [blame] | 25 | volume: 70 |
| 26 | bass: 11 |
| 27 | treble: 12 |
| 28 | balance: 0 |
| 29 | channels: 0 |
| 30 | loudness: 5 |
| 31 | bass boost: 30 |
| 32 | auto volume: 0 |
| Justin Heiner | 94d3ba2 | 2002-09-06 06:20:15 +0000 | [diff] [blame] | 33 | |
| Björn Stenberg | 0e6088f | 2002-10-02 16:33:26 +0000 | [diff] [blame] | 34 | This sets each line to the respective values after it. |
| 35 | |
| 36 | Value ranges |
| 37 | ------------ |
| 38 | volume: 0 to 100 |
| 39 | bass: player: -15 to 15, recorder: -12 to 12 |
| 40 | treble: player: -15 to 15, recorder: -12 to 12 |
| 41 | balance: -100 to 100 |
| 42 | channels: 0=Stereo, 1=Mono, 2=Mono Left, 3=Mono Right |
| 43 | loudness: 0 to 17 (recorder only) |
| 44 | bass boost: 0 to 100 (recorder only) |
| 45 | auto volume: 0=off, 1=2s, 2=4s, 3=8s (recorder only) |