From 6e7add16bf035f7624e54cdb0c8f5438dc11ebcf Mon Sep 17 00:00:00 2001
From: Marcin Misiurski <misiur66+github@gmail.com>
Date: Thu, 22 Oct 2015 11:11:05 +0200
Subject: [PATCH] Add permeability example and doc entry

---
 demo/index.html              |  1 +
 examples/permeableObjects.js | 70 ++++++++++++++++++++++++++++++++++++
 src/body/Body.js             |  8 +++++
 3 files changed, 79 insertions(+)
 create mode 100644 examples/permeableObjects.js

diff --git a/demo/index.html b/demo/index.html
index 8063002..bc2d018 100644
--- a/demo/index.html
+++ b/demo/index.html
@@ -74,6 +74,7 @@
                     <option value="beachBalls">Beach Balls</option>
                     <option value="stress">Stress 1</option>
                     <option value="stress2">Stress 2</option>
+                    <option value="permeableObjects">Permeable Objects</option>
                 </select>
                 <input id="demo-reset" value="Reset" type="submit">
                 <div class="demo-view-source nav-links">
diff --git a/examples/permeableObjects.js b/examples/permeableObjects.js
new file mode 100644
index 0000000..2ce9afd
--- /dev/null
+++ b/examples/permeableObjects.js
@@ -0,0 +1,70 @@
+(function() {
+
+    var World = Matter.World,
+        Bodies = Matter.Bodies,
+        Common = Matter.Common,
+        Events = Matter.Events;
+
+    Example.permeableObjects = function(demo) {
+        var engine = demo.engine,
+            world = engine.world,
+            sceneEvents = demo.sceneEvents;
+
+        var redColor = '#C44D58',
+            greenColor = '#C7F464';
+
+        var collider = Bodies.rectangle(400, 300, 500, 50, {
+            isPermeable: true,
+            isStatic: true,
+            render: {
+                strokeStyle: redColor,
+                fillStyle: 'transparent'
+            }
+        });
+
+        World.add(world, collider);
+
+        World.add(world,
+            Bodies.circle(400, 40, 30, {
+                render: {
+                    strokeStyle: greenColor,
+                    fillStyle: 'transparent'
+                }
+            })
+        );
+
+        sceneEvents.push(
+            Events.on(engine, 'collisionStart', function(event) {
+                var pairs = event.pairs;
+                
+                for (var i = 0, j = pairs.length; i != j; ++i) {
+                    var pair = pairs[i];
+
+                    if (pair.bodyA === collider) {
+                        pair.bodyB.render.strokeStyle = redColor;
+                    } else if (pair.bodyB === collider) {
+                        pair.bodyA.render.strokeStyle = redColor;
+                    }
+                }
+            }),
+            Events.on(engine, 'collisionEnd', function(event) {
+                var pairs = event.pairs;
+                
+                for (var i = 0, j = pairs.length; i != j; ++i) {
+                    var pair = pairs[i];
+
+                    if (pair.bodyA === collider) {
+                        pair.bodyB.render.strokeStyle = greenColor;
+                    } else if (pair.bodyB === collider) {
+                        pair.bodyA.render.strokeStyle = greenColor;
+                    }
+                }
+            })
+        );
+
+        var renderOptions = engine.render.options;
+        renderOptions.wireframes = false;
+        renderOptions.background = '#222';
+        renderOptions.showAngleIndicator = false;
+    };
+})();
\ No newline at end of file
diff --git a/src/body/Body.js b/src/body/Body.js
index 3459cc5..8963734 100644
--- a/src/body/Body.js
+++ b/src/body/Body.js
@@ -788,6 +788,14 @@ var Axes = require('../geometry/Axes');
      * @default false
      */
 
+    /**
+     * A flag that indicates whether a body is considered permeable. A permeable body triggers collision events, but doesn't react with colliding body physically.
+     *
+     * @property isPermeable
+     * @type boolean
+     * @default false
+     */
+
     /**
      * A flag that indicates whether the body is considered sleeping. A sleeping body acts similar to a static body, except it is only temporary and can be awoken.
      * If you need to set a body as sleeping, you should use `Sleeping.set` as this requires more than just setting this flag.