Type reference

All public typedef declarations

This page reproduces every typedef declaration from the three public Native 3D headers. Opaque handles, enums, descriptors and callback signatures are included. The exact declaration is the authoritative field layout; the conceptual pages explain ownership and semantic constraints.

native_3d_engine_api_v1.h 146 typedefs

typedef struct gx3de_engine gx3de_engine;

typedef struct gx3de_scene gx3de_scene;

typedef struct gx3de_object gx3de_object;

typedef struct gx3de_particle_cloud gx3de_particle_cloud;

typedef struct gx3de_group gx3de_group;

typedef struct gx3de_plane gx3de_plane;

typedef struct gx3de_anchor gx3de_anchor;

typedef struct gx3de_measurement gx3de_measurement;

typedef struct gx3de_section gx3de_section;

typedef struct gx3de_profile gx3de_profile;

typedef struct gx3de_marker gx3de_marker;

typedef struct gx3de_mesh_loops gx3de_mesh_loops;

typedef struct gx3de_repeat_result gx3de_repeat_result;

typedef struct gx3de_constraint gx3de_constraint;

typedef struct gx3de_target gx3de_target;

typedef struct gx3de_view gx3de_view;

typedef struct gx3de_viewport gx3de_viewport;

typedef struct gx3de_gizmo gx3de_gizmo;

typedef struct gx3de_view_manipulation gx3de_view_manipulation;

typedef struct gx3de_job gx3de_job;

typedef struct gx3de_step_document gx3de_step_document;

typedef enum gx3de_result {
    GX3DE_OK=0, GX3DE_INVALID_ARGUMENT=1, GX3DE_OUT_OF_MEMORY=2,
    GX3DE_NOT_FOUND=3, GX3DE_UNSUPPORTED=4, GX3DE_RANGE=5,
    GX3DE_WRONG_OWNER=6, GX3DE_DEGENERATE=7
} gx3de_result;

typedef struct gx3de_info {
    uint32_t struct_size;
    uint32_t abi_version;
    uint64_t capabilities;
    uint64_t reserved[4];
} gx3de_info;

typedef struct gx3de_capability_set {
    uint32_t struct_size,api_group,api_version,word_count;
    uint64_t words[4];
    uint64_t reserved[4];
} gx3de_capability_set;

typedef enum gx3de_render_backend {
    GX3DE_RENDER_BACKEND_AUTO=0,GX3DE_RENDER_BACKEND_UNKNOWN=0,
    GX3DE_RENDER_BACKEND_OPENGL=1,
    GX3DE_RENDER_BACKEND_D3D11=2
} gx3de_render_backend;

typedef enum gx3de_render_execution {
    GX3DE_RENDER_EXECUTION_UNKNOWN=0,GX3DE_RENDER_EXECUTION_HARDWARE=1,
    GX3DE_RENDER_EXECUTION_SOFTWARE=2
} gx3de_render_execution;

typedef struct gx3de_renderer_device_info {
    uint32_t struct_size,backend,execution,context_lost;
    char adapter[128],driver[128],fallback_reason[256],last_error[256];
    uint64_t features[4];
} gx3de_renderer_device_info;

typedef struct gx3de_vec3 { double x,y,z; } gx3de_vec3;

typedef struct gx3de_mesh_intersection_pair {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t triangle_a, triangle_b; /* source triangle indices, a < b */
    gx3de_vec3 world_witness; /* contact or midpoint of a near contact */
    uint64_t reserved[2];
} gx3de_mesh_intersection_pair;

typedef struct gx3de_mat4 { double m[16]; } gx3de_mat4; /* column major, affine */

typedef struct gx3de_bounds { gx3de_vec3 min,max; } gx3de_bounds;

typedef struct gx3de_mesh_diagnostics {
    uint32_t struct_size;
    uint32_t closed_manifold;
    uint64_t boundary_edges, nonmanifold_edges, orientation_conflicts, disconnected_components;
    double surface_area, enclosed_volume;
    uint32_t volume_defined;
    uint32_t reserved32;
    uint64_t reserved[4];
} gx3de_mesh_diagnostics;

typedef struct gx3de_repeat_info {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t source_triangle,triangles_per_component,match_count,remainder_triangles;
    double tolerance;
    char fingerprint_sha256[65];
    uint64_t reserved[4];
} gx3de_repeat_info;

typedef struct gx3de_brep_diagnostics {
    uint32_t struct_size;
    uint32_t volume_defined;
    double surface_area,enclosed_volume;
    uint64_t reserved[4];
} gx3de_brep_diagnostics;

typedef struct gx3de_brep_topology {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t vertices,edges,faces;
    uint64_t reserved[4];
} gx3de_brep_topology;

typedef struct gx3de_brep_validation {
    uint32_t struct_size;
    uint32_t topology_valid; /* OCCT BRepCheck_Analyzer on immutable source shape */
    uint32_t closed_oriented_solids; /* no stray faces/open or unoriented shells */
    uint32_t reserved32;
    uint64_t solids, shells, faces;
    uint64_t reserved[4];
} gx3de_brep_validation;

typedef enum gx3de_brep_curve_type {
    GX3DE_BREP_CURVE_UNKNOWN=0,GX3DE_BREP_CURVE_LINE=1,
    GX3DE_BREP_CURVE_CIRCLE=2,GX3DE_BREP_CURVE_ELLIPSE=3,
    GX3DE_BREP_CURVE_HYPERBOLA=4,GX3DE_BREP_CURVE_PARABOLA=5,
    GX3DE_BREP_CURVE_BEZIER=6,GX3DE_BREP_CURVE_BSPLINE=7,
    GX3DE_BREP_CURVE_OFFSET=8,GX3DE_BREP_CURVE_OTHER=255
} gx3de_brep_curve_type;

