Optional inspect/fix step that runs after loading and before exporting in ModelConverter.convert. When enabled, the converter walks every SceneModel populated by the pipeline, runs inspectSceneModel (or its async variant) and — when fix is set — applyFixes before the exporters serialise. The resulting reports surface on ModelConverterResult.inspection.

interface ModelConverterInspectConfig {
    async?: boolean;
    checks?: Omit<InspectSceneModelParams, "sceneModel">;
    enabled?: boolean;
    failOnErrors?: boolean;
    fix?: boolean;
    reInspect?: boolean;
}

Properties

async?: boolean

Use inspectSceneModelAsync so a multi-million-tri IFC doesn't block the event loop. Default false.

checks?: Omit<InspectSceneModelParams, "sceneModel">

Pass-through to InspectSceneModelParams. The sceneModel field is supplied by the converter; everything else (the opt-in checkXxx flags, thresholds, custom registry) is forwarded verbatim.

enabled?: boolean

Master switch. Default false — pipelines without an inspect block keep their current behaviour.

failOnErrors?: boolean

Skip processOutputs and resolve with errors populated when report.errors.length > 0. Default true. Set false to export anyway (e.g. you want the bad output for diffing).

fix?: boolean

false (default) — report only. true — run applyFixes after inspection.

The fix pass is skipped when report.errors.length > 0 — auto-fixing on top of structural errors masks data corruption.

reInspect?: boolean

Re-run inspection after fix so the result reflects the post-fix state. Default true whenever fix is set.