PAlib: Large Maps

Page principale | Modules | Liste des fichiers | Portée globale | Rechercher

# Large Maps

## Macros

#define | PA_LoadLargeBg(screen, bg_select, bg_tiles, bg_map, color_mode, lx, ly)
| Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large)
#define | PA_LoadPAGfxLargeBg(screen, bg_number, bg_name)
| Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large), converti avec PAGfx
#define | PA_LoadLargeBgEx(screen, bg_select, bg_tiles, tile_size, bg_map, color_mode, lx, ly)
| Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large), mais ici on met soi-meme la taille des tiles

## Fonctions

void | PA_InfLargeScrollX (u8 screen, u8 bg_select, s32 x)
| Déplacer un fond à scrolling 'infini' horizontalement. Doit etre initialisé avec PA_LoadLargeBg.
void | PA_InfLargeScrollY (u8 screen, u8 bg_select, s32 y)
| Déplacer un fond à scrolling 'infini' verticalement. Doit etre initialisé avec PA_LoadLargeBg.
void | PA_InfLargeScrollXY (u8 screen, u8 bg_select, s32 x, s32 y)
| Déplacer un fond à scrolling 'infini' horizontalement et verticalement. Doit etre initialisé avec PA_LoadLargeBg.
void | PA_LargeScrollX (u8 screen, u8 bg_select, s32 x)
| Déplacer un grand fond à scrolling horizontalement.Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...
void | PA_LargeScrollY (u8 screen, u8 bg_select, s32 y)
| Déplacer un grand fond à scrolling verticalement. Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...
void | PA_LargeScrollXY (u8 screen, u8 bg_select, s32 x, s32 y)
| Déplacer un grand fond à scrolling horizontalement et verticalement. Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...
void | PA_InitParallaxX (u8 screen, s32 bg0, s32 bg1, s32 bg2, s32 bg3)
| Initialiser le Parallax Scrolling pour plusieurs fonds, horizontalement. Choix de la vitesse à laquelle les fonds vont défiler par rapport aux autres... Utiliser PA_ParallaxScrollX par la suite pour scroller
void | PA_InitParallaxY (u8 screen, s32 bg0, s32 bg1, s32 bg2, s32 bg3)
| Initialiser le Parallax Scrolling pour plusieurs fonds, horizontalement. Choix de la vitesse à laquelle les fonds vont défiler par rapport aux autres... Utiliser PA_ParallaxScrollX par la suite pour scroller
void | PA_ParallaxScrollX (u8 screen, s32 x)
| Déplacer les fonds activés pour le parallax...
void | PA_ParallaxScrollY (u8 screen, s32 y)
| Déplacer les fonds activés pour le parallax...
void | PA_ParallaxScrollXY (u8 screen, s32 x, s32 y)
| Déplacer les fonds activés pour le parallax...

## Description détaillée

Load Large Maps, scroll them...

## Documentation des macro

#define PA_LoadLargeBg | ( | screen,
|  | bg_select,
|  | bg_tiles,
|  | bg_map,
|  | color_mode,
|  | lx,
|  | ly |  | ) |

Valeur:

    {\
    PA_LoadSimpleBg(screen, bg_select, bg_tiles, Blank, BG_512X256, 0, color_mode);\
    PA_InitLargeBg(screen, bg_select, lx, ly, (void*)bg_map);}

Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large)

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | bg_tiles | Nom du tableau contenant les tiles (exemple: ship_Tiles)
  | bg_map | Nom du tableau contenant les infos sur la map (exemple : ship_Map)
  | color_mode | Nombre de couleurs : 0 pour 16 couleurs, 1 pour 256
  | lx | Largeur, en tiles. Un fond de 512 pixels de large fera 64 tiles de large.
  | ly | Hauteur, en tiles. Un fond de 512 pixels de hauy fera 64 tiles de haut.

#define PA_LoadLargeBgEx | ( | screen,
|  | bg_select,
|  | bg_tiles,
|  | tile_size,
|  | bg_map,
|  | color_mode,
|  | lx,
|  | ly |  | ) |

Valeur:

    {\
    PA_LoadBg(screen, bg_select, bg_tiles, tile_size, Blank, BG_512X256, 0, color_mode);\
    PA_InitLargeBg(screen, bg_select, lx, ly, (void*)bg_map);}

Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large), mais ici on met soi-meme la taille des tiles

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | bg_tiles | Nom du tableau contenant les tiles (exemple: ship_Tiles)
  | tile_size | Taille du tilset
  | bg_map | Nom du tableau contenant les infos sur la map (exemple : ship_Map)
  | color_mode | Nombre de couleurs : 0 pour 16 couleurs, 1 pour 256
  | lx | Largeur, en tiles. Un fond de 512 pixels de large fera 64 tiles de large.
  | ly | Hauteur, en tiles. Un fond de 512 pixels de hauy fera 64 tiles de haut.

