![]() |
libdragon
|
RDP Command queue: high-level sprite loading and blitting. More...
Functions | |
int | __rdpq_sprite_upload (rdpq_tile_t tile, sprite_t *sprite, const rdpq_texparms_t *parms, bool set_mode) |
Internal implementation of rdpq_sprite_upload that will optionally skip setting render modes. | |
int | rdpq_sprite_upload (rdpq_tile_t tile, sprite_t *sprite, const rdpq_texparms_t *parms) |
Upload a sprite to TMEM, making it ready for drawing. More... | |
void | rdpq_sprite_blit (sprite_t *sprite, float x0, float y0, const rdpq_blitparms_t *parms) |
Blit a sprite to the active framebuffer. More... | |
RDP Command queue: high-level sprite loading and blitting.
int rdpq_sprite_upload | ( | rdpq_tile_t | tile, |
sprite_t * | sprite, | ||
const rdpq_texparms_t * | parms | ||
) |
Upload a sprite to TMEM, making it ready for drawing.
This function will upload a sprite to TMEM, making it ready for drawing. It is similar to rdpq_tex_upload which can be used for any surface, but it builds upon it with sprite-specific features:
After calling this function, the specified tile descriptor will be ready to be used in drawing primitives like rdpq_triangle or rdpq_texture_rectangle.
This function is meant for sprites that can be loaded in full into TMEM; it will assert if the sprite does not fit TMEM. For larger sprites, either use rdpq_sprite_blit to directly draw then (handling partial uploads transparently), or use rdpq_tex_upload_sub to manually upload a smaller portion of the sprite.
To load multiple sprites in TMEM at once (for instance, for multitexturing), you can manually specify the parms->tmem_addr
for the second sprite, or call rdpq_tex_multi_begin / rdpq_tex_multi_end around multiple calls to rdpq_sprite_upload. For instance:
To speed up loading of a sprite, you can record the loading sequence in a rspq block and replay it any time later. For instance:
tile | Tile descriptor that will be initialized with this sprite |
sprite | Sprite to upload |
parms | Texture upload parameters to use |
void rdpq_sprite_blit | ( | sprite_t * | sprite, |
float | x0, | ||
float | y0, | ||
const rdpq_blitparms_t * | parms | ||
) |
Blit a sprite to the active framebuffer.
This function will perform a blit of a sprite to the active framebuffer, with several features like source rectangle selection, scaling, rotation, etc.
The function is similar to rdpq_tex_blit, but it works on a sprite rather than a generic surface. In addition to the standard features of rdpq_tex_blit, it will also handle sprite-specific features:
Just like rdpq_tex_blit, this function is designed to work with sprites of arbitrary sizes; those that won't fit in TMEM will be automatically split in multiple chunks to perform the requested operation.
Please refer to rdpq_tex_blit for a full overview of the features.
sprite | Sprite to blit |
x0 | X coordinate on the framebuffer where to draw the surface |
y0 | Y coordinate on the framebuffer where to draw the surface |
parms | Parameters for the blit operation (or NULL for default) |