pbox2d 0.9.1-java → 1.0.0-java

data/docs/_classes/world_builder.md

@@ -0,0 +1,7 @@
+---
+layout: page
+title: "World Builder"
+permalink: /classes/world_builder/
+---
+
+@box2d = WorldBuilder.build(app: self, gravity: [0, -20]) 

data/docs/_config.yml

@@ -0,0 +1,32 @@
+# Site settings
+port: 4000
+title: PBox2D for JRubyArt
+email: mamba2928@yahoo.co.uk
+description: > # this means to ignore newlines until "baseurl:"
+   PBox2D is a ruby wrapper for JBox2D, so you can use the physics engine with JRubyArt or propane (NB: original ruby-processing is no longer supported).
+baseurl: "" # the subpath of your site, e.g. /blog
+url: "https://ruby-processing.github.io/pbox2d"
+urls:
+  bugs: http://github.com/ruby-processing/pbox2d/issues
+  github: http://github.com/ruby-processing/pbox2d/
+twitter_username: monkstoneT
+github_username:  monkstone
+include: [collections]
+collections:
+  classes:
+    output: true
+    permalink: /classes/:path
+  methods:
+    output: true
+    permalink: /methods/:path
+  modules:
+    output: true
+    permalink: /modules/:path
+    
+syntax-highlighting:
+  enabled: true
+
+# Build settings
+markdown: kramdown
+gems:
+  - jekyll-sitemap

data/docs/_includes/footer.html

@@ -0,0 +1,55 @@
+<footer class="site-footer">
+
+  <div class="wrapper">
+
+    <h2 class="footer-heading">{{ site.title }}</h2>
+
+    <div class="footer-col-wrapper">
+      <div class="footer-col  footer-col-1">
+        <ul class="contact-list">
+          <li>{{ site.title }}</li>
+          <li><a href="mailto:{{ site.email }}">{{ site.email }}</a></li>
+        </ul>
+      </div>
+
+      <div class="footer-col  footer-col-2">
+        <ul class="social-media-list">
+          {% if site.github_username %}
+          <li>
+            <a href="https://github.com/{{ site.github_username }}">
+              <span class="icon  icon--github">
+                <svg viewBox="0 0 16 16">
+                  <path fill="#828282" d="M7.999,0.431c-4.285,0-7.76,3.474-7.76,7.761 c0,3.428,2.223,6.337,5.307,7.363c0.388,0.071,0.53-0.168,0.53-0.374c0-0.184-0.007-0.672-0.01-1.32 c-2.159,0.469-2.614-1.04-2.614-1.04c-0.353-0.896-0.862-1.135-0.862-1.135c-0.705-0.481,0.053-0.472,0.053-0.472 c0.779,0.055,1.189,0.8,1.189,0.8c0.692,1.186,1.816,0.843,2.258,0.645c0.071-0.502,0.271-0.843,0.493-1.037 C4.86,11.425,3.049,10.76,3.049,7.786c0-0.847,0.302-1.54,0.799-2.082C3.768,5.507,3.501,4.718,3.924,3.65 c0,0,0.652-0.209,2.134,0.796C6.677,4.273,7.34,4.187,8,4.184c0.659,0.003,1.323,0.089,1.943,0.261 c1.482-1.004,2.132-0.796,2.132-0.796c0.423,1.068,0.157,1.857,0.077,2.054c0.497,0.542,0.798,1.235,0.798,2.082 c0,2.981-1.814,3.637-3.543,3.829c0.279,0.24,0.527,0.713,0.527,1.437c0,1.037-0.01,1.874-0.01,2.129 c0,0.208,0.14,0.449,0.534,0.373c3.081-1.028,5.302-3.935,5.302-7.362C15.76,3.906,12.285,0.431,7.999,0.431z"/>
+                </svg>
+              </span>
+
+              <span class="username">{{ site.github_username }}</span>
+            </a>
+          </li>
+          {% endif %}
+
+          {% if site.twitter_username %}
+          <li>
+            <a href="https://twitter.com/{{ site.twitter_username }}">
+              <span class="icon  icon--twitter">
+                <svg viewBox="0 0 16 16">
+                  <path fill="#828282" d="M15.969,3.058c-0.586,0.26-1.217,0.436-1.878,0.515c0.675-0.405,1.194-1.045,1.438-1.809
+                  c-0.632,0.375-1.332,0.647-2.076,0.793c-0.596-0.636-1.446-1.033-2.387-1.033c-1.806,0-3.27,1.464-3.27,3.27 c0,0.256,0.029,0.506,0.085,0.745C5.163,5.404,2.753,4.102,1.14,2.124C0.859,2.607,0.698,3.168,0.698,3.767 c0,1.134,0.577,2.135,1.455,2.722C1.616,6.472,1.112,6.325,0.671,6.08c0,0.014,0,0.027,0,0.041c0,1.584,1.127,2.906,2.623,3.206 C3.02,9.402,2.731,9.442,2.433,9.442c-0.211,0-0.416-0.021-0.615-0.059c0.416,1.299,1.624,2.245,3.055,2.271 c-1.119,0.877-2.529,1.4-4.061,1.4c-0.264,0-0.524-0.015-0.78-0.046c1.447,0.928,3.166,1.469,5.013,1.469 c6.015,0,9.304-4.983,9.304-9.304c0-0.142-0.003-0.283-0.009-0.423C14.976,4.29,15.531,3.714,15.969,3.058z"/>
+                </svg>
+              </span>
+
+              <span class="username">{{ site.twitter_username }}</span>
+            </a>
+          </li>
+          {% endif %}
+        </ul>
+      </div>
+
+      <div class="footer-col  footer-col-3">
+        <p class="text">{{ site.description }}</p>
+      </div>
+    </div>
+
+  </div>
+
+</footer>

