sim_field_topology.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include "field.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum SimFieldTopologySeamMask {
    SIM_FIELD_TOPOLOGY_SEAM_BOTTOM = 1u << 0, 
    SIM_FIELD_TOPOLOGY_SEAM_RIGHT = 1u << 1,  
    SIM_FIELD_TOPOLOGY_SEAM_TOP = 1u << 2,    
    SIM_FIELD_TOPOLOGY_SEAM_LEFT = 1u << 3    
} SimFieldTopologySeamMask;
 
typedef enum SimFieldTopologyCellFlag {
    SIM_FIELD_TOPOLOGY_CELL_VALID = 1u << 0, 
    SIM_FIELD_TOPOLOGY_CELL_AMBIGUOUS =
        1u << 1, 
    SIM_FIELD_TOPOLOGY_CELL_CORE_OFFSET_VALID =
        1u << 2, 
    SIM_FIELD_TOPOLOGY_CELL_NONFINITE = 1u << 3 
} SimFieldTopologyCellFlag;
 
typedef struct SimFieldTopologyCell {
    int8_t charge;       
    uint8_t seam_mask;   
    uint8_t flags;       
    float core_offset_x; 
    float core_offset_y; 
    float confidence;    
} SimFieldTopologyCell;
 
typedef struct SimFieldTopologySummary {
    bool valid;                    
    size_t positive_singularities; 
    size_t negative_singularities; 
    size_t seam_edge_count;        
    size_t ambiguous_cell_count;   
} SimFieldTopologySummary;
 
typedef struct SimFieldTopologyConfig {
    float seam_phase_threshold; 
    float seam_ambiguity_band;  
    float charge_ambiguity_threshold; 
    float magnitude_epsilon;          
    bool enable_core_localization;    
} SimFieldTopologyConfig;
 
void sim_field_topology_config_default(SimFieldTopologyConfig *out_config);
 
bool sim_field_topology_dimensions(const struct SimField *field, size_t *out_width,
                                   size_t *out_height);
 
bool sim_field_topology_extract(const struct SimField *field, SimFieldTopologyCell *out_cells,
                                size_t cell_capacity, SimFieldTopologySummary *out_summary,
                                const SimFieldTopologyConfig *config, size_t *out_width,
                                size_t *out_height);
 
void sim_field_topology_cell_pack_rgba8(const SimFieldTopologyCell *cell, uint8_t out_texel[4]);
 
#ifdef __cplusplus
}
#endif