←Select platform

CompactFile(Stream,Stream,Int32,Int32,Boolean,Int64,Int32,Boolean,Int64,CodecsSavePageMode,Boolean,Boolean,Boolean) Method

Summary

Compacts TIFF streams with specific options.

Syntax

Java

Objective-C

C++

public void CompactFile(  
   Stream srcStream, 
   Stream destStream, 
   int pages, 
   int srcStartPage, 
   bool useSrcIfd, 
   long srcIfd, 
   int destStartPage, 
   bool useDestIfd, 
   long destIfd, 
   Leadtools.Codecs.CodecsSavePageMode pageMode, 
   bool noSubFileType, 
   bool motorolaOrder, 
   bool bigTiff 
)

Public Overloads Sub CompactFile( _ 
   ByVal srcStream As Stream, _ 
   ByVal destStream As Stream, _ 
   ByVal pages As Integer, _ 
   ByVal srcStartPage As Integer, _ 
   ByVal useSrcIfd As Boolean, _ 
   ByVal srcIfd As Long, _ 
   ByVal destStartPage As Integer, _ 
   ByVal useDestIfd As Boolean, _ 
   ByVal destIfd As Long, _ 
   ByVal pageMode As Leadtools.Codecs.CodecsSavePageMode, _ 
   ByVal noSubFileType As Boolean, _ 
   ByVal motorolaOrder As Boolean, _ 
   ByVal bigTiff As Boolean _ 
)

- (BOOL)compactStream:(LTLeadStream *)srcStream  
    destinationStream:(LTLeadStream *)destStream 
                pages:(NSUInteger)pages  
      sourceStartPage:(NSInteger)srcStartPage  
 destinationStartPage:(NSInteger)destStartPage  
         useSourceIFD:(BOOL)useSrcIfd  
            sourceIFD:(NSInteger)srcIfd  
    useDestinationIFD:(BOOL)useDestIfd  
       destinationIFD:(NSInteger)destIfd  
             pageMode:(LTCodecsSavePageMode)pageMode  
        noSubFileType:(BOOL)noSubFileType  
        motorolaOrder:(BOOL)motorolaOrder  
              bigTiff:(BOOL)bigTiff  
                error:(NSError **)error

public void compactFile(ILeadStream srcStream, ILeadStream destStream, int pages, int srcStartPage, boolean useSrcIfd, long srcIfd, int destStartPage, boolean useDestIfd, long destIfd, CodecsSavePageMode pageMode, boolean noSubFileType, boolean motorolaOrder, boolean bigTiff) throws Exception

public: 
void CompactFile(  
   Stream^ srcStream, 
   Stream^ destStream, 
   int pages, 
   int srcStartPage, 
   bool useSrcIfd, 
   int64 srcIfd, 
   int destStartPage, 
   bool useDestIfd, 
   int64 destIfd, 
   Leadtools.Codecs.CodecsSavePageMode pageMode, 
   bool noSubFileType, 
   bool motorolaOrder, 
   bool bigTiff 
)

Parameters

srcStream
A Stream containing the data of the file being compacted. All the pages will be read from this stream.

destStream
A Stream that will contain the written data.

pages
Value that represents the number of pages to copy. Use 0 to copy all the pages. If pages is > 0, only pages will be copied to destStream.

srcStartPage
Specifies the start page in the source stream. Page 1 is the first page, page 2 is the second page, etc. The pages will be read starting with this page.

useSrcIfd
true to use srcIfd as the stream offset of the first page. false to use srcStartPage.

srcIfd
Offset into the source stream for the start page. Used only if useSrcIfd is true.

All pages will be relative to that page. (Note that this might not be the first physical page in the stream). This is a common technique for manipulating files with thousands of pages.

destStartPage
0 to overwrite destStream. <>0 to append the pages to the end of the stream.

useDestIfd
true to use destIfd as the stream offset of the first page. false to use destStartPage.

destIfd
Offset into the destination stream for the start page. Used only if useDestIfd is true.

All pages will be relative to that page. (Note that this might not be the first physical page in the stream). This is a common technique for manipulating files with thousands of pages.

pageMode
Flag which indicates the save page mode.

Value	Meaning
CodecsSavePageMode.Insert	All pages are inserted before destStartPage.
CodecsSavePageMode.Replace	Pages in destStream are replaced beginning with destStartPage.

noSubFileType
true to have the TGSUBFILETYPE tag stripped from all pages in the destination file.

motorolaOrder
true to save pages in Motorola byte order. false to save pages in Intel byte order. This only applies when creating a new file. When updating existing files, the byte order of the original file is used.

bigTiff
true to save TIFF files using the BigTiff format, which allows TIFF files to exceed 4GB.

Remarks

This method can also be used to copy or extract one or more pages from a TIFF file and copy them without recompression to another TIFF file. Whenever you save an image containing a region as a TIFF file format, the region is also saved. Note, however, that the ability to save a region inside a TIFF file must be unlocked. This requires a Document Imaging or Medical Imaging toolkit.

Example

For an example, refer to CompactFile.

Requirements

Target Platforms