data/docs/_includes/head.html

@@ -0,0 +1,18 @@
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  {% if page.keywords %}
+  <meta name="keywords" content="{{ page.keywords }}" />
+  {% else %}
+  <meta name="keywords" content="art, JRubyArt, code, blog, ruby" />
+  {% endif %}<title>{% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %}</title>
+  <meta name="description" content="{% if page.excerpt %}{{ page.excerpt | strip_html | strip_newlines | truncate: 160 }}{% else %}{{ site.description }}{% endif %}">
+
+  <link rel="stylesheet" href="https://ruby-processing.github.io/JRubyArt/css/main.css"/>
+  <link rel="canonical" href="{{ page.url | replace:'index.html','' | prepend: site.github.url | prepend: site.url }}">
+  <link rel="alternate" type="application/rss+xml" title="{{ site.title }}" href="{{ "/feed.xml" | prepend: site.github.url | prepend: site.url }}" />
+</head>
+
+
+

data/docs/_includes/header.html

@@ -0,0 +1,27 @@
+<header class="site-header">
+
+  <div class="wrapper">
+
+    <a class="site-title" href="{{ site.github.url }}/">{{ site.title }}</a>
+
+    <nav class="site-nav">
+      <a href="#" class="menu-icon">
+        <svg viewBox="0 0 18 15">
+          <path fill="#424242" d="M18,1.484c0,0.82-0.665,1.484-1.484,1.484H1.484C0.665,2.969,0,2.304,0,1.484l0,0C0,0.665,0.665,0,1.484,0 h15.031C17.335,0,18,0.665,18,1.484L18,1.484z"/>
+          <path fill="#424242" d="M18,7.516C18,8.335,17.335,9,16.516,9H1.484C0.665,9,0,8.335,0,7.516l0,0c0-0.82,0.665-1.484,1.484-1.484 h15.031C17.335,6.031,18,6.696,18,7.516L18,7.516z"/>
+          <path fill="#424242" d="M18,13.516C18,14.335,17.335,15,16.516,15H1.484C0.665,15,0,14.335,0,13.516l0,0 c0-0.82,0.665-1.484,1.484-1.484h15.031C17.335,12.031,18,12.696,18,13.516L18,13.516z"/>
+        </svg>
+      </a>
+
+      <div class="trigger">
+        {% for page in site.pages %}
+          {% if page.title %}
+          <a class="page-link" href="{{ page.url | prepend: site.github.url }}">{{ page.title }}</a>
+          {% endif %}
+        {% endfor %}
+      </div>
+    </nav>
+
+  </div>
+
+</header>