typedef enum gx3de_brep_surface_type {
    GX3DE_BREP_SURFACE_UNKNOWN=0,GX3DE_BREP_SURFACE_PLANE=1,
    GX3DE_BREP_SURFACE_CYLINDER=2,GX3DE_BREP_SURFACE_CONE=3,
    GX3DE_BREP_SURFACE_SPHERE=4,GX3DE_BREP_SURFACE_TORUS=5,
    GX3DE_BREP_SURFACE_BEZIER=6,GX3DE_BREP_SURFACE_BSPLINE=7,
    GX3DE_BREP_SURFACE_REVOLUTION=8,GX3DE_BREP_SURFACE_EXTRUSION=9,
    GX3DE_BREP_SURFACE_OFFSET=10,GX3DE_BREP_SURFACE_OTHER=255
} gx3de_brep_surface_type;

typedef struct gx3de_brep_edge_geometry {
    uint32_t struct_size;
    uint32_t curve_type; /* gx3de_brep_curve_type */
    uint32_t closed;
    uint32_t reserved32;
    double first_parameter,last_parameter,length;
    gx3de_vec3 start,end,start_tangent,end_tangent; /* source-local */
    uint64_t reserved[4];
} gx3de_brep_edge_geometry;

typedef struct gx3de_brep_face_geometry {
    uint32_t struct_size;
    uint32_t surface_type; /* gx3de_brep_surface_type */
    uint32_t u_closed,v_closed;
    double u_min,u_max,v_min,v_max; /* source-local OCCT UV coordinates */
    uint64_t reserved[4];
} gx3de_brep_face_geometry;

typedef struct gx3de_segment3 { gx3de_vec3 a,b; } gx3de_segment3;

typedef struct gx3de_segment2 { double au,av,bu,bv; } gx3de_segment2;

typedef struct gx3de_contour_info {
    uint32_t struct_size;
    uint32_t closed;
    uint64_t point_count;
    double length,planar_area; /* area is zero for an open contour */
    uint64_t reserved[4];
} gx3de_contour_info;

typedef struct gx3de_cache_stats {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t entries,hits,misses;
    uint64_t reserved[4];
} gx3de_cache_stats;

typedef struct gx3de_disk_cache_stats {
    uint32_t struct_size;
    uint32_t enabled;
    uint64_t hits,misses,invalid_rebuilt,store_failures;
    uint64_t reserved[4];
} gx3de_disk_cache_stats;

typedef enum gx3de_job_state { GX3DE_JOB_READY=1,GX3DE_JOB_RUNNING=2,GX3DE_JOB_COMPLETED=3,GX3DE_JOB_CANCELED=4,GX3DE_JOB_FAILED=5 } gx3de_job_state;

typedef struct gx3de_job_event {
    uint32_t struct_size;
    uint32_t state;
    uint64_t sequence;
    uint64_t progress_permille; /* valid when GX3DE_CAP_JOB_PROGRESS is set */
    uint64_t reserved[3];
} gx3de_job_event;

typedef enum gx3de_mesh_import_format { GX3DE_IMPORT_OBJ=1,GX3DE_IMPORT_STL=2 } gx3de_mesh_import_format;

typedef enum gx3de_mesh_lod_level {
    GX3DE_LOD_PREVIEW=1, GX3DE_LOD_LOW=2, GX3DE_LOD_MEDIUM=3,
    GX3DE_LOD_HIGH=4, GX3DE_LOD_FULL=5
} gx3de_mesh_lod_level;

typedef struct gx3de_mesh_import_spec {
    uint32_t struct_size;
    uint32_t format;
    const char *path_utf8;
    uint64_t max_source_bytes; /* 0 selects the documented 256 MiB limit */
    uint64_t max_memory_bytes; /* 0: 4096 MiB; explicit: 32..1048576 MiB */
    uint64_t reserved[3];
} gx3de_mesh_import_spec;

typedef enum gx3de_scientific_kind {
    GX3DE_SCIENTIFIC_VTP=1, GX3DE_SCIENTIFIC_VTU=2,
    GX3DE_SCIENTIFIC_VTI=3, GX3DE_SCIENTIFIC_ISOSURFACE=4,
    GX3DE_SCIENTIFIC_POLYDATA_MEMORY=5,
    GX3DE_SCIENTIFIC_IMAGE_MEMORY=6,
    GX3DE_SCIENTIFIC_UNSTRUCTURED_MEMORY=7
} gx3de_scientific_kind;

typedef enum gx3de_scientific_association {
    GX3DE_SCI_ASSOC_POINT=1, GX3DE_SCI_ASSOC_CELL=2
} gx3de_scientific_association;

typedef enum gx3de_scientific_array_class {
    GX3DE_SCI_ARRAY_SCALAR=1, GX3DE_SCI_ARRAY_VECTOR3=2,
    GX3DE_SCI_ARRAY_OTHER=3
} gx3de_scientific_array_class;

typedef enum gx3de_scientific_cell_type {
    GX3DE_SCI_CELL_VERTEX=1, GX3DE_SCI_CELL_LINE=2,
    GX3DE_SCI_CELL_POLYLINE=3, GX3DE_SCI_CELL_TRIANGLE=4,
    GX3DE_SCI_CELL_POLYGON=5, GX3DE_SCI_CELL_TETRA=6,
    GX3DE_SCI_CELL_HEXAHEDRON=7,
    GX3DE_SCI_CELL_OTHER=255
} gx3de_scientific_cell_type;

typedef struct gx3de_scientific_import_spec {
    uint32_t struct_size;
    uint32_t format; /* VTP, VTU or VTI */
    const char *path_utf8;
    uint64_t max_source_bytes; /* 0 selects 256 MiB */
    uint64_t reserved[4];
} gx3de_scientific_import_spec;

typedef struct gx3de_scientific_cell_input {
    uint32_t struct_size;
    uint32_t type; /* VERTEX, LINE, POLYLINE, TRIANGLE, POLYGON */
    const uint64_t *point_ids;
    uint64_t point_count;
    uint64_t reserved[2];
} gx3de_scientific_cell_input;

