save()

Description

Saves images in DcsBuffer to the App sandbox directory synchronously.

Syntax

(void) save: (NSArray *) indices
file: (NSString *) filename
encodeParameter: (DcsEncodeParameter *) parameter

Parameters

indices:NSArray An array of the indices of images to be saved.
file:NSString The file name of the images to be saved. It is a full path defined by users.
encodeParameter:DcsEncodeParameter Its value will be chosen from DcsPNGEncodeParameter, DcsJPEGEncodeParameter or DcsPDFEncodeParameter which represents to save the images as PNG, JPG or PDF files.

Return value

Void

Remarks

encodeParameter Maximum Value Result if the length of indices exceeds the maximum value
DcsPNGEncodeParameter 1 Save the first image as a PNG file.
DcsJPEGEncodeParameter 1 Save the first image as a JPG file.
DcsPDFEncodeParameter no limit Save the images as a multi-page PDF.

Exceptions

Circumstance Exception thrown
License verification failed. DcsLicenseVerificationFailedException
There is not enough memory. DcsStorageSpaceLimitException
Indices/encodeParameter/file is nil. DcsValueNotValidException
Indices include a value not smaller than DcsBuffer.count. DcsValueOutOfRangeException
The file size exceeded the 50MB limit. DcsException

Example

DcsPDFEncodeParameter *pdf;
DcsPNGEncodeParameter *png;
DcsJPEGEncodeParameter *jpeg;
 
pdf = [[DcsPDFEncodeParameter alloc] init];
png = [[DcsPNGEncodeParameter alloc] init];
jpeg = [[DcsJPEGEncodeParameter alloc] init];
 
jpeg.quality = 0.8;
NSString *path1 = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingString: @"/dynamsoftDcs.pdf"];
NSString *path2 = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0] stringByAppendingString: @"/dynamsoftDcs.png"];
NSArray *tempArr = [[NSArray alloc]initWithObjects:@"1",@"2",nil]; // @"1" and @"2" are the indices of the second and third data in DcsBuffer.
[dcsView.io save:tempArr file: path1 encodeParameter:pdf];
[dcsView.io save:tempArr file: path2 encodeParameter:png]; // Only the first element in the array will be saved as a png file.


Is this page helpful?

Leave a Reply

Your email address will not be published.