Add the possibility to copy the files from the application bundle when using the new initializer

Update documentation

Author: Patrick Nollet

TesseractOCR/G8Tesseract.h

@@ -302,30 +302,37 @@ extern NSInteger const kG8MaxCredibleResolution;
 /**
  *  Initialize Tesseract with the provided language and engine mode.
  *
- *  @param language             The language to use in recognition. See
- *                              `language`.
- *  @param configDictionary     A dictionary of config variables to set.
- *  @param configFileNames      An array of file names containing key-value
- *                              config pairs. Config settings can be set at
- *                              initialization or run-time.  Furthermore, they
- *                              could be specified at the same time, in which
- *                              case Tesseract will get variables from every
- *                              config file as well as the dictionary.
- *                              The config files must exist in one of two
- *                              possible folders:  tessdata/tessconfigs or
- *                              tessdata/configs.
- *  @param absoluteDataPath     If the absoluteDataPath is specified, Tesseract
- *                              will be set to use that path.
- *  @param engineMode           The engine mode to use in recognition. See
- *                              `engineMode`.
+ *  @param language                 The language to use in recognition. See
+ *                                  `language`.
+ *  @param configDictionary         A dictionary of config variables to set.
+ *  @param configFileNames          An array of file names containing key-value
+ *                                  config pairs. Config settings can be set at
+ *                                  initialization or run-time.  Furthermore, they
+ *                                  could be specified at the same time, in which
+ *                                  case Tesseract will get variables from every
+ *                                  config file as well as the dictionary.
+ *                                  The config files must exist in one of two
+ *                                  possible folders:  tessdata/tessconfigs or
+ *                                  tessdata/configs.
+ *  @param absoluteDataPath         If the absoluteDataPath is specified, Tesseract
+ *                                  will be set to use that path. If nil, the
+ *                                  application bundle will be use instead
+ *  @param engineMode               The engine mode to use in recognition. See
+ *                                  `engineMode`.
+ *  @param copyFilesFromResources   Flag to determine if Tesseract should copy the
+ *                                  whole contents of the tessdata folder in the
+ *                                  application bundle to the
+ *                                  absoluteDataPath/tessdata directory
+ *
  *
  *  @return The initialized Tesseract object, or `nil` if there was an error.
  */
 - (id)initWithLanguage:(NSString *)language
       configDictionary:(NSDictionary *)configDictionary
        configFileNames:(NSArray *)configFileNames
       absoluteDataPath:(NSString *)absoluteDataPath
-            engineMode:(G8OCREngineMode)engineMode NS_DESIGNATED_INITIALIZER;
+            engineMode:(G8OCREngineMode)engineMode
+copyFilesFromResources:(BOOL)copyFilesFromResources NS_DESIGNATED_INITIALIZER;
 
 /**
  *  Set a Tesseract variable. See G8TesseractParameters.h for the available

TesseractOCR/G8Tesseract.mm

@@ -107,21 +107,23 @@ - (id)initWithLanguage:(NSString *)language
                  configDictionary:configDictionary
                   configFileNames:configFileNames
                  absoluteDataPath:absoluteDataPath
-                       engineMode:engineMode];
+                       engineMode:engineMode
+            copyFilesFromResources:cachesRelatedPath != nil];
 }
 
 - (id)initWithLanguage:(NSString *)language
       configDictionary:(NSDictionary *)configDictionary
        configFileNames:(NSArray *)configFileNames
       absoluteDataPath:(NSString *)absoluteDataPath
             engineMode:(G8OCREngineMode)engineMode
+copyFilesFromResources:(BOOL)copyFilesFromResources
 {
     self = [super init];
     if (self != nil) {
         if (configFileNames) {
             NSAssert([configFileNames isKindOfClass:[NSArray class]], @"Error! configFileNames should be of type NSArray");
         }
-        if (absoluteDataPath) {
+        if (copyFilesFromResources && absoluteDataPath != nil) {
             BOOL moveDataSuccess = [self moveTessdataToDirectoryIfNecessary:absoluteDataPath];
             if (moveDataSuccess == NO) {
                 return nil;