typedef struct gx3de_scientific_array_input {
    uint32_t struct_size;
    uint32_t association; /* POINT or CELL */
    uint32_t components; /* 1..16 */
    uint32_t reserved32;
    const char *name_utf8;
    const double *values; /* tuple_count * components, row major */
    uint64_t tuple_count;
    uint64_t reserved[2];
} gx3de_scientific_array_input;

typedef struct gx3de_scientific_polydata_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    const gx3de_vec3 *points;
    uint64_t point_count;
    const gx3de_scientific_cell_input *cells;
    uint64_t cell_count;
    const gx3de_scientific_array_input *arrays;
    uint64_t array_count;
    uint64_t reserved[4];
} gx3de_scientific_polydata_spec;

typedef struct gx3de_scientific_image_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    int32_t extent[6]; /* inclusive point extent */
    gx3de_vec3 origin,spacing;
    double direction[9]; /* row-major, invertible */
    const gx3de_scientific_array_input *arrays;
    uint64_t array_count;
    uint64_t max_data_bytes; /* zero selects 256 MiB input budget */
    uint64_t reserved[3];
} gx3de_scientific_image_spec;

typedef struct gx3de_scientific_unstructured_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    const gx3de_vec3 *points;
    uint64_t point_count;
    const gx3de_scientific_cell_input *cells;
    uint64_t cell_count;
    const gx3de_scientific_array_input *arrays;
    uint64_t array_count;
    uint64_t max_data_bytes; /* zero selects 256 MiB input budget */
    uint64_t reserved[3];
} gx3de_scientific_unstructured_spec;

typedef struct gx3de_scientific_info {
    uint32_t struct_size;
    uint32_t kind; /* gx3de_scientific_kind */
    uint64_t point_count,cell_count,array_count;
    uint32_t grid_dimensions[3]; /* nonzero for imported VTI and in-memory image */
    uint32_t derived;
    double isovalue; /* valid when derived */
    char selected_scalar_utf8[256]; /* empty unless derived */
    uint64_t reserved[4];
} gx3de_scientific_info;

typedef struct gx3de_scientific_grid_info {
    uint32_t struct_size;
    uint32_t reserved32;
    int32_t extent[6]; /* inclusive I/J/K point extent */
    gx3de_vec3 origin,spacing;
    double direction[9]; /* row major 3x3 */
    uint64_t reserved[4];
} gx3de_scientific_grid_info;

typedef struct gx3de_scientific_array_info {
    uint32_t struct_size;
    uint32_t association;
    uint32_t components;
    uint32_t classification; /* based on component count */
    uint64_t tuple_count;
    char name_utf8[256]; /* empty if source array is unnamed; index is identity */
    uint64_t reserved[4];
} gx3de_scientific_array_info;

typedef struct gx3de_scientific_cell_info {
    uint32_t struct_size;
    uint32_t type; /* gx3de_scientific_cell_type */
    uint64_t point_count;
    uint64_t reserved[4];
} gx3de_scientific_cell_info;

typedef struct gx3de_scientific_field_roles {
    uint32_t struct_size;
    uint32_t reserved32;
    int64_t scalar_array,vector_array,radius_array; /* -1 means unbound */
    double tube_radius; /* zero disables future tube presentation */
    uint64_t reserved[4];
} gx3de_scientific_field_roles;

typedef struct gx3de_scientific_vector_sample {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t point_id;
    gx3de_vec3 position,vector;
    uint64_t reserved[2];
} gx3de_scientific_vector_sample;

typedef struct gx3de_step_import_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    const char *path_utf8;
    uint64_t max_source_bytes; /* 0 selects 256 MiB */
    uint64_t max_nodes; /* 0 selects 100000 */
    uint64_t reserved[4];
} gx3de_step_import_spec;

typedef struct gx3de_step_mesh_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    double linear_deflection,angular_deflection,weld_tolerance;
    uint64_t max_triangles,max_output_bytes;
    uint64_t reserved[4];
} gx3de_step_mesh_spec;

typedef gx3de_step_mesh_spec gx3de_brep_mesh_spec;

typedef struct gx3de_step_summary {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t roots,nodes,assemblies,references,part_occurrences,unique_parts;
    uint64_t reserved[4];
} gx3de_step_summary;

typedef enum gx3de_step_node_kind {
    GX3DE_STEP_ASSEMBLY=1,
    GX3DE_STEP_PART_OCCURRENCE=2
} gx3de_step_node_kind;

typedef struct gx3de_step_node {
    uint32_t struct_size;
    uint32_t kind; /* gx3de_step_node_kind */
    uint64_t parent_index,prototype_index; /* UINT64_MAX when absent */
    uint32_t is_reference;
    uint32_t reserved32;
    gx3de_mat4 local_transform,world_transform;
    uint64_t reserved[4];
} gx3de_step_node;

typedef enum gx3de_step_text_field { GX3DE_STEP_NODE_ID=1,GX3DE_STEP_NODE_NAME=2,GX3DE_STEP_DEFINITION_ID=3,GX3DE_STEP_PROTOTYPE_ID=4,GX3DE_STEP_PROTOTYPE_NAME=5 } gx3de_step_text_field;

typedef struct gx3de_camera {
    uint32_t struct_size;
    uint32_t orthographic;
    gx3de_vec3 position,target,up;
    double near_clip,far_clip,vertical_fov_degrees;
    uint64_t reserved[4];
} gx3de_camera;

typedef struct gx3de_target_geometry {
    uint32_t struct_size,physical_width,physical_height,logical_width,logical_height;
    double device_pixel_ratio_x,device_pixel_ratio_y;
    uint64_t reserved[4];
} gx3de_target_geometry;

