JP2ECW—ERDAS JPEG2000（.jp2）

司机简称

JP2ECW公司

生成依赖项

ECW软件开发包

GDAL支持使用Hexagon Geospatial（以前是integraph、ERDAS、ERMapper）开发的ERDAS ECW/JP2 SDK读写JPEG2000文件。支持是可选的，需要在ECW/JP2 SDK下载页面提供的库中进行链接。

读取坐标系和地理参考转换，并在一定程度上支持GeoJP2（tm）（GeoTIFF-in-JPEG2000）、ERDAS GML-in-JPEG2000和OGC开发的新GML-in-JPEG2000规范。

驱动程序功能

Supports CreateCopy()

This driver supports the GDALDriver::CreateCopy() operation

Supports Create()

This driver supports the GDALDriver::Create() operation

Supports Georeferencing

This driver supports georeferencing

Supports VirtualIO

This driver supports virtual I/O operations (/vsimem/, etc.)

许可

ERDAS ECW/JP2 SDK v5.x在多种许可类型下可用。对于桌面使用，解码任何大小的ECW/JP2图像都是免费的。要在服务器平台上压缩、部署或解码移动平台上大小不受限制的文件，必须从Hexagon Geospatial购买许可证。

历史

  • v3.x-最新版本，2006

  • v4.x-最新版本，2012

  • v5.x-主动开发，2013-当前

影像配准

地理参考信息可以来自不同的来源：内部（GeoJP2或GMLJP2框）、worldfile.j2w/.wld sidecar文件或PAM（持久辅助元数据）.aux.xml sidecar文件。默认情况下，按以下顺序获取信息（首先列出的是最优先的）：PAM、GeoJP2、GMLJP2、WORLDFILE。

从GDAL 2.2开始，可以使用GDAL GEOREF_sources配置选项（或GEOREF_sources打开选项）更改允许的源及其优先级顺序，该选项的值是以下关键字的逗号分隔列表：PAM、GEOJP2、GMLJP2、INTERNAL（GEOJP2的快捷方式，GMLJP2）、WORLDFILE、NONE。首先提到的消息来源是最优先于接下来的消息来源。将忽略未提及的源。

例如，将其设置为“WORLDFILE，PAM，INTERNAL”将使潜在的WORLDFILE优先于PAM或内部JP2框生成地理转换矩阵。将其设置为“PAM，WORLDFILE，GEOJP2”将使用上述源代码并忽略GMLJP2框。

期权

以下打开选项可用：

  • 1BIT_ALPHA_PROMOTION=YES/NO ：是否应将1位alpha通道提升为8位。默认为“是”。

  • GEOREF_SOURCES=string ：（GDAL>2.2）定义允许哪些地理参考源及其优先级顺序。见 Georeferencing 段落。

创建选项：

注意：只需要指定授权和压缩目标。ECW/JP2 SDK将根据输入特性将所有其他选项默认为推荐的设置。更改其他选项可以 基本上 影响解码速度和与其他JPEG2000工具包的兼容性。

  • LARGE_OK=YES ： （仅限v3.x SDK） 允许根据EULA条款压缩大于500MB的文件。自v4.x以来已弃用，取而代之的是ECW_ENCODE_KEY&ECW_ENCODE_COMPANY。

  • ECW_ENCODE_KEY=key ： （v4.x SDK或更高版本） 提供原始设备制造商编码密钥，以解锁编码能力，最高可达许可的千兆像素限制。密钥大约有129个十六进制数字长。公司和密钥必须匹配，并且必须在每个次要版本的SDK中重新生成。它也可以作为配置选项全局提供。

  • ECW_ENCODE_COMPANY=name ： （v4.x SDK或更高版本） 在发出的OEM密钥中提供公司名称（请参阅ECW_ENCODE_密钥）。公司和密钥必须匹配，并且必须在每个次要版本的SDK中重新生成。它也可以作为配置选项全局提供。

  • TARGET=percent ：将目标大小缩减设置为原始大小的百分比。如果未提供，则默认为75%以减少75%。TARGET=0使用无损压缩。

  • PROJ=name ：要使用的ECW投影字符串的名称。常见的例子是NUTM11或大地测量。

  • DATUM=name ：要使用的ECW基准字符串的名称。常见的例子是WGS84或NAD83。

  • GMLJP2=YES/NO ：指示文件中是否应包含符合JPEG2000规范中OGC GML的GML框。除非使用GMLJP2V2_DEF，否则GMLJP2框的版本将为版本1。默认为“是”。

  • GMLJP2V2_DEF=filename ：表示GML框是否符合 OGC GML in JPEG2000, version 2 文件中应包含规范。 文件名 必须指向一个包含JSon内容的文件，该文件定义了如何构建GMLJP2 v2框。见 GMLJP2v2 definition file section JSon配置文件语法的JP2OpenJPEG驱动程序的文档中。还可以直接传递作为字符串内联的JSon内容。如果filename设置为YES，则将生成最小实例。

  • GeoJP2=YES/NO ：指示文件中是否应包含符合GeoJP2（JPEG2000中的GeoTIFF）规范的UUID/GeoTIFF框。默认为“是”。

  • PROFILE=profile ：基线0、基线1、基线2、NPJE或EPJE之一。查看ECW SDK文档以了解有关配置文件含义的详细信息。

  • PROGRESSION=LRCP/RLCP/RPCL ：设置JPEG2000码流的写入顺序。（默认，RPCL）

  • CODESTREAM_ONLY=YES/NO ：如果设置为“是”，则只会写入压缩图像代码流。如果没有一个JP2包将围绕包含各种元信息的代码流编写。（默认，否）

  • LEVELS=n ：棱锥体中的分辨率级别（默认情况下，最小缩略图的大小最大为64x64像素）

  • LAYERS=n ：质量层（默认，1）

  • PRECINCT_WIDTH=n ：辖区宽度（默认值，64）

  • PRECINCT_HEIGHT=n ：辖区高度（默认值64）

  • TILE_WIDTH=n ：平铺宽度（默认值，图像宽度，如1平铺）。除了GeoTIFF，在JPEG2000中，如果使用区域，平铺对于速度并不重要。标准允许的最小平铺大小为1024x1024像素。

  • TILE_HEIGHT=n ：平铺高度（默认值，图像高度，如1平铺）

  • INCLUDE_SOP=YES/NO ：包标记的输出开始（默认为false）

  • INCLUDE_EPH=YES/NO ：包头标记的输出端（默认为true）

  • DECOMPRESS_LAYERS=n ：要解码的质量层的数量

  • DECOMPRESS_RECONSTRUCTION_PARAMETER=n ：不可逆_9x7或可逆_5x3

  • WRITE_METADATA=YES/NO ：是否应在专用JP2 XML框中写入元数据。默认为“否”。XML框的内容如下：

    <GDALMultiDomainMetadata>
  <Metadata>
    <MDI key="foo">bar</MDI>
  </Metadata>
  <Metadata domain='aux_domain'>
    <MDI key="foo">bar</MDI>
  </Metadata>
  <Metadata domain='a_xml_domain' format='xml'>
    <arbitrary_xml_content>
    </arbitrary_xml_content>
  </Metadata>
