doxygen/sprites_8h_source.html

/*

** Jo Sega Saturn Engine

** Copyright (c) 2012-2026, Johannes Fetz (johannesfetz@gmail.com)

** All rights reserved.

**

** Redistribution and use in source and binary forms, with or without

** modification, are permitted provided that the following conditions are met:

**     * Redistributions of source code must retain the above copyright

**       notice, this list of conditions and the following disclaimer.

**     * Redistributions in binary form must reproduce the above copyright

**       notice, this list of conditions and the following disclaimer in the

**       documentation and/or other materials provided with the distribution.

**     * Neither the name of the Johannes Fetz nor the

**       names of its contributors may be used to endorse or promote products

**       derived from this software without specific prior written permission.

**

** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

** DISCLAIMED. IN NO EVENT SHALL Johannes Fetz BE LIABLE FOR ANY

** DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/


#ifndef __JO_SPRITES_H__

# define __JO_SPRITES_H__


/*

██╗███╗   ██╗████████╗███████╗██████╗ ███╗   ██╗ █████╗ ██╗

██║████╗  ██║╚══██╔══╝██╔════╝██╔══██╗████╗  ██║██╔══██╗██║

██║██╔██╗ ██║   ██║   █████╗  ██████╔╝██╔██╗ ██║███████║██║

██║██║╚██╗██║   ██║   ██╔══╝  ██╔══██╗██║╚██╗██║██╔══██║██║

██║██║ ╚████║   ██║   ███████╗██║  ██║██║ ╚████║██║  ██║███████╗

╚═╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝

▲ DO NOT USE THESE FUNCTIONS ▲

*/


extern jo_sprite_attributes    __jo_sprite_attributes;

extern jo_texture_definition        __jo_sprite_def[JO_MAX_SPRITE];

extern jo_picture_definition   __jo_sprite_pic[JO_MAX_SPRITE];

extern unsigned short           __jo_sprite_lut[JO_MAX_SPRITE];

void    jo_sprite_draw(const int sprite_id, const jo_pos3D * const pos, const bool centered_style_coordinates, const bool billboard);

void    jo_sprite_draw_rotate(const int sprite_id, const jo_pos3D * const pos, const int angle, const bool centered_style_coordinates, const bool billboard);


static  __jo_force_inline void  __internal_jo_sprite_set_position3D(const int x, const int y, const int z)

{

    extern jo_pos3D __jo_sprite_pos;

    __jo_sprite_pos.x = x;

    __jo_sprite_pos.y = y;

    __jo_sprite_pos.z = z;

}


/*

 █████╗ ██████╗ ██████╗     ██╗██████╗ ███████╗██████╗ ██╗      █████╗  ██████╗███████╗    ██╗███████╗██████╗ ███████╗███████╗

██╔══██╗██╔══██╗██╔══██╗   ██╔╝██╔══██╗██╔════╝██╔══██╗██║     ██╔══██╗██╔════╝██╔════╝   ██╔╝██╔════╝██╔══██╗██╔════╝██╔════╝

███████║██║  ██║██║  ██║  ██╔╝ ██████╔╝█████╗  ██████╔╝██║     ███████║██║     █████╗    ██╔╝ █████╗  ██████╔╝█████╗  █████╗

██╔══██║██║  ██║██║  ██║ ██╔╝  ██╔══██╗██╔══╝  ██╔═══╝ ██║     ██╔══██║██║     ██╔══╝   ██╔╝  ██╔══╝  ██╔══██╗██╔══╝  ██╔══╝

██║  ██║██████╔╝██████╔╝██╔╝   ██║  ██║███████╗██║     ███████╗██║  ██║╚██████╗███████╗██╔╝   ██║     ██║  ██║███████╗███████╗

╚═╝  ╚═╝╚═════╝ ╚═════╝ ╚═╝    ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝    ╚═╝     ╚═╝  ╚═╝╚══════╝╚══════╝

*/


int     jo_get_last_sprite_id(void);


int     jo_sprite_add(const jo_img * const img);


int     jo_sprite_add_8bits_image(const jo_img_8bits * const img);


int     jo_sprite_add_4bits_lut(const unsigned char * const pixels, const unsigned short width, const unsigned short height,

                                const jo_color * const lut);


int     jo_sprite_add_image_4bits_lut(const jo_img * const img);


int     __jo_sprite_add_4bits(const void * const pixels, const unsigned short width, const unsigned short height, const unsigned short lut);