typedef enum gx3de_transparency_mode {
    GX3DE_TRANSPARENCY_DEPTH_PEEL=1,GX3DE_TRANSPARENCY_ALPHA_FALLBACK=2
} gx3de_transparency_mode;

typedef struct gx3de_render_quality {
    uint32_t struct_size,msaa_samples,transparency_mode,reserved32;
    uint64_t reserved[4];
} gx3de_render_quality;

typedef enum gx3de_graphics_execution {
    GX3DE_GRAPHICS_AUTO=0,GX3DE_GRAPHICS_HARDWARE=1,GX3DE_GRAPHICS_SOFTWARE=2
} gx3de_graphics_execution;

typedef enum gx3de_shadow_policy {
    GX3DE_SHADOW_OFF=0, GX3DE_SHADOW_OPAQUE_ONLY=1, GX3DE_SHADOW_FULL=2
} gx3de_shadow_policy;

typedef struct gx3de_graphics_policy {
    uint32_t struct_size,execution,normal_lod,interaction_lod_enabled;
    uint32_t interaction_lod,interaction_active,export_supersampling,shadow_policy;
    uint64_t display_triangle_budget,gpu_budget_bytes;
    uint64_t worker_rss_budget_bytes,worker_address_space_budget_bytes;
    gx3de_render_quality quality;
    uint64_t reserved[4];
} gx3de_graphics_policy;

typedef struct gx3de_render_stats {
    uint32_t struct_size,reserved32;
    uint64_t completed_frames,geometry_rebuild_frames,geometry_reuse_frames;
    uint64_t reserved[4];
} gx3de_render_stats;

typedef enum gx3de_resource_accounting {
    GX3DE_RESOURCE_UNAVAILABLE=0,GX3DE_RESOURCE_ESTIMATED=1,
    GX3DE_RESOURCE_MEASURED=2
} gx3de_resource_accounting;

typedef struct gx3de_render_resource_info {
    uint32_t struct_size;
    uint32_t gpu_accounting; /* ESTIMATED on OpenGL; no exact GPU allocation query */
    uint32_t measured_accounting; /* UNAVAILABLE when driver allocation is unknown */
    uint32_t budget_enforced;
    uint64_t gpu_budget_bytes; /* zero disables this explicit limit */
    uint64_t gpu_estimated_bytes; /* conservative preflight, last attempt */
    uint64_t gpu_measured_bytes; /* zero unless a backend reports measurement */
    uint64_t last_rejected_estimate_bytes;
    uint64_t reserved[4];
} gx3de_render_resource_info;

typedef struct gx3de_view_clip_plane {
    uint32_t struct_size;
    uint32_t enabled;
    gx3de_vec3 origin,normal; /* world coordinates; normal is normalized on set */
    uint32_t keep_positive;
    uint32_t reserved32;
    uint64_t reserved[4];
} gx3de_view_clip_plane;

typedef enum gx3de_interaction_mode {
    GX3DE_INTERACTION_NONE=0,
    GX3DE_INTERACTION_POINT=1,
    GX3DE_INTERACTION_DRAG=2
} gx3de_interaction_mode;

typedef struct gx3de_view_interaction {
    uint32_t struct_size;
    uint32_t mode; /* gx3de_interaction_mode */
    gx3de_vec3 start_world,current_world;
    uint64_t pointer_id;
    uint64_t reserved[4];
} gx3de_view_interaction;

typedef enum gx3de_gizmo_handle {
    GX3DE_GIZMO_TRANSLATE_X=1,GX3DE_GIZMO_TRANSLATE_Y=2,GX3DE_GIZMO_TRANSLATE_Z=3,
    GX3DE_GIZMO_TRANSLATE_XY=4,GX3DE_GIZMO_TRANSLATE_YZ=5,GX3DE_GIZMO_TRANSLATE_ZX=6,
    GX3DE_GIZMO_TRANSLATE_FREE=7,
    GX3DE_GIZMO_ROTATE_X=8,GX3DE_GIZMO_ROTATE_Y=9,GX3DE_GIZMO_ROTATE_Z=10
} gx3de_gizmo_handle;

typedef struct gx3de_ray {uint32_t struct_size;uint32_t reserved32;gx3de_vec3 origin,direction;uint64_t reserved[4];} gx3de_ray;

typedef struct gx3de_gizmo_spec {
    uint32_t struct_size,visible,space,families,preview_only,pivot_mode;
    gx3de_object *object;gx3de_anchor *anchor;
    gx3de_vec3 world_pivot;double size_pixels;
    uint64_t reserved[4];
} gx3de_gizmo_spec;

typedef struct gx3de_gizmo_result {
    uint32_t struct_size,active_handle,constraint_status,reserved32;
    gx3de_vec3 translation_world;double angle_radians;
    gx3de_mat4 proposed_local_transform;
    uint64_t reserved[4];
} gx3de_gizmo_result;

typedef struct gx3de_view_axes {
    uint32_t struct_size,show_world,show_local,show_reference;
    gx3de_object *local_object;gx3de_anchor *reference_axis;
    double size_pixels;uint64_t reserved[4];
} gx3de_view_axes;

typedef struct gx3de_rgb {double r,g,b;} gx3de_rgb;

typedef struct gx3de_view_background {
    uint32_t struct_size;
    uint32_t gradient;
    gx3de_rgb top,bottom; /* solid uses top */
    uint64_t reserved[4];
} gx3de_view_background;

typedef struct gx3de_checkerboard_background {
    uint32_t struct_size,enabled,checker_pixels,reserved32;
    gx3de_rgb first,second;
    uint64_t reserved[4];
} gx3de_checkerboard_background;

typedef enum gx3de_navcube_corner {
    GX3DE_NAVCUBE_TOP_LEFT=0,GX3DE_NAVCUBE_TOP_RIGHT=1,
    GX3DE_NAVCUBE_BOTTOM_LEFT=2,GX3DE_NAVCUBE_BOTTOM_RIGHT=3
} gx3de_navcube_corner;

