AutoMovie API
    Preparing search index...

    Module @automovie/recovery

    @automovie/recovery

    Recovers curves from a reference triangle mesh, saves them as a curve artifact, and generates new geometry from that artifact alone. Use it when an imported or generated mesh has to become something code can deform or drive by parameters. A mesh that is usable as supplied does not need it.

    Reconstruction reads no original mesh positions, faces or normals: the generated surface and its construction lines both come from the recovered curves.

    The package needs Node.js 22.23.2 or later.

    npm install @automovie/recovery
    

    The package touches no files and starts no processes. Writing files and the command-line entry are Node tooling that a generated production carries under src/executable/recovery.

    import {
    convertAutoMovieRecoveryCurves,
    reconstructAutoMovieRecoveryModel,
    } from "@automovie/recovery";
    import fs from "node:fs";

    const curves = JSON.parse(fs.readFileSync("curves.json", "utf8"));
    const hermite = convertAutoMovieRecoveryCurves(curves, "hermite");
    const result = reconstructAutoMovieRecoveryModel(hermite);
    if (!("value" in result)) throw new Error(result.diagnostics.join("; "));
    console.log(result.status, result.diagnostics);

    curves.json holds a curve artifact that observeAutoMovieRecovery returned. Reconstruction accepts an artifact in either basis, Bezier or Hermite, so the conversion here only shows the call. A partial result still carries usable geometry together with the domains, the pieces of the surface the artifact declares, that it could not resolve, so read its diagnostics before using it.

    1. prepareAutoMovieRecoveryInput accepts indexed triangles in millimetres that are already registered to your coordinate frame. You supply that frame, the pose, the component selection and the source transform already applied.
    2. observeAutoMovieRecovery cuts the mesh and fits cubic curves. { curveFormat: "hermite" } saves endpoint positions and derivatives; the default "bezier" saves Bernstein controls. convertAutoMovieRecoveryCurves changes the basis of a curve artifact later.
    3. reconstructAutoMovieRecoveryModel generates the model, its construction lines and a per-domain record, in metres.

    Other entry points:

    Need Entry point
    Sections at planes you choose, or a polyline you ordered yourself observeAutoMovieRecoverySections, observeAutoMovieRecoveryPolyline
    Source topology between already saved sections, without refitting observeAutoMovieRecoverySlabs
    Another fit of only the contours that failed resumeAutoMovieRecoveryContours
    A loft from calibrated orthographic images instead of a mesh observeAutoMovieRecoveryImages, then fitAutoMovieRecoveryImageLoft and compileAutoMovieRecoveryImageLoft for elliptical sections, or fitAutoMovieRecoveryImageSupportLoft and compileAutoMovieRecoverySupportLoft for convex ones
    Relative cameras from two, three or more calibrated photographs estimateAutoMovieRecoveryCameraPair, estimateAutoMovieRecoveryCameraMap, estimateAutoMovieRecoveryCameraScene

    The inputs, limits and guarantees of each one are in its JSDoc. Registration input types are in @automovie/interface.

    Every operation returns a status. complete and partial carry a value as well as diagnostics; refused, failed and cancelled carry diagnostics alone. complete describes the scope that was processed. It says nothing about likeness, smoothness, watertightness or how much of the source was covered. Unknown and unsupported domains stay explicit in the result instead of being filled in.

    • The image path needs horizontal orthographic cameras you supply, a fixed background colour, and one connected foreground interval per row. Caps, interiors and hidden concavities stay unknown.
    • Camera estimation is experimental. It needs known pinhole intrinsics and a static scene, returns poses of unknown physical scale, and can refuse on repeated texture, occlusion, a weak baseline or a planar scene. It produces sparse points, not a surface.
    • Curve conversion handles cubic curves. It does not repair missing geometry.
    AutoMovieRecoveryCompactApproximation
    AutoMovieRecoveryConicApproximation
    AutoMovieRecoveryEventCurve
    AutoMovieRecoveryMeshSections
    AutoMovieRecoveryOpenContinuation
    AutoMovieRecoveryOrderedLineage
    cutExact
    IRecoveryChartLeafControls
    IRecoveryChartLeafFit
    IRecoveryDiskChart
    IRecoveryMultiBoundaryChart
    IRecoveryOpenSlabGraph
    RecoveryBezierFit
    RecoveryChartFit
    RecoveryChartMap
    RecoveryChartSurface
    RecoveryOpenSlabGraph
    RecoveryScalarIndex
    RecoverySlabGraph
    RecoveryFeasibleCapacityError
    CriticalVertex
    CutPoint
    IAutoMovieRecoveryAnalyticDomain
    IAutoMovieRecoveryAnalyticDomainsInput
    IAutoMovieRecoveryAnalyticPort
    IAutoMovieRecoveryAnalyticPublication
    IAutoMovieRecoveryAnalyticRealization
    IAutoMovieRecoveryAnalyticRealizationInput
    IAutoMovieRecoveryAnalyticReport
    IAutoMovieRecoveryAnnularChart
    IAutoMovieRecoveryArchivedModel
    IAutoMovieRecoveryArchiveInput
    IAutoMovieRecoveryArrayFragment
    IAutoMovieRecoveryArraySource
    IAutoMovieRecoveryArtifact
    IAutoMovieRecoveryArtifactCoverage
    IAutoMovieRecoveryArtifactInput
    IAutoMovieRecoveryAtlasCompilation
    IAutoMovieRecoveryAtlasCounts
    IAutoMovieRecoveryAtlasGeneration
    IAutoMovieRecoveryAtlasObservation
    IAutoMovieRecoveryAtlasObservationInput
    IAutoMovieRecoveryAtlasPrimitiveRange
    IAutoMovieRecoveryAtlasRealization
    IAutoMovieRecoveryAtlasTessellation
    IAutoMovieRecoveryByteDigest
    IAutoMovieRecoveryCameraConsensus
    IAutoMovieRecoveryCameraFeaturePopulation
    IAutoMovieRecoveryCameraFile
    IAutoMovieRecoveryCameraFiles
    IAutoMovieRecoveryCameraHomographyConsensus
    IAutoMovieRecoveryCameraMapEstimate
    IAutoMovieRecoveryCameraMapFiles
    IAutoMovieRecoveryCameraMatch
    IAutoMovieRecoveryCameraOptimizerFit
    IAutoMovieRecoveryCameraPairEstimate
    IAutoMovieRecoveryCameraRelativePose
    IAutoMovieRecoveryCameraSceneEstimate
    IAutoMovieRecoveryCameraSceneFiles
    IAutoMovieRecoveryCameraSetObservation
    IAutoMovieRecoveryCameraSource
    IAutoMovieRecoveryChartEndpoint
    IAutoMovieRecoveryChartPatchBudgetFailure
    IAutoMovieRecoveryChartSourcePiece
    IAutoMovieRecoveryCheckpointReporting
    IAutoMovieRecoveryCoefficientOverride
    IAutoMovieRecoveryCoefficientPublication
    IAutoMovieRecoveryCompleted
    IAutoMovieRecoveryCompletion
    IAutoMovieRecoveryContourFileMesh
    IAutoMovieRecoveryContourResume
    IAutoMovieRecoveryContourResumeInput
    IAutoMovieRecoveryContourResumePolicy
    IAutoMovieRecoveryCurvatureAdmission
    IAutoMovieRecoveryCurvatureReport
    IAutoMovieRecoveryCurveBinding
    IAutoMovieRecoveryCurveFit
    IAutoMovieRecoveryCurveOverride
    IAutoMovieRecoveryDefaultObservationOptions
    IAutoMovieRecoveryDomainAddress
    IAutoMovieRecoveryDomainEmission
    IAutoMovieRecoveryDomainLedger
    IAutoMovieRecoveryDomainLedgerMember
    IAutoMovieRecoveryDomainLedgerUnattributed
    IAutoMovieRecoveryEndpointControlOwner
    IAutoMovieRecoveryEventChart
    IAutoMovieRecoveryEventChartInput
    IAutoMovieRecoveryEventCompilationPolicy
    IAutoMovieRecoveryEventCurveArc
    IAutoMovieRecoveryEventCurveCoefficients
    IAutoMovieRecoveryEventCurvePiece
    IAutoMovieRecoveryEventCurveSource
    IAutoMovieRecoveryEventDomainCompilation
    IAutoMovieRecoveryFeasibleArithmetic
    IAutoMovieRecoveryFeasibleCandidate
    IAutoMovieRecoveryFeasibleDiagnostics
    IAutoMovieRecoveryFeasibleDirection
    IAutoMovieRecoveryFeasibleDirectionReport
    IAutoMovieRecoveryFeasibleFit
    IAutoMovieRecoveryFeasibleJointOptions
    IAutoMovieRecoveryFeasibleMapLinearization
    IAutoMovieRecoveryFeasibleMapReporting
    IAutoMovieRecoveryFeasibleMapWork
    IAutoMovieRecoveryFeasibleModel
    IAutoMovieRecoveryFeasibleProblem
    IAutoMovieRecoveryFeasibleReportCapacity
    IAutoMovieRecoveryFeasibleTrials
    IAutoMovieRecoveryFeasibleTrialSelection
    IAutoMovieRecoveryFieldComplex
    IAutoMovieRecoveryFieldComplexCounts
    IAutoMovieRecoveryFieldComplexInput
    IAutoMovieRecoveryFieldComplexPiece
    IAutoMovieRecoveryFieldComplexPolicy
    IAutoMovieRecoveryFileReceipt
    IAutoMovieRecoveryFrontierChannel
    IAutoMovieRecoveryHermiteCurve
    IAutoMovieRecoveryHermiteSpan
    IAutoMovieRecoveryImageDirectionRank
    IAutoMovieRecoveryImageFile
    IAutoMovieRecoveryImageFiles
    IAutoMovieRecoveryImageFit
    IAutoMovieRecoveryImageFitCounts
    IAutoMovieRecoveryImageFitPolicy
    IAutoMovieRecoveryImageLoftBudget
    IAutoMovieRecoveryImageProfileSample
    IAutoMovieRecoveryImageRealization
    IAutoMovieRecoveryImageSource
    IAutoMovieRecoveryIndexedMesh
    IAutoMovieRecoveryInputHashes
    IAutoMovieRecoveryLinkedTrack
    IAutoMovieRecoveryLocalBinding
    IAutoMovieRecoveryMapCurvatureBlocks
    IAutoMovieRecoveryMapCurvatureFit
    IAutoMovieRecoveryMapDesignFactor
    IAutoMovieRecoveryMapDesignFit
    IAutoMovieRecoveryMapElimination
    IAutoMovieRecoveryMapEvaluation
    IAutoMovieRecoveryMapJointBlock
    IAutoMovieRecoveryMapJointFit
    IAutoMovieRecoveryMapJointPreparation
    IAutoMovieRecoveryMapJointResult
    IAutoMovieRecoveryMapJointStep
    IAutoMovieRecoveryMapLandmark
    IAutoMovieRecoveryMapLocalCurvature
    IAutoMovieRecoveryMapMetric
    IAutoMovieRecoveryMapMetricFit
    IAutoMovieRecoveryMapMetricScales
    IAutoMovieRecoveryMapObservation
    IAutoMovieRecoveryMapPose
    IAutoMovieRecoveryMapProjection
    IAutoMovieRecoveryMapResection
    IAutoMovieRecoveryMapState
    IAutoMovieRecoveryMapTriangularMetric
    IAutoMovieRecoveryMemoryPeaks
    IAutoMovieRecoveryMemoryUsage
    IAutoMovieRecoveryMeshChunkOwner
    IAutoMovieRecoveryMeshCounts
    IAutoMovieRecoveryMeshFrontier
    IAutoMovieRecoveryMeshFrontierInput
    IAutoMovieRecoveryMeshSections
    IAutoMovieRecoveryMeshSpool
    IAutoMovieRecoveryMetadata
    IAutoMovieRecoveryModelCounts
    IAutoMovieRecoveryNativeChartCompilation
    IAutoMovieRecoveryNativeCurveOwner
    IAutoMovieRecoveryNativeEndpoint
    IAutoMovieRecoveryObservationAnchor
    IAutoMovieRecoveryObservationChart
    IAutoMovieRecoveryObservationChartSeed
    IAutoMovieRecoveryObservationEntry
    IAutoMovieRecoveryObservationOptions
    IAutoMovieRecoveryObservationTangents
    IAutoMovieRecoveryObservationTransported
    IAutoMovieRecoveryObservationTransportRefused
    IAutoMovieRecoveryObservedInteriorPoint
    IAutoMovieRecoveryObservedPoint
    IAutoMovieRecoveryOpenContinuation
    IAutoMovieRecoveryOpenContinuationInterval
    IAutoMovieRecoveryOpenCurveGroup
    IAutoMovieRecoveryOpenCurvePair
    IAutoMovieRecoveryOpenPairAddress
    IAutoMovieRecoveryOptions
    IAutoMovieRecoveryOutcome
    IAutoMovieRecoveryPolylineInput
    IAutoMovieRecoveryPreparedInput
    IAutoMovieRecoveryPublicationOptions
    IAutoMovieRecoveryReconstructedModel
    IAutoMovieRecoveryReconstruction
    IAutoMovieRecoveryRegisteredInput
    IAutoMovieRecoveryRegularizationReport
    IAutoMovieRecoveryRegularizationUpdate
    IAutoMovieRecoveryResectionConsensus
    IAutoMovieRecoveryResectionDesign
    IAutoMovieRecoveryResectionDesignTrace
    IAutoMovieRecoveryResectionScore
    IAutoMovieRecoveryResectionTrace
    IAutoMovieRecoverySavedSection
    IAutoMovieRecoverySceneAttempt
    IAutoMovieRecoverySceneCandidate
    IAutoMovieRecoverySceneCheckpoint
    IAutoMovieRecoverySceneCheckpointTrace
    IAutoMovieRecoverySceneFeasibleRouting
    IAutoMovieRecoverySceneGrowth
    IAutoMovieRecoverySceneLandmark
    IAutoMovieRecoveryScenePointEvaluation
    IAutoMovieRecoverySceneQueue
    IAutoMovieRecoverySceneRay
    IAutoMovieRecoverySceneRegistration
    IAutoMovieRecoverySceneTriangulation
    IAutoMovieRecoverySceneWork
    IAutoMovieRecoverySectionCoverage
    IAutoMovieRecoverySectionReport
    IAutoMovieRecoverySections
    IAutoMovieRecoverySectionsInput
    IAutoMovieRecoverySectionSummary
    IAutoMovieRecoverySlabObservation
    IAutoMovieRecoverySlabPair
    IAutoMovieRecoverySlabs
    IAutoMovieRecoverySlabsInput
    IAutoMovieRecoverySourceLineage
    IAutoMovieRecoverySourceTerminal
    IAutoMovieRecoverySqpArc
    IAutoMovieRecoverySqpMix
    IAutoMovieRecoverySqpOptions
    IAutoMovieRecoverySqpReport
    IAutoMovieRecoverySqpTightening
    IAutoMovieRecoverySupportFit
    IAutoMovieRecoverySupportFitPolicy
    IAutoMovieRecoverySupportGeneration
    IAutoMovieRecoverySupportLoftBudget
    IAutoMovieRecoverySupportRealization
    IAutoMovieRecoverySupportRealizationMetrics
    IAutoMovieRecoveryTensorBoundary
    IAutoMovieRecoveryTensorConstruction
    IAutoMovieRecoveryTensorFamiliesInput
    IAutoMovieRecoveryTensorFamily
    IAutoMovieRecoveryTensorRealization
    IAutoMovieRecoveryTensorReport
    IAutoMovieRecoveryTerminalSeed
    IAutoMovieRecoveryTerminated
    IAutoMovieRecoveryTopologyGap
    IAutoMovieRecoveryTrackLinkage
    IAutoMovieRecoveryTrackPair
    IAutoMovieRecoveryTransportedObservationRow
    IAutoMovieRecoveryUnconsumedEvent
    IAutoMovieRecoveryUnsupportedDomain
    IAutoMovieRecoveryUntiltedEstimate
    IRecoveryAuthorityRecord
    IRecoveryOpenContinuationRow
    Plane
    Polyline
    RecoveryLocalResult
    RecoveryLocalRunReport
    AutoMovieRecoveryCurveData
    AutoMovieRecoveryCurveFormat
    AutoMovieRecoveryDiagnosticScalars
    AutoMovieRecoveryObservationProvenance
    AutoMovieRecoveryObservationTransport
    AutoMovieRecoveryOperator
    AutoMovieRecoverySqpCorrection
    IAutoMovieRecoveryDiagnosticNumber
    IAutoMovieRecoveryResult
    V2
    V3
    cross
    dist
    dot
    len
    mul
    norm
    sub
    to2
    admitRecoveryCameraMap
    admitRecoveryCameraPair
    admitRecoveryCameraScene
    admitRecoveryMapCurvature
    analyzeRecoveryMultiBoundarySurface
    applyAutoMovieRecoveryAnalyticPublication
    approximateAutoMovieRecoveryCompactCurves
    approximateAutoMovieRecoveryConicsAhn
    approximateAutoMovieRecoveryConicsGhosh
    assembleAutoMovieRecoveryFieldComplex
    assembleRecoveryMapCurvature
    assertRecoveryImageChart
    assertRecoverySceneLinearRetention
    bindRecoveryOrderedFits
    bindRecoverySavedSectionCuts
    calibrateRecoveryEpipolarMatrix
    chooseRecoverySqpTightening
    collectRecoveryContourFaceSupport
    collectRecoverySceneSupport
    compileAutoMovieRecoveryAtlas
    compileAutoMovieRecoveryEventDomain
    compileAutoMovieRecoveryImageLoft
    compileAutoMovieRecoveryNativeNamedChart
    compileAutoMovieRecoverySupportLoft
    completeRecoverySceneCheckpoint
    convertAutoMovieRecoveryCurves
    copyRecoveryUntiltedEstimate
    createRecoveryCameraChart
    createRecoveryCameraEstimate
    createRecoveryCameraMap
    createRecoveryCameraScene
    createRecoveryFeasibleDiagnostics
    createRecoveryFeasibleSqpArc
    createRecoveryImageDirectionSolver
    createRecoveryMapMetric
    createRecoveryMapTangent
    createRecoveryMapTriangularMetric
    createRecoveryObservationPolicy
    createRecoveryPoseModel
    createRecoverySceneSeedReportObserver
    critical
    cutExact
    describeRecoveryDomains
    describeRecoveryNamedDomains
    describeRecoveryOpenRun
    describeRecoverySceneRegistration
    differentiateRecoveryMapProjection
    differentiateRecoveryMapTangent
    encodeRecoveryDiagnosticNumber
    estimateAutoMovieRecoveryCameraMap
    estimateAutoMovieRecoveryCameraPair
    estimateAutoMovieRecoveryCameraScene
    evaluateRecoveryScenePoint
    extractRecoveryImageFeatures
    extractRecoveryMeshSections
    factorRecoveryMapCurvature
    factorRecoveryMapDesign
    factorRecoveryMapMetric
    filterRecoveryImageGaussian
    fitAutoMovieRecoveryImageLoft
    fitAutoMovieRecoveryImageSupportLoft
    fitRecoveryEpipolarConsensus
    fitRecoveryEpipolarMatrix
    fitRecoveryHomography
    fitRecoveryHomographyConsensus
    fitRecoveryImageProfiles
    fitRecoveryResectionConsensus
    fitRecoveryResectionDesign
    fitRecoveryScalarProfiles
    GhoshConicApproximationBalance
    GhoshConicApproximationDisplacement
    growRecoverySceneLandmarks
    initializeRecoverySceneSeed
    isRecoveryCameraNumericalRefusal
    isRecoveryMapIdentityGauge
    linearizeRecoveryFeasibleMap
    linearizeRecoveryPoseResiduals
    linkRecoveryCameraTracks
    matchRecoveryImageFeatures
    measureRecoveryEpipolarErrors
    measureRecoveryFeasibleArithmetic
    measureRecoveryHomographyErrors
    mixRecoveryFeasibleSqpStep
    normalizeRecoveryCourse
    normalizeRecoveryImagePoints
    observeAutoMovieRecovery
    observeAutoMovieRecoveryAtlas
    observeAutoMovieRecoveryImages
    observeAutoMovieRecoveryPolyline
    observeAutoMovieRecoverySections
    observeAutoMovieRecoverySlabs
    observeRecoveryCameraSet
    observeRecoveryOrderedCuts
    observeRecoverySection
    observeRecoverySourceSlabs
    observeRecoverySourceTerminals
    planeFrame
    predictRecoveryMapDecrease
    prepareAutoMovieRecoveryAnnularChart
    prepareAutoMovieRecoveryInput
    prepareRecoveryChartLeafBoundary
    prepareRecoveryCheckpointReportCapacity
    prepareRecoveryCriticalBrackets
    prepareRecoveryDiskBoundary
    prepareRecoveryFeasibleMapReporting
    prepareRecoveryFeasibleMapWork
    prepareRecoveryFeasibleReportCapacity
    prepareRecoveryImageSupports
    prepareRecoveryLocalContinuation
    prepareRecoveryMapJointBlocks
    prepareRecoveryMeshIncidence
    prepareRecoveryOpenRuns
    prepareRecoveryOpenSlabGraph
    prepareRecoverySceneFeasibleRouting
    prepareRecoverySceneReportCapacity
    projectRecoveryMapPoint
    readRecoveryEventCurveControls
    readRecoveryEventCurveParent
    readRecoveryMetadata
    realizeAutoMovieRecoveryAnalyticDomains
    realizeAutoMovieRecoveryTensorFamilies
    rebindRecoveryCurveAuthorities
    reconstructAutoMovieRecoveryModel
    reconstructRecovery
    reconstructRecoveryOpen
    RecoveryAnnularChart
    RecoveryAtlasObservationChart
    RecoveryAtlasObservationCreases
    RecoveryAtlasObservationFeatures
    RecoveryAtlasObservationNormals
    RecoveryAtlasObservationPublish
    RecoveryAtlasObservationSource
    RecoveryChartAreaObservations
    RecoveryChartAssembly
    RecoveryChartBatch
    RecoveryChartBoundary
    RecoveryChartBoundaryNetwork
    RecoveryChartBoundaryNetworkAugment
    RecoveryChartBoundaryNetworkBindings
    RecoveryChartBoundaryNetworkRegistry
    RecoveryChartBoxSolve
    RecoveryChartCollar
    RecoveryChartControlRelations
    RecoveryChartFitPrepare
    RecoveryChartFitReport
    RecoveryChartFitRows
    RecoveryChartFitSolve
    RecoveryChartFitSystem
    RecoveryChartLeafAssembly
    RecoveryChartLeafControls
    RecoveryChartLeafFit
    RecoveryChartPhysicalJet
    RecoveryChartReachableBox
    RecoveryChartRefinementClosure
    RecoveryDiskChart
    RecoveryEventRegion
    RecoveryEventRegionCells
    RecoveryEventRegionPorts
    RecoveryEventRegionSource
    RecoveryEventRegionTopology
    RecoveryFeatureChartCuts
    RecoveryFeatureChartCutsFans
    RecoveryFeatureChartCutsSeams
    RecoveryFeatureChartCutsSubdivide
    RecoveryFeatureChartCutsTopology
    RecoveryFeatureChartPreparation
    RecoveryMultiBoundaryChart
    refineRecoveryCameraMap
    refineRecoveryCameraMapFeasible
    refineRecoveryCameraPose
    refineRecoveryChartBoundaryChords
    refineRecoveryEpipolarModel
    refineRecoveryFeasibleState
    refineRecoveryResection
    requiredRecoveryCameraTrials
    restoreRecoveryCurveBasis
    resumeAutoMovieRecoveryContours
    sampleRecoveryCameraIndices
    scoreRecoveryCameraResiduals
    selectRecoveryCameraPose
    selectRecoveryFeasibleTrial
    selectRecoveryScalarIntervals
    signedArea
    solveRecoveryFeasibleDirection
    solveRecoveryMapDesign
    solveRecoveryMapJointStep
    sourceOrientation
    spendRecoverySceneWork
    stepRecoveryMapPose
    stepRecoveryMapSeedPose
    stepRecoveryRelativePose
    transportAutoMovieRecoveryObservationChart
    triangulateRecoveryCameraPoint
    triangulateRecoverySceneTrack
    updateRecoveryRegularization
    validateRecoveryContourResume
    validateRecoveryMapMetricRow
    validateRecoveryMapMetricScales
    IAutoMovieRecoveryLocalResult → RecoveryLocalResult
    IAutoMovieRecoveryPublication → IAutoMovieRecoveryFileReceipt