gx_xf.h

Go to the documentation of this file.

 
// This header is not supposed to be included directly.
// Instead include gx.h
 
#include <stdint.h>
 
#include "powerblocks/core/utils/math/matrix3.h"
#include "powerblocks/core/utils/math/matrix4.h"
#include "powerblocks/core/utils/math/matrix34.h"
 
/* -------------------XF Matrix Control--------------------- */

typedef enum {
    GX_MTX_ID_0  = (0*3),
    GX_MTX_ID_1  = (1*3),
    GX_MTX_ID_2  = (2*3),
    GX_MTX_ID_3  = (3*3),
    GX_MTX_ID_4  = (4*3),
    GX_MTX_ID_5  = (5*3),
    GX_MTX_ID_6  = (6*3),
    GX_MTX_ID_7  = (7*3),
    GX_MTX_ID_8  = (8*3),
    GX_MTX_ID_9  = (9*3),
    GX_MTX_ID_10 = (10*3),
    GX_MTX_ID_11 = (11*3),
    GX_MTX_ID_12 = (12*3),
    GX_MTX_ID_13 = (13*3),
    GX_MTX_ID_14 = (14*3),
    GX_MTX_ID_15 = (15*3),
    GX_MTX_ID_16 = (16*3),
    GX_MTX_ID_17 = (17*3),
    GX_MTX_ID_18 = (18*3),
    GX_MTX_ID_19 = (19*3),
    GX_MTX_ID_20 = (20*3),
 
    GX_MTX_ID_IDENTITY = GX_MTX_ID_20
} gx_mtx_id_t;

extern void gx_flash_viewport(float x, float y, float width, float height, float near, float far, bool jitter);

extern void gx_flash_projection(const matrix4 mtx, bool is_perspective);

extern void gx_flash_matrix(const matrix34 mtx, gx_mtx_id_t index, bool type);

extern void gx_flash_nrm_matrix(const matrix3 mtx, gx_mtx_id_t index);

extern void gx_set_current_psn_matrix(gx_mtx_id_t index);
 
/* -------------------XF Color Control--------------------- */
 
typedef enum { // These are just the XF register addresses for them
    GX_COLOR_CHANNEL_COLOR0 = 0,
    GX_COLOR_CHANNEL_COLOR1 = 1,
    GX_COLOR_CHANNEL_ALPHA0 = 2,
    GX_COLOR_CHANNEL_ALPHA1 = 3
} gx_color_channel_t;
 
typedef enum {
    GX_LIGHT_BIT_NONE,
    GX_LIGHT_BIT_0 = (1<<2),
    GX_LIGHT_BIT_1 = (1<<3),
    GX_LIGHT_BIT_2 = (1<<4),
    GX_LIGHT_BIT_3 = (1<<5),
    GX_LIGHT_BIT_4 = (1<<11),
    GX_LIGHT_BIT_5 = (1<<12),
    GX_LIGHT_BIT_6 = (1<<13),
    GX_LIGHT_BIT_7 = (1<<14)
} gx_light_bit_t;
 
typedef enum {
    // Bit 1 is just the attenuation enable
    // Bit 0 is the select. We just turned the binary to number here.
    GX_ATTENUATION_MODE_NONE,
    GX_ATTENUATION_MODE_SPECULAR = 1,
    GX_ATTENUATION_MODE_SPOTLIGHT = 3
} gx_attenuation_mode_t;
 
typedef enum {
    GX_DIFFUSE_MODE_NONE,
    GX_DIFFUSE_SIGNED,
    GX_DIFFUSE_CLAMPED, // From [0, 1]
} gx_diffuse_mode_t;
 
typedef enum {
    GX_XF_COLOR_AMBIENT_0 = 0x100A,
    GX_XF_COLOR_AMBIENT_1 = 0x100B,
    GX_XF_COLOR_MATERIAL_0 = 0x100C,
    GX_XF_COLOR_MATERIAL_1 = 0x100D
} gx_xf_color_t;
 
typedef enum { // Instead of raw XF addresses, indexes, so it can be used in texcoord gens.
    GX_LIGHT_ID_0,
    GX_LIGHT_ID_1,
    GX_LIGHT_ID_2,
    GX_LIGHT_ID_3,
    GX_LIGHT_ID_4,
    GX_LIGHT_ID_5,
    GX_LIGHT_ID_6,
    GX_LIGHT_ID_7
} gx_light_id_t;
 
typedef struct {
    uint32_t color; // RGBA
 
    // Light attenuation!
    // Described as a quadratic with
    // Angle is the light direction, and the vertex to light. basically the dot product/cosine
    // attn.x + attn.y * cos(angle) + attn.z * cos(angle)^2
    vec3 cos_attenuation;
    
    // Same quadratic idea, inverse this time
    vec3 distance_attenuation;
 
    vec3 position;
 
    // These are negative by the way
    // Times them by -1. Fun hardware
    vec3 direction;
} gx_light_t;

extern void gx_set_color_channels(uint32_t count);

extern void gx_configure_color_channel(gx_color_channel_t channel, gx_light_bit_t lights,
                                       bool lighting, bool ambient_source, bool material_source,
                                       gx_diffuse_mode_t diffuse, gx_attenuation_mode_t attenuation);

extern void gx_flash_xf_color(gx_xf_color_t id, uint8_t r, uint8_t g, uint8_t b, uint8_t a);

extern void gx_flash_light(gx_light_id_t id, const gx_light_t* light);
 
/* -------------------XF TexCoord Control--------------------- */
 
typedef enum {
    GX_TEXGEN_TYPE_REGULAR,
    GX_TEXGEN_TYPE_EMBOSS,
    GX_TEXGEN_TYPE_COLOR_0,
    GX_TEXGEN_TYPE_COLOR_1
} gx_texgen_type_t;
 
typedef enum {
    GX_TEXGEN_SOURCE_POSITION,
    GX_TEXGEN_SOURCE_NORMAL,
    GX_TEXGEN_SOURCE_COLORS,
    GX_TEXGEN_SOURCE_BINORMAL_T,
    GX_TEXGEN_SOURCE_BINORMAL_B,
    GX_TEXGEN_SOURCE_TEX0,
    GX_TEXGEN_SOURCE_TEX1,
    GX_TEXGEN_SOURCE_TEX2,
    GX_TEXGEN_SOURCE_TEX3,
    GX_TEXGEN_SOURCE_TEX4,
    GX_TEXGEN_SOURCE_TEX5,
    GX_TEXGEN_SOURCE_TEX6,
    GX_TEXGEN_SOURCE_TEX7
} gx_texgen_source_t;
 
typedef enum {
    GX_TEXTURE_MAP_0,
    GX_TEXTURE_MAP_1,
    GX_TEXTURE_MAP_2,
    GX_TEXTURE_MAP_3,
    GX_TEXTURE_MAP_4,
    GX_TEXTURE_MAP_5,
    GX_TEXTURE_MAP_6,
    GX_TEXTURE_MAP_7
} gx_texture_map_t;

extern void gx_set_texcoord_channels(uint32_t count);

extern void gx_configure_texcoord_channel(gx_texture_map_t map, gx_texgen_source_t source, gx_texgen_type_t type, bool projection, bool three_component, gx_light_id_t embossing_light);

extern void gx_configure_dual_texcoord(gx_texture_map_t map, gx_mtx_id_t index, bool normalize);

extern void gx_flash_dual_texcoord_matrix(matrix34 mtx, gx_mtx_id_t index, bool type);

void gx_set_current_texcoord_matrix(gx_texture_map_t map, gx_mtx_id_t index);

void gx_flash_enable_dual_texcoord(bool enable);