CodecsJpeg2000PrecinctSize Enumeration

Values to specify the size of JPEG 2000 compressed packets, provides a mean of random access into a JPEG 2000 compressed stream.

Syntax

C#
Visual Basic
WinRT C#
Objective-C
Java
WinRT JavaScript
C++

public enum CodecsJpeg2000PrecinctSize : System.Enum, System.IComparable, System.IConvertible, System.IFormattable

'Declaration
 
Public Enum CodecsJpeg2000PrecinctSize 
   Inherits System.Enum
   Implements System.IComparable, System.IConvertible, System.IFormattable

'Usage
 
Dim instance As CodecsJpeg2000PrecinctSize

public enum CodecsJpeg2000PrecinctSize : System.IComparable, System.IConvertible, System.IFormattable

typedef enum LTCodecsJpeg2000PrecinctSize LTCodecsJpeg2000PrecinctSize;

public enum CodecsJpeg2000PrecinctSize

Leadtools.Codecs.CodecsJpeg2000PrecinctSize = function() { };
Leadtools.Codecs.CodecsJpeg2000PrecinctSize.prototype = {

  Full = 0,
	Uniform64 = 1,
	Uniform128 = 2,
	Uniform256 = 3,
	Uniform512 = 4,
	Uniform1024 = 5,
	Uniform2048 = 6,
	HierarchicalOne64 = 7,
	HierarchicalOne128 = 8,
	HierarchicalOne256 = 9,
	HierarchicalOne512 = 10,
	HierarchicalTwo64 = 11,
	HierarchicalTwo128 = 12,
	HierarchicalTwo256 = 13,
	HierarchicalTwo512 = 14,
	
 };

public enum class CodecsJpeg2000PrecinctSize : public System.Enum, System.IComparable, System.IConvertible, System.IFormattable

Members

Value	Member	Description
0	Full	No precinct is used, size is infinite.
1	Uniform64	For all resolution levels, a precinct dimension of [64x64] will be applied.
2	Uniform128	For all resolution levels, a precinct dimension of [128x128] will be applied.
3	Uniform256	For all resolution levels, a precinct dimension of [256x256] will be applied.
4	Uniform512	For all resolution levels, a precinct dimension of [512x512] will be applied.
5	Uniform1024	For all resolution levels, a precinct dimension of [1024x1024] will be applied.
6	Uniform2048	For all resolution levels, a precinct dimension of [2048x2048] will be applied.
7	HierarchicalOne64	A precinct size of [X by X] will be applied to the first(smallest) resolution of the image. The second resolution precinct dimension would be [2X by 2X]. The third resolution precinct dimension would be [4X by 4X] and so on. If the JPEG 2000 file has five levels and HierarchicalOne64 is used, the precinct dimensions will be as follows: [64x64] level 1 [128x128] level 2 [256x256] level 3 [512x512] level 4 [1024x1024] level 5
8	HierarchicalOne128	A precinct size of [X by X] will be applied to the first(smallest) resolution of the image. The second resolution precinct dimension would be [2X by 2X]. The third resolution precinct dimension would be [4X by 4X] and so on. If the JPEG 2000 file has five levels and HierarchicalOne128 is used, the precinct dimensions will be as follows: [128x128] level 1 [256x256]level 2 [512x512]level 3 [1024x1024] level 4 [2048x2048] level 5
9	HierarchicalOne256	A precinct size of [X by X] will be applied to the first(smallest) resolution of the image. The second resolution precinct dimension would be [2X by 2X]. The third resolution precinct dimension would be [4X by 4X] and so on. If the JPEG 2000 file has five levels and HierarchicalOne256 is used, the precinct dimensions will be as follows: [256x256] level 1 [512x512] level 2 [1024x1024] level 3 [2048x2048] level 4 [4096x4096] level 5
10	HierarchicalOne512	A precinct size of [X by X] will be applied to the first(smallest) resolution of the image. The second resolution precinct dimension would be [2X by 2X]. The third resolution precinct dimension would be [4X by 4X] and so on. If the JPEG 2000 file has five levels and HierarchicalOne512 is used, the precinct dimensions will be as follows: [512x512] level 1 [1024x1024 level 2 [2048x2048] level 3 [4096x4096]level 4 [8192x8192] level 5
11	HierarchicalTwo64	A precinct size of [X by X] will be applied to the first and second (smallest) resolutions of the image. The third and fourth resolution precinct dimensions would be [2X by 2X] and so on. So if the JPEG 2000 file has five levels and HierarchicalTwo64 is used, the precinct dimensions will be as follows: [64x64] level 1 [64x64] level 2 [128x128] level 3 [128x128] level 4 [256x256] level 5
12	HierarchicalTwo128	A precinct size of [X by X] will be applied to the first and second (smallest) resolutions of the image. The third and fourth resolution precinct dimensions would be [2X by 2X] and so on. So if the JPEG 2000 file has five levels and HierarchicalTwo128 is used, the precinct dimensions will be as follows: [128x128] level 1 [128x128] level 2 [256x256] level 3 [256x256] level 4 [512x512] level 5
13	HierarchicalTwo256	A precinct size of [X by X] will be applied to the first and second (smallest) resolutions of the image. The third and fourth resolution precinct dimensions would be [2X by 2X] and so on. So if the JPEG 2000 file has five levels and HierarchicalTwo256 is used, the precinct dimensions will be as follows: [256x256] level 1 [256x256] level 2 [512x512] level 3 [512x512] level 4 [1024x1024] level 5
14	HierarchicalTwo512	A precinct size of [X by X] will be applied to the first and second (smallest) resolutions of the image. The third and fourth resolution precinct dimensions would be [2X by 2X] and so on. So if the JPEG 2000 file has five levels and HierarchicalTwo512 is used, the precinct dimensions will be as follows: [512x512] level 1 [512x512] level 2 [1024x1024] level 3 [1024x1024] level 4 [2048x2048] level 5

Remarks

Precincts are rectangular regions in the wavelet domain, within a given resolution level and image component that represent a spatial region on the image. They are used for limiting the size of JPEG 2000 compressed packets and to provide a means of random access into a JPEG 2000 compressed stream. For this reason, they should be used for interactive transfer of JPEG 2000 files as in JPIP applications. In general, dividing the image into precincts is better than tiling it. So it is recommended that users compress the image as one tile and use precincts to divide the spatial region. This will give better compression ratios and image quality.

Using smaller precinct dimensions provides finer access to the compressed stream yet increases the compressed stream size. It is recommended to use HierarchicalOne128 and no tiling to generate JPEG 2000 files for any purpose.

Example

For an example, refer to CodecsJpeg2000Options.

Inheritance Hierarchy

System.Object
   System.ValueType
      System.Enum
         Leadtools.Codecs.CodecsJpeg2000PrecinctSize

Requirements

Target Platforms

Reference

Leadtools.Codecs Namespace