</GDALMultiDomainMetadata>

    如果有名称以“xml:BOX”开头的元数据域，它们将分别作为单独的jp2xml框写入。

    如果有一个名为“xml:XMP”的元数据域，它的内容将被写为jp2uuidxmp框。

  • MAIN_MD_DOMAIN_ONLY=YES/NO ：（仅当WRITE_METADATA=YES时）是否应仅写入主域中的元数据。默认为否。

“JPEG2000格式不支持创建GDAL概述，因为该格式已被视为针对“任意概述”进行了优化。”。JP2ECW驱动程序还安排JP2码流，以允许对两个概览的功率进行最佳访问。这是由创建选项级别控制的。”

配置选项

ERDAS ECW/JP2 SDK支持多种 runtime configuration options 控制各种特性。其中大多数是作为GDAL配置选项公开的。请参阅ECW/JP2 SDK文档，以获取有关这些选项含义的完整详细信息。

  • ECW_CACHE_MAXMEM=bytes ：用于内存缓存的最大RAM字节数。如果没有设置，SDK将使用多达四分之一的物理RAM进行内存缓存。

  • ECW_TEXTURE_DITHER=TRUE/FALSE ：在解压缩ECW文件时，这可能设置为FALSE以禁用抖动。默认为TRUE。

  • ECW_FORCE_FILE_REOPEN=TRUE/FALSE ：此值可以设置为TRUE，以强制为所建立的每个连接打开每个文件的文件句柄。默认为FALSE。

  • ECW_CACHE_MAXOPEN=number ：要为ECW文件句柄缓存保持打开的最大文件数。默认为无限制。

  • ECW_AUTOGEN_J2I=TRUE/FALSE ：控制打开jpeg2000文件时是否应创建.j2i索引文件。默认为TRUE。

  • ECW_RESILIENT_DECODING=TRUE/FALSE ：控制读取器是否应原谅文件中的错误，尝试返回尽可能多的可用数据。默认为TRUE。如果设置为FALSE，则无效文件将导致错误。

元数据

XMP元数据可以从JPEG2000文件中提取，并作为XML原始内容存储在XML:XMP元数据域中。

ECW/JP2 SDK v5.1+还将JPEG2000结构信息作为“JPEG2000”元数据域（-mdd）下报告的通用文件元数据播发：

  • ALL_COMMENTS ：通用注释文本字段

  • PROFILE ：配置文件类型（0,1,2）。有关更多信息，请参阅ECW/JP2 SDK文档

  • TILES_X ：X（水平）轴上的瓷砖数量

  • TILES_Y ：Y（垂直）轴上的平铺数

  • TILE_WIDTH ：X轴上的平铺大小

  • TILE_HEIGHT ：Y轴上的平铺大小

  • PRECINCT_SIZE_X ：X轴上每个分辨率级别（最小到最大）的区域大小

  • PRECINCT_SIZE_Y ：Y轴上每个分辨率级别（最小到最大）的区域大小

  • CODE_BLOCK_SIZE_X ：X轴上的代码块大小

  • CODE_BLOCK_SIZE_Y ：Y轴上的代码块大小

  • PRECISION ：每个分量的精度/位深度，如8比特3波段图像的8、8、8。

  • RESOLUTION_LEVELS ：分辨率级别数

  • QUALITY_LAYERS ：质量层数量

  • PROGRESSION_ORDER ：进展顺序（RPCL、LRCP、CPRL、RLCP）

  • TRANSFORMATION_TYPE ：使用过滤器转换（9x7，5x3）

  • USE_SOP ：检测到包标记的开始（真/假）

  • USE_EPH ：检测到数据包头结束标记（真/假）

  • GML_JP2_DATA ：检测到OGC GML地理参考框（真/假）

  • COMPRESSION_RATE_TARGET ：编码时使用的目标压缩率

也见