Nightly

dist/preview release/gui/babylon.gui.js

@@ -422,6 +422,9 @@ var BABYLON;
                     return;
                 }
                 this._pointerMoveObserver = scene.onPrePointerObservable.add(function (pi, state) {
+                    if (scene.isPointerCaptured((pi.event).pointerId)) {
+                        return;
+                    }
                     if (pi.type !== BABYLON.PointerEventTypes.POINTERMOVE
                         && pi.type !== BABYLON.PointerEventTypes.POINTERUP
                         && pi.type !== BABYLON.PointerEventTypes.POINTERDOWN) {
@@ -3501,7 +3504,9 @@ var BABYLON;
                 if (!_super.prototype._onPointerDown.call(this, target, coordinates, pointerId, buttonIndex)) {
                     return false;
                 }
-                this.isChecked = !this.isChecked;
+                if (!this.isChecked) {
+                    this.isChecked = true;
+                }
                 return true;
             };
             return RadioButton;

dist/preview release/viewer/babylon.viewer.d.ts

@@ -334,6 +334,9 @@ declare module BabylonViewer {
                 * The configuration loader of this viewer
                 */
             protected _configurationLoader: ConfigurationLoader;
+            /**
+                * Is the viewer already initialized. for internal use.
+                */
             protected _isInit: boolean;
             constructor(containerElement: HTMLElement, initialConfiguration?: ViewerConfiguration);
             /**
@@ -383,9 +386,10 @@ declare module BabylonViewer {
                 * Only provided information will be updated, old configuration values will be kept.
                 * If this.configuration was manually changed, you can trigger this function with no parameters,
                 * and the entire configuration will be updated.
-                * @param newConfiguration
+                * @param newConfiguration the partial configuration to update
+                *
                 */
-            updateConfiguration(newConfiguration?: Partial<ViewerConfiguration>, mode?: ViewerModel): void;
+            updateConfiguration(newConfiguration?: Partial<ViewerConfiguration>): void;
             /**
                 * this is used to register native functions using the configuration object.
                 * This will configure the observers.
@@ -416,7 +420,7 @@ declare module BabylonViewer {
                 */
             protected _initEngine(): Promise<BABYLON.Engine>;
             /**
-                * Initialize a model loading. The returns object (a ViewerModel object) will be loaded in the background.
+                * Initialize a model loading. The returned object (a ViewerModel object) will be loaded in the background.
                 * The difference between this and loadModel is that loadModel will fulfill the promise when the model finished loading.
                 *
                 * @param modelConfig model configuration to use when loading the model.
@@ -425,7 +429,9 @@ declare module BabylonViewer {
                 */
             initModel(modelConfig: string | IModelConfiguration, clearScene?: boolean): ViewerModel;
             /**
-                * load a model using the provided configuration
+                * load a model using the provided configuration.
+                * This function, as opposed to initModel, will return a promise that resolves when the model is loaded, and rejects with error.
+                * If you want to attach to the observables of the model, use initModle instead.
                 *
                 * @param modelConfig the model configuration or URL to load.
                 * @param clearScene Should the scene be cleared before loading the model
@@ -480,6 +486,9 @@ declare module BabylonViewer {
                 * @return The current session ID
                 */
             readonly session: string;
+            /**
+                * Disposes the telemetry manager
+                */
             dispose(): void;
     }
     export const telemetryManager: TelemetryManager;
@@ -502,6 +511,11 @@ declare module BabylonViewer {
                 * @param _viewer the viewer using this model loader
                 */
             constructor(_viewer: AbstractViewer);
+            /**
+                * Adds a new plugin to the loader process.
+                *
+                * @param plugin the plugin name or the plugin itself
+                */
             addPlugin(plugin: ILoaderPlugin | string): void;
             /**
                 * Load a model using predefined configuration
@@ -523,6 +537,9 @@ declare module BabylonViewer {
     
     
     
+    /**
+        * The current state of the model
+        */
     export enum ModelState {
             INIT = 0,
             LOADING = 1,
@@ -891,6 +908,11 @@ declare module BabylonViewer {
     
     
     
+    /**
+      * This interface defines the structure of a loader plugin.
+      * Any of those functions will be called if (!) the loader supports those callbacks.
+      * Any loader supports onInit, onLoaded, onError and onProgress.
+      */
     export interface ILoaderPlugin {
         onInit?: (loader: BABYLON.ISceneLoaderPlugin | BABYLON.ISceneLoaderPluginAsync, model: ViewerModel) => void;
         onLoaded?: (model: ViewerModel) => void;
@@ -1455,12 +1477,30 @@ declare module BabylonViewer {
         * A single template configuration object
         */
     export interface ITemplateConfiguration {
+            /**
+                * can be either the id of the template's html element or a URL.
+                * See - http://doc.babylonjs.com/extensions/the_templating_system#location-vs-html
+                */
             location?: string;
+            /**
+                * If no location is provided you can provide here the raw html of this template.
+                * See http://doc.babylonjs.com/extensions/the_templating_system#location-vs-html
+                */
             html?: string;
             id?: string;
+            /**
+                * Parameters that will be delivered to the template and will render it accordingly.
+                */
             params?: {
                     [key: string]: string | number | boolean | object;
             };
+            /**
+                * Events to attach to this template.
+                * event name is the key. the value can either be a boolean (attach to the parent element)
+                * or a map of html id elements.
+                *
+                * See - http://doc.babylonjs.com/extensions/the_templating_system#event-binding
+                */
             events?: {
                     pointerdown?: boolean | {
                             [id: string]: boolean;
@@ -1617,6 +1657,8 @@ declare module BabylonViewer {
                 * The parameters are provided to Handlebars which in turn generates the template.
                 * This function will update the template with the new parameters
                 *
+                * Note that when updating parameters the events will be registered again (after being cleared).
+                *
                 * @param params the new template parameters
                 */
             updateParams(params: {
@@ -1785,7 +1827,7 @@ declare module BabylonViewer {
                 * @param newConfiguration the delta that should be configured. This includes only the changes
                 * @param globalConfiguration The global configuration object, after the new configuration was merged into it
                 */
-            updateConfiguration(newConfiguration: Partial<ViewerConfiguration>, globalConfiguration: ViewerConfiguration, model?: ViewerModel): void;
+            updateConfiguration(newConfiguration: Partial<ViewerConfiguration>, globalConfiguration: ViewerConfiguration): void;
             bloomEnabled: boolean;
             fxaaEnabled: boolean;
             /**
@@ -1805,8 +1847,8 @@ declare module BabylonViewer {
                 * @param cameraConfig the new camera configuration
                 * @param model optionally use the model to configure the camera.
                 */
-            protected _configureCamera(cameraConfig?: ICameraConfiguration, model?: ViewerModel): void;
-            protected _configureEnvironment(skyboxConifguration?: ISkyboxConfiguration | boolean, groundConfiguration?: IGroundConfiguration | boolean, model?: ViewerModel): Promise<BABYLON.Scene> | undefined;
+            protected _configureCamera(cameraConfig?: ICameraConfiguration): void;
+            protected _configureEnvironment(skyboxConifguration?: ISkyboxConfiguration | boolean, groundConfiguration?: IGroundConfiguration | boolean): Promise<BABYLON.Scene> | undefined;
             /**
                 * configure the lights.
                 *
@@ -1815,7 +1857,7 @@ declare module BabylonViewer {
                 */
             protected _configureLights(lightsConfiguration?: {
                     [name: string]: ILightConfiguration | boolean;
-            }, model?: ViewerModel): void;
+            }): void;
             /**
                 * Gets the shadow map blur kernel according to the light configuration.
                 * @param light The light used to generate the shadows
@@ -1899,6 +1941,11 @@ declare module BabylonViewer {
 declare module BabylonViewer {
     
     
+    /**
+        * The ViewerLabs class will hold functions that are not (!) backwards compatible.
+        * The APIs in all labs-related classes and configuration  might change.
+        * Once stable, lab features will be moved to the publis API and configuration object.
+        */
     export class ViewerLabs {
             constructor(_sceneManager: SceneManager);
             assetsRootURL: string;
@@ -1945,9 +1992,9 @@ declare module BabylonViewer {
     
     
     /**
-                * Spherical polynomial coefficients (counter part to spherical harmonic coefficients used in shader irradiance calculation)
-                * @ignoreChildren
-                */
+        * Spherical polynomial coefficients (counter part to spherical harmonic coefficients used in shader irradiance calculation)
+        * @ignoreChildren
+        */
     export interface SphericalPolynomalCoefficients {
             x: BABYLON.Vector3;
             y: BABYLON.Vector3;

dist/preview release/viewer/babylon.viewer.module.d.ts

@@ -334,6 +334,9 @@ declare module 'babylonjs-viewer/viewer/viewer' {
                 * The configuration loader of this viewer
                 */
             protected _configurationLoader: ConfigurationLoader;
+            /**
+                * Is the viewer already initialized. for internal use.
+                */
             protected _isInit: boolean;
             constructor(containerElement: HTMLElement, initialConfiguration?: ViewerConfiguration);
             /**
@@ -383,9 +386,10 @@ declare module 'babylonjs-viewer/viewer/viewer' {
                 * Only provided information will be updated, old configuration values will be kept.
                 * If this.configuration was manually changed, you can trigger this function with no parameters,
                 * and the entire configuration will be updated.
-                * @param newConfiguration
+                * @param newConfiguration the partial configuration to update
+                *
                 */
-            updateConfiguration(newConfiguration?: Partial<ViewerConfiguration>, mode?: ViewerModel): void;
+            updateConfiguration(newConfiguration?: Partial<ViewerConfiguration>): void;
             /**
                 * this is used to register native functions using the configuration object.
                 * This will configure the observers.
@@ -416,7 +420,7 @@ declare module 'babylonjs-viewer/viewer/viewer' {
                 */
             protected _initEngine(): Promise<Engine>;
             /**
-                * Initialize a model loading. The returns object (a ViewerModel object) will be loaded in the background.
+                * Initialize a model loading. The returned object (a ViewerModel object) will be loaded in the background.
                 * The difference between this and loadModel is that loadModel will fulfill the promise when the model finished loading.
                 *
                 * @param modelConfig model configuration to use when loading the model.
@@ -425,7 +429,9 @@ declare module 'babylonjs-viewer/viewer/viewer' {
                 */
             initModel(modelConfig: string | IModelConfiguration, clearScene?: boolean): ViewerModel;
             /**
-                * load a model using the provided configuration
+                * load a model using the provided configuration.
+                * This function, as opposed to initModel, will return a promise that resolves when the model is loaded, and rejects with error.
+                * If you want to attach to the observables of the model, use initModle instead.
                 *
                 * @param modelConfig the model configuration or URL to load.
                 * @param clearScene Should the scene be cleared before loading the model
@@ -480,6 +486,9 @@ declare module 'babylonjs-viewer/telemetryManager' {
                 * @return The current session ID
                 */
             readonly session: string;
+            /**
+                * Disposes the telemetry manager
+                */
             dispose(): void;
     }
     export const telemetryManager: TelemetryManager;
@@ -502,6 +511,11 @@ declare module 'babylonjs-viewer/loader/modelLoader' {
                 * @param _viewer the viewer using this model loader
                 */
             constructor(_viewer: AbstractViewer);
+            /**
+                * Adds a new plugin to the loader process.
+                *
+                * @param plugin the plugin name or the plugin itself
+                */
             addPlugin(plugin: ILoaderPlugin | string): void;
             /**
                 * Load a model using predefined configuration
@@ -523,6 +537,9 @@ declare module 'babylonjs-viewer/model/viewerModel' {
     import { IModelConfiguration } from "babylonjs-viewer/configuration/configuration";
     import { IModelAnimation } from "babylonjs-viewer/model/modelAnimation";
     import { AbstractViewer } from "babylonjs-viewer/";
+    /**
+        * The current state of the model
+        */
     export enum ModelState {
             INIT = 0,
             LOADING = 1,
@@ -891,6 +908,11 @@ declare module 'babylonjs-viewer/loader/plugins/loaderPlugin' {
     import { ViewerModel } from "babylonjs-viewer/model/viewerModel";
     import { IGLTFLoaderExtension, IGLTFLoaderData } from "babylonjs-loaders";
     import { AbstractMesh, ISceneLoaderPlugin, ISceneLoaderPluginAsync, SceneLoaderProgressEvent, BaseTexture, Material } from "babylonjs";
+    /**
+      * This interface defines the structure of a loader plugin.
+      * Any of those functions will be called if (!) the loader supports those callbacks.
+      * Any loader supports onInit, onLoaded, onError and onProgress.
+      */
     export interface ILoaderPlugin {
         onInit?: (loader: ISceneLoaderPlugin | ISceneLoaderPluginAsync, model: ViewerModel) => void;
         onLoaded?: (model: ViewerModel) => void;
@@ -1455,12 +1477,30 @@ declare module 'babylonjs-viewer/templateManager' {
         * A single template configuration object
         */
     export interface ITemplateConfiguration {
+            /**
+                * can be either the id of the template's html element or a URL.
+                * See - http://doc.babylonjs.com/extensions/the_templating_system#location-vs-html
+                */
             location?: string;
+            /**
+                * If no location is provided you can provide here the raw html of this template.
+                * See http://doc.babylonjs.com/extensions/the_templating_system#location-vs-html
+                */
             html?: string;
             id?: string;
+            /**
+                * Parameters that will be delivered to the template and will render it accordingly.
+                */
             params?: {
                     [key: string]: string | number | boolean | object;
             };
+            /**
+                * Events to attach to this template.
+                * event name is the key. the value can either be a boolean (attach to the parent element)
+                * or a map of html id elements.
+                *
+                * See - http://doc.babylonjs.com/extensions/the_templating_system#event-binding
+                */
             events?: {
                     pointerdown?: boolean | {
                             [id: string]: boolean;
@@ -1617,6 +1657,8 @@ declare module 'babylonjs-viewer/templateManager' {
                 * The parameters are provided to Handlebars which in turn generates the template.
                 * This function will update the template with the new parameters
                 *
+                * Note that when updating parameters the events will be registered again (after being cleared).
+                *
                 * @param params the new template parameters
                 */
             updateParams(params: {
@@ -1785,7 +1827,7 @@ declare module 'babylonjs-viewer/viewer/sceneManager' {
                 * @param newConfiguration the delta that should be configured. This includes only the changes
                 * @param globalConfiguration The global configuration object, after the new configuration was merged into it
                 */
-            updateConfiguration(newConfiguration: Partial<ViewerConfiguration>, globalConfiguration: ViewerConfiguration, model?: ViewerModel): void;
+            updateConfiguration(newConfiguration: Partial<ViewerConfiguration>, globalConfiguration: ViewerConfiguration): void;
             bloomEnabled: boolean;
             fxaaEnabled: boolean;
             /**
@@ -1805,8 +1847,8 @@ declare module 'babylonjs-viewer/viewer/sceneManager' {
                 * @param cameraConfig the new camera configuration
                 * @param model optionally use the model to configure the camera.
                 */
-            protected _configureCamera(cameraConfig?: ICameraConfiguration, model?: ViewerModel): void;
-            protected _configureEnvironment(skyboxConifguration?: ISkyboxConfiguration | boolean, groundConfiguration?: IGroundConfiguration | boolean, model?: ViewerModel): Promise<Scene> | undefined;
+            protected _configureCamera(cameraConfig?: ICameraConfiguration): void;
+            protected _configureEnvironment(skyboxConifguration?: ISkyboxConfiguration | boolean, groundConfiguration?: IGroundConfiguration | boolean): Promise<Scene> | undefined;
             /**
                 * configure the lights.
                 *
@@ -1815,7 +1857,7 @@ declare module 'babylonjs-viewer/viewer/sceneManager' {
                 */
             protected _configureLights(lightsConfiguration?: {
                     [name: string]: ILightConfiguration | boolean;
-            }, model?: ViewerModel): void;
+            }): void;
             /**
                 * Gets the shadow map blur kernel according to the light configuration.
                 * @param light The light used to generate the shadows
@@ -1927,6 +1969,11 @@ declare module 'babylonjs-viewer/eventManager' {
 declare module 'babylonjs-viewer/labs/viewerLabs' {
     import { PBREnvironment } from "babylonjs-viewer/labs/environmentSerializer";
     import { SceneManager } from 'babylonjs-viewer/viewer/sceneManager';
+    /**
+        * The ViewerLabs class will hold functions that are not (!) backwards compatible.
+        * The APIs in all labs-related classes and configuration  might change.
+        * Once stable, lab features will be moved to the publis API and configuration object.
+        */
     export class ViewerLabs {
             constructor(_sceneManager: SceneManager);
             assetsRootURL: string;
@@ -1973,9 +2020,9 @@ declare module 'babylonjs-viewer/labs/environmentSerializer' {
     import { Vector3 } from "babylonjs";
     import { TextureCube } from 'babylonjs-viewer/labs/texture';
     /**
-                * Spherical polynomial coefficients (counter part to spherical harmonic coefficients used in shader irradiance calculation)
-                * @ignoreChildren
-                */
+        * Spherical polynomial coefficients (counter part to spherical harmonic coefficients used in shader irradiance calculation)
+        * @ignoreChildren
+        */
     export interface SphericalPolynomalCoefficients {
             x: Vector3;
             y: Vector3;

gui/src/advancedDynamicTexture.ts

@@ -459,6 +459,10 @@ module BABYLON.GUI {
             }
 
             this._pointerMoveObserver = scene.onPrePointerObservable.add((pi, state) => {
+                if (scene!.isPointerCaptured((<PointerEvent>(pi.event)).pointerId)) {
+                    return;
+                }
+
                 if (pi.type !== BABYLON.PointerEventTypes.POINTERMOVE
                     && pi.type !== BABYLON.PointerEventTypes.POINTERUP
                     && pi.type !== BABYLON.PointerEventTypes.POINTERDOWN) {

gui/src/controls/radioButton.ts

@@ -148,7 +148,10 @@ module BABYLON.GUI {
             if (!super._onPointerDown(target, coordinates, pointerId, buttonIndex)) {
                 return false;
             }
-            this.isChecked = !this.isChecked;
+            
+            if (!this.isChecked) {
+                this.isChecked = true;
+            }
 
             return true;
         }

src/Engine/babylon.engine.ts

@@ -1729,6 +1729,14 @@
         }
 
         /**
+         * Gets current screen aspect ratio
+         * @returns a number defining the aspect ratio
+         */
+        public getScreenAspectRatio(): number {
+            return (this.getRenderWidth(true)) / (this.getRenderHeight(true));
+        }        
+
+        /**
          * Gets the current render width
          * @param useScreen defines if screen size must be used (or the current render target if any)
          * @returns a number defining the current render width

src/PostProcess/RenderPipeline/Pipelines/babylon.ssao2RenderingPipeline.ts

@@ -327,11 +327,13 @@
         }
 
         private _createSSAOCombinePostProcess(ratio: number): void {
-            this._ssaoCombinePostProcess = new PostProcess("ssaoCombine", "ssaoCombine", [], ["originalColor"],
+            this._ssaoCombinePostProcess = new PostProcess("ssaoCombine", "ssaoCombine", [], ["originalColor", "viewport"],
                 ratio, null, Texture.BILINEAR_SAMPLINGMODE,
                 this._scene.getEngine(), false);
 
             this._ssaoCombinePostProcess.onApply = (effect: Effect) => {
+                let viewport = this._scene.activeCamera!.viewport;
+                effect.setVector4("viewport", Tmp.Vector4[0].copyFromFloats(viewport.x, viewport.y, viewport.width, viewport.height));
                 effect.setTextureFromPostProcess("originalColor", this._originalColorPostProcess);
             };
         }

src/PostProcess/RenderPipeline/Pipelines/babylon.ssaoRenderingPipeline.ts

@@ -208,11 +208,12 @@
         }
 
         private _createSSAOCombinePostProcess(ratio: number): void {
-            this._ssaoCombinePostProcess = new PostProcess("ssaoCombine", "ssaoCombine", [], ["originalColor"],
+            this._ssaoCombinePostProcess = new PostProcess("ssaoCombine", "ssaoCombine", [], ["originalColor", "viewport"],
                 ratio, null, Texture.BILINEAR_SAMPLINGMODE,
                 this._scene.getEngine(), false);
 
             this._ssaoCombinePostProcess.onApply = (effect: Effect) => {
+                effect.setVector4("viewport", Tmp.Vector4[0].copyFromFloats(0, 0, 1.0, 1.0));
                 effect.setTextureFromPostProcess("originalColor", this._originalColorPostProcess);
             };
         }

src/PostProcess/babylon.postProcess.ts

@@ -53,6 +53,11 @@
         public enablePixelPerfectMode = false;
 
         /**
+         * Force the postprocess to be applied without taking in account viewport
+         */
+        public forceFullscreenViewport = true;
+
+        /**
         * Scale mode for the post process (default: Engine.SCALEMODE_FLOOR)
         */
         public scaleMode = Engine.SCALEMODE_FLOOR;
@@ -446,11 +451,11 @@
             // Bind the input of this post process to be used as the output of the previous post process.
             if (this.enablePixelPerfectMode) {
                 this._scaleRatio.copyFromFloats(requiredWidth / desiredWidth, requiredHeight / desiredHeight);
-                this._engine.bindFramebuffer(target, 0, requiredWidth, requiredHeight, true);
+                this._engine.bindFramebuffer(target, 0, requiredWidth, requiredHeight, this.forceFullscreenViewport);
             }
             else {
                 this._scaleRatio.copyFromFloats(1, 1);
-                this._engine.bindFramebuffer(target, 0, undefined, undefined, true);
+                this._engine.bindFramebuffer(target, 0, undefined, undefined, this.forceFullscreenViewport);
             }
 
             this.onActivateObservable.notifyObservers(camera);

src/Shaders/ssaoCombine.fragment.fx

@@ -1,10 +1,11 @@
 uniform sampler2D textureSampler;
 uniform sampler2D originalColor;
+uniform vec4 viewport;
 
 varying vec2 vUV;
 
 void main(void) {
-	vec4 ssaoColor = texture2D(textureSampler, vUV);
+	vec4 ssaoColor = texture2D(textureSampler, viewport.xy + vUV * viewport.zw);
 	vec4 sceneColor = texture2D(originalColor, vUV);
 
 	gl_FragColor = sceneColor * ssaoColor;

src/babylon.scene.ts

@@ -1813,6 +1813,15 @@
         }
 
         /**
+         * Gets a boolean indicating if the current pointer event is captured (meaning that the scene has already handled the pointer down)
+         * @param pointerId defines the pointer id to use in a multi-touch scenario (0 by default)
+         * @returns true if the pointer was captured
+         */
+        public isPointerCaptured(pointerId = 0): boolean {
+            return this._pointerCaptures[pointerId];
+        }
+
+        /**
         * Attach events to the canvas (To handle actionManagers triggers and raise onPointerMove, onPointerDown and onPointerUp
         * @param attachUp defines if you want to attach events to pointerup
         * @param attachDown defines if you want to attach events to pointerdown
@@ -2066,7 +2075,7 @@
                 this._updatePointerPosition(evt);
                 this._initClickEvent(this.onPrePointerObservable, this.onPointerObservable, evt, (clickInfo: ClickInfo, pickResult: Nullable<PickingInfo>) => {
                     // PreObservable support
-                    if (this.onPrePointerObservable.hasObservers() && !this._pointerCaptures[evt.pointerId]) {
+                    if (this.onPrePointerObservable.hasObservers()) {
                         if (!clickInfo.ignore) {
                             if (!clickInfo.hasSwiped) {
                                 if (clickInfo.singleClick && this.onPrePointerObservable.hasSpecificMask(PointerEventTypes.POINTERTAP)) {