Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-obj

Source of release 0.10.1

0.10.1 / src / obj.lucb

from luce_std import files, collections
import interop
import memory
from luce_geocore.geocore import Mesh
import encode as encoding
import reader
import reference
import source

pub struct Obj:
    let reserved: u8 = 0

    ## Read at most 1 GiB of polygon text; preflight bounds native allocations.
    pub static func load(path: str) -> interop.Reference[Mesh]!:
        let data = try source.read(path, 1073741824)
        defer free(data) in memory.heap
        return try reader.decode(data, validate = true)

    ## Decode shared positions, polygon indices, corner UVs and corner normals.
    pub static func decode(text: str) -> interop.Reference[Mesh]!:
        return try reader.decode(text.bytes, validate = false)

    ## The original single-pass decoder, which `decode` must match exactly and
    ## which reports its errors. For tests and comparisons; several times slower.
    pub static func decode_reference(text: str) -> interop.Reference[Mesh]!:
        return try reference.decode_reference(text)

    ## Wavefront text for `mesh`: `v` per point with 17 significant digits,
    ## optional per-corner `vt`/`vn` from corner-domain `uv`/`N`, and `f` per polygon.
    pub static func encode(mesh: interop.Reference[Mesh], attributes: bool = true) -> interop.Owned[str]!:
        var output: collections.Buffer
        defer output.destroy()
        try encoding.encode(&output, try mesh.get(), attributes)
        return try interop.copy_text(output.text())

    ## Write `mesh` to `path` as `encode` does, replacing the file atomically.
    pub static func write(path: str, mesh: interop.Reference[Mesh], attributes: bool = true) -> !:
        var output: collections.Buffer
        defer output.destroy()
        try encoding.encode(&output, try mesh.get(), attributes)
        try files.write_text(path, output.text())