Lumenarium/src_v2/engine/lumenarium_engine_assembly.h

/* date = March 22nd 2022 6:40 pm */

#ifndef LUMENARIUM_ENGINE_ASSEMBLY_H
#define LUMENARIUM_ENGINE_ASSEMBLY_H

// Assembly_Handle is valid for any index, including zero. However, 
// valid values must have the high bit set. This way, the handle declared
// via Assembly_Handle my_handle = {}; is invalid, while still allowing
// index zero to be used in the array.
// 
// If memory corruption becomes an issue we can make this a bigger bit
// field that we check since Lumenarium doesn't ever really expect to have
// more than 128 sculptures in a scene - but who knows, maybe someday O.o?
#define ASSEMBLY_HANDLE_VALID_BIT (1 << 31)
#define ASSEMBLY_HANDLE_INDEX_MASK ~ASSEMBLY_HANDLE_VALID_BIT
typedef struct Assembly_Handle Assembly_Handle;
struct Assembly_Handle
{
  u32 value;
};

typedef union Assembly_Pixel Assembly_Pixel;
union Assembly_Pixel
{
  struct {
    u8 r;
    u8 g;
    u8 b;
  };
  u8 channels[3];
};

typedef struct Assembly_Pixel_Buffer Assembly_Pixel_Buffer;
struct Assembly_Pixel_Buffer
{
  u32 cap;
  u32 len;
  Assembly_Pixel* pixels;
  v4*             positions;
};

typedef struct Assembly_Strip Assembly_Strip;
struct Assembly_Strip
{
  u32  pixels_cap;
  u32  pixels_len;
  // array of indices into the Assembly_Pixel_Buffer for the same assembly
  u32* pixels;
  
  Output_Data_Kind output_kind;
  u32 sacn_universe;
};

typedef struct Assembly_Strip_Array Assembly_Strip_Array;
struct Assembly_Strip_Array
{
  u32 cap;
  u32 len;
  Assembly_Strip* strips;
};

typedef struct Assembly_Array Assembly_Array;
struct Assembly_Array
{
  u32 cap;
  u32 len;
  
  // assembly names
  String*                names;
  
  // each assembly gets its own pixel buffer
  Assembly_Pixel_Buffer* pixel_buffers;
  
  // each assembly gets its own array of strips which
  // index into that assemblies pixel_buffer
  Assembly_Strip_Array*  strip_arrays;
  
  Allocator* allocator;
};

Assembly_Array  assembly_array_create(Allocator* allocator, u32 cap);
Assembly_Handle assembly_add(Assembly_Array* a, String name, u32 pixels_cap, u32 strips_cap);
void            assembly_rem(Assembly_Array* a, Assembly_Handle h);
Assembly_Strip* assembly_add_strip(Assembly_Array* a, Assembly_Handle h, u32 pixels_cap);
void            assembly_add_led(Assembly_Array* a, Assembly_Handle h, Assembly_Strip* strip, v4 position);


#endif //LUMENARIUM_ENGINE_ASSEMBLY_H