typedef struct gx3de_navcube_state {
    uint32_t struct_size,visible,corner,size_pixels;
    uint32_t margin_pixels,hover_region,active_region,synced_region;
    uint64_t reserved[4];
} gx3de_navcube_state;

typedef enum gx3de_camera_preset {
    GX3DE_CAMERA_FRONT=1,GX3DE_CAMERA_BACK=2,
    GX3DE_CAMERA_LEFT=3,GX3DE_CAMERA_RIGHT=4,
    GX3DE_CAMERA_TOP=5,GX3DE_CAMERA_BOTTOM=6,
    GX3DE_CAMERA_ISOMETRIC=7,GX3DE_CAMERA_FIT_SCENE=8,
    GX3DE_CAMERA_FIT_OBJECT=9,GX3DE_CAMERA_FIT_SELECTION=10
} gx3de_camera_preset;

typedef struct gx3de_directional_light {
    gx3de_vec3 direction; /* world vector from light toward the scene */
    gx3de_rgb color;
    double intensity;
} gx3de_directional_light;

typedef struct gx3de_view_lighting {
    uint32_t struct_size;
    uint32_t enabled;
    double ambient,diffuse,specular; /* nonnegative, at most 1 */
    uint32_t light_count; /* 0..4; disabled lighting uses ambient only */
    uint32_t reserved32;
    gx3de_directional_light lights[4];
    uint64_t reserved[4];
} gx3de_view_lighting;

typedef struct gx3de_positional_light {
    uint32_t struct_size,enabled;
    gx3de_vec3 position;
    gx3de_rgb color;
    double intensity;
    double attenuation_constant,attenuation_linear,attenuation_quadratic;
    uint64_t reserved[4];
} gx3de_positional_light;

typedef struct gx3de_particle {
    gx3de_vec3 position;
    double radius;
    gx3de_rgb color;
    uint32_t flags,reserved32;
} gx3de_particle;

typedef struct gx3de_particle_cloud_style {
    uint32_t struct_size;
    double radius;
    gx3de_rgb color;
    double opacity;
    uint64_t reserved[4];
} gx3de_particle_cloud_style;

typedef enum gx3de_lighting_preset {
    GX3DE_LIGHT_SCIENTIFIC_NEUTRAL=1,
    GX3DE_LIGHT_HIGH_CONTRAST=2,
    GX3DE_LIGHT_SOFT_DIFFUSE=3,
    GX3DE_LIGHT_FLAT_UNLIT=4
} gx3de_lighting_preset;

typedef enum gx3de_image_transfer {
    GX3DE_IMAGE_TRANSFER_SRGB=1
} gx3de_image_transfer;

typedef enum gx3de_alpha_convention {
    GX3DE_ALPHA_STRAIGHT=1
} gx3de_alpha_convention;

typedef enum gx3de_png_color_tag {
    GX3DE_PNG_COLOR_UNTAGGED=1 /* RGB byte values expect sRGB transfer */
} gx3de_png_color_tag;

typedef struct gx3de_image_output_info {
    uint32_t struct_size;
    uint32_t component_count; /* 4 */
    uint32_t bits_per_component; /* 8 */
    uint32_t alpha_convention; /* gx3de_alpha_convention */
    uint32_t transfer; /* gx3de_image_transfer */
    uint32_t png_transfer; /* same transfer expectation as RGBA readback */
    uint32_t png_color_tag; /* gx3de_png_color_tag */
    char component_order[8]; /* "RGBA" */
    uint64_t reserved[4];
} gx3de_image_output_info;

typedef struct gx3de_view_clip_box {
    uint32_t struct_size;
    uint32_t enabled;
    gx3de_bounds world_bounds;
    uint64_t reserved[4];
} gx3de_view_clip_box;

typedef enum gx3de_view_manipulation_target {
    GX3DE_MANIP_WORKING_PLANE=1,GX3DE_MANIP_CLIP_PLANE=2,GX3DE_MANIP_CLIP_BOX=3
} gx3de_view_manipulation_target;

typedef enum gx3de_view_manipulation_action {
    GX3DE_MANIP_TRANSLATE=1,GX3DE_MANIP_ROTATE=2
} gx3de_view_manipulation_action;

typedef enum gx3de_view_manipulation_handle {
    GX3DE_MANIP_FREE=0,GX3DE_MANIP_X=1,GX3DE_MANIP_Y=2,GX3DE_MANIP_Z=3,
    GX3DE_MANIP_BOX_MIN_X=4,GX3DE_MANIP_BOX_MIN_Y=5,GX3DE_MANIP_BOX_MIN_Z=6,
    GX3DE_MANIP_BOX_MAX_X=7,GX3DE_MANIP_BOX_MAX_Y=8,GX3DE_MANIP_BOX_MAX_Z=9
} gx3de_view_manipulation_handle;

typedef struct gx3de_view_manipulation_result {
    uint32_t struct_size,target,action,handle;
    gx3de_vec3 origin,normal,u_axis;
    gx3de_view_clip_box box;
    uint64_t reserved[4];
} gx3de_view_manipulation_result;

typedef enum gx3de_display_mode {
    GX3DE_DISPLAY_SURFACE=1,GX3DE_DISPLAY_WIREFRAME=2,
    GX3DE_DISPLAY_SURFACE_EDGES=3,GX3DE_DISPLAY_POINTS=4
} gx3de_display_mode;

typedef struct gx3de_object_style {
    uint32_t struct_size;
    uint32_t mode;
    gx3de_rgb color;
    double line_width,point_size;
    uint32_t backface_culling,scalar_coloring;
    uint64_t reserved[4];
} gx3de_object_style;

typedef struct gx3de_texture gx3de_texture;

