ExtractFrames Method

Summary

Extracts the specified frames from the input file, and saves them to a new JPEG 2000 file. This method is available in the Document/Medical Toolkits.

Syntax

C++/CLI

Python

public void ExtractFrames( 
   string inputFileName, 
   string outputFileName, 
   List<int> frames 
)

public: 
void ExtractFrames(  
   String^ inputFileName, 
   String^ outputFileName, 
   List<int>^ frames 
)

def ExtractFrames(self,inputFileName,outputFileName,frames):

Parameters

inputFileName
System.String containing the name of the JPEG 2000 file from which the frames are being extracted.

outputFileName
System.String containing the name of the JPEG 2000 file to be used to save the extracted frames. This file will contain only the extracted frames.

frames
Frame indices. A list of integers specifying the indices of the frames to be extracted from the input file. All indices should be 0-based.

Remarks

. This file contains only the extracted frame headers/code streams (not any obtained through the decompressing/recompressing process) so it saves processor time and memory.

This method is very suitable for server applications where multiple clients request specific frames of a JPEG 2000 file. Instead of decompressing and then recompressing the frames this method copies only the needed frame data, saving the data to a new JPEG 2000 file.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Jpeg2000; 
 
 
public void AppendGmlDataStringExample(String inputFile, String outputFile, GmlElement newData) 
{ 
   Jpeg2000Engine engine = new Jpeg2000Engine(); 
   //Read GML data in the input file 
   GmlData gml = engine.ReadGmlData(inputFile); 
   //Add the new gml element data 
   gml.Data.Add(newData); 
   List<int> frames = new List<int>(); 
   //extract all inputfile frames 
   Jpeg2000FileInformation fileInfo = engine.GetFileInformation(inputFile); 
   for (int i = 0; i < fileInfo.Frame.GetLength(0); i++) 
      frames.Add(i); 
   engine.ExtractFrames(inputFile, outputFile, frames); 
   //add all GML data 
   engine.AppendGmlData(outputFile, gml); 
}