ExtractFramesMemory(String,List<Int32>) Method

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

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++/CLI

public byte[] ExtractFramesMemory( 
   string fileName,
   List<int> frames
)

'Declaration
 
Public Overloads Function ExtractFramesMemory( _
   ByVal fileName As String, _
   ByVal frames As List(Of Integer) _
) As Byte()

'Usage
 
Dim instance As Jpeg2000Engine
Dim fileName As String
Dim frames As List(Of Integer)
Dim value() As Byte
 
value = instance.ExtractFramesMemory(fileName, frames)

public byte[] ExtractFramesMemory( 
   string fileName,
   List<int> frames
)

 function Leadtools.Jpeg2000.Jpeg2000Engine.ExtractFramesMemory(String,List{Int32})( 
   fileName ,
   frames 
)

public:
array<byte>^ ExtractFramesMemory( 
   String^ fileName,
   List<int>^ frames
)

Parameters

fileName: System.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 byte array that contains a JPEG 2000 file with only the extracted frames.

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

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Private Function ExtractFramesMemoryStringExample(ByVal frames As List(Of Integer)) As Byte()
      Dim engine As New Jpeg2000Engine()

      Dim fileInfo As Jpeg2000FileInformation = engine.GetFileInformation(Path.Combine(LEAD_VARS.ImagesDir, "image1.jpx"))

      For i As Integer = 0 To frames.Count - 1
         If (frames(i) >= fileInfo.Frame.GetLength(0)) Then
            Return Nothing
         End If
      Next i
      Return engine.ExtractFramesMemory(Path.Combine(LEAD_VARS.ImagesDir, "image1.jpx"), frames)
   End Function

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public byte[] ExtractFramesMemoryStringExample(List<int> frames)
   {
      Jpeg2000Engine engine = new Jpeg2000Engine();

      Jpeg2000FileInformation fileInfo = engine.GetFileInformation(Path.Combine(LEAD_VARS.ImagesDir, "image1.jpx"));

      for (int i = 0; i < frames.Count; i++)
         if (frames[i] >= fileInfo.Frame.GetLength(0))
            return null;
      return engine.ExtractFramesMemory(Path.Combine(LEAD_VARS.ImagesDir, "image1.jpx"), frames);
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Jpeg2000Engine Class
Jpeg2000Engine Members
Overload List
ExtractFrames Method
ExtractFramesMemory(Stream, List)
ExtractFramesNativeMemory
AppendFrames
AppendGmlData
FragmentJpxFile Method
ReadBox
ReadFrames
ReadGmlData
Compression Using LEAD and JPEG Formats
File Formats - JPEG And LEAD Compressed
Bitmaps In Memory And In Files
JPEG2000 File Comments
JPEG And LEAD File Comments
Programming with JPEG 2000 Features
JPEG 2000 Boxes