int     jo_sprite_replace(const jo_img * const img, const int sprite_id);


int     __jo_sprite_replace(const jo_img * const img, const int sprite_id, const bool async);


bool    jo_sprite_add_end_codes(const int sprite_id);


void    jo_sprite_free_from(const int sprite_id);


static  __jo_force_inline void  jo_sprite_free_all(void)

{

    jo_sprite_free_from(0);

}


# ifdef JO_COMPILE_WITH_SPRITE_HASHTABLE

int     jo_sprite_name2id(const char *const filename);

#endif


/*

████████╗██████╗  █████╗ ███╗   ██╗███████╗██████╗  █████╗ ██████╗ ███████╗███╗   ██╗ ██████╗██╗   ██╗

╚══██╔══╝██╔══██╗██╔══██╗████╗  ██║██╔════╝██╔══██╗██╔══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝╚██╗ ██╔╝

   ██║   ██████╔╝███████║██╔██╗ ██║███████╗██████╔╝███████║██████╔╝█████╗  ██╔██╗ ██║██║      ╚████╔╝

   ██║   ██╔══██╗██╔══██║██║╚██╗██║╚════██║██╔═══╝ ██╔══██║██╔══██╗██╔══╝  ██║╚██╗██║██║       ╚██╔╝

   ██║   ██║  ██║██║  ██║██║ ╚████║███████║██║     ██║  ██║██║  ██║███████╗██║ ╚████║╚██████╗   ██║

   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═══╝ ╚═════╝   ╚═╝

*/


/*

** Screen doors filter (old school transparency)

*/


static  __jo_force_inline void  jo_sprite_enable_screen_doors_filter(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.effect, 0x100);

}


static  __jo_force_inline void  jo_sprite_disable_screen_doors_filter(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.effect, 0x100);

}


/*

** Half transparency

*/


static  __jo_force_inline void  jo_sprite_enable_half_transparency(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.effect, 0x3);

}


static  __jo_force_inline void  jo_sprite_disable_half_transparency(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.effect, 0x3);

}


/*

███████╗██╗  ██╗ █████╗ ██████╗  ██████╗ ██╗    ██╗

██╔════╝██║  ██║██╔══██╗██╔══██╗██╔═══██╗██║    ██║

███████╗███████║███████║██║  ██║██║   ██║██║ █╗ ██║

╚════██║██╔══██║██╔══██║██║  ██║██║   ██║██║███╗██║

███████║██║  ██║██║  ██║██████╔╝╚██████╔╝╚███╔███╔╝

╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝  ╚═════╝  ╚══╝╚══╝

*/


static  __jo_force_inline void  jo_sprite_enable_shadow_filter(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.effect, 0x1);

}


static  __jo_force_inline void  jo_sprite_disable_shadow_filter(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.effect, 0x1);

}


/*

** Dark filter

*/


static  __jo_force_inline void  jo_sprite_enable_dark_filter(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.effect, 0x2);

}


static  __jo_force_inline void  jo_sprite_disable_dark_filter(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.effect, 0x2);

}


/*

 ██████╗  ██████╗ ██╗   ██╗██████╗  █████╗ ██╗   ██╗██████╗     ███████╗██╗  ██╗ █████╗ ██████╗ ██╗███╗   ██╗ ██████╗

██╔════╝ ██╔═══██╗██║   ██║██╔══██╗██╔══██╗██║   ██║██╔══██╗    ██╔════╝██║  ██║██╔══██╗██╔══██╗██║████╗  ██║██╔════╝

██║  ███╗██║   ██║██║   ██║██████╔╝███████║██║   ██║██║  ██║    ███████╗███████║███████║██║  ██║██║██╔██╗ ██║██║  ███╗

██║   ██║██║   ██║██║   ██║██╔══██╗██╔══██║██║   ██║██║  ██║    ╚════██║██╔══██║██╔══██║██║  ██║██║██║╚██╗██║██║   ██║

╚██████╔╝╚██████╔╝╚██████╔╝██║  ██║██║  ██║╚██████╔╝██████╔╝    ███████║██║  ██║██║  ██║██████╔╝██║██║ ╚████║╚██████╔╝

 ╚═════╝  ╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝╚═╝  ╚═══╝ ╚═════╝

*/


# define JO_NO_GOURAUD_COLOR            (0xc210)


