# vgplay-ios

**Repository Path**: vg/vgplay-ios

## Basic Information

- **Project Name**: vgplay-ios
- **Description**: A vector shape playing and animation framework based on TouchVG for iOS.
- **Primary Language**: Objective-C
- **License**: LGPL-2.1
- **Default Branch**: demo
- **Homepage**: https://github.com/touchvg/vgplay-ios
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2014-07-23
- **Last Updated**: 2024-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TouchVGPlay Demo for iOS

This is a unit test and example project for TouchVGPlay, which is a lightweight vector shape playing and animation framework based on [vgios](https://github.com/rhcad/vgios) for iOS.

API: [GiPlayingHelper](vgplay/GiPlayingHelper.h)

## Features

- Vector shape playback and recording.
- One drawing, others playback synchronous (Shared whiteboard).
- Shape provider which can play any customized animation.
- Spirit animation (animated GIF).
- Export shapes to CAShapeLayer for animation on path.

![](/Screenshot/animatedlines.gif) |
![](/Screenshot/spirit.gif) |
![](/Screenshot/sharedboard.gif) |
![](/Screenshot/anipath.gif) 

## How to Compile

### Compile with CocoaPods

Type `pod install` or `pod update --no-repo-update`, then open `TestView.xcworkspace` in Xcode and run the `TestView` demo app.

- To run on device, you may need to change the Bundle Identifier of the demo application, such as "com.yourcompany.TestView", and choose your own development certificate (Code Signing).

### Compile without CocoaPods

Alternatively, you can build as one of the following methods:

- Cd the folder of this project and type `./build.sh` or `./build.sh -arch arm64` to checkout and build libraries needed.

- Open `TestView.xcworkspace` in Xcode, then run the `TestView` demo app (Need to build each library while not type `./build.sh`).

## How to Contribute

Contributors and sponsors are welcome. You may translate, commit issues or pull requests on this Github site.
To contribute, please follow the branching model outlined here: [A successful Git branching model](http://nvie.com/posts/a-successful-git-branching-model/).

## License

This is an open source LGPL 2.1 licensed project. It uses the following open source projects:

- [vgios](https://github.com/rhcad/vgios) (LGPL): Vector drawing framework for iOS.
- [vgcore](https://github.com/rhcad/vgcore) (LGPL): Cross-platform vector drawing libraries using C++.
- TouchVGPlay (NOT open source yet): Shape playing and animation framework based on TouchVG.