typedef struct gx3de_planar_texture gx3de_planar_texture;

typedef struct gx3de_curved_texture gx3de_curved_texture;

typedef struct gx3de_texture_info {
    uint32_t struct_size,width,height,channels;
    uint64_t reserved[4];
} gx3de_texture_info;

typedef struct gx3de_planar_texture_spec {
    uint32_t struct_size;
    uint64_t source_triangle;
    gx3de_vec3 local_anchor;
    double anchor_u,anchor_v,width,height,rotation_radians;
    uint32_t flip_u,flip_v;
    uint64_t reserved[4];
} gx3de_planar_texture_spec;

typedef struct gx3de_curved_texture_spec {
    uint32_t struct_size;
    uint64_t source_triangle;
    gx3de_vec3 local_anchor;
    double anchor_u,anchor_v,width,height,rotation_radians;
    double max_distance,max_edge_angle_radians,max_seed_angle_radians;
    uint32_t flip_u,flip_v;
    uint64_t reserved[4];
} gx3de_curved_texture_spec;

typedef enum gx3de_curved_wrap_flags {
    GX3DE_CURVED_WRAP_SEAM=1u,
    GX3DE_CURVED_WRAP_DISTANCE_LIMIT=2u,
    GX3DE_CURVED_WRAP_ANGLE_LIMIT=4u,
    GX3DE_CURVED_WRAP_CHART_LIMIT=8u,
    GX3DE_CURVED_WRAP_OPEN_BOUNDARY=16u,
    GX3DE_CURVED_WRAP_NONMANIFOLD=32u
} gx3de_curved_wrap_flags;

typedef struct gx3de_curved_texture_status {
    uint32_t struct_size;
    uint32_t flags;
    uint64_t chart_triangles,rendered_triangles,seam_edges;
    uint64_t distance_stops,angle_stops,chart_stops,open_edges,nonmanifold_edges;
    uint64_t reserved[4];
} gx3de_curved_texture_status;

typedef enum gx3de_planar_resize_mode {
    GX3DE_PLANAR_RESIZE_PROPORTIONAL=1,
    GX3DE_PLANAR_RESIZE_STRETCH=2
} gx3de_planar_resize_mode;

typedef enum gx3de_planar_gizmo_handle {
    GX3DE_PLANAR_HANDLE_ANCHOR=1,
    GX3DE_PLANAR_HANDLE_CORNER_00=2,GX3DE_PLANAR_HANDLE_CORNER_10=3,
    GX3DE_PLANAR_HANDLE_CORNER_11=4,GX3DE_PLANAR_HANDLE_CORNER_01=5,
    GX3DE_PLANAR_HANDLE_WIDTH=6,GX3DE_PLANAR_HANDLE_HEIGHT=7,
    GX3DE_PLANAR_HANDLE_ROTATION=8
} gx3de_planar_gizmo_handle;

typedef enum gx3de_marker_kind {
    GX3DE_MARKER_POINT=1,GX3DE_MARKER_CROSS=2,
    GX3DE_MARKER_NORMAL=3,GX3DE_MARKER_TANGENT=4
} gx3de_marker_kind;

typedef struct gx3de_marker_style {
    uint32_t struct_size;
    uint32_t visible;
    uint32_t kind;
    uint32_t highlighted;
    gx3de_rgb color;
    double size_pixels,line_width;
    uint64_t reserved[4];
} gx3de_marker_style;

typedef struct gx3de_measurement_style {
    uint32_t struct_size;
    uint32_t visible;
    uint32_t show_value;
    uint32_t reserved32;
    gx3de_rgb color;
    double marker_size_pixels,line_width;
    uint64_t reserved[4];
} gx3de_measurement_style;

typedef struct gx3de_curve_style {
    uint32_t struct_size;
    uint32_t visible;
    gx3de_rgb color;
    double line_width,opacity;
    uint64_t reserved[4];
} gx3de_curve_style;

typedef enum gx3de_native_window_kind {
    GX3DE_NATIVE_WINDOW_X11=1,
    GX3DE_NATIVE_WINDOW_WIN32=2
} gx3de_native_window_kind;

typedef enum gx3de_pick_geometry_kind {
    GX3DE_PICK_MESH=1,GX3DE_PICK_BREP_DISPLAY=2,GX3DE_PICK_SCIENTIFIC=3,
    GX3DE_PICK_REPEAT=4
} gx3de_pick_geometry_kind;

typedef struct gx3de_pick_hit {
    uint32_t struct_size;
    uint32_t geometry_kind; /* gx3de_pick_geometry_kind */
    gx3de_object *object; /* borrowed; valid while object and scene live */
    uint64_t cell_index,point_index; /* UINT64_MAX if unavailable; renderer IDs are transient */
    gx3de_vec3 world_point,local_point,world_normal;
    uint32_t has_surface_normal;
    uint32_t reserved32;
    uint64_t topology_index; /* zero-based face of exact immutable B-Rep, if available */
    double topology_u,topology_v; /* normalized face parameters */
    uint32_t has_topology;
    uint32_t reserved32_2;
    uint64_t reserved[2];
} gx3de_pick_hit;

typedef enum gx3de_colormap {
    GX3DE_COLORMAP_VIRIDIS=1,GX3DE_COLORMAP_COOL_WARM=2,
    GX3DE_COLORMAP_GRAYSCALE=3
} gx3de_colormap;

typedef struct gx3de_scientific_presentation {
    uint32_t struct_size;
    uint32_t colormap; /* gx3de_colormap */
    double scalar_min,scalar_max; /* finite and min < max if use_scalar_range */
    uint32_t use_scalar_range;
    uint32_t sphere_glyphs;
    uint32_t show_vectors;
    uint32_t reserved32;
    uint64_t max_vector_glyphs; /* 0 selects 2000; upper limit 20000 */
    uint64_t reserved[4];
} gx3de_scientific_presentation;

