mirror of
https://github.com/exyte/Macaw.git
synced 2024-09-21 01:47:44 +03:00
93 lines
3.3 KiB
Markdown
93 lines
3.3 KiB
Markdown
# Macaw
|
|
|
|
[![CI Status](https://travis-ci.org/exyte/Macaw.svg?style=flat)](https://travis-ci.org/exyte/Macaw)
|
|
[![Version](https://img.shields.io/cocoapods/v/Macaw.svg?style=flat)](http://cocoapods.org/pods/Macaw)
|
|
[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-0473B3.svg?style=flat)](https://github.com/Carthage/Carthage)
|
|
[![License](https://img.shields.io/cocoapods/l/Macaw.svg?style=flat)](http://cocoapods.org/pods/Macaw)
|
|
[![Platform](https://img.shields.io/cocoapods/p/Macaw.svg?style=flat)](http://cocoapods.org/pods/Macaw)
|
|
|
|
<img src="https://github.com/exyte/Macaw/blob/master/logo.png" width="400">
|
|
|
|
## What is Macaw?
|
|
|
|
Macaw is a powerful and easy-to-use vector graphics library written in Swift.
|
|
|
|
#### It's simple
|
|
|
|
Get started with Macaw in several lines of code:
|
|
|
|
```swift
|
|
class MyView: MacawView {
|
|
|
|
required init?(coder aDecoder: NSCoder) {
|
|
let text = Text(text: "Hello, World!", place: .move(dx: 145, dy: 100))
|
|
super.init(node: text, coder: aDecoder)
|
|
}
|
|
|
|
}
|
|
```
|
|
|
|
<img src="https://www.dropbox.com/s/o4xe3eezk4zv901/macaw-readme-001.png?dl=1" width="475">
|
|
|
|
#### It has SVG support
|
|
|
|
Include Scalable Vector Graphics right into your iOS application:
|
|
|
|
<img src="https://www.dropbox.com/s/p84o7komopmb2yn/macaw-howto-004.png?dl=1" width="475">
|
|
|
|
#### It's powerful
|
|
|
|
Affine transformations, user events, animation and various effects to build beautiful apps with Macaw:
|
|
|
|
<img src="https://www.dropbox.com/s/b6lspzzqa80ielk/periodic-ipad.gif?dl=1" width="600">
|
|
|
|
## Motivation
|
|
|
|
Modern designs contain tons of illustrations and complex animations. Mobile developers have to spend a lot of time on converting designs into native views that will be resizable for different screens. With Macaw you can reduce development time to a minimum and describe all graphics in high level [scene](https://en.wikipedia.org/wiki/Scene_graph) elements. Or even render SVG graphics right from your design tool with Macaw events and animation support.
|
|
|
|
## Documentation
|
|
|
|
We're working hard to provide full documentation. Currently you can take a look at the following docs:
|
|
* [Getting started guide](https://github.com/exyte/Macaw/wiki/Getting-started)
|
|
* [Render SVG file](https://github.com/exyte/Macaw/wiki/Render-SVG-file)
|
|
|
|
## Examples
|
|
|
|
[Macaw-Examples](https://github.com/exyte/macaw-examples) is a repository where you can find various usages of the `Macaw` library from simple charts to the complex periodic table.
|
|
|
|
## Requirements
|
|
|
|
* iOS 8.0+ / Mac OS X 10.9+
|
|
* Xcode 7.3+
|
|
|
|
## Installation
|
|
|
|
## [CocoaPods](http://cocoapods.org)
|
|
|
|
To install it, simply add the following line to your Podfile:
|
|
```ruby
|
|
pod "Macaw", "0.7.0"
|
|
```
|
|
|
|
## [Carthage](http://github.com/Carthage/Carthage)
|
|
|
|
```ogdl
|
|
github "Exyte/Macaw" ~> 0.7.0
|
|
```
|
|
|
|
## Building from sources
|
|
|
|
To build Macaw from sources:
|
|
* clone the repo `git@github.com:exyte/Macaw.git`
|
|
* open terminal and run `cd <MacawRepo>/Example/`
|
|
* run `pod install` to install all dependencies
|
|
* run `open Example.xcworkspace/` to open project in the Xcode
|
|
|
|
## Author
|
|
|
|
This project is maintained by the [exyte](http://www.exyte.com) company, a team of experienced software engineers from the cold Siberia. We don't have bears and don't like vodka, but we love to create great applications! Just [contact us](mailto:info@exyte.com).
|
|
|
|
## License
|
|
|
|
Macaw is available under the MIT license. See the LICENSE file for more info.
|