8 bits

Simple sample to show you how to use palettes.

Using library

GP2X minimal library by rlyeh, 2005

License

  • Free for non-commercial projects (it would be nice receiving a mail from you).  Other cases, ask me first.
  • GamePark Holdings is not allowed to use this library and/or use parts from it.

Source code

#include "minimal.h"

int main(int argc, char *argv[])
{
gp2x_init(1000, 8, 11025,16,1,60, 1);

//set & update color #1 (as white)
gp2x_video_RGB_color8(255,255,255,1);
gp2x_video_RGB_setpalette();

while(1)
{
unsigned long pad=gp2x_joystick_read(), R=0,G=0,B=0;

if(pad & GP2X_VOL_DOWN) if(pad & GP2X_START) exit(0);

if(pad & GP2X_A) R=255;
if(pad & GP2X_X) G=255;
if(pad & GP2X_B) B=255;

//set & update color #0
gp2x_video_RGB_color8(R,G,B,0);
gp2x_video_RGB_setpalette();

//put a white pixel (color #1) at center of screen (160,120)
gp2x_video_RGB[0].screen8[160+120*320]=1;

gp2x_video_RGB_flip(0);
}
}

void gp2x_sound_frame(void *blah, void *buff, int samples) { }

Explanation

  • Our gp2x_init line inits the whole library.  We set 1000 ticks per second, 8 bits video mode, 11025/16bits/stereo/60Hz sound mode, and solid font.
  • Our gp2x_joystick_read line reads the joystick.  It is used to act properly to different button combinations.
  • Our first gp2x_video_RGB_color8 line sets color entry 1 to white.
  • Our second gp2x_video_RGB_color8 line sets color entry 0 to a determinated color.  Note that the whole screen defaults to entry 0, so this will change the entire screen.
  • Our gp2x_video_RGB_setpalette line updates all gp2x_video_RGB_color8 changes.  So at this point exactly the screen color will change.
  • Our gp2x_video_RGB [0].screen8 line will plot a white pixel (color #1) at center of screen.
  • Our gp2x_sound_frame line fills our sound buffer.  Note that this function will not generate any sound since we have written a void function.

C Compilation

arm-linux-gcc minimal.c 8bits.c -static -lpthread -lm

C++ Compilation

arm-linux-g++ minimal.c 8bits.c -static -lpthread -lm

Output

  • this program show different color patterns when you press buttons (pressing A,X and/or B changes the color).
  • press volume down and start buttons to exit.
void gp2x_init(int ticks_per_second,
int bpp,
int rate,
int bits,
int stereo,
int Hz,
int solid_font)
This function sets up the whole library.
unsigned long gp2x_joystick_read(void)
This function returns the active GP2X joystick values.
void gp2x_video_RGB_color8 (int R,
int G,
int B,
int C)
This function sets the palettized color entry C to a given triad of R,G,B components.
void gp2x_video_RGB_setpalette(void)
This function updates the whole 8 bits palette into screen.
gp2x_video_layer gp2x_video_RGB[1]
This struct allows you to work directly with RGB video layer.
extern void gp2x_sound_frame(void *blah,
void *buffer,
int samples)
This function is automatically called by the library, and expects a sound buffer to be filled in.