Skip to main content

Module container_10d

Module container_10d 

Source
Expand description

.10d living-container v1 — normative header, axis-role taxonomy, and metric-completeness descriptor for the 10-D tensor substrate. P0.1 barrier task. Available to browser/WASM builds (P0.8 parity target). See docs/plans/native-computational-geometry-EXECUTION.md P0.1. .10d versioned container codecs and shared native/WASM SDK boundaries.

Source includes v1/v2 headers, aligned section tables and CRC integrity; quantized meshes, tensor nodes, provenance, materials, UV/frame streams, typed MID2 payload references, morph/skeletal data and other specialized sections. Presence of an API is not qualification of every combination, consumer, target or scientific interpretation.

Current numeric and typed-payload contracts are maintained in docs/manuals/standards/10d-container-format.md and docs/manuals/standards/10d-typed-field-payloads.md. Those companions identify the exact native conformance cases and the limits of their evidence.

Axis roles remain q/v/w selectors, x/y/z/t/alpha/sigma coordinates, and mu a coordinate carrier. Metric completeness must reflect actual runtime math; no source-only completeness or native/WASM parity claim follows here. Legacy API/file names containing identity remain compatibility spellings; identifiers, qualified referents and integrity digests retain distinct roles.

Re-exports§

pub use manifold_identity_container::decode_container_manifold_identity;
pub use manifold_identity_container::encode_container_with_manifold_identity;
pub use manifold_identity_container::encode_container_with_manifold_identity_extensions;
pub use manifold_identity_container::ManifoldContainerError;
pub use cluster_dag_section::cluster_dag_encoded_len;
pub use cluster_dag_section::decode_cluster_dag_section;
pub use cluster_dag_section::decode_oct16_normal;
pub use cluster_dag_section::encode_cluster_dag_section;
pub use cluster_dag_section::encode_oct16_normal;
pub use cluster_dag_section::project_sphere_error_px;
pub use cluster_dag_section::select_cut_clusters_zero_heap;
pub use cluster_dag_section::ClusterDagMiniHeader;
pub use cluster_dag_section::ClusterDagSectionError;
pub use cluster_dag_section::MeshletClusterNode;
pub use cluster_dag_section::CLUSTER_DAG_HEADER_SIZE;
pub use cluster_dag_section::CLUSTER_DAG_SECTION_VERSION;
pub use cluster_dag_section::FLAG_CDAG_CONE_CULLED;
pub use cluster_dag_section::FLAG_CDAG_SEAM_LOCKED;
pub use cluster_dag_section::MAGIC_CDAG;
pub use cluster_dag_section::MAX_CLUSTER_DAG_NODES;
pub use cluster_dag_section::MAX_MESHLET_TRIANGLES;
pub use cluster_dag_section::MAX_MESHLET_VERTICES;
pub use cluster_dag_section::MESHLET_CLUSTER_NODE_SIZE;
pub use correspondence_section::correspondence_encoded_len;
pub use correspondence_section::decode_correspondence_section;
pub use correspondence_section::deform_surface_vertices_zero_heap;
pub use correspondence_section::encode_correspondence_section;
pub use correspondence_section::CorrespondenceMiniHeader;
pub use correspondence_section::CorrespondenceSectionError;
pub use correspondence_section::VertexTetBinding;
pub use correspondence_section::BARYCENTRIC_UNORM16_SUM;
pub use correspondence_section::CORRESPONDENCE_HEADER_SIZE;
pub use correspondence_section::CORRESPONDENCE_SECTION_VERSION;
pub use correspondence_section::FLAG_FEMC_CONFORMING_BARYCENTRIC;
pub use correspondence_section::FLAG_FEMC_HAS_NORMAL_ROTATION;
pub use correspondence_section::MAGIC_FEMC;
pub use correspondence_section::MAX_CORRESPONDENCE_BINDINGS;
pub use correspondence_section::VERTEX_TET_BINDING_SIZE;
pub use axis_role::AxisRole;
pub use axis_role::AXIS_ORDER;
pub use axis_role::COORDINATE_AXES;
pub use axis_role::MU_AXIS;
pub use axis_role::PROPOSED_AXIS_ROLES;
pub use axis_role::SELECTOR_AXES;
pub use crc32c::crc32c;
pub use crc32c::crc32c_update;
pub use entity_ontology_section::decode_entity_ontology_section_into;
pub use entity_ontology_section::decode_personal_ontology_section_into;
pub use entity_ontology_section::encode_entity_ontology_section;
pub use entity_ontology_section::encode_personal_ontology_section;
pub use entity_ontology_section::entity_ontology_encoded_len;
pub use entity_ontology_section::personal_ontology_encoded_len;
pub use entity_ontology_section::AffordanceBinaryRecord;
pub use entity_ontology_section::EntityOntologySectionError;
pub use entity_ontology_section::PersonalOntologyMiniHeader;
pub use entity_ontology_section::PersonalOntologySectionError;
pub use entity_ontology_section::AFFORDANCE_RECORD_SIZE;
pub use entity_ontology_section::ENTITY_ONTOLOGY_MINI_HEADER_SIZE;
pub use entity_ontology_section::ENTITY_ONTOLOGY_SECTION_VERSION;
pub use entity_ontology_section::MAGIC_EONT;
pub use entity_ontology_section::MAGIC_PONT;
pub use entity_ontology_section::MAX_AFFORDANCES_PER_SECTION;
pub use entity_ontology_section::PERSONAL_ONTOLOGY_MINI_HEADER_SIZE;
pub use entity_ontology_section::PERSONAL_ONTOLOGY_SECTION_VERSION;
pub use header::Container10dHeader;
pub use header::HeaderParseError;
pub use header::FLAG_DEFAULT_DISPOSITION_REFUSE;
pub use header::HEADER_BYTE_SIZE;
pub use header::HEADER_VERSION;
pub use header::LEGACY_HEADER_VERSION;
pub use header::MAGIC_10D;
pub use header::MAX_SECTION_COUNT;
pub use header::SUPPORTED_HEADER_VERSIONS;
pub use impostor_section::decode_impostor_section;
pub use impostor_section::encode_impostor_section;
pub use impostor_section::hemi_octahedral_decode;
pub use impostor_section::hemi_octahedral_encode;
pub use impostor_section::sample_impostor_blend_weights;
pub use impostor_section::ImpostorAtlasMiniHeader;
pub use impostor_section::ImpostorBlendSample;
pub use impostor_section::ImpostorSectionError;
pub use impostor_section::FLAG_DEPTH_IN_ALPHA;
pub use impostor_section::FLAG_HEMI_OCTAHEDRAL;
pub use impostor_section::FLAG_OCT32_NORMALS;
pub use impostor_section::FLAG_PBR_METALLIC_ROUGHNESS;
pub use impostor_section::IMPOSTOR_MINI_HEADER_SIZE;
pub use impostor_section::IMPOSTOR_SECTION_VERSION;
pub use impostor_section::MAGIC_IMPO;
pub use integrity::compute_whole_file_crc32c;
pub use integrity::seal_whole_file_crc32c;
pub use integrity::verify_whole_file_crc32c;
pub use integrity::IntegrityError;
pub use manifold_identity_v2::decode_manifold_identity_v2;
pub use manifold_identity_v2::encode_manifold_identity_v2;
pub use manifold_identity_v2::encode_manifold_identity_v2_with_extensions;
pub use manifold_identity_v2::encoded_len as manifold_identity_v2_encoded_len;
pub use manifold_identity_v2::IntegrityIndexDigest;
pub use manifold_identity_v2::ManifestV2Error;
pub use manifold_identity_v2::ManifoldIdentityV2;
pub use manifold_identity_v2::StableEntityId;
pub use manifold_identity_v2::TypedFieldRecord;
pub use manifold_identity_v2::BUILTIN_FIELD_KINDS;
pub use manifold_identity_v2::FIELD_KIND_ELECTROMAGNETIC;
pub use manifold_identity_v2::FIELD_KIND_SCALAR;
pub use manifold_identity_v2::FIELD_KIND_SPECTRAL;
pub use manifold_identity_v2::FIELD_KIND_TENSOR;
pub use manifold_identity_v2::FIELD_KIND_VECTOR;
pub use manifold_identity_v2::FIELD_KIND_SURFACE_FRAMES;
pub use manifold_identity_v2::FIELD_KIND_MORPH_TARGETS;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_AXIS_ORDER;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_FIELD_RECORD_SIZE;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_HEADER_SIZE;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_MAGIC;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_MAX_BYTES;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_MAX_FIELDS;
pub use manifold_identity_v2::MANIFOLD_IDENTITY_V2_VERSION;
pub use material_container::attach_material_section;
pub use material_container::material_container_counts;
pub use material_container::read_material_section_into;
pub use material_container::MaterialContainerError;
pub use material_section::decode_material_section_into;
pub use material_section::encode_material_section;
pub use material_section::encoded_len as material_section_encoded_len;
pub use material_section::material_section_counts;
pub use material_section::validate_material_bindings;
pub use material_section::MaterialRecord;
pub use material_section::MaterialSectionError;
pub use material_section::OpacityMode;
pub use material_section::ShadingModel;
pub use material_section::SubmeshRange;
pub use material_section::TextureAddressMode;
pub use material_section::TextureFilterMode;
pub use material_section::TextureMinFilter;
pub use material_section::TextureSampler;
pub use material_section::TextureTransform;
pub use material_section::MATERIAL_RECORD_SIZE;
pub use material_section::MATERIAL_SECTION_HEADER_SIZE;
pub use material_section::MATERIAL_SECTION_VERSION;
pub use material_section::MATERIAL_V1_RECORD_SIZE;
pub use material_section::MAX_MATERIALS;
pub use material_section::MAX_SUBMESH_RANGES;
pub use material_section::SUBMESH_RANGE_SIZE;
pub use material_section::TEXTURE_SAMPLER_RECORD_SIZE;
pub use mesh_section::decode_mesh_section;
pub use mesh_section::encode_mesh_section;
pub use mesh_section::parse_mesh_header;
pub use mesh_section::MeshMiniHeader;
pub use mesh_section::MeshSectionError;
pub use mesh_section::FLAG_U16_INDICES;
pub use mesh_section::MAX_TRIANGLE_COUNT;
pub use mesh_section::MAX_VERTEX_COUNT;
pub use mesh_section::MESH_MINI_HEADER_SIZE;
pub use morph_section::apply_morph_targets_zero_heap;
pub use morph_section::decode_morph_section_into;
pub use morph_section::dequantize_morph_delta;
pub use morph_section::encode_morph_section;
pub use morph_section::morph_section_encoded_len;
pub use morph_section::quantize_morph_delta;
pub use morph_section::MorphSectionError;
pub use morph_section::MorphSectionHeader;
pub use morph_section::QuantizedMorphDelta;
pub use morph_section::FLAG_MORPH_DENSE;
pub use morph_section::FLAG_MORPH_HAS_NORMALS;
pub use morph_section::FLAG_MORPH_HAS_TANGENTS;
pub use morph_section::FLAG_MORPH_ONTOGENETIC_BIND;
pub use morph_section::FLAG_MORPH_SPARSE;
pub use morph_section::MAGIC_MRP1;
pub use morph_section::MAX_MORPH_DELTAS;
pub use morph_section::MAX_MORPH_TARGETS;
pub use morph_section::MORPH_SECTION_HEADER_SIZE;
pub use morph_section::MORPH_SECTION_VERSION;
pub use morph_section::QUANTIZED_MORPH_DELTA_SIZE;
pub use metric_check::proposed_metric_descriptor;
pub use metric_check::verify_descriptor_against_reality;
pub use metric_check::MetricBranchDescriptor;
pub use metric_check::MetricCompletenessDescriptor;
pub use metric_check::MetricDivergence;
pub use metric_check::MetricKind;
pub use metric_check::BOUNDARY_CLIQUE_BRANCH_INDEX;
pub use metric_check::METRIC_BRANCH_COUNT;
pub use corpus_envelope::cited_envelope_from_corpus;
pub use corpus_envelope::reference_envelope_for_species;
pub use corpus_envelope::BoundBasis;
pub use corpus_envelope::BoundCitation;
pub use corpus_envelope::CitedMetricEnvelope;
pub use corpus_envelope::P_BODY_HEIGHT;
pub use corpus_envelope::P_BODY_LENGTH;
pub use corpus_envelope::P_BODY_MASS;
pub use corpus_envelope::P_BODY_WIDTH;
pub use corpus_envelope::UNIT_KILOGRAM;
pub use corpus_envelope::UNIT_METRE;
pub use metric_trait_gate::measure_aabb_extents_zero_heap;
pub use metric_trait_gate::verify_fauna_vs_vehicle_scale_invariant_zero_heap;
pub use metric_trait_gate::verify_metric_trait_bounds_zero_heap;
pub use metric_trait_gate::MetricTraitEnvelope;
pub use metric_trait_gate::MetricTraitGateViolation;
pub use metric_trait_gate::ENVELOPE_AQUILA_AUDAX;
pub use metric_trait_gate::ENVELOPE_CORYMBIA_APARRERINJA;
pub use metric_trait_gate::ENVELOPE_FIELD_UTILITY_4WD;
pub use metric_trait_gate::ENVELOPE_MACROPUS_GIGANTEUS;
pub use metric_trait_gate::ENVELOPE_ORNITHORHYNCHUS_ANATINUS;
pub use metric_trait_gate::ENVELOPE_VOMBATUS_URSINUS;
pub use node_section::parse_node_header;
pub use node_section::read_node;
pub use node_section::read_node_aos;
pub use node_section::read_node_soa;
pub use node_section::read_node_soa_lane;
pub use node_section::transpose_aos_to_soa;
pub use node_section::transpose_soa_to_aos;
pub use node_section::write_node_q_at;
pub use node_section::write_node_section_aos;
pub use node_section::write_node_section_soa;
pub use node_section::NodeMiniHeader;
pub use node_section::NodeSectionError;
pub use node_section::AXIS_COUNT;
pub use node_section::LAYOUT_AOS;
pub use node_section::LAYOUT_SOA;
pub use node_section::MAX_NODE_COUNT;
pub use node_section::NODE_MINI_HEADER_SIZE;
pub use node_section::TENSOR10D_SIZE;
pub use normal_section::decode_mesh_frames;
pub use normal_section::decode_mesh_frames_into;
pub use normal_section::decode_mesh_frames_with_limits;
pub use normal_section::inspect_mesh_frames;
pub use normal_section::MeshFrameDecodeLimits;
pub use normal_section::MeshFrameLayout;
pub use normal_section::decode_normals;
pub use normal_section::decode_tangents;
pub use normal_section::encode_mesh_frames;
pub use normal_section::encode_normals;
pub use normal_section::frame_encoded_len;
pub use normal_section::is_normal_section;
pub use normal_section::MeshFrameStreams;
pub use normal_section::NormalSectionError;
pub use normal_section::MAX_NORMAL_COUNT;
pub use normal_section::NORMAL_SECTION_HEADER_SIZE;
pub use normal_section::NORMAL_SECTION_VERSION;
pub use procedural_synthesis::decode_procedural_synthesis_section;
pub use procedural_synthesis::encode_procedural_synthesis_section;
pub use procedural_synthesis::evaluate_allometric_dimension;
pub use procedural_synthesis::evaluate_log_spiral_2d;
pub use procedural_synthesis::evaluate_pga_motor_oscillation;
pub use procedural_synthesis::evaluate_smooth_minimum_sdf;
pub use procedural_synthesis::evaluate_stress_cleavage_partition;
pub use procedural_synthesis::evaluate_voronoi_cellular_f1;
pub use procedural_synthesis::ProceduralSynthesisError;
pub use procedural_synthesis::ProceduralSynthesisHeader;
pub use procedural_synthesis::FLAG_ALLOMETRIC_GROWTH;
pub use procedural_synthesis::FLAG_CELLULAR_VORONOI;
pub use procedural_synthesis::FLAG_IMPLICIT_FILLET;
pub use procedural_synthesis::FLAG_LOG_SPIRAL_ODE;
pub use procedural_synthesis::FLAG_PGA_MOTOR_DYNAMICS;
pub use procedural_synthesis::FLAG_STRESS_FRACTURE;
pub use procedural_synthesis::MAGIC_PROC;
pub use procedural_synthesis::PROCEDURAL_SYNTHESIS_HEADER_SIZE;
pub use procedural_synthesis::PROCEDURAL_SYNTHESIS_SECTION_VERSION;
pub use provenance_section::decode_provenance_section;
pub use provenance_section::encode_provenance_section;
pub use provenance_section::encoded_len as provenance_encoded_len;
pub use provenance_section::validate_provenance;
pub use provenance_section::ProvenanceMiniHeader;
pub use provenance_section::ProvenanceSectionError;
pub use provenance_section::ProvenanceSidecar;
pub use provenance_section::ProvenanceSidecarView;
pub use provenance_section::FLAG_HAS_VC;
pub use provenance_section::PROVENANCE_MAGIC;
pub use provenance_section::PROVENANCE_MINI_HEADER_SIZE;
pub use provenance_section::PROVENANCE_SECTION_VERSION;
pub use typed_payloads::inspect_container_mesh_frames;
pub use typed_payloads::read_container_mesh_frames;
pub use typed_payloads::read_container_mesh_frames_into;
pub use typed_payloads::read_container_mesh_frames_with_limits;
pub use typed_payloads::read_container_morph_targets_into;
pub use typed_payloads::TypedPayload;
pub use typed_payloads::TypedPayloadError;
pub use typed_payloads::TypedPayloadResolver;
pub use section::encode_container;
pub use section::parse_section_table;
pub use section::AlignmentTier;
pub use section::SectionDescriptor;
pub use section::SectionInput;
pub use section::SectionTableError;
pub use section::SectionType;
pub use section::SECTION_DESCRIPTOR_SIZE;
pub use spatial_index_section::decode_spatial_index_section;
pub use spatial_index_section::encode_spatial_index_section;
pub use spatial_index_section::DecodedSpatialIndex;
pub use spatial_index_section::SpatialIndexMiniHeader;
pub use spatial_index_section::SpatialIndexSectionError;
pub use spatial_index_section::SPATIAL_INDEX_MINI_HEADER_SIZE;
pub use surfel_section::decode_octahedral_normal;
pub use surfel_section::decode_surfel_section;
pub use surfel_section::encode_octahedral_normal;
pub use surfel_section::encode_surfel_section;
pub use surfel_section::generate_surfel_from_cluster;
pub use surfel_section::SurfelBinaryRecord;
pub use surfel_section::SurfelSectionError;
pub use surfel_section::SurfelSectionMiniHeader;
pub use surfel_section::FLAG_SURFEL_GAUSSIAN_COVARIANCE;
pub use surfel_section::FLAG_SURFEL_HIERARCHICAL;
pub use surfel_section::MAGIC_SURF;
pub use surfel_section::SURFEL_MINI_HEADER_SIZE;
pub use surfel_section::SURFEL_RECORD_SIZE;
pub use surfel_section::SURFEL_SECTION_VERSION;
pub use texture_coordinate_container::attach_texture_coordinate_section;
pub use texture_coordinate_container::read_texture_coordinate_section_into;
pub use texture_coordinate_container::TextureCoordinateContainerError;
pub use texture_coordinate_section::decode_texture_coordinates_into;
pub use texture_coordinate_section::encode_texture_coordinate_section;
pub use texture_coordinate_section::texture_coordinate_section_count;
pub use texture_coordinate_section::TextureCoordinateSectionError;
pub use texture_coordinate_section::TEXTURE_COORDINATE_SECTION_HEADER_SIZE;
pub use texture_coordinate_section::TEXTURE_COORDINATE_SECTION_VERSION;
pub use topology_section::decode_topology_section;
pub use topology_section::encode_topology_section;
pub use topology_section::TopologyMiniHeader;
pub use topology_section::TopologySectionData;
pub use topology_section::TopologySectionError;
pub use topology_section::TOPOLOGY_MINI_HEADER_SIZE;
pub use section::copy_opaque_container_into;
pub use section::inspect_opaque_container;
pub use section::replace_known_section_bytes_preserving_layout;
pub use section::OpaqueContainerView;
pub use section::OpaquePreservationBudget;
pub use section::OpaquePreservationError;
pub use voxel_section::*;

