PSArborTouch is a particle / spring physics engine optimised for 2D content layout and eye-catching visual effects.
The goal of PSArborTouch is to build a high-quality physics based graph layout engine designed specifically for the Mac OSX and iOS. The inspiration / structure comes from [arbor] (https://github.com/samizdatco/arbor), a dynamic and well structured javascript engine for the same purpose.
This distribution contains several examples that demonstrate the features of PSArborTouch. This includes those found in arbor.js and a few more that explore other uses.
This library is functional but it is still a work in progress, see issues and milestones
PSArborTouch is a drop in solution that uses a GCD to keep the main application loop free and responsive. Those looking for a reference counted implementation should look for a "Non ARC 1.0" branch.
This project follows the SemVer standard. The API may change in backwards-incompatible ways before the 1.0 release.
You can generate documentation with doxygen. The example project includes a documentation build target to do this within Xcode. For more details, see the Documentation page in this projects wiki.
If you'd like to contribute to PSArborTouch, start by forking this repository on GitHub:
http://github.com/epreston/PSArborTouch
The best way to get your changes merged back into core is as follows:
- Clone down your fork
- Create a thoughtfully named topic branch to contain your change
- Hack away
- Add tests and make sure everything still passes
- If you are adding new functionality, document it in the README
- Do not change the version number, I will do that on my end
- If necessary, rebase your commits into logical chunks, without errors
- Push the branch up to GitHub
- Send a pull request to the epreston/PSArborTouch project.
Or better still, [donate] (http://epreston.github.com/PSArborTouch/) via the [project website] (http://epreston.github.com/PSArborTouch/).
Copyright 2012 Preston Software.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
