Thanks for downloading Dynamsoft Barcode Reader Package!

Your download will start shortly. If your download does not begin, click here to retry.

DSFileFetcher

The DSFileFetcher class is a utility class that partitions a multi-page image file into multiple independent ImageData objects. It inherits from the DSImageSourceAdapter class.

Definition

Assembly: DynamsoftUtility.framework

Objective-C
Swift

```
@interface DSFileFetcher : NSObject
```
```
class FileFetcher : NSObject
```

Methods

Method	Description
`setFileWithPath`	Sets the file with a file path.
`setFileWithBytes`	Sets the file with file bytes.
`setFileWithBuffer`	Sets the file with a `DSImageData` object.
`setFileWithImage`	Sets the file with a `UIImage`.
`hasNextImageToFetch`	Whether there is a next image to fetch.
`getImage`	Get the image data of the image.
`setPages`	Set the pages to read.

setFileWithPath

Sets the file with a file path.

Objective-C
Swift

-(BOOL)setFileWithPath:(NSString *)filePath
             error:(NSError *_Nullable *_Nullable)error;

func setFile(withPath filePath: String) throws

Parameters

filePath: The file path.

error: An NSError pointer. If an error occurs, it will represent the error information.

Error

Error Code	Value	Description
EC_FILE_NOT_FOUND	-10005	The file is not found.
EC_FILE_TYPE_NOT_SUPPORTED	-10006	The file type is not supported.

setFileWithBytes

Sets the file with file bytes.

Objective-C
Swift

-(BOOL)setFileWithBytes:(NSData *)fileBytes
              error:(NSError *_Nullable *_Nullable)error;

func setFile(withBytes fileBytes: Data) throws

Parameters

fileBytes: The file bytes.

error: An NSError pointer. If an error occurs, it will represent the error information.

Error

Error Code	Value	Description
EC_NULL_POINTER	-10002	The fileBytes you input is null.

setFileWithBuffer

Sets the file with a DSImageData object.

Objective-C
Swift

-(BOOL)setFileWithBuffer:(DSImageData *)buffer
               error:(NSError *_Nullable *_Nullable)error;

func setFile(withBuffer buffer: ImageData) throws

Parameters

buffer: The image data.

error: An NSError pointer. If an error occurs, it will represent the error information.

Error

Error Code	Value	Description
EC_NULL_POINTER	-10002	The fileBytes you input is null.

setFileWithImage

Sets the file with a UIImage.

Objective-C
Swift

-(BOOL)setFileWithImage:(UIImage *)image
              error:(NSError *_Nullable *_Nullable)error;

func setFile(withImage image: UIImage) throws

Parameters

image: A UIImage.

error: An NSError pointer. If an error occurs, it will represent the error information.

Error

Error Code	Value	Description
EC_NULL_POINTER	-10002	The fileBytes you input is null.

hasNextImageToFetch

Whether there is a next image to fetch.

Objective-C
Swift

```
-(BOOL)hasNextImageToFetch;
```
```
func hasNextImageToFetch() -> Bool
```

Return Value

A bool value that indicates whether there is a next image to fetch.

getImage

Get the image data of the image.

Objective-C
Swift

```
-(DSImageData *)getImage;
```
```
func getImage() -> ImageData
```

Return Value

A DSImageData as the image.

setPages

Set the pages to read.

Objective-C
Swift

-(BOOL)setPages:(NSArray *)pages
      error:(NSError *_Nullable *_Nullable)error;

func setPages(_ pages: NSArray) throws -> BOOL

Parameters

pages: An array that contains all the pages to read.
error: An NSError pointer. If an error occurs, it will represent the error information.

Error

Error Code	Value	Description
EC_FILE_NOT_FOUND	-10005	File not found.
EC_FILE_TYPE_NOT_SUPPORTED	-10006	The file type is not supported.
EC_IMAGE_READ_FAILED	-10012	Failed to read the image.