Taos API Reference
    Preparing search index...

    Interface ForwardPresetOptions

    interface ForwardPresetOptions {
        sky?: SkyOption;
        shadow?: boolean | ShadowFeatureOptions;
        ibl?: IblTextures;
        lighting?: { useSphericalHarmonics?: boolean };
        directional?: () => DirectionalLight;
        taa?: boolean;
        aa?: false | "taa" | "smaa";
        smaa?: SMAAOptions;
        motionBlur?: boolean | MotionBlurFeatureOptions;
        dof?: boolean | DofFeatureOptions;
        bloom?: boolean | BloomFeatureOptions;
        exposure?: number;
        aces?: boolean;
        camera?: CameraExposureSettings;
        physicalSceneScale?: number;
        hdrCanvas?: boolean;
    }
    Index

    Properties

    sky?: SkyOption

    Sky source — see SkyOption for the union. Default: no sky.

    shadow?: boolean | ShadowFeatureOptions

    Cascaded directional shadow map. Default: disabled — the forward path is used most often for material-showcase scenes that don't need cascades. Pass true for defaults, or a config object forwarded to ShadowFeature.

    ibl?: IblTextures

    IBL texture set passed to the forward-lit pass for indirect lighting.

    lighting?: { useSphericalHarmonics?: boolean }

    Forward-lit tuning. useSphericalHarmonics selects the IBL_DIFFUSE_SH variant (diffuse IBL from order-3 SH coefficients instead of the irradiance cube); it's a pipeline-build-time choice, so it must be set here.

    directional?: () => DirectionalLight

    Override the directional light supplied to the forward pass; otherwise the scene's first DirectionalLight component is used.

    taa?: boolean

    Temporal anti-aliasing. Default: false (kept off so the minimal sample stays minimal; turn on per-sample). Ignored when aa is set.

    aa?: false | "taa" | "smaa"

    Anti-aliasing method, a superset of taa that also selects SMAA:

    • 'taa' — temporal AA (TAAFeature).
    • 'smaa' — spatial SMAA 1x (SMAAFeature); no jitter/history/ghosting.
    • false — no anti-aliasing. When omitted, falls back to taa (default off).

    Tuning forwarded to SMAAFeature when aa: 'smaa'.

    motionBlur?: boolean | MotionBlurFeatureOptions

    Motion blur. Camera-only by default; pass { useVelocityBuffer: true } to add per-object motion blur via an extra velocity-buffer pass. Slotted after TAA and before DoF / bloom. Default: disabled.

    dof?: boolean | DofFeatureOptions
    bloom?: boolean | BloomFeatureOptions
    exposure?: number
    aces?: boolean

    Drive the tonemap exposure from a physical camera (aperture/shutter/ISO → EV100) instead of exposure. See TonemapFeature.

    physicalSceneScale?: number

    Calibration for camera on a still-normalized scene (default 1).

    hdrCanvas?: boolean