LittleGPTracker can be configured in a various ways through a series of flags. These flags can either be defined temporarely at the command line or permanently in a config file called 'config.xml'.
Note that values do not necessarely affect all platforms. Also, if one of the values isn't working for you it's possible that you need to get the latest ghetto build.
You can specify any of the options at the command line using
This can be handy when trying out the effect of a flag before deciding to keep it permanently in the config.xml
Create a new file config.xml and place it in the same folder as the platform executable you are using (ie. in windows, it must be in the bin folder with the .exe; on the gp2x it should be in the root with lgpt.gpe, etc.) Open it in a text editor or xml editor. First create a root node like this:
Then you can add as many config flags as you like:
<CONFIG> <FLAGNAME value=' '/> <FOO value='BAR'/> </CONFIG>
To start LittleGPTracker in fullscreen:
<CONFIG> <FULLSCREEN value='YES'/> </CONFIG>
To have the screen bigger than the original GP2X resolution, use SCREEMULT to set a multiplier value:
Be careful as large values take a lot of juice and interfere with sound playback.
LittleGPTracker uses 4 colours to do all the drawing. If you want, you can redefine them using the following parameters:
All colors are defined by a set of hexadecimal triplet for RGB. Here's an example:
<CONFIG> <BACKGROUND value="505444" /> <FOREGROUND value="FFFFFF" /> <!-- text and cursor in cursor --> <HICOLOR1 value="F41B38" /> <!-- row count in song screen --> <HICOLOR2 value="FF0000" /> <!-- cursor--> </CONFIG>
You can generate this config values in an awesome web app
The buttons (GP2X/PSP) or keys (WIN/DEB/OSX) arrangment that is predefined can be totally reconfigured through the following parameters:
To connect the button to a keyboard key, it's pretty easy: simply put the key name as defined by the SDL_KeySym as value. For example:
<CONFIG> <KEY_A value="f" /> <KEY_B value="d" /> <KEY_LEFT value="j" /> <KEY_RIGHT value="l" /> <KEY_UP value="i" /> <KEY_DOWN value="k" /> <KEY_LSHOULDER value="a" /> <KEY_RSHOULDER value=";" /> <KEY_START value="space" /> </CONFIG>
to connect or redefine the button arrangment of a GP2X or a PSP, you need to define it using the following syntax:
<KEY_START value="but:0:x" />
where x is the button id of the button. The listing of button id's for PSP & GP2X can be found here.
Here's an example that maps the start button to the X on PSP:
<CONFIG> <KEY_START value="but:0:11" /> </CONFIG>
And if you want to configure a USB joypad, you'll have to use the mapping.xml
You can tweak the timing used to repeat the arrows keys and other.
<CONFIG> <KEYDELAY value="185"/> <KEYREPEAT value="40"/> </CONFIG>
You can tweak two different path:
<CONFIG> <ROOTFOLDER value="c:/files/tracks/"/> <SAMPLELIB value="root:"/> </CONFIG>
Additionally to playing the song, LittleGPTracker can be used to render the audio to file. To control file rendering, the variable RENDER can be set to either FILE,FILESPLIT,FILERT,FILESPLITRT. Note that there's a small issue with the speed when using FILE/FILESPLIT so the xxRT seem like the best choice at the moment
<CONFIG> <RENDER value='FILERT'/> </CONFIG>
This setting is for GP2X and Dingoo only. It is used to set the volume of the hardware at startup. In decimal (base 10).
<CONFIG> <VOLUME value='60'/> </CONFIG>
These settings are used to control various options of the audio configuration. They are currenly mostly used for W32 but might extend in the future to other platforms
<CONFIG> <AUDIODRIVER value='Real'/> <AUDIOBUFFERSIZE value='512'/> </CONFIG>
This setting is also W32 only. It can be use to delay the output of midi by a certain amount of milliseconds. For example, to delay it of 1 msecs:
<CONFIG> <MIDIDELAY value='1'/> </CONFIG>
also note: Because MIDI on PC is a bitch to synchronise and that the ONLY system that kind of worked was, surprisingly, the old MMSYSTEM audio system, I've re-enabled it as an option. So, if you need good midi sync or good timing, you will NEED to use this. The latency isn't great but in our case it's not a problem. To enable the old ass audio system and enjoy pretty stable midi out, add an entry in the config.xml with <AUDIOAPI value='MMSYSTEM' />
Get piggy dumping a log on the terminal or to a .log file, useful for debugging crashes or making a mapping.xml for your usb pad:
<CONFIG> <DUMPEVENT value='YES'/> </CONFIG>