data/docs/_includes/menu.html

@@ -0,0 +1,8 @@
+<nav class="menu">
+      <ul>
+        <li><a href="#">Products</a></li>
+        <li><a href="#">Download</a></li>
+        <li><a href="#">Support</a></li>
+        <li><a href="#">Buy Now</a></li>
+      </ul>
+</nav>

data/docs/_includes/navigation.html

@@ -0,0 +1,24 @@
+{% capture html %}
+<ul>
+    {% if include.context == "/" %}
+        <li class="{% if page.url == "/" %}active{% endif %}">
+            <a href="{{ site.github.url }}/">{{ site.title }}</a>
+        </li>
+    {% endif %}
+
+    {% assign entries = site.pages | sort: "path" %}
+    {% for entry in entries %}
+
+        {% capture slug    %}{{ entry.url | split: "/"   | last                       }}{% endcapture %}
+        {% capture current %}{{ entry.url | remove: slug | remove: "//" | append: "/" }}{% endcapture %}
+
+        {% if current == include.context %}
+            <li class="{% if page.url contains entry.url %}active{% endif %}">
+                <a href="{{ site.github.url }}{{ entry.url }}">{{ entry.title }}</a>
+                {% include navigation.html context=entry.url %}
+            </li>
+        {% endif %}
+
+    {% endfor %}
+</ul>
+{% endcapture %}{{ html | strip_newlines | replace:'    ','' | replace:'    ','' | replace:'  ',' ' }}

data/docs/_layouts/default.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html>
+
+  {% include head.html %}
+
+  <body>
+
+    {% include header.html %}
+
+    <div class="page-content">
+      <div class="wrapper">
+        {{ content }}
+      </div>
+    </div>
+
+    {% include footer.html %}
+
+  </body>
+
+</html>

data/docs/_layouts/page.html

@@ -0,0 +1,14 @@
+---
+layout: default
+---
+<div class="post">
+
+  <header class="post-header">
+    <h1 class="post-title">{{ page.title }}</h1>
+  </header>
+
+  <article class="post-content">
+    {{ content }}
+  </article>
+
+</div>

data/docs/_layouts/post.html

@@ -0,0 +1,15 @@
+---
+layout: default
+---
+<div class="post">
+
+  <header class="post-header">
+    <h1 class="post-title">{{ page.title }}</h1>
+    <p class="post-meta">{{ page.date | date: "%b %-d, %Y" }}{% if page.author %} • {{ page.author }}{% endif %}{% if page.meta %} • {{ page.meta }}{% endif %}</p>
+  </header>
+
+  <article class="post-content">
+    {{ content }}
+  </article>
+
+</div>

data/docs/_methods/init_options.md

@@ -0,0 +1,28 @@
+---
+layout: post
+title:  "init_options"
+permalink: /methods/init_options/
+---
+
+### init_options method ###
+Need not called directly if using [WorldBuilder][world_builder]
+```ruby
+def init_options(args = {})
+    args = defaults.merge(args)
+    set_options(args[:scale],
+                args[:gravity].to_java(Java::float),
+                args[:warm],
+                args[:continuous]
+               )
+end
+```
+
+### related default options ###
+Provides defaults for init_options
+```ruby
+def defaults
+   { scale: 10.0, gravity: [0, -10], warm: true, continuous: true }
+end
+```
+
+[world_builder]:{{ site.github.url }}/modules/world_builder/

