Babylon.js/Viewer/src/configuration/configuration.ts

import { ITemplateConfiguration } from './../templateManager';

export interface ViewerConfiguration {

    // configuration version
    version?: string;
    extends?: string; // is this configuration extending an existing configuration?

    pageUrl?: string; // will be used for sharing and other fun stuff. This is the page showing the model (not the model's url!)

    configuration?: string | {
        url: string;
        mapper?: string; // json (default), html, yaml, xml, etc'. if not provided, file extension will be used.
    };

    // Deprecated
    /*// native (!!!) javascript events. Mainly used in the JSON-format.
    // those events will be triggered by the container element (the <babylon> tag);
    events?: {
        load: boolean | string;
        init: boolean | string;
        meshselected: boolean | string;
        pointerdown: boolean | string;
        pointerup: boolean | string;
        pointermove: boolean | string;
        // load: 'onViewerLoaded' // will trigger the event prefix-onViewerLoaded instead of prefix-onLoad (and ONLY this event).
    } | boolean; //events: true - fire all events*/
    //eventPrefix?: string;

    // names of functions in the window context.
    observers?: {
        onEngineInit?: string;
        onSceneInit?: string;
        onModelLoaded?: string;
    }

    canvasElement?: string; // if there is a need to override the standard implementation - ID of HTMLCanvasElement

    model?: {
        url?: string;
        loader?: string; // obj, gltf?
        position?: { x: number, y: number, z: number };
        rotation?: { x: number, y: number, z: number, w: number };
        scaling?: { x: number, y: number, z: number };
        parentObjectIndex?: number; // the index of the parent object of the model in the loaded meshes array.

        title: string;
        subtitle?: string;
        thumbnail?: string; // URL or data-url

        [propName: string]: any; // further configuration, like title and creator
    } | string;

    scene?: {
        debug?: boolean;
        autoRotate?: boolean;
        rotationSpeed?: number;
        defaultCamera?: boolean;
        defaultLight?: boolean;
        clearColor?: { r: number, g: number, b: number, a: number };
        imageProcessingConfiguration?: IImageProcessingConfiguration;
    },
    // at the moment, support only a single camera.
    camera?: {
        position?: { x: number, y: number, z: number };
        rotation?: { x: number, y: number, z: number, w: number };
        fov?: number;
        fovMode?: number;
        minZ?: number;
        maxZ?: number;
        inertia?: number;
        behaviors?: {
            [name: string]: number | {
                type: number;
                [propName: string]: any;
            };
        };

        [propName: string]: any;
    },
    skybox?: {
        cubeTexture: {
            noMipMap?: boolean;
            gammaSpace?: boolean;
            url: string | Array<string>;
        };
        pbr?: boolean;
        scale?: number;
        blur?: number;
        material?: {
            imageProcessingConfiguration?: IImageProcessingConfiguration;
        };
        infiniteDIstance?: boolean;

    };

    ground?: boolean | {
        size?: number;
        receiveShadows?: boolean;
        shadowOnly?: boolean;
        material?: {
            [propName: string]: any;
        }
    };
    lights?: {
        [name: string]: {
            type: number;
            name?: string;
            disabled?: boolean;
            position?: { x: number, y: number, z: number };
            target?: { x: number, y: number, z: number };
            direction?: { x: number, y: number, z: number };
            diffuse?: { r: number, g: number, b: number };
            specular?: { r: number, g: number, b: number };
            intensity?: number;
            radius?: number;
            shadownEnabled?: boolean; // only on specific lights!
            shadowConfig?: {
                useBlurExponentialShadowMap?: boolean;
                useKernelBlur?: boolean;
                blurKernel?: number;
                blurScale?: number;
                [propName: string]: any;
            }
            [propName: string]: any;

            // no behaviors for light at the moment, but allowing configuration for future reference.
            behaviors?: {
                [name: string]: number | {
                    type: number;
                    [propName: string]: any;
                };
            };
        }
    },
    // engine configuration. optional!
    engine?: {
        antialiasing?: boolean;
    },
    //templateStructure?: ITemplateStructure,
    templates?: {
        main: ITemplateConfiguration,
        [key: string]: ITemplateConfiguration
    };
    // nodes?
}

export interface IImageProcessingConfiguration {
    colorGradingEnabled?: boolean;
    colorCurvesEnabled?: boolean;
    colorCurves?: {
        globalHue?: number;
        globalDensity?: number;
        globalSaturation?: number;
        globalExposure?: number;
        highlightsHue?: number;
        highlightsDensity?: number;
        highlightsSaturation?: number;
        highlightsExposure?: number;
        midtonesHue?: number;
        midtonesDensity?: number;
        midtonesSaturation?: number;
        midtonesExposure?: number;
        shadowsHue?: number;
        shadowsDensity?: number;
        shadowsSaturation?: number;
        shadowsExposure?: number;
    };
    colorGradingWithGreenDepth?: boolean;
    colorGradingBGR?: boolean;
    exposure?: number;
    toneMappingEnabled?: boolean;
    contrast?: number;
    vignetteEnabled?: boolean;
    vignetteStretch?: number;
    vignetteCentreX?: number;
    vignetteCentreY?: number;
    vignetteWeight?: number;
    vignetteColor?: { r: number, g: number, b: number, a?: number };
    vignetteCameraFov?: number;
    vignetteBlendMode?: number;
    vignetteM?: boolean;
    applyByPostProcess?: boolean;

}