Modules§

axis_role
Normative axis-role taxonomy for the .10d container header.
cluster_dag_section
Section 23 (CDAG): Nanite-Style Hierarchical Meshlet Cluster DAG Section.
conformance
.10d v1 normative-spec conformance vectors + layout-table drift gate (P0.7 scaffold).
corpus_envelope
Species-trait envelopes read from a species corpus.
correspondence_section
Section 9 (FEMC): Volumetric-to-Surface Correspondence Map Section.
crc32c
Shared CRC-32C (Castagnoli, reflected) — the canonical integrity primitive for the .10d container and the q42/p64_weight.rs weight container.
entity_ontology_section
Versioned .10d Entity Behavioral & Affordance Ontology Section.
field_section
FIEL v0 field descriptors and optional raster sample payloads.
header
Normative .10d container header — the barrier surface every later P0 task consumes.
impostor_section
Section 19 (IMPO): Directional Octahedral Impostor Atlas for .10d Living Containers.
integrity
Whole-file content hash + canonical-encoding integrity gates (P0.3).
manifold_identity_container
Bounded integration of the v2 identity manifest with the versioned section envelope. Caller-buffered integration between the .10d v2 identity manifest and section envelope.
manifold_identity_v2
Version-2 manifold identity and typed scientific/presentation field manifest. .10d v2 manifold identity and typed-field manifest codec.
material_container
Container-level attach/read helpers for the optional MAT1 section.
material_section
Versioned .10d material and submesh sidecar.
mesh_section
.10d QuantizedMesh section — the geometry half of a mesh asset in the container (P0.4).
metric_check
Metric-completeness descriptor + the “queryability claim == code” gate.
metric_trait_gate
Fail-Closed QUDT Species-Trait & Artefact Dimensional Admission Gate (GAP-13 / G69).
morph_section
.10d Morph Target Section (MRP1) — sparse and dense quantized blend-shape deltas with optional EONT1 ontogenetic/metabolic binding.
node_section
.10d Tensor10D NODE section — the 40-byte epistemic atom in the container (P0.5).
normal_section
Compact, optional vertex-normal field sidecar for compiled mesh assets.
procedural_synthesis
Principled Procedural Geometry & Surface Synthesis for .10d Living Containers.
provenance_section
.10d ProvenanceSidecar section (P1) — the provenance half of an asset, bundled physically inside the container so context is byte-inseparable from the data it attests.
section
.10d self-describing section table + tiered alignment + caller-buffered writer (P0.2).
skeletal_container
Caller-buffered SKL1 / SKL2 attachment and integrity-checked readback.
skeletal_section
Versioned rig, skin influence and motor clip records. SKL1: versioned rigid rigs, four-weight vertex skins and named motor clips. Stable joint/clip IDs use the engine’s q_hash identity domain. All records are little endian; decoding validates the entire payload before writes.
spatial_index_section
.10d Spatial-index section — BVH node array + kd-tree node array serialized as a self-describing section (P3.7).
surface_reading
Per-vertex surface colour reading.
surfel_section
Section 20 (SURF1): Hierarchical Surfel / 3D Gaussian Splat Primitives for .10d Living Containers.
texture_coordinate_container
Container-level attach/read helpers for the UV01 vertex-coordinate section.
texture_coordinate_section
Versioned, vertex-aligned UV0 sidecar for imported material texture coordinates.
topology_section
.10d Topology section — half-edge graph + CSR adjacency + connectivity summary serialized as a self-describing section (P2.8).
typed_payloads
Borrowed typed-field selection and existing-codec container readers. Typed-field SDK over existing MID2 ranges and payload codecs.
voxel_section
Section 22 (VOX0): 3D Sparse Voxel Octree / DAG Lattice Section.

Structs§

EntityOntologyMiniHeader
40-byte header for SectionType::EntityOntology (EONT1), unified with etalon_render::skeletal::OntogeneticStateHeader. Domain-neutral 40-byte ontogenetic and metabolic state header (EONT1 layout).

Constants§

CONTAINER_10D_ABI_VERSION
Versioned .10d container ABI. Increment only when public POD layouts or caller-buffer contracts change. P0.1 sets this to 1; P0.2/P0.3 may raise it when the section table + CRC lands.