data/docs/_methods/processing_to_world.md

@@ -0,0 +1,29 @@
+---
+layout: post
+title:  "processing_to_world"
+permalink: /methods/processing_to_world/
+---
+From sketch to physics world and vice versa
+
+Because of the peculiar choice by the processing guys down is up (dimensions in pixels) jbox2d doesn't like to live in the pixel world (where up is really up), and prefers meters or feet and inches (whatever). What this means is that there is a need to scale between the two worlds using [world_to_processing][world_to_processing] and processing_to_world methods provided. You should study the included example sketches.
+
+
+The java code ([PBox2D][pbox2d] inherits this from [Box2DProcessing][pbox2d])
+### public Vec2 processingToWorld(float worldX, float worldY) ###
+```java
+public Vec2 processingToWorld(float pixelX, float pixelY) {
+      float worldX = map(pixelX, parent.width / 2, parent.width / 2 + scaleFactor, 0f, 1f);
+      float worldY = map(pixelY, parent.height / 2, parent.height / 2 + scaleFactor, 1f, 0f);
+      return new Vec2(worldX, worldY);
+}
+```
+
+### Ruby usage ###
+Use camel case
+```ruby
+processing_to_world(x, y) # returns new Vec2 instance (in the PBox2D world)
+```
+
+[pbox2d]:{{ site.github.url }}/classes/pbox2d/
+[world_to_processing]:{{ site.github.url }}/methods/world_to_processing/
+[examples]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/pbox2d/

data/docs/_methods/scale_to_processing.md

@@ -0,0 +1,24 @@
+---
+layout: post
+title:  "scale_to_processing"
+permalink: /methods/scale_to_processing/
+---
+From sketch to physics world and vice versa
+
+The java code ([PBox2D][pbox2d] inherits this from [Box2DProcessing][pbox2d])
+### public float scaleToProcessing(float val) ###
+```java
+public float scaleToProcessing(float val) {
+        return val * scaleFactor;
+}
+```
+
+### Ruby usage ###
+Use camel case
+```ruby
+scale_to_processing(val)
+```
+
+[pbox2d]:{{ site.github.url }}/classes/pbox2d/
+[world_to_processing]:{{ site.github.url }}/methods/world_to_processing/
+[examples]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/pbox2d/

data/docs/_methods/scale_to_world.md

@@ -0,0 +1,29 @@
+---
+layout: post
+title:  "scale_to_world"
+permalink: /methods/scale_to_world/
+---
+From sketch to physics world
+
+Because of the peculiar choice by the processing guys down is up (dimensions in pixels) jbox2d doesn't like to live in the pixel world (where up is really up), and prefers meters or feet and inches (whatever). What this means is that there is a need to scale between the two worlds using [world_to_processing][world_to_processing] and processing_to_world methods provided. You should study the included example sketches.
+
+
+The java code ([PBox2D][pbox2d] inherits this from [Box2DProcessing][pbox2d])
+### public Vec2 scaleToWorld(float worldX, float worldY) ###
+```java
+public Vec2 scaleToWorld(float pixelX, float pixelY) {
+      float worldX = map(pixelX, parent.width / 2, parent.width / 2 + scaleFactor, 0f, 1f);
+      float worldY = map(pixelY, parent.height / 2, parent.height / 2 + scaleFactor, 1f, 0f);
+      return new Vec2(worldX, worldY);
+}
+```
+
+### Ruby usage ###
+Use camel case
+```ruby
+scale_to_world(x, y) # returns new Vec2 instance (in the PBox2D world)
+```
+
+[pbox2d]:{{ site.github.url }}/classes/pbox2d/
+[world_to_processing]:{{ site.github.url }}/methods/world_to_processing/
+[examples]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/pbox2d/