#define PA_LoadPAGfxLargeBg | ( | screen,
|  | bg_number,
|  | bg_name |  | ) |

Valeur:

    {\
           PA_LoadBgPal(screen, bg_number, (void*)bg_name##_Pal); \
           PA_LoadLargeBg(screen, bg_number, bg_name##_Tiles, bg_name##_Map, 1, (bg_name##_Width) >> 3, (bg_name##_Height) >> 3);}

Charger et initialiser un fond pour le scrolling infini (pour les fonds de plus de 512 pixels de haut ou de large), converti avec PAGfx

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_number | Numéro du fond que l'on veut charger (0-3)
  | bg_name | Nom du fond dans PAGfx

## Documentation des fonctions

void PA_InfLargeScrollX | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | x
| ) |

Déplacer un fond à scrolling 'infini' horizontalement. Doit etre initialisé avec PA_LoadLargeBg.

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | x | Valeur X à déplacer

inline void PA_InfLargeScrollXY | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | x,
|  | s32 | y
| ) | `[inline]`

Déplacer un fond à scrolling 'infini' horizontalement et verticalement. Doit etre initialisé avec PA_LoadLargeBg.

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | x | Valeur X à déplacer
  | y | Valeur Y à déplacer

void PA_InfLargeScrollY | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | y
| ) |

Déplacer un fond à scrolling 'infini' verticalement. Doit etre initialisé avec PA_LoadLargeBg.

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | y | Valeur Y à déplacer

inline void PA_InitParallaxX | ( | u8 | screen,
|  | s32 | bg0,
|  | s32 | bg1,
|  | s32 | bg2,
|  | s32 | bg3
| ) | `[inline]`

Initialiser le Parallax Scrolling pour plusieurs fonds, horizontalement. Choix de la vitesse à laquelle les fonds vont défiler par rapport aux autres... Utiliser PA_ParallaxScrollX par la suite pour scroller

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg0 | Valeur pour le premier fond (0). 256 met en vitesse normal, moins pour moins lent (128 pour moitié de vitesse), plus pour plus rapide (512 équivaut à 2 fois plus vite). On peut utiliser des valeurs négatives. 0 désactive le scrolling parallax pour ce fond
  | bg1 | Idem, pour le Fond 1
  | bg2 | Idem, pour le Fond 2
  | bg3 | Idem, pour le Fond 3

inline void PA_InitParallaxY | ( | u8 | screen,
|  | s32 | bg0,
|  | s32 | bg1,
|  | s32 | bg2,
|  | s32 | bg3
| ) | `[inline]`

Initialiser le Parallax Scrolling pour plusieurs fonds, horizontalement. Choix de la vitesse à laquelle les fonds vont défiler par rapport aux autres... Utiliser PA_ParallaxScrollX par la suite pour scroller

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg0 | Valeur pour le premier fond (0). 256 met en vitesse normal, moins pour moins lent (128 pour moitié de vitesse), plus pour plus rapide (512 équivaut à 2 fois plus vite). On peut utiliser des valeurs négatives. 0 désactive le scrolling parallax pour ce fond
  | bg1 | Idem, pour le Fond 1
  | bg2 | Idem, pour le Fond 2
  | bg3 | Idem, pour le Fond 3

void PA_LargeScrollX | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | x
| ) |

Déplacer un grand fond à scrolling horizontalement.Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | x | Valeur X à déplacer

inline void PA_LargeScrollXY | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | x,
|  | s32 | y
| ) | `[inline]`

Déplacer un grand fond à scrolling horizontalement et verticalement. Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | x | Valeur X à déplacer
  | y | Valeur Y à déplacer

void PA_LargeScrollY | ( | u8 | screen,
|  | u8 | bg_select,
|  | s32 | y
| ) |

Déplacer un grand fond à scrolling verticalement. Doit etre initialisé avec PA_LoadLargeBg. Cette fonction ne permet pas au fond de 'boucler' sur lui-meme, mais est bien plus rapide que InfLargeScroll...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | bg_select | Numéro du fond que l'on veut charger (de 0 à 3 en mode 0, uniquement 2 et 3 en mode 2)
  | y | Valeur Y à déplacer

inline void PA_ParallaxScrollX | ( | u8 | screen,
|  | s32 | x
| ) | `[inline]`

Déplacer les fonds activés pour le parallax...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | x | Valeur X à déplacer

inline void PA_ParallaxScrollXY | ( | u8 | screen,
|  | s32 | x,
|  | s32 | y
| ) | `[inline]`

Déplacer les fonds activés pour le parallax...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | x | Valeur X à déplacer
  | y | Valeur Y à déplacer

inline void PA_ParallaxScrollY | ( | u8 | screen,
|  | s32 | y
| ) | `[inline]`

Déplacer les fonds activés pour le parallax...

Paramètres:

  | screen | Choix de l'écran (0 ou 1)
  | y | Valeur Y à déplacer