void    jo_set_gouraud_shading_colors(const jo_color topleft_color,

                                      const jo_color topright_color,

                                      const jo_color bottomright_color,

                                      const jo_color bottomleft_color);


static  __jo_force_inline void  jo_sprite_enable_gouraud_shading(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.effect, 0x4);

}


static  __jo_force_inline void  jo_sprite_disable_gouraud_shading(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.effect, 0x4);

}


static  __jo_force_inline void  jo_sprite_set_gouraud_table(const unsigned short table)

{

    __jo_sprite_attributes.gouraud_shading_index = table;

}


# define JO_DEFAULT_BRIGHTNESS      (16)


# define JO_MAX_BRIGHTNESS          (31)


void     jo_set_gouraud_shading_brightness(const unsigned char brightness);


/*

██╗  ██╗ ██████╗ ██████╗ ██╗███████╗    ██╗██╗   ██╗███████╗██████╗ ████████╗    ███████╗██╗     ██╗██████╗

██║  ██║██╔═══██╗██╔══██╗██║╚══███╔╝   ██╔╝██║   ██║██╔════╝██╔══██╗╚══██╔══╝    ██╔════╝██║     ██║██╔══██╗

███████║██║   ██║██████╔╝██║  ███╔╝   ██╔╝ ██║   ██║█████╗  ██████╔╝   ██║       █████╗  ██║     ██║██████╔╝

██╔══██║██║   ██║██╔══██╗██║ ███╔╝   ██╔╝  ╚██╗ ██╔╝██╔══╝  ██╔══██╗   ██║       ██╔══╝  ██║     ██║██╔═══╝

██║  ██║╚██████╔╝██║  ██║██║███████╗██╔╝    ╚████╔╝ ███████╗██║  ██║   ██║       ██║     ███████╗██║██║

╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝╚══════╝╚═╝      ╚═══╝  ╚══════╝╚═╝  ╚═╝   ╚═╝       ╚═╝     ╚══════╝╚═╝╚═╝

*/


static  __jo_force_inline void  jo_sprite_enable_vertical_flip(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.direction, 0x20);

}


static  __jo_force_inline void  jo_sprite_disable_vertical_flip(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.direction, 0x20);

}


static  __jo_force_inline void  jo_sprite_enable_horizontal_flip(void)

{

    JO_ADD_FLAG(__jo_sprite_attributes.direction, 0x10);

}


static  __jo_force_inline void  jo_sprite_disable_horizontal_flip(void)

{

    JO_REMOVE_FLAG(__jo_sprite_attributes.direction, 0x10);

}


/*

███████╗ ██████╗ █████╗ ██╗     ███████╗

██╔════╝██╔════╝██╔══██╗██║     ██╔════╝

███████╗██║     ███████║██║     █████╗

╚════██║██║     ██╔══██║██║     ██╔══╝

███████║╚██████╗██║  ██║███████╗███████╗

╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝

*/


# define JO_NO_ZOOM             (65536)


static  __jo_force_inline void  jo_sprite_change_sprite_scale(const float scale)

{

    __jo_sprite_attributes.fixed_scale_x = jo_float2fixed(scale);

    __jo_sprite_attributes.fixed_scale_y = __jo_sprite_attributes.fixed_scale_x;

}


static  __jo_force_inline void  jo_sprite_change_sprite_scale_xy(const float scale_x, const float scale_y)

{

    __jo_sprite_attributes.fixed_scale_x = jo_float2fixed(scale_x);

    __jo_sprite_attributes.fixed_scale_y = jo_float2fixed(scale_y);

}


static  __jo_force_inline void  jo_sprite_change_sprite_scale_xy_fixed(const jo_fixed scale_x, const jo_fixed scale_y)

{

    __jo_sprite_attributes.fixed_scale_x = scale_x;

    __jo_sprite_attributes.fixed_scale_y = scale_y;

}


static  __jo_force_inline void  jo_sprite_restore_sprite_scale(void)

{

    __jo_sprite_attributes.fixed_scale_x = JO_NO_ZOOM;

    __jo_sprite_attributes.fixed_scale_y = JO_NO_ZOOM;

}


/*

██████╗ ██████╗  █████╗ ██╗    ██╗

██╔══██╗██╔══██╗██╔══██╗██║    ██║

██║  ██║██████╔╝███████║██║ █╗ ██║

██║  ██║██╔══██╗██╔══██║██║███╗██║

██████╔╝██║  ██║██║  ██║╚███╔███╔╝

╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝

*/