data/docs/_methods/step_options.md

@@ -0,0 +1,25 @@
+---
+
+layout: post
+title:  "step_options"
+permalink: /methods/step_options/
+---
+Need not be called directly especially when using [WorldBuilder][world_builder]
+
+```ruby
+def step_options(args = {})
+  default_step.merge(args)
+   # now call the java method
+  set_step(args[:time_step], args[:velocity_iter], args[:position_iter])
+end
+```
+
+The default options
+
+```ruby
+def default_step
+  { time_step: 1.0 / 60, velocity_iter: 8, position_iter: 10 }
+end
+```
+
+[world_builder]:{{ site.github.url }}/modules/world_builder/

data/docs/_methods/world_to_processing.md

@@ -0,0 +1,30 @@
+---
+layout: post
+title:  "world_to_processing"
+date:   2016-05-23 05:04:00
+categories: jruby_art update
+permalink: /methods/world_to_processing/
+---
+From physics world to sketch
+
+Because of the peculiar choice by the processing guys down is up (dimensions in pixels) jbox2d doesn't like to live in the pixel world (where up is really up), and prefers meters or feet and inches (whatever). What this means is that there is a need to scale between the two worlds using world_to_processing and [processing_to_world][processing_to_world] methods provided. You should also study the included [example sketches][examples].
+
+The java code ([PBox2D][pbox2d] inherits this from [Box2DProcessing][pbox2d])
+### public Vec2 worldToProcessing(float worldX, float worldY) ###
+```java
+public Vec2 worldToProcessing(float worldX, float worldY) {
+        float pixelX = map(worldX, 0f, 1f, parent.width / 2, parent.width / 2 + scaleFactor);
+        float pixelY = map(worldY, 1f, 0f, parent.height / 2, parent.height / 2 + scaleFactor);
+        return new Vec2(pixelX, pixelY);
+}
+```
+
+### Ruby usage ###
+Use camel case
+```ruby
+world_to_processing(x, y) # returns new Vec2 instance (in processing world)
+```
+
+[pbox2d]:{{ site.github.url }}/classes/pbox2d/
+[processing_to_world]:{{ site.github.url }}/methods/processing_to_world/
+[examples]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/pbox2d/

data/docs/_modules/pb.md

@@ -0,0 +1,25 @@
+---
+layout: page
+title: "PB (namespace)"
+permalink: /modules/world_builder/
+---
+```ruby
+# Import into module namespace to avoid likely clashes
+module PB
+  particle = %w(
+    ParticleColor
+    ParticleContact
+    ParticleGroupDef
+    ParticleBodyContact
+    ParticleGroup
+    ParticleType
+    ParticleGroupType
+    ParticleGroupDef
+    ParticleSystem
+    StackQueue
+    VoronoiDiagram
+  )
+  particle_format = 'org.jbox2d.particle.%s'
+  import_class_list(particle, particle_format)
+end
+```

data/docs/_modules/world_builder.md

@@ -0,0 +1,26 @@
+---
+layout: page
+title: "World Builder"
+permalink: /modules/world_builder/
+---
+The WorldBuilder module is a factory, that provides a flexible options signature, and hides the post intialization of Box2D. Note that `app:` is a required keyword.
+```ruby
+module WorldBuilder
+  def self.build(app:, **opts)
+    b2d = Box2D.new(app)
+    b2d.init_options(opts)
+    b2d.create_world
+    b2d
+  end
+end
+```
+
+Usage:
+Strictly the `gravity:` option is optional here, it is only used to demonstrate a valid argument. No acceleration in horizontal plane and negative (falling) acceleration in vertical plane.
+```ruby
+@box2d = WorldBuilder.build(app: self, gravity: [0, -20])
+```
+
+See [:init_options][init_options] and [:defaults][init_options] methods for a list of available options
+
+[init_options]:{{ site.github.url }}/methods/init_options/