Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An Objective-CFramework for the shapecatcher.com api
Objective-C
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
AFNetworking @ 76255d3
JSONKit @ 0aff3de
ShapecatcherKit.xcodeproj
ShapecatcherKitTest
Source
.gitignore
.gitmodules
LICENSE
Screenshot.png
ShapecatcherKit-Info.plist
readme.md

readme.md

ShapecatcherKit is an Objective-C framework for shapecatcher.com that provides full support for the API to recognize unicode shapes from drawings and rate the results.

Please note the sample app does not include drawing code, it's purpose is only to demonstrate how to use the api.

Also ShapecatcherKitTestApiKey.h is referenced from the sample app but missing from the project because it contains my private api key, you will need to request your own :)

How to…

The sample application included with this project demonstrates how to fully use the API but here are some code snippets.

First set your api key on the sharedKit:

[[ShapecatcherKit sharedKit] setApiKey:@"<your private api key>"];

Then you can recognize NSImages asynchronously:

[[ShapecatcherKit sharedKit] recognizeFromImage:image withSuccess:^(NSArray *shapes){
    NSLog(@"%@", shapes);
} andFailure:nil];

The shapes array contains SKShape objects with all the data from the api. This object also allows you to asynchronously request an image of the shape and rate how well the shape matches the drawing:

[shape requestCharacterImageWithSuccess:^(NSImage *image){
    NSLog(@"%@", image);
} andFailure:nil];
[shape setRating:SKShapeGoodRating withSuccess:^(){
    NSLog(@"%@", image);
} andFailure:nil];

Shapes can be rated good(SKShapeGoodRating) bad(SKShapeBadRating) or the previous rating can be undone with undo(SKShapeUndoRating).


ShapecatcherKit is available under the MIT license. See the LICENSE file for more info.

ShapecatcherKit is built on top of AFNetworking and JSONKit.

Something went wrong with that request. Please try again.