static  __jo_force_inline void  jo_sprite_set_palette(int palette_id)

{

    __jo_sprite_attributes.color_table_index = JO_MULT_BY_256(palette_id);

}


static  __jo_force_inline void  jo_sprite_set_additive_palette(int palette_id)

{

    // (bits 14 and 13: the priority register 3 of the sprites, see JO_VDP2_ADDITIVE_SPRITE_BANK in jo/vdp2.h)

    __jo_sprite_attributes.color_table_index = JO_MULT_BY_256(palette_id) | 0x6000;

}


static  __jo_force_inline void  jo_sprite_draw3D_and_rotate(const int sprite_id, const int x, const int y, const int z, const int angle)

{

    extern jo_pos3D __jo_sprite_pos;

    __internal_jo_sprite_set_position3D(x, y, z);

    jo_sprite_draw_rotate(sprite_id, &__jo_sprite_pos, angle, true, false);

}


static  __jo_force_inline void  jo_sprite_draw3D(const int sprite_id, const int x, const int y, const int z)

{

    extern jo_pos3D __jo_sprite_pos;

    __internal_jo_sprite_set_position3D(x, y, z);

    jo_sprite_draw(sprite_id, &__jo_sprite_pos, true, false);

}


static  __jo_force_inline void  jo_sprite_draw3D_and_rotate2(const int sprite_id, const int x, const int y, const int z, const int angle)

{

    extern jo_pos3D __jo_sprite_pos;

    __internal_jo_sprite_set_position3D(x, y, z);

    jo_sprite_draw_rotate(sprite_id, &__jo_sprite_pos, angle, false, false);

}


static  __jo_force_inline void  jo_sprite_draw3D2(const int sprite_id, const int x, const int y, const int z)

{

    extern jo_pos3D __jo_sprite_pos;

    __internal_jo_sprite_set_position3D(x, y, z);

    jo_sprite_draw(sprite_id, &__jo_sprite_pos, false, false);

}


void        jo_sprite_draw_4p_fixed(const int sprite_id, const jo_pos2D_fixed * const four_points, const jo_fixed z, const bool centered_style_coordinates);


void        jo_sprite_draw_rotated_fixed(const int sprite_id, const jo_fixed x, const jo_fixed y, const jo_fixed z,

                                         const jo_fixed half_width, const jo_fixed half_height, const int angle);


/*

 ██████╗██╗     ██╗██████╗ ██████╗ ██╗███╗   ██╗ ██████╗

██╔════╝██║     ██║██╔══██╗██╔══██╗██║████╗  ██║██╔════╝

██║     ██║     ██║██████╔╝██████╔╝██║██╔██╗ ██║██║  ███╗

██║     ██║     ██║██╔═══╝ ██╔═══╝ ██║██║╚██╗██║██║   ██║

╚██████╗███████╗██║██║     ██║     ██║██║ ╚████║╚██████╔╝

 ╚═════╝╚══════╝╚═╝╚═╝     ╚═╝     ╚═╝╚═╝  ╚═══╝ ╚═════╝

*/


static  __jo_force_inline void  jo_sprite_enable_clipping(bool outside)

{

    __jo_sprite_attributes.clipping = outside ? JO_VDP1_WINDOW_OUT : JO_VDP1_WINDOW_IN;

}


static  __jo_force_inline void  jo_sprite_disable_clipping(void)

{

    __jo_sprite_attributes.clipping = JO_VDP1_NO_WINDOW;

}


void jo_sprite_set_clipping_area(const unsigned int x, const unsigned int y, const unsigned int width, const unsigned int height, const int depth);


void jo_sprite_set_system_clipping_area(const unsigned int width, const unsigned int height);


/*

 ██████╗ ███████╗████████╗    ███████╗██████╗ ██████╗ ██╗████████╗███████╗    ██╗███╗   ██╗███████╗ ██████╗

██╔════╝ ██╔════╝╚══██╔══╝    ██╔════╝██╔══██╗██╔══██╗██║╚══██╔══╝██╔════╝    ██║████╗  ██║██╔════╝██╔═══██╗

██║  ███╗█████╗     ██║       ███████╗██████╔╝██████╔╝██║   ██║   █████╗      ██║██╔██╗ ██║█████╗  ██║   ██║

██║   ██║██╔══╝     ██║       ╚════██║██╔═══╝ ██╔══██╗██║   ██║   ██╔══╝      ██║██║╚██╗██║██╔══╝  ██║   ██║

╚██████╔╝███████╗   ██║       ███████║██║     ██║  ██║██║   ██║   ███████╗    ██║██║ ╚████║██║     ╚██████╔╝

 ╚═════╝ ╚══════╝   ╚═╝       ╚══════╝╚═╝     ╚═╝  ╚═╝╚═╝   ╚═╝   ╚══════╝    ╚═╝╚═╝  ╚═══╝╚═╝      ╚═════╝

*/


