// generated by diplomat-tool
import type { Schematic } from "./Schematic.mjs"
import type { pointer, codepoint } from "./diplomat-runtime.d.ts";



export class DistanceField {
    /** @internal */
    get ffiValue(): pointer;
    /** @internal */
    constructor();


    /**
     * Distance transform of a build's occupied voxels: every solid block
     * learns how many blocks it sits below the surface, and the gradient of
     * that depth gives the outward normal. Computed once over the
     * schematic's bounding box.
     */
    static fromSchematic(schematic: Schematic): DistanceField;

    /**
     * Blocks below the surface at a voxel: 0 for empty/outside, 1 at the
     * surface, increasing inward.
     */
    depth(x: number, y: number, z: number): number;

    /**
     * The upward component of the outward surface normal: 1 on flat ground,
     * 0 on a vertical face, negative under an overhang. The scalar to key
     * slope-based landscaping on (grass on the flats, stone on the steeps).
     */
    slope(x: number, y: number, z: number): number;

    /**
     * The full outward surface normal as JSON `[nx, ny, nz]`.
     */
    normalJson(x: number, y: number, z: number): string;
}