Merge branch 'patchVisible' into prtdrawcalls

src/framework/components/model/component.js

@@ -584,6 +584,58 @@ pc.extend(pc, function () {
                     this.system.app.scene.removeModel(model);
                 }
             }
+        },
+
+        /**
+        * @function
+        * @name pc.ModelComponent#hide
+        * @description Stop rendering model without removing it from the scene hierarchy.
+        * This method sets the {@link pc.MeshInstance#visible} property of every MeshInstance in the model to false
+        * Note, this does not remove the model or mesh instances from the scene hierarchy or draw call list.
+        * So the model component still incurs some CPU overhead.
+        * @example
+        *   this.timer = 0;
+        *   this.visible = true;
+        *   // ...
+        *   // blink model every 0.1 seconds
+        *   this.timer += dt;
+        *   if (this.timer > 0.1) {
+        *       if (!this.visible) {
+        *           this.entity.model.show();
+        *           this.visible = true;
+        *       } else {
+        *           this.entity.model.hide();
+        *           this.visible = false;
+        *       }
+        *       this.timer = 0;
+        *   }
+        */
+        hide: function () {
+            var model = this.data.model;
+            if (model) {
+                var i, l;
+                var instances = model.meshInstances;
+                for (i = 0, l = instances.length; i < l; i++) {
+                    instances[i].visible = false;
+                }
+            }
+        },
+
+        /**
+        * @function
+        * @name pc.ModelComponent#show
+        * @description Enable rendering of the model if hidden using {@link pc.ModelComponent#hide}.
+        * This method sets all the {@link pc.MeshInstance#visible} property on all mesh instances to true.
+        */
+        show: function () {
+            var model = this.data.model;
+            if (model) {
+                var i, l;
+                var instances = model.meshInstances;
+                for (i = 0, l = instances.length; i < l; i++) {
+                    instances[i].visible = true;
+                }
+            }
         }
     });
 

src/scene/forward-renderer.js

@@ -585,6 +585,8 @@ pc.extend(pc, function () {
     pc.extend(ForwardRenderer.prototype, {
 
         _isVisible: function(camera, meshInstance) {
+            if (!meshInstance.visible) return false;
+
             meshPos = meshInstance.aabb.center;
             if (meshInstance.node._dirtyScale) {
                 meshInstance._aabb._radius = meshInstance._aabb.halfExtents.length();
@@ -964,7 +966,7 @@ pc.extend(pc, function () {
                 visible = true;
                 meshPos = null;
                 if (!drawCall.command) {
-                    if (drawCall._hidden) continue; // use _hidden property to quickly hide/show meshInstances
+                    if (!drawCall.visible) continue; // use hidden property to quickly hide/show meshInstances
                     meshInstance = drawCall;
 
                     // Only alpha sort and cull mesh instances in the main world

src/scene/mesh.js

@@ -80,6 +80,8 @@ pc.extend(pc, function () {
      * mesh instance.
      * @property {Boolean} castShadow Controls whether the mesh instances casts shadows.
      * Defaults to false.
+     * @property {Boolean} visible Enable rendering for this mesh instance. Use visible property to enable/disable rendering without overhead of removing from scene.
+     * But note that the mesh instance is still in the hierarchy and still in the draw call list.
      * @property {Number} layer The layer used by this mesh instance. Can be:
      * <ul>
      *     <li>pc.LAYER_WORLD</li>
@@ -109,6 +111,7 @@ pc.extend(pc, function () {
         this._shaderDefs |= mesh.vertexBuffer.format.hasColor? pc.SHADERDEF_VCOLOR : 0;
 
         // Render options
+        this.visible = true;
         this.layer = pc.LAYER_WORLD;
         this.renderStyle = pc.RENDERSTYLE_SOLID;
         this.castShadow = false;