static  __jo_force_inline jo_color        jo_sprite_get_pixel_color(const jo_color * const data, const unsigned int x, const unsigned int y, const unsigned int image_width)

{

    return (data[x + y * image_width]);

}


static  __jo_force_inline unsigned char     jo_sprite_get_pixel_palette_index(const unsigned char * const data, const unsigned int x, const unsigned int y, const unsigned int image_width)

{

    return (data[x + y * image_width]);

}


static  __jo_force_inline bool        jo_sprite_is_pixel_transparent(const jo_color * const data, const unsigned int x, const unsigned int y, const unsigned int image_width)

{

    return (jo_sprite_get_pixel_color(data, x, y, image_width) == JO_COLOR_Transparent);

}


static  __jo_force_inline int         jo_sprite_get_width(const int sprite_id)

{

    return (__jo_sprite_def[sprite_id].width);

}


static  __jo_force_inline int           jo_sprite_get_height(const int sprite_id)

{

    return (__jo_sprite_def[sprite_id].height);

}


static  __jo_force_inline void          *jo_sprite_get_raw_data(const int sprite_id)

{

    return (__jo_sprite_pic[sprite_id].data);

}


/*

███████╗████████╗ █████╗ ████████╗██╗███████╗████████╗██╗ ██████╗███████╗

██╔════╝╚══██╔══╝██╔══██╗╚══██╔══╝██║██╔════╝╚══██╔══╝██║██╔════╝██╔════╝

███████╗   ██║   ███████║   ██║   ██║███████╗   ██║   ██║██║     ███████╗

╚════██║   ██║   ██╔══██║   ██║   ██║╚════██║   ██║   ██║██║     ╚════██║

███████║   ██║   ██║  ██║   ██║   ██║███████║   ██║   ██║╚██████╗███████║

╚══════╝   ╚═╝   ╚═╝  ╚═╝   ╚═╝   ╚═╝╚══════╝   ╚═╝   ╚═╝ ╚═════╝╚══════╝

*/


static  __jo_force_inline int         jo_sprite_count(void)

{

    return (jo_get_last_sprite_id() + 1);

}


int                                   jo_sprite_usage_percent(void);


unsigned int                          jo_sprite_free_memory(void);


#endif /* !__JO_SPRITES_H__ */


/*

** END OF FILE

*/

JO_COLOR_Transparent
#define JO_COLOR_Transparent
Transparent color.
Definition colors.h:87

JO_MULT_BY_256
#define JO_MULT_BY_256(X)
Multiply a variable by 256.
Definition math.h:111

jo_float2fixed
static __jo_force_inline jo_fixed jo_float2fixed(const float x)
Convert float to jo engine fixed (avoid usage of GCC Soft Float).
Definition math.h:497

JO_REMOVE_FLAG
#define JO_REMOVE_FLAG(BYTEFIELD, FLAG)
Remove flag in bytefield.
Definition math.h:372

JO_ADD_FLAG
#define JO_ADD_FLAG(BYTEFIELD, FLAG)
Add flag in bytefield.
Definition math.h:366

jo_sprite_draw
void jo_sprite_draw(const int sprite_id, const jo_pos3D *const pos, const bool centered_style_coordinates, const bool billboard)
(internal engine usage)

jo_set_gouraud_shading_colors
void jo_set_gouraud_shading_colors(const jo_color topleft_color, const jo_color topright_color, const jo_color bottomright_color, const jo_color bottomleft_color)
Change Gouraud Shading colors.

jo_sprite_free_memory
unsigned int jo_sprite_free_memory(void)
Get the free sprite memory (VDP1 VRAM).

jo_set_gouraud_shading_brightness
void jo_set_gouraud_shading_brightness(const unsigned char brightness)
Change Gouraud Shading brightness.

jo_sprite_free_from
void jo_sprite_free_from(const int sprite_id)
Free all sprites from the given sprite_id.