typedef enum gx3de_measure_kind {
    GX3DE_DISTANCE=1, GX3DE_DELTA_X=2, GX3DE_DELTA_Y=3,
    GX3DE_DELTA_Z=4, GX3DE_ANGLE_THREE_POINTS=5,
    GX3DE_DISTANCE_ON_PLANE=6,
    GX3DE_POINT_LINE_DISTANCE=7, GX3DE_POINT_PLANE_DISTANCE=8,
    GX3DE_LINE_LINE_ANGLE=9, GX3DE_LINE_PLANE_ANGLE=10,
    GX3DE_PLANE_PLANE_ANGLE=11, GX3DE_POINT_SURFACE_DISTANCE=12
} gx3de_measure_kind;

typedef struct gx3de_measure_spec {
    uint32_t struct_size;
    uint32_t kind;
    gx3de_anchor *anchors[4];
    gx3de_plane *planes[2];
    gx3de_object *surface_object; /* triangle mesh for point-to-surface distance */
    uint64_t reserved[4];
} gx3de_measure_spec;

typedef struct gx3de_measure_value {
    uint32_t struct_size;
    uint32_t kind;
    double value;
    uint32_t unit_known; /* 0 means no source unit was asserted */
    uint32_t reserved32;
    uint64_t reserved[4];
} gx3de_measure_value;

typedef enum gx3de_anchor_kind {
    GX3DE_ANCHOR_FREE=1, GX3DE_ANCHOR_VERTEX=2,
    GX3DE_ANCHOR_OBJECT_POINT=3, GX3DE_ANCHOR_EDGE=4,
    GX3DE_ANCHOR_FACE=5, GX3DE_ANCHOR_CENTER=6,
    GX3DE_ANCHOR_BREP_VERTEX=7, GX3DE_ANCHOR_BREP_EDGE=8,
    GX3DE_ANCHOR_BREP_FACE=9,
    GX3DE_ANCHOR_LINE=10,
    GX3DE_ANCHOR_OBJECT_AXIS=11,
    GX3DE_ANCHOR_OBJECT_REFERENCE=12
} gx3de_anchor_kind;

typedef enum gx3de_plane_preset { GX3DE_PLANE_XY=1,GX3DE_PLANE_XZ=2,GX3DE_PLANE_YZ=3 } gx3de_plane_preset;

typedef enum gx3de_boolean_kind { GX3DE_BOOLEAN_UNION=1,GX3DE_BOOLEAN_INTERSECTION=2,GX3DE_BOOLEAN_DIFFERENCE=3 } gx3de_boolean_kind;

typedef enum gx3de_constraint_kind { GX3DE_CONSTRAINT_FIXED=1,GX3DE_CONSTRAINT_COINCIDENT=2,GX3DE_CONSTRAINT_DISTANCE=3,GX3DE_CONSTRAINT_POINT_ON_PLANE=4,
    GX3DE_CONSTRAINT_ANGLE_LINES=5,GX3DE_CONSTRAINT_PARALLEL_LINES=6,GX3DE_CONSTRAINT_PERPENDICULAR_LINES=7,
    GX3DE_CONSTRAINT_POINT_ON_LINE=8,GX3DE_CONSTRAINT_POINT_ON_SURFACE=9,GX3DE_CONSTRAINT_ALIGNED_AXES=10 } gx3de_constraint_kind;

typedef enum gx3de_constraint_status { GX3DE_CONSTRAINT_SATISFIED=1,GX3DE_CONSTRAINT_VIOLATED=2,GX3DE_CONSTRAINT_UNDERDETERMINED=3,GX3DE_CONSTRAINT_OVERCONSTRAINED=4,GX3DE_CONSTRAINT_UNSUPPORTED=5 } gx3de_constraint_status;

typedef struct gx3de_constraint_spec {
    uint32_t struct_size;
    uint32_t kind;
    gx3de_object *moving_object;
    gx3de_anchor *a,*b;
    gx3de_plane *plane;
    double target,tolerance;
    uint64_t reserved[4];
} gx3de_constraint_spec;

typedef struct gx3de_constraint_value {
    uint32_t struct_size;
    uint32_t status;
    double residual,tolerance;
    uint64_t reserved[4];
} gx3de_constraint_value;

typedef struct gx3de_constraint_system_result {
    uint32_t struct_size;
    uint32_t status; /* gx3de_constraint_status */
    uint64_t constraint_count, satisfied_count, moving_object_count;
    uint32_t passes;
    uint32_t reserved32;
    double maximum_residual; /* absolute units differ by constraint kind */
    uint64_t reserved[4];
} gx3de_constraint_system_result;

typedef struct gx3de_constraint_spec_ex {
    uint32_t struct_size;
    uint32_t kind;
    gx3de_object *moving_object;
    gx3de_anchor *anchors[4]; /* lines: moving [0,1], target [2,3]; point-on-line: point [0], line [1,2] */
    gx3de_object *surface_object; /* point-on-surface: fixed triangle mesh */
    double target,tolerance; /* angle target in radians */
    uint64_t reserved[4];
} gx3de_constraint_spec_ex;

typedef struct gx3de_alignment_spec {
    uint32_t struct_size;
    uint32_t reserved32;
    gx3de_object *moving_object;
    gx3de_anchor *moving_points[3];
    gx3de_anchor *target_points[3];
    double tolerance;
    uint64_t reserved[4];
} gx3de_alignment_spec;

native_3d_animation_api_v1.h 7 typedefs

typedef struct gx3de_animation gx3de_animation;

typedef struct gx3de_animation_layer gx3de_animation_layer;

typedef enum gx3de_animation_interpolation {
    GX3DE_ANIM_NEAREST=1,GX3DE_ANIM_LINEAR=2
} gx3de_animation_interpolation;

