MeshDataTool

public MeshDataTool();

Creates an owned RefCounted with zero counts/format and no material. Import a Triangles surface before indexed access.

public void Clear();

Clears working vertices, edges, faces and their metadata; resets material/format. Does not change the source Mesh.

public Error CommitToSurface(ArrayMesh mesh);

Appends a Triangles surface to mesh and assigns current material. Neither replaces an old surface nor clears the tool. Does not serialize metadata/custom channels/blend shapes/LODs; bone/weight channels use 4 values. Error.Ok establishes neither visual correctness nor unsupported-channel fidelity.

public Error CommitToSurface(ArrayMesh mesh, ulong compressionFlags = 0);

Appends a Triangles surface to mesh and assigns current material. Neither replaces an old surface nor clears the tool. Does not serialize metadata/custom channels/blend shapes/LODs; bone/weight channels use 4 values. Error.Ok establishes neither visual correctness nor unsupported-channel fidelity.

public Error CreateFromSurface(ArrayMesh mesh, int surface);

Reads one ArrayMesh Triangles surface, checking nonempty vertices, triangle-divisible indices and index bounds. Without INDEX it uses sequential indices rather than position welding. Successful import replaces state/material; old IDs must not be reused. Does not validate arbitrary manifold topology or every channel length.

public int GetEdgeCount();

Count of unique undirected vertex-index pairs. Equal positions with distinct indices do not weld edges.

public int[] GetEdgeFaces(int idx);

Returns face IDs using the edge. One is normally a boundary, two a shared edge; more than two is possible and not rejected as nonmanifold.

public Variant GetEdgeMeta(int idx);

Reads current-element metadata Variant. Nil is valid rather than an error-only sentinel. Tool-local metadata rather than a serialized surface field.

public int GetEdgeVertex(int idx, int vertex);

Returns one of an edge's two vertex IDs. Endpoints are stored in ascending-index order rather than face-winding direction.

public int GetFaceCount();

Triangle face count rather than index count.

public int GetFaceEdge(int idx, int edge);

Returns the edge ID between local corners edge and (edge+1)%3. Stored edge endpoints have canonical order, not necessarily face direction.

public Variant GetFaceMeta(int idx);

Reads current-element metadata Variant. Nil is valid rather than an error-only sentinel. Tool-local metadata rather than a serialized surface field.

public Vector3 GetFaceNormal(int idx);

Computes a Plane unit normal from current corner positions. Neither reads nor updates stored vertex normals. Degenerate faces have no reliable direction.

public int GetFaceVertex(int idx, int vertex);

Returns the vertex ID of local corner 0…2 in original triangle-index order.

public ulong GetFormat();

Returns ulong mask of imported/enabled channels. Does not establish that Commit preserves every source-format bit; custom and 8-weight data lack complete roundtrip support.

public Material GetMaterial();

Returns the shared current-surface Material or null. Not an independent copy; do not dispose an alias still used by an owner.

public Vector3 GetVertex(int idx);

Reads vertex-record position. Working data rather than world-transformed values.

public int[] GetVertexBones(int idx);

Reads vertex-record four bone indices. Returns an independent managed array; editing it does not mutate the tool.

public Color GetVertexColor(int idx);

Reads vertex-record color. Working data rather than world-transformed values.

public int GetVertexCount();

Current imported vertex-record count rather than unique-position count.

public int[] GetVertexEdges(int idx);

Returns copied local edge IDs incident to a vertex record, not traversal of the entire connected component.

public int[] GetVertexFaces(int idx);

Returns copied face IDs containing the vertex record without position welding.

public Variant GetVertexMeta(int idx);

Reads current-element metadata Variant. Nil is valid rather than an error-only sentinel. Tool-local metadata rather than a serialized surface field.

public Vector3 GetVertexNormal(int idx);

Reads vertex-record stored normal. Working data rather than world-transformed values.

public Plane GetVertexTangent(int idx);

Reads vertex-record tangent in Plane (Normal=xyz, D=handedness). Working data rather than world-transformed values.

public Vector2 GetVertexUV(int idx);

Reads vertex-record first UV. Working data rather than world-transformed values.

public Vector2 GetVertexUV2(int idx);

Reads vertex-record second UV. Working data rather than world-transformed values.

public float[] GetVertexWeights(int idx);

Reads vertex-record four weights. Returns an independent managed array; editing it does not mutate the tool.

public void SetEdgeMeta(int idx, Variant meta);

Stores element metadata only in the tool. Variant containers are not deep-cloned; Commit omits metadata and Clear/new import removes it.

public void SetFaceMeta(int idx, Variant meta);

Stores element metadata only in the tool. Variant containers are not deep-cloned; Commit omits metadata and Clear/new import removes it.

public void SetMaterial(Material material);

Stores a shared reference for the next CommitToSurface without immediately changing the source Mesh. null clears the selected material.

public void SetVertex(int idx, Vector3 vertex);

Writes vertex-record position. Does not recompute normals/tangents, UVs, source-Mesh bounds or topology.

public void SetVertexBones(int idx, int[] bones);

Writes vertex-record four bone indices. Requires exactly 4 values and enables the channel. When first adding it, prepare matching bones/weights for every vertex; no normalization is performed.

public void SetVertexBones(int idx, ReadOnlySpan<int> bones);

Writes vertex-record four bone indices. Requires exactly 4 values and enables the channel. When first adding it, prepare matching bones/weights for every vertex; no normalization is performed.

public void SetVertexColor(int idx, Color color);

Writes vertex-record color. Enables the surface channel; populate all vertices. Does not automatically generate coherent remaining attributes.

public void SetVertexMeta(int idx, Variant meta);

Stores element metadata only in the tool. Variant containers are not deep-cloned; Commit omits metadata and Clear/new import removes it.

public void SetVertexNormal(int idx, Vector3 normal);

Writes vertex-record stored normal. Enables the surface channel; populate all vertices. Does not automatically generate coherent remaining attributes.

public void SetVertexTangent(int idx, Plane tangent);

Writes vertex-record tangent in Plane (Normal=xyz, D=handedness). Enables the surface channel; populate all vertices. Does not automatically generate coherent remaining attributes.

public void SetVertexUV(int idx, Vector2 uV);

Writes vertex-record first UV. Enables the surface channel; populate all vertices. Does not automatically generate coherent remaining attributes.

public void SetVertexUV2(int idx, Vector2 uV2);

Writes vertex-record second UV. Enables the surface channel; populate all vertices. Does not automatically generate coherent remaining attributes.

public void SetVertexWeights(int idx, ReadOnlySpan<float> weights);

Writes vertex-record four weights. Requires exactly 4 values and enables the channel. When first adding it, prepare matching bones/weights for every vertex; no normalization is performed.

public void SetVertexWeights(int idx, float[] weights);

Writes vertex-record four weights. Requires exactly 4 values and enables the channel. When first adding it, prepare matching bones/weights for every vertex; no normalization is performed.