jo_sprite_disable_vertical_flip
static __jo_force_inline void jo_sprite_disable_vertical_flip(void)
Disable vertical flip for every sprite displayed after this call.
Definition sprites.h:346

jo_sprite_draw3D_and_rotate
static __jo_force_inline void jo_sprite_draw3D_and_rotate(const int sprite_id, const int x, const int y, const int z, const int angle)
Display a sprite in 3 dimensional space.
Definition sprites.h:449

jo_sprite_set_system_clipping_area
void jo_sprite_set_system_clipping_area(const unsigned int width, const unsigned int height)
Set the VDP1 drawing area (system clipping).

__jo_sprite_def
jo_texture_definition __jo_sprite_def[JO_MAX_SPRITE]
(internal engine usage)

jo_sprite_enable_horizontal_flip
static __jo_force_inline void jo_sprite_enable_horizontal_flip(void)
Activate horizontal flip for every sprite displayed after this call.
Definition sprites.h:352

jo_sprite_name2id
int jo_sprite_name2id(const char *const filename)
Retrive the Sprite Id from filename based on the four first character in the filename.

jo_sprite_count
static __jo_force_inline int jo_sprite_count(void)
Get sprite count.
Definition sprites.h:636

jo_sprite_get_pixel_palette_index
static __jo_force_inline unsigned char jo_sprite_get_pixel_palette_index(const unsigned char *const data, const unsigned int x, const unsigned int y, const unsigned int image_width)
Get a specific pixel palette index from image bytes.
Definition sprites.h:579

jo_sprite_replace
int jo_sprite_replace(const jo_img *const img, const int sprite_id)
Replace a sprite.

jo_sprite_is_pixel_transparent
static __jo_force_inline bool jo_sprite_is_pixel_transparent(const jo_color *const data, const unsigned int x, const unsigned int y, const unsigned int image_width)
Get if a specific pixel is transparent (JO_COLOR_Transparent) in image bytes.
Definition sprites.h:592

jo_sprite_draw3D
static __jo_force_inline void jo_sprite_draw3D(const int sprite_id, const int x, const int y, const int z)
Display a sprite in 3 dimensional space.
Definition sprites.h:462

jo_sprite_set_clipping_area
void jo_sprite_set_clipping_area(const unsigned int x, const unsigned int y, const unsigned int width, const unsigned int height, const int depth)
Set user clipping area.

jo_sprite_enable_clipping
static __jo_force_inline void jo_sprite_enable_clipping(bool outside)
Activate sprite clipping for every sprite displayed after this call.
Definition sprites.h:522

jo_sprite_draw3D2
static __jo_force_inline void jo_sprite_draw3D2(const int sprite_id, const int x, const int y, const int z)
Display a sprite in 3 dimensional space.
Definition sprites.h:489

jo_sprite_set_additive_palette
static __jo_force_inline void jo_sprite_set_additive_palette(int palette_id)
Change palette for every 8 bits sprite displayed after this call: their light is added to the image u...
Definition sprites.h:436

