+@end
+```
+
**MyViewController.m**
-
+
+```Objective-C
- (void)viewDidLoad
{
-[super viewDidLoad];
-
-// language are used for recognition. Ex: eng. Tesseract will search for a eng.traineddata file in the dataPath directory; eng+ita will search for a eng.traineddata and ita.traineddata.
-
-//Like in the Template Framework Project:
-// Assumed that .traineddata files are in your "tessdata" folder and the folder is in the root of the project.
-// Assumed, that you added a folder references "tessdata" into your xCode project tree, with the ‘Create folder references for any added folders’ options set up in the «Add files to project» dialog.
-// Assumed that any .traineddata files is in the tessdata folder, like in the Template Framework Project
-
-//Create your tesseract using the initWithLanguage method:
-// Tesseract* tesseract = [[Tesseract alloc] initWithLanguage:@"eng+ita"];
-
-// set up the delegate to recieve tesseract's callback
-// self should respond to TesseractDelegate and implement shouldCancelImageRecognitionForTesseract: method
-// to have an ability to recieve callback and interrupt Tesseract before it finishes
-
-Tesseract* tesseract = [[Tesseract alloc] initWithLanguage:@"eng+ita"];
-tesseract.delegate = self;
-
-[tesseract setVariableValue:@"0123456789" forKey:@"tessedit_char_whitelist"]; //limit search
-[tesseract setImage:[[UIImage imageNamed:@"image_sample.jpg"] blackAndWhite]]; //image to check
-[tesseract setRect:CGRectMake(20, 20, 100, 100)]; //optional: set the rectangle to recognize text in the image
-[tesseract recognize];
-
-NSLog(@"%@", [tesseract recognizedText]);
-
-tesseract = nil; //deallocate and free all memory
+ [super viewDidLoad];
+
+ // language are used for recognition. Ex: eng. Tesseract will search for a eng.traineddata file in the dataPath directory; eng+ita will search for a eng.traineddata and ita.traineddata.
+
+ //Like in the Template Framework Project:
+ // Assumed that .traineddata files are in your "tessdata" folder and the folder is in the root of the project.
+ // Assumed, that you added a folder references "tessdata" into your xCode project tree, with the ‘Create folder references for any added folders’ options set up in the «Add files to project» dialog.
+ // Assumed that any .traineddata files is in the tessdata folder, like in the Template Framework Project
+
+ //Create your tesseract using the initWithLanguage method:
+ // Tesseract* tesseract = [[Tesseract alloc] initWithLanguage:@"eng+ita"];
+
+ // set up the delegate to recieve tesseract's callback
+ // self should respond to TesseractDelegate and implement shouldCancelImageRecognitionForTesseract: method
+ // to have an ability to recieve callback and interrupt Tesseract before it finishes
+
+ Tesseract* tesseract = [[Tesseract alloc] initWithLanguage:@"eng+ita"];
+ tesseract.delegate = self;
+
+ [tesseract setVariableValue:@"0123456789" forKey:@"tessedit_char_whitelist"]; //limit search
+ [tesseract setImage:[[UIImage imageNamed:@"image_sample.jpg"] blackAndWhite]]; //image to check
+ [tesseract setRect:CGRectMake(20, 20, 100, 100)]; //optional: set the rectangle to recognize text in the image
+ [tesseract recognize];
+
+ NSLog(@"%@", [tesseract recognizedText]);
+
+ tesseract = nil; //deallocate and free all memory
}
- (BOOL)shouldCancelImageRecognitionForTesseract:(Tesseract*)tesseract
{
-NSLog(@"progress: %d", tesseract.progress);
-return NO; // return YES, if you need to interrupt tesseract before it finishes
+ NSLog(@"progress: %d", tesseract.progress);
+ return NO; // return YES, if you need to interrupt tesseract before it finishes
}
-
-
+```
Set Tesseract variable key to value. See http://www.sk-spell.sk.cx/tesseract-ocr-en-variables for a complete (but not up-to-date) list.
For instance, use tessedit_char_whitelist to restrict characters to a specific set.
-
-
How to use (swift)
=================
Make sure that you have used an Objective-c bridging header to include the <TesseractOCR/TesseractOCR.h> library. (instructions can be found at https://developer.apple.com/library/ios/documentation/swift/conceptual/buildingcocoaapps/MixandMatch.html#//apple_ref/doc/uid/TP40014216-CH10-XID_77)
**ViewController.swift**
-
+
+```Swift
import UIKit
class ViewController: UIViewController, TesseractDelegate {
-override func viewDidLoad() {
-super.viewDidLoad()
+ override func viewDidLoad() {
+ super.viewDidLoad()
-var tesseract:Tesseract = Tesseract();
-tesseract.language = "eng+ita";
-tesseract.delegate = self;
-tesseract.setVariableValue("01234567890", forKey: "tessedit_char_whitelist");
-tesseract.image = UIImage(named: "image_sample.jpg");
-tesseract.recognize();
+ var tesseract:Tesseract = Tesseract();
+ tesseract.language = "eng+ita";
+ tesseract.delegate = self;
+ tesseract.setVariableValue("01234567890", forKey: "tessedit_char_whitelist");
+ tesseract.image = UIImage(named: "image_sample.jpg");
+ tesseract.recognize();
-NSLog("%@", tesseract.recognizedText);
-}
+ NSLog("%@", tesseract.recognizedText);
+ }
-override func didReceiveMemoryWarning() {
-super.didReceiveMemoryWarning()
-}
+ override func didReceiveMemoryWarning() {
+ super.didReceiveMemoryWarning()
+ }
-func shouldCancelImageRecognitionForTesseract(tesseract: Tesseract!) -> Bool {
-return false; // return true, if you need to interrupt tesseract before it finishes
-}
+ func shouldCancelImageRecognitionForTesseract(tesseract: Tesseract!) -> Bool {
+ return false; // return true, if you need to interrupt tesseract before it finishes
+ }
}
-
+```
+
+Known Limitations
+=================
+
+- Only supports iPhone 5 and lower simulators
Updates in this version
=================
-- 3.03 (Thanks to Kevin Conley href="https://github.com/kevincon")
+### 3.03 (Thanks to [Kevin Conley](https://github.com/kevincon))
- This update fixes the confidence value issue I reported in #56
- fixed the memory leak
- Modified characterBoxes function to return characters in order
- Removed unused lib files
- Added some null checks to fix a bug where no text is recognized
-- Note that building the Tesseract OCR Aggregate product will yield a warning about how the Tesseract and Leptonica lib files don't work for the x86_64 architecture. However, everything still works in the simulator, I guess because the libraries work okay with the i386 target.
-
-
-- New implementation based off the API examples for tesseract-ocr href="https://code.google.com/p/tesseract-ocr/wiki/APIExample#Result_iterator_example
-
-- 2.3
+- **Note**: Building the Tesseract OCR Aggregate product will yield a warning about how the Tesseract and Leptonica lib files don't work for the x86_64 architecture. However, everything still works in the simulator for iPhone 5 and lower, as well as on all physical devices. I guess because the libraries work okay with the i386 target.
+- New implementation based off the [API examples for tesseract-ocr](https://code.google.com/p/tesseract-ocr/wiki/APIExample#Result_iterator_example)
+### 2.3
- Bug fixing.
-
- CoreImage filters: use [img blackAndWhite]; to convert the UIImage to recognize into a RecognizeImageType
-
- Rect: use [tesseract setRect:CGRectMake(20, 20, 100, 100)] to define the rect where the text must be recognized
-
-- 2.23 There is no need to draw an image for tesseract.
+### 2.23
+- There is no need to draw an image for tesseract.
Instead it's possible just to get raw data from the input image.
Such way is better, cause in the case of the grayscale input image, there is no need to draw it in RGB color space, increasing memory consumptions significantly.
-- 2.22 CocoaPods
+### 2.22
+- CocoaPods
-- 2.21 tesserackCallbackFunction: leak solved on iDevice.
+### 2.21
+- tesserackCallbackFunction: leak solved on iDevice.
-- The 2.2 is like 2.1... but shouldCancelImageRecognitionForTesseract works again! Thank you to Timo Formella!
+### The 2.2 is like 2.1...
+but shouldCancelImageRecognitionForTesseract works again! Thank you to Timo Formella!
- Template project updated. Now with camera support.
-- New release 2.1
+### New release 2.1
- Fixed memory leaks. Moved all freeing memory job to dealloc. Thanks to frank4565.
-
- Clear method is deprecated. Set tesseract = nil; to free all memory.
-
- Free the utf8Text according to the comment in Tesseract that “The recognized text is returned as a char* which is coded as UTF8 and must be freed with the delete [] operator.”.
-
- Template Framework Project updated.
-
-
-
-- New release 2.0 with 64 bit support.
+### New release 2.0 with 64 bit support.
- The - (id)initWithDataPath:(NSString *)dataPath language:(NSString *)language method is now deprecated.
-
- Bug fixing!
-
- Removed tessdata folder from the framework project.
-
- The tessdata folder (follow the Template Framework Project) is now linked with the "folder references" option into the Template Project. REQUIRED!!!
-
- Added delegate TesseractDelegate
-
- arm64 support. Thanks to Cyril
-
- Now you can compile yours libraries. Follow the README_howto_compile_libaries.md inside. Thanks to Simon Strangbaard
-
- Framework updated
-
- Bugs fixed. Thanks to Simon Strangbaard
-
- iOS7 libstdc++ issue solved (using libstdc++.6.0.9).
-
- **Template Framework Project added.** It's the start point for use the Tesseract Framework. It's **iOS7** ready!
-
- 11 october 2013, tesseract is up to date with last https://github.com/ldiqual/tesseract-ios version available.
-
- Clear method updated:[tesseract clear]; //call Clear() end End() functions
-
- XCode 5 ready!
-
- Framework builded with the new Xcode 5.
-
-
Dependencies
=================