worked on rewrite of sprite

This commit is contained in:
herbglitch 2025-03-23 00:45:39 -06:00
parent 1b2e2cb7f1
commit 0918b6f225
4 changed files with 125 additions and 113 deletions

View file

@ -11,27 +11,46 @@ extern "C" {
#include "arc/math/rectangle.h"
#include "arc/std/array.h"
/**
* @brief
*/
typedef enum ARC_SpriteAxis {
ARC_SPRITE_AXIS_NONE = 0x00,
ARC_SPRITE_AXIS_Y = 0x01,
ARC_SPRITE_AXIS_X = 0x02,
} ARC_SpriteAxix;
/**
* @brief a sprite type
*
* @note the actual type should be define by overriding for a graphics api
*/
typedef struct ARC_Sprite ARC_Sprite;
*/
typedef struct ARC_Sprite {
ARC_Spritesheet *spritesheet;
ARC_Array frames;
uint32_t frameIndex;
double angle;
ARC_FPoint origin;
float opacity;
ARC_SpriteAxix axis;
} ARC_Sprite;
/**
* @brief creates ARC_Sprite type
*
* @param sprite ARC_Sprite that is being created
* @param spritesheet ARC_Spritesheet that ARC_Sprite will be pulled from
* @param frames ARC_Array of bounds of sprite on spritesheet
*/
void ARC_Sprite_Create(ARC_Sprite **sprite, ARC_Spritesheet *spritesheet, ARC_Array *frames);
* @param frames ARC_Array of ARC_FRect bounds of sprite on spritesheet
*/
void ARC_Sprite_Create(ARC_Sprite **sprite, ARC_Spritesheet *spritesheet, ARC_Array frames);
/**
* @brief destroys ARC_Sprite type
*
* @param sprite ARC_Sprite to destroy
*/
*/
void ARC_Sprite_Destroy(ARC_Sprite *sprite);
/**
@ -39,20 +58,8 @@ void ARC_Sprite_Destroy(ARC_Sprite *sprite);
*
* @param newSprite ARC_Sprite that is being copied to and created
* @param oldSprite ARC_Sprite contents that are being copied
*/
void ARC_Sprite_Copy(ARC_Sprite **newSprite, ARC_Sprite *oldSprite);
//TODO: temp
/**
* @brief sets ARC_Sprite's opacity
*
* @param sprite ARC_Sprite that is changing opacity
* @param opacity new opacity for ARC_Sprite
*
* @note this is temp because opacity probably should be a value
* bigger than 255
*/
void ARC_Sprite_SetOpacity(ARC_Sprite *sprite, uint8_t opacity);
void ARC_Sprite_Copy(ARC_Sprite **newSprite, ARC_Sprite *oldSprite);
/**
* @brief renders ARC_Sprite type
@ -60,51 +67,59 @@ void ARC_Sprite_SetOpacity(ARC_Sprite *sprite, uint8_t opacity);
* @param sprite ARC_Sprite that will be rendered
* @param renderer ARC_Renderer that is handling rendering
* @param renderBounds area of renderer that ARC_Sprite will be rendered to
*/
void ARC_Sprite_Render(ARC_Sprite *sprite, ARC_Renderer *renderer, ARC_Rect *renderBounds);
//TODO: move this to a better location
typedef enum ARC_Sprite_Axis {
ARC_SPRITE_AXIS_NONE = 0x00,
ARC_SPRITE_AXIS_Y = 0x01,
ARC_SPRITE_AXIS_X = 0x02,
} ARC_Sprite_Axix;
*/
void ARC_Sprite_Render(ARC_Sprite *sprite, ARC_Renderer *renderer, ARC_FRect renderBounds);
/**
* @brief renders ARC_Sprite type with flip
* @brief renders ARC_Sprite type at a point and at a set scale
*
* @param sprite ARC_Sprite that will be rendered
* @param renderer ARC_Renderer that is handling rendering
* @param renderBounds area of renderer that ARC_Sprite will be rendered to
* @param axis axis to flip sprite
*/
void ARC_Sprite_RenderFlip(ARC_Sprite *sprite, ARC_Renderer *renderer, ARC_Rect *renderBounds, enum ARC_Sprite_Axis axis);
* @param sprite ARC_Sprite that will be rendered
* @param renderer ARC_Renderer that is handling rendering
* @param point point on the renderer that ARC_Sprite will be rendered to (will be scaled as well)
* @param scale the scale to render at
*/
void ARC_Sprite_RenderAt(ARC_Sprite *sprite, ARC_Renderer *renderer, ARC_FPoint point, double scale);
/**
* @brief renders ARC_Sprite type with rotation
* @brief switches ARC_Sprite's frames to next for animation
*
* @param sprite ARC_Sprite that will be rendered
* @param renderer ARC_Renderer that is handling rendering
* @param renderBounds area of renderer that ARC_Sprite will be rendered to
* @param angle angle to rotate ARC_Sprite
* @param center point to rotate ARC_Sprite around
*/
void ARC_Sprite_RenderRotated(ARC_Sprite *sprite, ARC_Renderer *renderer, ARC_Rect *renderBounds, ARC_Point *center, double angle);
* @param sprite ARC_Sprite that is having its frame updated
*/
void ARC_Sprite_IterateFrame(ARC_Sprite *sprite);
/**
* @brief switches ARC_Sprite's frame to specified index
*
* @param sprite ARC_Sprite that is having its frame set
* @param index uint32_t to set ARC_Sprite's frame index to
*/
*/
void ARC_Sprite_SetFrameIndex(ARC_Sprite *sprite, uint32_t index);
/**
* @brief switches ARC_Sprite's frames to next for animation
* @brief sets the origin point of the sprite (the rotation and position point)
*
* @param sprite ARC_Sprite that is having its frame updated
*/
void ARC_Sprite_IterateFrame(ARC_Sprite *sprite);
* @param sprite ARC_Sprite that is having its angle set
* @param index the given agnel in degrees to rotate around (rotated clockwise)
*/
void ARC_Sprite_SetAngle(ARC_Sprite *sprite, double angle);
/**
* @brief sets the origin point of the sprite (the rotation and position point)
*
* @param sprite ARC_Sprite that is having its origin set
* @param origin the point on the arc sprite (based on its bounds/frame) to rotate around
*/
void ARC_Sprite_SetOrigin(ARC_Sprite *sprite, ARC_FPoint origin);
/**
* @brief sets ARC_Sprite's opacity
*
* @note opacity is a float value between 0.0 and 1.0 (1.0 is fully opaque)
*
* @param sprite ARC_Sprite that is changing opacity
* @param opacity new opacity for ARC_Sprite
*/
void ARC_Sprite_SetOpacity(ARC_Sprite *sprite, float opacity);
/**
* @brief gets ARC_Sprite's current frame
@ -112,22 +127,22 @@ void ARC_Sprite_IterateFrame(ARC_Sprite *sprite);
* @param sprite ARC_Sprite to get frame from
*
* @return index ARC_Sprite's current frame index
*/
*/
uint32_t ARC_Sprite_GetFrameIndex(ARC_Sprite *sprite);
/**
* @brief returns the current bounds based on the ARC_Sprite's frames
*
* @param sprite ARC_Sprite to get bounds from
*/
ARC_Rect *ARC_Sprite_GetBounds(ARC_Sprite *sprite);
*/
ARC_FRect *ARC_Sprite_GetBounds(ARC_Sprite *sprite);
/**
* @brief returns the array of bounds that a sprite has
*
* @param sprite ARC_Sprite to get all the bounds from
*/
ARC_Array *ARC_Sprite_GetAllBounds(ARC_Sprite *sprite);
ARC_Array ARC_Sprite_GetAllBounds(ARC_Sprite *sprite);
#ifdef __cplusplus
}