typedef enum gx3de_animation_loop {
    GX3DE_ANIM_ONCE=1,GX3DE_ANIM_LOOP=2,GX3DE_ANIM_PING_PONG=3
} gx3de_animation_loop;

typedef enum gx3de_animation_state {
    GX3DE_ANIM_STOPPED=1,GX3DE_ANIM_PAUSED=2,GX3DE_ANIM_PLAYING=3
} gx3de_animation_state;

typedef gx3de_result (*gx3de_animation_frame_loader)(gx3de_scene *scene,uint64_t frame_index,
                                                       double time_value,void *user,
                                                       gx3de_object **out_object);

typedef struct gx3de_animation_info {
    uint32_t struct_size;
    uint32_t state;
    uint32_t interpolation;
    uint32_t loop_mode;
    uint64_t frame_count,current_frame,resident_frames,max_resident_frames;
    double current_time,start_time,end_time,playback_rate;
    uint64_t resident_estimated_bytes,max_resident_bytes;
    uint64_t reserved[4];
} gx3de_animation_info;

native_3d_field_api_v1.h 11 typedefs

typedef struct gx3de_field_source_info {
    uint32_t struct_size;
    uint32_t scientific_kind;
    uint64_t supported_cells,unsupported_cells;
    uint32_t first_unsupported_cell_type; /* 0 when all cells are supported */
    uint32_t reserved32;
    uint64_t reserved[4];
} gx3de_field_source_info;

typedef enum gx3de_field_seed_kind {
    GX3DE_FIELD_SEED_POINTS=1, GX3DE_FIELD_SEED_LINE=2,
    GX3DE_FIELD_SEED_PLANE=3
} gx3de_field_seed_kind;

typedef enum gx3de_field_direction {
    GX3DE_FIELD_FORWARD=1, GX3DE_FIELD_BACKWARD=2,
    GX3DE_FIELD_BOTH=3
} gx3de_field_direction;

typedef struct gx3de_field_line_spec {
    uint32_t struct_size;
    uint32_t seed_kind; /* gx3de_field_seed_kind; seed positions are field-local */
    gx3de_object *field; /* immutable image or tetra/hexa unstructured field */
    uint64_t vector_array; /* point-associated 3-component array */
    int64_t scalar_array; /* point-associated scalar array, -1 disables */
    const gx3de_vec3 *seed_points;
    uint64_t seed_count; /* POINTS: count, LINE/PLANE: ignored */
    gx3de_vec3 seed_origin,seed_u,seed_v;
    uint32_t seed_u_count,seed_v_count; /* LINE uses u count, PLANE uses both */
    uint32_t direction; /* gx3de_field_direction */
    uint32_t reserved32;
    double step_size; /* local distance per normalized-vector RK4 step */
    double min_vector_magnitude; /* below this, line terminates */
    double tube_radius; /* 0: line; >0: rendered tube */
    uint64_t max_steps_per_direction; /* 1..100000 */
    uint64_t max_output_points; /* 2..1000000 */
    uint64_t max_memory_bytes; /* temporary grid + output, at most 512 MiB */
    uint64_t reserved[4];
} gx3de_field_line_spec;

typedef struct gx3de_field_line_info {
    uint32_t struct_size;
    uint32_t reserved32;
    uint64_t requested_seeds,created_lines,output_points;
    uint64_t boundary_stops,low_magnitude_stops,step_limit_stops;
    uint64_t reserved[4];
} gx3de_field_line_info;

typedef struct gx3de_field_slice_spec {
    uint32_t struct_size,reserved32;
    gx3de_object *field; /* immutable structured image scalar field */
    uint64_t scalar_array; /* point-associated scalar array */
    gx3de_vec3 origin,u_step,v_step; /* field-local grid-plane samples */
    uint32_t u_count,v_count; /* 2..1024 each, at most 1M points */
    uint64_t max_memory_bytes; /* input + output, at most 512 MiB */
    uint64_t reserved[4];
} gx3de_field_slice_spec;

typedef gx3de_result (*gx3de_field_frame_loader)(gx3de_scene *scene,uint64_t frame_index,
                                                  double time_value,void *user,
                                                  gx3de_object **out_field);

typedef struct gx3de_field_pathline_spec {
    uint32_t struct_size,reserved32;
    const double *times; /* strictly increasing, at least two samples */
    const gx3de_object *const *frames; /* optional; each entry may be NULL if loader is set */
    uint64_t frame_count;
    gx3de_field_frame_loader loader;
    void *loader_user;
    uint64_t vector_array; /* point-associated 3-component */
    int64_t scalar_array; /* point-associated 1-component, -1 disables */
    const gx3de_vec3 *seed_points; /* local coordinates; seed at times[0] */
    uint64_t seed_count;
    double time_step; /* positive maximum integration interval */
    double min_vector_magnitude; /* stop when below this threshold */
    double tube_radius;
    uint64_t max_steps_per_seed,max_output_points,max_memory_bytes;
    uint64_t reserved[4];
} gx3de_field_pathline_spec;

typedef struct gx3de_field_pathline_info {
    uint32_t struct_size,reserved32;
    uint64_t requested_seeds,created_lines,output_points;
    uint64_t boundary_stops,low_magnitude_stops,step_limit_stops;
    uint64_t loaded_frames; /* loader calls; static frames do not count */
    uint64_t reserved[4];
} gx3de_field_pathline_info;

typedef struct gx3de_field_transfer_point {
    double scalar,red,green,blue,opacity;
} gx3de_field_transfer_point;

typedef struct gx3de_field_volume_style {
    uint32_t struct_size,enabled;
    uint64_t scalar_array; /* point scalar on VTI/image object */
    double sample_distance; /* >0 world units between ray samples */
    uint32_t transfer_count,reserved32;
    gx3de_field_transfer_point transfer[GX3DE_MAX_FIELD_TRANSFER_POINTS];
    uint64_t reserved[4];
} gx3de_field_volume_style;