Leadtools.Jpeg2000 Requires Document/Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.10
ExtractFramesNativeMemory(String,Generic List) Method
See Also  Example
Leadtools.Jpeg2000 Namespace > Jpeg2000Engine Class > ExtractFramesNativeMemory Method : ExtractFramesNativeMemory(String,Generic List) Method




fileName
String containing the name of the JPEG 2000 file from which the frames are being extracted.
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.
Extracts specific frames from the input file, and saves them to a new JPEG 2000 file in a RasterNativeBuffer object. This file contains only the extracted frame headers/codestreams (not any obtained through the decompressing/recompressing process) so it saves processor time and memory. This method is available in the Document/Medical Toolkits.

Syntax

Visual Basic (Declaration) 
Overloads Public Function ExtractFramesNativeMemory( _
   ByVal fileName As String, _
   ByVal frames As List(Of Integer) _
) As RasterNativeBuffer
Visual Basic (Usage)Copy Code
Dim instance As Jpeg2000Engine
Dim fileName As String
Dim frames As List(Of Integer)
Dim value As RasterNativeBuffer
 
value = instance.ExtractFramesNativeMemory(fileName, frames)
C# 
public RasterNativeBuffer ExtractFramesNativeMemory( 
   string fileName,
   List<int> frames
)
Managed Extensions for C++ 
public: RasterNativeBuffer ExtractFramesNativeMemory( 
   string* fileName,
   List<int>* frames
)
C++/CLI 
public:
RasterNativeBuffer ExtractFramesNativeMemory( 
   String^ fileName,
   List<int>^ frames
)

Parameters

fileName
String containing the name of the JPEG 2000 file from which the frames are being extracted.
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.

Return Value

A RasterNativeBuffer object that contains a JPEG 2000 file with only the extracted frames.

Example

Visual BasicCopy Code
Leadtools.Jpeg2000.Jpeg2000Engine.ExtractFramesNativeMemory(String)
      Private Function ExtractFramesNativeMemoryStringExample(ByVal frames As List(Of Integer)) As RasterNativeBuffer
         Dim engine As New Jpeg2000Engine()

         Dim fileInfo As Jpeg2000FileInformation = engine.GetFileInformation("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx")

         For i As Integer = 0 To frames.Count - 1
            If (frames(i) >= fileInfo.Frame.GetLength(0)) Then
               Return RasterNativeBuffer.Empty
            End If
         Next i
         Return engine.ExtractFramesNativeMemory("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx", frames)
      End Function
C#Copy Code
Leadtools.Jpeg2000.Jpeg2000Engine.ExtractFramesNativeMemory(String) 
      private RasterNativeBuffer ExtractFramesNativeMemoryStringExample(List<int> frames) 
      { 
         Jpeg2000Engine engine = new Jpeg2000Engine(); 
 
         Jpeg2000FileInformation fileInfo = engine.GetFileInformation(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx"); 
 
         for (int i = 0; i < frames.Count; i++) 
            if (frames[i] >= fileInfo.Frame.GetLength(0)) 
               return RasterNativeBuffer.Empty; 
         return engine.ExtractFramesNativeMemory(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\image1.jpx", frames); 
      }

Remarks

. 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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Leadtools.Jpeg2000 requires a Document or Medical toolkit license and unlock key. For more information, refer to: Raster Pro/Document/Medical Features