adamwulf / JotUI

OpenGL based drawing view built for and used by Loose Leaf for iPad
http://getlooseleaf.com/opensource/
MIT License
268 stars 28 forks source link

Overview

The JotUI framework provides an OpenGL drawing view with primary goals of:

  1. No lag during drawing
  2. Easy to customize pen textures and colors
  3. Low memory footprint
  4. Undo/Redo support
  5. Lots of control during drawing through view's delegate
  6. Saving and loading are asynchronous to keep your main thread running smoothly

The JotUI framework was originally built as part of Loose Leaf - a gesture-based note taking iPad app. More frameworks and pieces from Loose Leaf are also available as open source.

The JotView in Loose Leaf

The JotUI.framework is the drawing engine used in Loose Leaf.

example.jpg

Adding JotUI to Your Project

JotUI builds into a static framework that can be linked into your iOS app. The JotUI.workspace provides a sample project that shows JotUI fully integrated into an app.

  1. In your workspace, add JotUI.framework to your main project's Link Binary With Libraries build phase
  2. Copy the .vsh and .fsh files into your project's Copy Resources phase
  3. Add #import <JotUI/JotUI.h>
  4. Create a JotView and implement the JotViewDelegate protocol
  5. Add "-ObjC" to the Other Linker Flags in the project's Settings
  6. Enjoy!

Get Involved

Some great places to get involved and help make JotUI better for everyone:

JotUI includes a spacecommander as a submodule to help with keeping code style consistent. Please format all your code before submitting a PR by using the included format-all.sh and format-staged.sh scripts.

Sample Application

The Xcode workspace includes a jotuiexample project that shows a fully functional integration of the JotUI framework. You can refer to this example for any questions about how to integrate into your app.

License

The JotUI framework and sample code are provided under the MIT License.

Support This Project