head 1.1; branch 1.1.1; access ; symbols start:1.1.1.1 PAlibDoc:1.1.1; locks ; strict; comment @# @; 1.1 date 2005.11.02.08.30.35; author jandujar; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2005.11.02.08.30.35; author jandujar; state Exp; branches ; next ; desc @@ 1.1 log @Initial revision @ text @ PA_lib: Palette system
Page principale | Modules | Liste des fichiers | Portée globale | Rechercher 

Palette system


Macros

#define PA_LoadPal(palette, source)   DMA_Copy((void*)source, (void*)palette, 256, DMA_16NOW);
 Charger une palette de 256 couleurs pour les fonds ou les sprites pour l'écran 0 ou 1. Ex : PA_LoadPal(PALETTE_BG1, bg_pal);
#define PA_LoadPal16(palette, n_palette, source)   DMA_Copy((void*)source, (void*)(palette + (n_palette << 5)), 16, DMA_16NOW);
 Charger une palette de 16 couleurs pour les fonds ou les sprites pour l'écran 0 ou 1. Ex : PA_LoadPal16(PALETTE_BG1, 4, bg_pal);
#define PA_RGB(r, g, b)   ((1 << 15) + (r) + ((g)<<5) + ((b)<<10))
 Convertir une couleurs au format Rouge, Vert, Bleu en un nombre utilisable par le système de palette. Attention : sur Gba, les valeurs vont de 0 à 31...
#define PA_SetBgPalCol(screen, color_number, colorRGB)   BG_PALETTE[color_number + (screen << 9)] = colorRGB
 Changer la couleur d'une des couleurs de la palette des fonds
#define PA_SetSpritePalCol(screen, color_number, colorRGB)   BG_PALETTE[256 + color_number + (screen << 9)] = colorRGB
 Changer la couleur d'une des couleurs de la palette des sprites

Fonctions

void PA_SetBrightness (bool screen, s8 bright)
 Régler la luminosité de l'écran
void PA_SetPalNeg (u32 palette)
 Négativer une palette donnée. Pour annuler, il suffit de négativer à nouveau.
void PA_SetPal16Neg (u32 palette, u8 n_palette)
 Négativer une palette de 16 couleurs donnée. Pour annuler, il suffit de négativer à nouveau.
void PA_InitSpriteExtPal (void)
 Initialise le mode 16 palettes pour sprites de 256 couleurs...
void PA_InitBgExtPal (void)
 Initialise le mode 16 palettes pour fonds de 256 couleurs...
void PA_LoadSpriteExtPal (bool screen, u16 palette_number, void *palette)
 Charger une palette de 256 couleurs dans les palettes étendues des sprites
void PA_LoadBgExtPal (bool screen, u16 palette_number, void *palette)
 Charger une palette de 256 couleurs dans les palettes étendues les fonds

Description détaillée

Load palettes, change palette colors, set the gamma, etc...

Documentation des macro

#define PA_LoadPal (  palette,
source   )     DMA_Copy((void*)source, (void*)palette, 256, DMA_16NOW);
 

Charger une palette de 256 couleurs pour les fonds ou les sprites pour l'écran 0 ou 1. Ex : PA_LoadPal(PALETTE_BG1, bg_pal);

Paramètres:
palette Charger pour les Bg ou les Sprites, sur l'écran 0 ou 1 : PAL_BG0, PAL_SPRITE0, PAL_BG1, ou PAL_SPRITE1
source Nom de la palette (ex : master_Palette)

#define PA_LoadPal16 (  palette,
n_palette,
source   )     DMA_Copy((void*)source, (void*)(palette + (n_palette << 5)), 16, DMA_16NOW);
 

Charger une palette de 16 couleurs pour les fonds ou les sprites pour l'écran 0 ou 1. Ex : PA_LoadPal16(PALETTE_BG1, 4, bg_pal);

Paramètres:
palette Charger pour les Bg ou les Sprites, sur l'écran 0 ou 1 : PAL_BG0, PAL_SPRITE0, PAL_BG1, ou PAL_SPRITE1
n_palette Numéro de la palette de 16 couleurs que l'on veut charger (0-15)

source Nom de la palette (ex : master_Palette)

#define PA_RGB (  r,
g,
b   )     ((1 << 15) + (r) + ((g)<<5) + ((b)<<10))
 

Convertir une couleurs au format Rouge, Vert, Bleu en un nombre utilisable par le système de palette. Attention : sur Gba, les valeurs vont de 0 à 31...

Paramètres:
r Rouge (0-31)
g Vert (0-31)
b Bleu (0-31)

#define PA_SetBgPalCol (  screen,
color_number,
colorRGB   )     BG_PALETTE[color_number + (screen << 9)] = colorRGB
 

Changer la couleur d'une des couleurs de la palette des fonds

Paramètres:
screen Ecran...
color_number Numéro de la couleur dans la palette (0-255)
colorRGB Valeur RGB, comme PA_RGB(31, 31, 31) pour blanc

#define PA_SetSpritePalCol (  screen,
color_number,
colorRGB   )     BG_PALETTE[256 + color_number + (screen << 9)] = colorRGB
 

Changer la couleur d'une des couleurs de la palette des sprites

Paramètres:
screen Ecran...
color_number Numéro de la couleur dans la palette (0-255)
colorRGB Valeur RGB, comme PA_RGB(31, 31, 31) pour blanc

Documentation des fonctions

void PA_LoadBgExtPal (  bool  screen,
u16  palette_number,
void *  palette
) 
 

Charger une palette de 256 couleurs dans les palettes étendues les fonds

Paramètres:
screen Ecran...
palette_number Numéro de la palette (0-15)
palette Nom de la palette à charger ((void*)nom_palette)

void PA_LoadSpriteExtPal (  bool  screen,
u16  palette_number,
void *  palette
) 
 

Charger une palette de 256 couleurs dans les palettes étendues des sprites

Paramètres:
screen Ecran...
palette_number Numéro de la palette (0-15)
palette Nom de la palette à charger ((void*)nom_palette)

void PA_SetBrightness (  bool  screen,
s8  bright
) 
 

Régler la luminosité de l'écran

Paramètres:
screen Choix de l'écran (0 ou 1)
bright Luminosité, de -32 à 32, 0 étant neutre

inline void PA_SetPal16Neg (  u32  palette,
u8  n_palette
)  [inline]
 

Négativer une palette de 16 couleurs donnée. Pour annuler, il suffit de négativer à nouveau.

Paramètres:
palette Charger pour les Bg ou les Sprites, sur l'écran 0 ou 1 : PAL_BG0, PAL_SPRITE0, PAL_BG1, ou PAL_SPRITE1
n_palette Numéro de la palette de 16 couleurs (0-15)

inline void PA_SetPalNeg (  u32  palette  )  [inline]
 

Négativer une palette donnée. Pour annuler, il suffit de négativer à nouveau.

Paramètres:
palette Charger pour les Bg ou les Sprites, sur l'écran 0 ou 1 : PAL_BG0, PAL_SPRITE0, PAL_BG1, ou PAL_SPRITE1

Généré le Fri Oct 28 23:18:14 2005 pour PA_lib par  doxygen 1.3.9.1
@ 1.1.1.1 log @Initial import of PalibDoc, begin on PAlib0.64b @ text @@