jo_sprite_draw_rotated_fixed
void jo_sprite_draw_rotated_fixed(const int sprite_id, const jo_fixed x, const jo_fixed y, const jo_fixed z, const jo_fixed half_width, const jo_fixed half_height, const int angle)
Display a sprite turned on the screen (any angle: the 4 corners are computed, the sprite is distorted...

jo_sprite_usage_percent
int jo_sprite_usage_percent(void)
Get sprite memory usage.

jo_sprite_disable_clipping
static __jo_force_inline void jo_sprite_disable_clipping(void)
Disable sprite clipping for every sprite displayed after this call.
Definition sprites.h:529

jo_sprite_disable_screen_doors_filter
static __jo_force_inline void jo_sprite_disable_screen_doors_filter(void)
Disable screen doors filter for every sprite displayed after this call.
Definition sprites.h:207

jo_sprite_get_width
static __jo_force_inline int jo_sprite_get_width(const int sprite_id)
Get sprite width.
Definition sprites.h:601

__jo_sprite_pic
jo_picture_definition __jo_sprite_pic[JO_MAX_SPRITE]
(internal engine usage)

jo_sprite_disable_gouraud_shading
static __jo_force_inline void jo_sprite_disable_gouraud_shading(void)
Disable Gouraud Shading for every sprite displayed after this call.
Definition sprites.h:303

jo_sprite_change_sprite_scale_xy
static __jo_force_inline void jo_sprite_change_sprite_scale_xy(const float scale_x, const float scale_y)
Change scale for every sprite displayed after this call.
Definition sprites.h:391

jo_sprite_change_sprite_scale
static __jo_force_inline void jo_sprite_change_sprite_scale(const float scale)
Change scale for every sprite displayed after this call.
Definition sprites.h:381

jo_sprite_add
int jo_sprite_add(const jo_img *const img)
Add a sprite.

jo_sprite_change_sprite_scale_xy_fixed
static __jo_force_inline void jo_sprite_change_sprite_scale_xy_fixed(const jo_fixed scale_x, const jo_fixed scale_y)
Change scale for every sprite displayed after this call using fixed number.
Definition sprites.h:401

jo_sprite_restore_sprite_scale
static __jo_force_inline void jo_sprite_restore_sprite_scale(void)
Restore default scale for every sprite displayed after this call.
Definition sprites.h:409

jo_sprite_disable_horizontal_flip
static __jo_force_inline void jo_sprite_disable_horizontal_flip(void)
Disable horizontal flip for every sprite displayed after this call.
Definition sprites.h:359

jo_sprite_set_palette
static __jo_force_inline void jo_sprite_set_palette(int palette_id)
Change palette for every 8 bits sprite displayed after this call.
Definition sprites.h:427

__jo_sprite_replace
int __jo_sprite_replace(const jo_img *const img, const int sprite_id, const bool async)
Replace a sprite (internal usage).

jo_sprite_get_height
static __jo_force_inline int jo_sprite_get_height(const int sprite_id)
Get sprite height.
Definition sprites.h:610

__internal_jo_sprite_set_position3D
static __jo_force_inline void __internal_jo_sprite_set_position3D(const int x, const int y, const int z)
Internal usage don't use it.
Definition sprites.h:71

jo_sprite_add_image_4bits_lut
int jo_sprite_add_image_4bits_lut(const jo_img *const img)
Add an RGB image of 14 colors at most (the index 15 is the end code of the VDP1) as a 16 colors textu...

jo_sprite_draw_rotate
void jo_sprite_draw_rotate(const int sprite_id, const jo_pos3D *const pos, const int angle, const bool centered_style_coordinates, const bool billboard)
(internal engine usage)

jo_sprite_enable_vertical_flip
static __jo_force_inline void jo_sprite_enable_vertical_flip(void)
Activate vertical flip for every sprite displayed after this call.
Definition sprites.h:339

jo_sprite_disable_half_transparency
static __jo_force_inline void jo_sprite_disable_half_transparency(void)
Disable half transparency for every sprite displayed after this call.
Definition sprites.h:225

__jo_sprite_lut
unsigned short __jo_sprite_lut[JO_MAX_SPRITE]
(internal engine usage) Color lookup table of a 16 colors texture (VRAM address / 8),...

jo_sprite_set_gouraud_table
static __jo_force_inline void jo_sprite_set_gouraud_table(const unsigned short table)
Gouraud table of the sprites displayed after this call with jo_sprite_enable_gouraud_shading() (inste...
Definition sprites.h:312

__jo_sprite_attributes
jo_sprite_attributes __jo_sprite_attributes
Current displayed sprite attribute (internal engine usage).

jo_sprite_get_pixel_color
static __jo_force_inline jo_color jo_sprite_get_pixel_color(const jo_color *const data, const unsigned int x, const unsigned int y, const unsigned int image_width)
Get a specific pixel color from image bytes.
Definition sprites.h:567

jo_sprite_add_end_codes
bool jo_sprite_add_end_codes(const int sprite_id)
Write the VDP1 end codes after the last visible pixel of each line of a sprite (RGB sprites).

jo_sprite_enable_half_transparency
static __jo_force_inline void jo_sprite_enable_half_transparency(void)
Activate half transparency for every sprite displayed after this call.
Definition sprites.h:218

jo_sprite_get_raw_data
static __jo_force_inline void * jo_sprite_get_raw_data(const int sprite_id)
Get sprite raw image contents.
Definition sprites.h:619

jo_sprite_free_all
static __jo_force_inline void jo_sprite_free_all(void)
Free all sprites.
Definition sprites.h:171

jo_sprite_add_4bits_lut
int jo_sprite_add_4bits_lut(const unsigned char *const pixels, const unsigned short width, const unsigned short height, const jo_color *const lut)
Add a 16 colors texture with its color lookup table: 4 bits per pixel (4 times less VRAM than an RGB ...

jo_get_last_sprite_id
int jo_get_last_sprite_id(void)
Get last Sprite Id.

jo_sprite_disable_shadow_filter
static __jo_force_inline void jo_sprite_disable_shadow_filter(void)
Disable shadow filter for every sprite displayed after this call.
Definition sprites.h:248

jo_sprite_add_8bits_image
int jo_sprite_add_8bits_image(const jo_img_8bits *const img)
Add a 8 bits sprite.

jo_sprite_enable_screen_doors_filter
static __jo_force_inline void jo_sprite_enable_screen_doors_filter(void)
Activate screen doors filter for every sprite displayed after this call.
Definition sprites.h:200

JO_NO_ZOOM
#define JO_NO_ZOOM
Value used to keep the original scale (1.0 in jo_fixed).
Definition sprites.h:376

jo_sprite_enable_gouraud_shading
static __jo_force_inline void jo_sprite_enable_gouraud_shading(void)
Activate Gouraud Shading for every sprite displayed after this call.
Definition sprites.h:296

jo_sprite_enable_dark_filter
static __jo_force_inline void jo_sprite_enable_dark_filter(void)
Activate dark filter for every sprite displayed after this call.
Definition sprites.h:259

jo_sprite_enable_shadow_filter
static __jo_force_inline void jo_sprite_enable_shadow_filter(void)
Activate shadow filter for every sprite displayed after this call.
Definition sprites.h:241

jo_sprite_disable_dark_filter
static __jo_force_inline void jo_sprite_disable_dark_filter(void)
Disable dark filter for every sprite displayed after this call.
Definition sprites.h:266

jo_sprite_draw3D_and_rotate2
static __jo_force_inline void jo_sprite_draw3D_and_rotate2(const int sprite_id, const int x, const int y, const int z, const int angle)
Display a sprite in 3 dimensional space.
Definition sprites.h:476

jo_sprite_draw_4p_fixed
void jo_sprite_draw_4p_fixed(const int sprite_id, const jo_pos2D_fixed *const four_points, const jo_fixed z, const bool centered_style_coordinates)

__jo_sprite_add_4bits
int __jo_sprite_add_4bits(const void *const pixels, const unsigned short width, const unsigned short height, const unsigned short lut)
Add a 16 colors texture that uses the color lookup table of another one (internal engine usage: small...

__jo_force_inline
#define __jo_force_inline
force inline attribute (and prevent Doxygen prototype parsing bug)
Definition types.h:39

jo_pos3D::y
int y
Definition types.h:76

jo_sprite_attributes::color_table_index
unsigned int color_table_index
Definition types.h:274

jo_color
unsigned short jo_color
15 bits color type
Definition types.h:42

jo_sprite_attributes::effect
unsigned short effect
Definition types.h:272

jo_sprite_attributes::clipping
unsigned int clipping
Definition types.h:278

jo_sprite_attributes::fixed_scale_y
jo_fixed fixed_scale_y
Definition types.h:277

jo_fixed
int jo_fixed
Fixed point Q16.16 number.
Definition types.h:48

jo_pos3D::x
int x
Definition types.h:75

jo_pos3D::z
int z
Definition types.h:77

jo_sprite_attributes::gouraud_shading_index
unsigned int gouraud_shading_index
Definition types.h:275

jo_sprite_attributes::direction
unsigned short direction
Definition types.h:273

jo_sprite_attributes::fixed_scale_x
jo_fixed fixed_scale_x
Definition types.h:276

jo_img
15 bits image struct
Definition types.h:231

jo_img_8bits
8 bits image struct
Definition types.h:239

jo_picture_definition
Picture definition.
Definition types.h:223

jo_pos2D_fixed
2D position using fixed number
Definition types.h:65

jo_pos3D
3D position
Definition types.h:74

jo_sprite_attributes
Sprite attributes.
Definition types.h:271

jo_texture_definition
Texture definition.
Definition types.h:214

JO_VDP1_NO_WINDOW
#define JO_VDP1_NO_WINDOW
No clipping window.
Definition vdp1_command_pipeline.h:128

JO_VDP1_WINDOW_IN
#define JO_VDP1_WINDOW_IN
Draw inside the user clipping area.
Definition vdp1_command_pipeline.h:130

JO_VDP1_WINDOW_OUT
#define JO_VDP1_WINDOW_OUT
Draw outside the user clipping area.
Definition vdp1_command_pipeline.h:132