类 Imgcodecs


  • public class Imgcodecs
    extends java.lang.Object
    • 字段详情

      • IMREAD_UNCHANGED

        public static final int IMREAD_UNCHANGED
        另请参见
        常量字段值
      • IMREAD_GRAYSCALE

        public static final int IMREAD_GRAYSCALE
        另请参见
        常量字段值
      • IMREAD_COLOR_BGR

        public static final int IMREAD_COLOR_BGR
        另请参见
        常量字段值
      • IMREAD_COLOR

        public static final int IMREAD_COLOR
        另请参见
        常量字段值
      • IMREAD_ANYDEPTH

        public static final int IMREAD_ANYDEPTH
        另请参见
        常量字段值
      • IMREAD_ANYCOLOR

        public static final int IMREAD_ANYCOLOR
        另请参见
        常量字段值
      • IMREAD_LOAD_GDAL

        public static final int IMREAD_LOAD_GDAL
        另请参见
        常量字段值
      • IMREAD_REDUCED_GRAYSCALE_2

        public static final int IMREAD_REDUCED_GRAYSCALE_2
        另请参见
        常量字段值
      • IMREAD_REDUCED_COLOR_2

        public static final int IMREAD_REDUCED_COLOR_2
        另请参见
        常量字段值
      • IMREAD_REDUCED_GRAYSCALE_4

        public static final int IMREAD_REDUCED_GRAYSCALE_4
        另请参见
        常量字段值
      • IMREAD_REDUCED_COLOR_4

        public static final int IMREAD_REDUCED_COLOR_4
        另请参见
        常量字段值
      • IMREAD_REDUCED_GRAYSCALE_8

        public static final int IMREAD_REDUCED_GRAYSCALE_8
        另请参见
        常量字段值
      • IMREAD_REDUCED_COLOR_8

        public static final int IMREAD_REDUCED_COLOR_8
        另请参见
        常量字段值
      • IMREAD_IGNORE_ORIENTATION

        public static final int IMREAD_IGNORE_ORIENTATION
        另请参见
        常量字段值
      • IMREAD_COLOR_RGB

        public static final int IMREAD_COLOR_RGB
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_NO

        public static final int IMWRITE_EXR_COMPRESSION_NO
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_RLE

        public static final int IMWRITE_EXR_COMPRESSION_RLE
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_ZIPS

        public static final int IMWRITE_EXR_COMPRESSION_ZIPS
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_ZIP

        public static final int IMWRITE_EXR_COMPRESSION_ZIP
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_PIZ

        public static final int IMWRITE_EXR_COMPRESSION_PIZ
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_PXR24

        public static final int IMWRITE_EXR_COMPRESSION_PXR24
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_B44

        public static final int IMWRITE_EXR_COMPRESSION_B44
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_B44A

        public static final int IMWRITE_EXR_COMPRESSION_B44A
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_DWAA

        public static final int IMWRITE_EXR_COMPRESSION_DWAA
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION_DWAB

        public static final int IMWRITE_EXR_COMPRESSION_DWAB
        另请参见
        常量字段值
      • IMWRITE_EXR_TYPE_HALF

        public static final int IMWRITE_EXR_TYPE_HALF
        另请参见
        常量字段值
      • IMWRITE_EXR_TYPE_FLOAT

        public static final int IMWRITE_EXR_TYPE_FLOAT
        另请参见
        常量字段值
      • IMWRITE_JPEG_QUALITY

        public static final int IMWRITE_JPEG_QUALITY
        另请参见
        常量字段值
      • IMWRITE_JPEG_PROGRESSIVE

        public static final int IMWRITE_JPEG_PROGRESSIVE
        另请参见
        常量字段值
      • IMWRITE_JPEG_OPTIMIZE

        public static final int IMWRITE_JPEG_OPTIMIZE
        另请参见
        常量字段值
      • IMWRITE_JPEG_RST_INTERVAL

        public static final int IMWRITE_JPEG_RST_INTERVAL
        另请参见
        常量字段值
      • IMWRITE_JPEG_LUMA_QUALITY

        public static final int IMWRITE_JPEG_LUMA_QUALITY
        另请参见
        常量字段值
      • IMWRITE_JPEG_CHROMA_QUALITY

        public static final int IMWRITE_JPEG_CHROMA_QUALITY
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR
        另请参见
        常量字段值
      • IMWRITE_PNG_COMPRESSION

        public static final int IMWRITE_PNG_COMPRESSION
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY

        public static final int IMWRITE_PNG_STRATEGY
        另请参见
        常量字段值
      • IMWRITE_PNG_BILEVEL

        public static final int IMWRITE_PNG_BILEVEL
        另请参见
        常量字段值
      • IMWRITE_PXM_BINARY

        public static final int IMWRITE_PXM_BINARY
        另请参见
        常量字段值
      • IMWRITE_EXR_TYPE

        public static final int IMWRITE_EXR_TYPE
        另请参见
        常量字段值
      • IMWRITE_EXR_COMPRESSION

        public static final int IMWRITE_EXR_COMPRESSION
        另请参见
        常量字段值
      • IMWRITE_EXR_DWA_COMPRESSION_LEVEL

        public static final int IMWRITE_EXR_DWA_COMPRESSION_LEVEL
        另请参见
        常量字段值
      • IMWRITE_WEBP_QUALITY

        public static final int IMWRITE_WEBP_QUALITY
        另请参见
        常量字段值
      • IMWRITE_HDR_COMPRESSION

        public static final int IMWRITE_HDR_COMPRESSION
        另请参见
        常量字段值
      • IMWRITE_PAM_TUPLETYPE

        public static final int IMWRITE_PAM_TUPLETYPE
        另请参见
        常量字段值
      • IMWRITE_TIFF_RESUNIT

        public static final int IMWRITE_TIFF_RESUNIT
        另请参见
        常量字段值
      • IMWRITE_TIFF_XDPI

        public static final int IMWRITE_TIFF_XDPI
        另请参见
        常量字段值
      • IMWRITE_TIFF_YDPI

        public static final int IMWRITE_TIFF_YDPI
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION

        public static final int IMWRITE_TIFF_COMPRESSION
        另请参见
        常量字段值
      • IMWRITE_TIFF_ROWSPERSTRIP

        public static final int IMWRITE_TIFF_ROWSPERSTRIP
        另请参见
        常量字段值
      • IMWRITE_TIFF_PREDICTOR

        public static final int IMWRITE_TIFF_PREDICTOR
        另请参见
        常量字段值
      • IMWRITE_JPEG2000_COMPRESSION_X1000

        public static final int IMWRITE_JPEG2000_COMPRESSION_X1000
        另请参见
        常量字段值
      • IMWRITE_AVIF_QUALITY

        public static final int IMWRITE_AVIF_QUALITY
        另请参见
        常量字段值
      • IMWRITE_AVIF_DEPTH

        public static final int IMWRITE_AVIF_DEPTH
        另请参见
        常量字段值
      • IMWRITE_AVIF_SPEED

        public static final int IMWRITE_AVIF_SPEED
        另请参见
        常量字段值
      • IMWRITE_JPEGXL_QUALITY

        public static final int IMWRITE_JPEGXL_QUALITY
        另请参见
        常量字段值
      • IMWRITE_JPEGXL_EFFORT

        public static final int IMWRITE_JPEGXL_EFFORT
        另请参见
        常量字段值
      • IMWRITE_JPEGXL_DISTANCE

        public static final int IMWRITE_JPEGXL_DISTANCE
        另请参见
        常量字段值
      • IMWRITE_JPEGXL_DECODING_SPEED

        public static final int IMWRITE_JPEGXL_DECODING_SPEED
        另请参见
        常量字段值
      • IMWRITE_GIF_LOOP

        public static final int IMWRITE_GIF_LOOP
        另请参见
        常量字段值
      • IMWRITE_GIF_SPEED

        public static final int IMWRITE_GIF_SPEED
        另请参见
        常量字段值
      • IMWRITE_GIF_QUALITY

        public static final int IMWRITE_GIF_QUALITY
        另请参见
        常量字段值
      • IMWRITE_GIF_DITHER

        public static final int IMWRITE_GIF_DITHER
        另请参见
        常量字段值
      • IMWRITE_GIF_TRANSPARENCY

        public static final int IMWRITE_GIF_TRANSPARENCY
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE

        public static final int IMWRITE_GIF_COLORTABLE
        另请参见
        常量字段值
      • IMWRITE_GIF_FAST_NO_DITHER

        public static final int IMWRITE_GIF_FAST_NO_DITHER
        另请参见
        常量字段值
      • IMWRITE_GIF_FAST_FLOYD_DITHER

        public static final int IMWRITE_GIF_FAST_FLOYD_DITHER
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_8

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_8
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_16

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_16
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_32

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_32
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_64

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_64
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_128

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_128
        另请参见
        常量字段值
      • IMWRITE_GIF_COLORTABLE_SIZE_256

        public static final int IMWRITE_GIF_COLORTABLE_SIZE_256
        另请参见
        常量字段值
      • IMWRITE_HDR_COMPRESSION_NONE

        public static final int IMWRITE_HDR_COMPRESSION_NONE
        另请参见
        常量字段值
      • IMWRITE_HDR_COMPRESSION_RLE

        public static final int IMWRITE_HDR_COMPRESSION_RLE
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR_411

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR_411
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR_420

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR_420
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR_422

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR_422
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR_440

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR_440
        另请参见
        常量字段值
      • IMWRITE_JPEG_SAMPLING_FACTOR_444

        public static final int IMWRITE_JPEG_SAMPLING_FACTOR_444
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_NULL

        public static final int IMWRITE_PAM_FORMAT_NULL
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_BLACKANDWHITE

        public static final int IMWRITE_PAM_FORMAT_BLACKANDWHITE
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_GRAYSCALE

        public static final int IMWRITE_PAM_FORMAT_GRAYSCALE
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_GRAYSCALE_ALPHA

        public static final int IMWRITE_PAM_FORMAT_GRAYSCALE_ALPHA
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_RGB

        public static final int IMWRITE_PAM_FORMAT_RGB
        另请参见
        常量字段值
      • IMWRITE_PAM_FORMAT_RGB_ALPHA

        public static final int IMWRITE_PAM_FORMAT_RGB_ALPHA
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY_DEFAULT

        public static final int IMWRITE_PNG_STRATEGY_DEFAULT
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY_FILTERED

        public static final int IMWRITE_PNG_STRATEGY_FILTERED
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY_HUFFMAN_ONLY

        public static final int IMWRITE_PNG_STRATEGY_HUFFMAN_ONLY
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY_RLE

        public static final int IMWRITE_PNG_STRATEGY_RLE
        另请参见
        常量字段值
      • IMWRITE_PNG_STRATEGY_FIXED

        public static final int IMWRITE_PNG_STRATEGY_FIXED
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_NONE

        public static final int IMWRITE_TIFF_COMPRESSION_NONE
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITTRLE

        public static final int IMWRITE_TIFF_COMPRESSION_CCITTRLE
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITTFAX3

        public static final int IMWRITE_TIFF_COMPRESSION_CCITTFAX3
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITT_T4

        public static final int IMWRITE_TIFF_COMPRESSION_CCITT_T4
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITTFAX4

        public static final int IMWRITE_TIFF_COMPRESSION_CCITTFAX4
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITT_T6

        public static final int IMWRITE_TIFF_COMPRESSION_CCITT_T6
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_LZW

        public static final int IMWRITE_TIFF_COMPRESSION_LZW
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_OJPEG

        public static final int IMWRITE_TIFF_COMPRESSION_OJPEG
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_JPEG

        public static final int IMWRITE_TIFF_COMPRESSION_JPEG
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_T85

        public static final int IMWRITE_TIFF_COMPRESSION_T85
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_T43

        public static final int IMWRITE_TIFF_COMPRESSION_T43
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_NEXT

        public static final int IMWRITE_TIFF_COMPRESSION_NEXT
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_CCITTRLEW

        public static final int IMWRITE_TIFF_COMPRESSION_CCITTRLEW
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_PACKBITS

        public static final int IMWRITE_TIFF_COMPRESSION_PACKBITS
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_THUNDERSCAN

        public static final int IMWRITE_TIFF_COMPRESSION_THUNDERSCAN
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_IT8CTPAD

        public static final int IMWRITE_TIFF_COMPRESSION_IT8CTPAD
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_IT8LW

        public static final int IMWRITE_TIFF_COMPRESSION_IT8LW
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_IT8MP

        public static final int IMWRITE_TIFF_COMPRESSION_IT8MP
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_IT8BL

        public static final int IMWRITE_TIFF_COMPRESSION_IT8BL
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_PIXARFILM

        public static final int IMWRITE_TIFF_COMPRESSION_PIXARFILM
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_PIXARLOG

        public static final int IMWRITE_TIFF_COMPRESSION_PIXARLOG
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_DEFLATE

        public static final int IMWRITE_TIFF_COMPRESSION_DEFLATE
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_ADOBE_DEFLATE

        public static final int IMWRITE_TIFF_COMPRESSION_ADOBE_DEFLATE
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_DCS

        public static final int IMWRITE_TIFF_COMPRESSION_DCS
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_JBIG

        public static final int IMWRITE_TIFF_COMPRESSION_JBIG
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_SGILOG

        public static final int IMWRITE_TIFF_COMPRESSION_SGILOG
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_SGILOG24

        public static final int IMWRITE_TIFF_COMPRESSION_SGILOG24
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_JP2000

        public static final int IMWRITE_TIFF_COMPRESSION_JP2000
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_LERC

        public static final int IMWRITE_TIFF_COMPRESSION_LERC
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_LZMA

        public static final int IMWRITE_TIFF_COMPRESSION_LZMA
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_ZSTD

        public static final int IMWRITE_TIFF_COMPRESSION_ZSTD
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_WEBP

        public static final int IMWRITE_TIFF_COMPRESSION_WEBP
        另请参见
        常量字段值
      • IMWRITE_TIFF_COMPRESSION_JXL

        public static final int IMWRITE_TIFF_COMPRESSION_JXL
        另请参见
        常量字段值
      • IMWRITE_TIFF_PREDICTOR_NONE

        public static final int IMWRITE_TIFF_PREDICTOR_NONE
        另请参见
        常量字段值
      • IMWRITE_TIFF_PREDICTOR_HORIZONTAL

        public static final int IMWRITE_TIFF_PREDICTOR_HORIZONTAL
        另请参见
        常量字段值
      • IMWRITE_TIFF_PREDICTOR_FLOATINGPOINT

        public static final int IMWRITE_TIFF_PREDICTOR_FLOATINGPOINT
        另请参见
        常量字段值
    • 构造函数详情

      • Imgcodecs

        public Imgcodecs()
    • 方法详情

      • imread

        public static Mat imread​(java.lang.String filename,
                                 int flags)
        从文件中加载图像。imread imread 函数从指定文件加载图像并返回 OpenCV 矩阵。如果无法读取图像(由于文件丢失、权限不足或格式不受支持/无效),则该函数将返回一个空矩阵。目前,支持以下文件格式:
        • Windows 位图 - \*.bmp, \*.dib(始终支持)
        • GIF 文件 - \*.gif(始终支持)
        • JPEG 文件 - \*.jpeg, \*.jpg, \*.jpe(参见“注意”部分)
        • JPEG 2000 文件 - \*.jp2(参见“注意”部分)
        • 便携式网络图形 - \*.png(参见“注意”部分)
        • WebP - \*.webp(参见“注意”部分)
        • AVIF - \*.avif(参见“注意”部分)
        • 便携式图像格式 - \*.pbm, \*.pgm, \*.ppm, \*.pxm, \*.pnm(始终支持)
        • PFM 文件 - \*.pfm(参见“注意”部分)
        • Sun 光栅 - \*.sr, \*.ras(始终支持)
        • TIFF 文件 - \*.tiff, \*.tif(参见“注意”部分)
        • OpenEXR 图像文件 - \*.exr(参见“注意”部分)
        • Radiance HDR - \*.hdr, \*.pic(始终支持)
        • GDAL 支持的栅格和矢量地理空间数据(参见“注意”部分)
        注意
        • 该函数通过其内容而不是文件扩展名来确定图像类型。
        • 对于彩色图像,解码后的图像的通道将以B G R顺序存储。
        • 使用 IMREAD_GRAYSCALE 时,如果可用,将使用编解码器的内部灰度转换。结果可能与 cvtColor() 的输出不同。
        • 在 Microsoft Windows\* 和 Mac OS\* 上,默认情况下使用 OpenCV 附带的编解码器(libjpeg、libpng、libtiff 和 libjasper)。因此,OpenCV 始终可以读取 JPEG、PNG 和 TIFF。在 Mac OS 上,还可以选择使用本机 Mac OS 图像读取器。但是,请注意,由于嵌入在 Mac OS 中的颜色管理,这些本机图像加载器当前生成的图像像素值不同。
        • 在 Linux\*、BSD 版本和其他类 Unix 开放源代码操作系统上,OpenCV 查找操作系统提供的编解码器。确保安装了相关的软件包(包括开发文件,例如 Debian\* 和 Ubuntu\* 中的“libjpeg-dev”)以获得编解码器支持,或者在 CMake 中打开 OPENCV_BUILD_3RDPARTY_LIBS 标志。
        • 如果在 CMake 中将 *WITH_GDAL* 标志设置为 true 并使用 REF: IMREAD_LOAD_GDAL 加载图像,则将使用 [GDAL](http://www.gdal.org) 驱动程序解码图像,支持 [栅格](http://www.gdal.org/formats_list.html) 和 [矢量](http://www.gdal.org/ogr_formats.html) 格式。
        • 如果 EXIF 信息嵌入在图像文件中,则将考虑 EXIF 方向,因此图像将相应旋转,除非传递标志 REF: IMREAD_IGNORE_ORIENTATION 或 REF: IMREAD_UNCHANGED。
        • 使用 IMREAD_UNCHANGED 标志保留 PFM 图像中的浮点值。
        • 默认情况下,像素数量必须小于 2^30。可以通过设置环境变量 OPENCV_IO_MAX_IMAGE_PIXELS 来更改此限制。参见 REF: tutorial_env_reference。
        参数
        filename - 要加载的文件名。
        flags - 可以取 cv::ImreadModes 值的标志。
        返回值
        自动生成
      • imread

        public static Mat imread​(java.lang.String filename)
        从文件中加载图像。imread imread 函数从指定文件加载图像并返回 OpenCV 矩阵。如果无法读取图像(由于文件丢失、权限不足或格式不受支持/无效),则该函数将返回一个空矩阵。目前,支持以下文件格式:
        • Windows 位图 - \*.bmp, \*.dib(始终支持)
        • GIF 文件 - \*.gif(始终支持)
        • JPEG 文件 - \*.jpeg, \*.jpg, \*.jpe(参见“注意”部分)
        • JPEG 2000 文件 - \*.jp2(参见“注意”部分)
        • 便携式网络图形 - \*.png(参见“注意”部分)
        • WebP - \*.webp(参见“注意”部分)
        • AVIF - \*.avif(参见“注意”部分)
        • 便携式图像格式 - \*.pbm, \*.pgm, \*.ppm, \*.pxm, \*.pnm(始终支持)
        • PFM 文件 - \*.pfm(参见“注意”部分)
        • Sun 光栅 - \*.sr, \*.ras(始终支持)
        • TIFF 文件 - \*.tiff, \*.tif(参见“注意”部分)
        • OpenEXR 图像文件 - \*.exr(参见“注意”部分)
        • Radiance HDR - \*.hdr, \*.pic(始终支持)
        • GDAL 支持的栅格和矢量地理空间数据(参见“注意”部分)
        注意
        • 该函数通过其内容而不是文件扩展名来确定图像类型。
        • 对于彩色图像,解码后的图像的通道将以B G R顺序存储。
        • 使用 IMREAD_GRAYSCALE 时,如果可用,将使用编解码器的内部灰度转换。结果可能与 cvtColor() 的输出不同。
        • 在 Microsoft Windows\* 和 Mac OS\* 上,默认情况下使用 OpenCV 附带的编解码器(libjpeg、libpng、libtiff 和 libjasper)。因此,OpenCV 始终可以读取 JPEG、PNG 和 TIFF。在 Mac OS 上,还可以选择使用本机 Mac OS 图像读取器。但是,请注意,由于嵌入在 Mac OS 中的颜色管理,这些本机图像加载器当前生成的图像像素值不同。
        • 在 Linux\*、BSD 版本和其他类 Unix 开放源代码操作系统上,OpenCV 查找操作系统提供的编解码器。确保安装了相关的软件包(包括开发文件,例如 Debian\* 和 Ubuntu\* 中的“libjpeg-dev”)以获得编解码器支持,或者在 CMake 中打开 OPENCV_BUILD_3RDPARTY_LIBS 标志。
        • 如果在 CMake 中将 *WITH_GDAL* 标志设置为 true 并使用 REF: IMREAD_LOAD_GDAL 加载图像,则将使用 [GDAL](http://www.gdal.org) 驱动程序解码图像,支持 [栅格](http://www.gdal.org/formats_list.html) 和 [矢量](http://www.gdal.org/ogr_formats.html) 格式。
        • 如果 EXIF 信息嵌入在图像文件中,则将考虑 EXIF 方向,因此图像将相应旋转,除非传递标志 REF: IMREAD_IGNORE_ORIENTATION 或 REF: IMREAD_UNCHANGED。
        • 使用 IMREAD_UNCHANGED 标志保留 PFM 图像中的浮点值。
        • 默认情况下,像素数量必须小于 2^30。可以通过设置环境变量 OPENCV_IO_MAX_IMAGE_PIXELS 来更改此限制。参见 REF: tutorial_env_reference。
        参数
        filename - 要加载的文件名。
        返回值
        自动生成
      • imread

        public static void imread​(java.lang.String filename,
                                  Mat dst,
                                  int flags)
        从文件加载图像。这是一个重载的成员函数,为了方便提供。它与上述函数的不同之处仅在于它接受的参数和返回值。
        参数
        filename - 要加载的文件名。
        dst - 将加载图像的对象。
        flags - 可以取 cv::ImreadModes 值的标志 **注意:** 通过 img 参数传递的图像可以预先分配。如果形状和类型与加载的图像匹配,则内存将被重用。
      • imread

        public static void imread​(java.lang.String filename,
                                  Mat dst)
        从文件加载图像。这是一个重载的成员函数,为了方便提供。它与上述函数的不同之处仅在于它接受的参数和返回值。
        参数
        filename - 要加载的文件名。
        dst - 将加载图像的对象。 **注意:** 通过 img 参数传递的图像可以预先分配。如果形状和类型与加载的图像匹配,则内存将被重用。
      • imreadmulti

        public static boolean imreadmulti​(java.lang.String filename,
                                          java.util.List<Mat> mats,
                                          int flags)
        从文件中加载多页图像。imreadmulti 函数将多页图像从指定文件加载到 Mat 对象的向量中。
        参数
        filename - 要加载的文件名。
        mats - 包含每个页面的 Mat 对象向量。
        flags - 标志,可以取 cv::ImreadModes 的值,默认为 cv::IMREAD_ANYCOLOR。参见:cv::imread
        返回值
        自动生成
      • imreadmulti

        public static boolean imreadmulti​(java.lang.String filename,
                                          java.util.List<Mat> mats)
        从文件中加载多页图像。imreadmulti 函数将多页图像从指定文件加载到 Mat 对象的向量中。
        参数
        filename - 要加载的文件名。
        mats - 包含每个页面的 Mat 对象向量。参见:cv::imread
        返回值
        自动生成
      • imreadmulti

        public static boolean imreadmulti​(java.lang.String filename,
                                          java.util.List<Mat> mats,
                                          int start,
                                          int count,
                                          int flags)
        从文件中加载多页图像的图像。imreadmulti 函数将指定文件中多页图像的指定范围加载到 Mat 对象向量中。
        参数
        filename - 要加载的文件名。
        mats - 包含每个页面的 Mat 对象向量。
        start - 要加载的图像的起始索引
        count - 要加载的图像数量
        flags - 标志,可以取 cv::ImreadModes 的值,默认为 cv::IMREAD_ANYCOLOR。参见:cv::imread
        返回值
        自动生成
      • imreadmulti

        public static boolean imreadmulti​(java.lang.String filename,
                                          java.util.List<Mat> mats,
                                          int start,
                                          int count)
        从文件中加载多页图像的图像。imreadmulti 函数将指定文件中多页图像的指定范围加载到 Mat 对象向量中。
        参数
        filename - 要加载的文件名。
        mats - 包含每个页面的 Mat 对象向量。
        start - 要加载的图像的起始索引
        count - 要加载的图像数量 参见:cv::imread
        返回值
        自动生成
      • imreadanimation

        public static boolean imreadanimation​(java.lang.String filename,
                                              Animation animation,
                                              int start,
                                              int count)
        将动画图像文件的帧加载到 Animation 结构中。imreadanimation 函数将动画图像文件(例如 GIF、AVIF、APNG、WEBP)中的帧加载到提供的 Animation 结构中。
        参数
        filename - 包含文件路径的字符串。
        animation - 对 Animation 结构的引用,加载的帧将存储在此结构中。在调用此函数之前应进行初始化。
        start - 要加载的第一帧的索引。这是可选的,默认为 0。
        count - 要加载的帧数。这是可选的,默认为 32767。
        返回值
        如果文件成功加载并提取了帧,则返回 true;否则返回 false。
      • imreadanimation

        public static boolean imreadanimation​(java.lang.String filename,
                                              Animation animation,
                                              int start)
        将动画图像文件的帧加载到 Animation 结构中。imreadanimation 函数将动画图像文件(例如 GIF、AVIF、APNG、WEBP)中的帧加载到提供的 Animation 结构中。
        参数
        filename - 包含文件路径的字符串。
        animation - 对 Animation 结构的引用,加载的帧将存储在此结构中。在调用此函数之前应进行初始化。
        start - 要加载的第一帧的索引。这是可选的,默认为 0。
        返回值
        如果文件成功加载并提取了帧,则返回 true;否则返回 false。
      • imreadanimation

        public static boolean imreadanimation​(java.lang.String filename,
                                              Animation animation)
        将动画图像文件的帧加载到 Animation 结构中。imreadanimation 函数将动画图像文件(例如 GIF、AVIF、APNG、WEBP)中的帧加载到提供的 Animation 结构中。
        参数
        filename - 包含文件路径的字符串。
        animation - 对 Animation 结构的引用,加载的帧将存储在此结构中。在调用此函数之前应进行初始化。
        返回值
        如果文件成功加载并提取了帧,则返回 true;否则返回 false。
      • imwriteanimation

        public static boolean imwriteanimation​(java.lang.String filename,
                                               Animation animation,
                                               MatOfInt params)
        将动画保存到指定文件。imwriteanimation 函数将提供的 Animation 数据保存到指定文件中,采用动画格式。支持的格式取决于实现,可能包括 GIF、AVIF、APNG 或 WEBP 等格式。
        参数
        filename - 要保存动画的文件名。文件扩展名决定格式。
        animation - 对 Animation 结构的常量引用,其中包含要保存的帧和元数据。
        params - 可选的特定于格式的参数,编码为对 (paramId_1, paramValue_1, paramId_2, paramValue_2, ...)。这些参数用于指定编码过程的附加选项。有关可能的参数详细信息,请参阅 cv::ImwriteFlags
        返回值
        如果动画成功保存,则返回 true;否则返回 false。
      • imwriteanimation

        public static boolean imwriteanimation​(java.lang.String filename,
                                               Animation animation)
        将动画保存到指定文件。imwriteanimation 函数将提供的 Animation 数据保存到指定文件中,采用动画格式。支持的格式取决于实现,可能包括 GIF、AVIF、APNG 或 WEBP 等格式。
        参数
        filename - 要保存动画的文件名。文件扩展名决定格式。
        animation - 对 Animation 结构的常量引用,其中包含要保存的帧和元数据。这些参数用于指定编码过程的附加选项。有关可能的参数详细信息,请参阅 cv::ImwriteFlags
        返回值
        如果动画成功保存,则返回 true;否则返回 false。
      • imcount

        public static long imcount​(java.lang.String filename,
                                   int flags)
        返回给定文件内图像的数量。imcount 函数返回多页图像(例如 TIFF)中的页数、动画(例如 AVIF)中的帧数,否则返回 1。如果无法解码图像,则返回 0。
        参数
        filename - 要加载的文件名。
        flags - 标志,可以取 cv::ImreadModes 的值,默认为 cv::IMREAD_ANYCOLOR。TODO:当使用 cv::IMREAD_LOAD_GDAL 标志时,返回值将为 0 或 1,因为 OpenCV 的 GDAL 解码器尚不支持多页读取。
        返回值
        自动生成
      • imcount

        public static long imcount​(java.lang.String filename)
        返回给定文件内图像的数量。imcount 函数返回多页图像(例如 TIFF)中的页数、动画(例如 AVIF)中的帧数,否则返回 1。如果无法解码图像,则返回 0。
        参数
        filename - 要加载的文件名。TODO:当使用 cv::IMREAD_LOAD_GDAL 标志时,返回值将为 0 或 1,因为 OpenCV 的 GDAL 解码器尚不支持多页读取。
        返回值
        自动生成
      • imwrite

        public static boolean imwrite​(java.lang.String filename,
                                      Mat img,
                                      MatOfInt params)
        将图像保存到指定文件。imwrite 函数将图像保存到指定文件。图像格式根据文件名扩展名选择(有关扩展名列表,请参见 cv::imread)。通常,只能使用此函数保存 8 位无符号 (CV_8U) 单通道或 3 通道(通道顺序为“BGR”)图像,但以下情况例外:
        • 使用 OpenEXR 编码器,只能保存 32 位浮点 (CV_32F) 图像。
          • 不支持 8 位无符号 (CV_8U) 图像。
        • 使用 Radiance HDR 编码器,可以保存非 64 位浮点 (CV_64F) 图像。
          • 所有图像都将转换为 32 位浮点 (CV_32F)。
        • 使用 JPEG 2000 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 JPEG XL 编码器,可以保存 8 位无符号 (CV_8U)、16 位无符号 (CV_16U) 和 32 位浮点 (CV_32F) 图像。
          • 可以使用此函数保存具有 alpha 通道的 JPEG XL 图像。为此,请创建 8 位(或 16 位、32 位浮点)4 通道图像 BGRA,其中 alpha 通道位于最后。完全透明的像素的 alpha 值应设置为 0,完全不透明的像素的 alpha 值应设置为 255/65535/1.0。
        • 使用 PAM 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 PNG 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
          • 可以使用此函数保存具有 alpha 通道的 PNG 图像。为此,请创建 8 位(或 16 位)4 通道图像 BGRA,其中 alpha 通道位于最后。完全透明的像素的 alpha 值应设置为 0,完全不透明的像素的 alpha 值应设置为 255/65535(请参见下面的代码示例)。
        • 使用 PGM/PPM 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 TIFF 编码器,可以保存 8 位无符号 (CV_8U)、8 位有符号 (CV_8S)、16 位无符号 (CV_16U)、16 位有符号 (CV_16S)、32 位有符号 (CV_32S)、32 位浮点 (CV_32F) 和 64 位浮点 (CV_64F) 图像。
          • 可以以 TIFF 格式保存多个图像(Mat 向量)(请参见下面的代码示例)。
          • 32 位浮点 3 通道 (CV_32FC3) TIFF 图像将使用 LogLuv 高动态范围编码保存(每个像素 4 字节)
          如果不支持图像格式,则图像将转换为 8 位无符号 (CV_8U) 并以这种方式保存。
        如果格式、深度或通道顺序不同,请使用 Mat::convertTo 和 cv::cvtColor 在保存之前进行转换。或者,使用通用的 FileStorage I/O 函数将图像保存为 XML 或 YAML 格式。下面的示例显示如何创建 BGRA 图像、如何设置自定义压缩参数并将其保存到 PNG 文件。它还演示了如何在 TIFF 文件中保存多个图像:INCLUDE: snippets/imgcodecs_imwrite.cpp
        参数
        filename - 文件名。
        img - (Mat 或 Mat 向量) 要保存的图像或图像。
        params - 作为对编码的特定于格式的参数 (paramId_1, paramValue_1, paramId_2, paramValue_2, ... ) 参见 cv::ImwriteFlags
        返回值
        自动生成
      • imwrite

        public static boolean imwrite​(java.lang.String filename,
                                      Mat img)
        将图像保存到指定文件。imwrite 函数将图像保存到指定文件。图像格式根据文件名扩展名选择(有关扩展名列表,请参见 cv::imread)。通常,只能使用此函数保存 8 位无符号 (CV_8U) 单通道或 3 通道(通道顺序为“BGR”)图像,但以下情况例外:
        • 使用 OpenEXR 编码器,只能保存 32 位浮点 (CV_32F) 图像。
          • 不支持 8 位无符号 (CV_8U) 图像。
        • 使用 Radiance HDR 编码器,可以保存非 64 位浮点 (CV_64F) 图像。
          • 所有图像都将转换为 32 位浮点 (CV_32F)。
        • 使用 JPEG 2000 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 JPEG XL 编码器,可以保存 8 位无符号 (CV_8U)、16 位无符号 (CV_16U) 和 32 位浮点 (CV_32F) 图像。
          • 可以使用此函数保存具有 alpha 通道的 JPEG XL 图像。为此,请创建 8 位(或 16 位、32 位浮点)4 通道图像 BGRA,其中 alpha 通道位于最后。完全透明的像素的 alpha 值应设置为 0,完全不透明的像素的 alpha 值应设置为 255/65535/1.0。
        • 使用 PAM 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 PNG 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
          • 可以使用此函数保存具有 alpha 通道的 PNG 图像。为此,请创建 8 位(或 16 位)4 通道图像 BGRA,其中 alpha 通道位于最后。完全透明的像素的 alpha 值应设置为 0,完全不透明的像素的 alpha 值应设置为 255/65535(请参见下面的代码示例)。
        • 使用 PGM/PPM 编码器,可以保存 8 位无符号 (CV_8U) 和 16 位无符号 (CV_16U) 图像。
        • 使用 TIFF 编码器,可以保存 8 位无符号 (CV_8U)、8 位有符号 (CV_8S)、16 位无符号 (CV_16U)、16 位有符号 (CV_16S)、32 位有符号 (CV_32S)、32 位浮点 (CV_32F) 和 64 位浮点 (CV_64F) 图像。
          • 可以以 TIFF 格式保存多个图像(Mat 向量)(请参见下面的代码示例)。
          • 32 位浮点 3 通道 (CV_32FC3) TIFF 图像将使用 LogLuv 高动态范围编码保存(每个像素 4 字节)
          如果不支持图像格式,则图像将转换为 8 位无符号 (CV_8U) 并以这种方式保存。
        如果格式、深度或通道顺序不同,请使用 Mat::convertTo 和 cv::cvtColor 在保存之前进行转换。或者,使用通用的 FileStorage I/O 函数将图像保存为 XML 或 YAML 格式。下面的示例显示如何创建 BGRA 图像、如何设置自定义压缩参数并将其保存到 PNG 文件。它还演示了如何在 TIFF 文件中保存多个图像:INCLUDE: snippets/imgcodecs_imwrite.cpp
        参数
        filename - 文件名。
        img - (Mat 或 Mat 向量) 要保存的图像或图像。
        返回值
        自动生成
      • imwritemulti

        public static boolean imwritemulti​(java.lang.String filename,
                                           java.util.List<Mat> img,
                                           MatOfInt params)
      • imwritemulti

        public static boolean imwritemulti​(java.lang.String filename,
                                           java.util.List<Mat> img)
      • imdecode

        public static Mat imdecode​(Mat buf,
                                   int flags)
        从内存中的缓冲区读取图像。imdecode 函数从内存中指定的缓冲区读取图像。如果缓冲区太短或包含无效数据,则函数将返回空矩阵 (Mat::data==NULL)。有关支持的格式和标志说明,请参见 cv::imread。注意:对于彩色图像,解码后的图像的通道将按B G R顺序存储。
        参数
        buf - 输入字节数组或向量。
        flags - 与 cv::imread 中的标志相同,参见 cv::ImreadModes。
        返回值
        自动生成
      • imdecodemulti

        public static boolean imdecodemulti​(Mat buf,
                                            int flags,
                                            java.util.List<Mat> mats,
                                            Range range)
        从内存中的缓冲区读取多页图像。imdecodemulti 函数从内存中指定的缓冲区读取多页图像。如果缓冲区太短或包含无效数据,则函数将返回 false。有关支持的格式和标志说明,请参见 cv::imreadmulti。注意:对于彩色图像,解码后的图像的通道将按B G R顺序存储。
        参数
        buf - 输入字节数组或向量。
        flags - 与 cv::imread 中的标志相同,参见 cv::ImreadModes。
        mats - 如果有多页,则为包含每个页面的 Mat 对象向量。
        range - 页面的连续选择。
        返回值
        自动生成
      • imdecodemulti

        public static boolean imdecodemulti​(Mat buf,
                                            int flags,
                                            java.util.List<Mat> mats)
        从内存中的缓冲区读取多页图像。imdecodemulti 函数从内存中指定的缓冲区读取多页图像。如果缓冲区太短或包含无效数据,则函数将返回 false。有关支持的格式和标志说明,请参见 cv::imreadmulti。注意:对于彩色图像,解码后的图像的通道将按B G R顺序存储。
        参数
        buf - 输入字节数组或向量。
        flags - 与 cv::imread 中的标志相同,参见 cv::ImreadModes。
        mats - 如果有多页,则为包含每个页面的 Mat 对象向量。
        返回值
        自动生成
      • imencode

        public static boolean imencode​(java.lang.String ext,
                                       Mat img,
                                       MatOfByte buf,
                                       MatOfInt params)
        将图像编码到内存缓冲区中。imencode 函数压缩图像并将其存储在调整大小以适合结果的内存缓冲区中。有关支持的格式和标志说明,请参见 cv::imwrite。
        参数
        ext - 定义输出格式的文件扩展名。必须包含前导句点。
        img - 要压缩的图像。
        buf - 调整大小以适合压缩图像的输出缓冲区。
        params - 格式相关的参数。参见 cv::imwrite 和 cv::ImwriteFlags。
        返回值
        自动生成
      • imencode

        public static boolean imencode​(java.lang.String ext,
                                       Mat img,
                                       MatOfByte buf)
        将图像编码到内存缓冲区中。imencode 函数压缩图像并将其存储在调整大小以适合结果的内存缓冲区中。有关支持的格式和标志说明,请参见 cv::imwrite。
        参数
        ext - 定义输出格式的文件扩展名。必须包含前导句点。
        img - 要压缩的图像。
        buf - 调整大小以适合压缩图像的输出缓冲区。
        返回值
        自动生成
      • imencodemulti

        public static boolean imencodemulti​(java.lang.String ext,
                                            java.util.List<Mat> imgs,
                                            MatOfByte buf,
                                            MatOfInt params)
        将图像数组编码到内存缓冲区中。该函数类似于 cv::imencode,用于内存中多页图像压缩。有关支持的格式和标志说明,请参见 cv::imwrite。
        参数
        ext - 定义输出格式的文件扩展名。必须包含前导句点。
        imgs - 要写入的图像向量。
        buf - 调整大小以适应压缩数据的输出缓冲区。
        params - 格式相关的参数。参见 cv::imwrite 和 cv::ImwriteFlags。
        返回值
        自动生成
      • imencodemulti

        public static boolean imencodemulti​(java.lang.String ext,
                                            java.util.List<Mat> imgs,
                                            MatOfByte buf)
        将图像数组编码到内存缓冲区中。该函数类似于 cv::imencode,用于内存中多页图像压缩。有关支持的格式和标志说明,请参见 cv::imwrite。
        参数
        ext - 定义输出格式的文件扩展名。必须包含前导句点。
        imgs - 要写入的图像向量。
        buf - 调整大小以适应压缩数据的输出缓冲区。
        返回值
        自动生成
      • haveImageReader

        public static boolean haveImageReader​(java.lang.String filename)
        检查OpenCV是否能够解码指定的图像文件。该函数检查OpenCV是否能够读取指定的文件。这对于在尝试加载图像之前验证对给定图像格式的支持非常有用。
        参数
        filename - 要检查的文件名。
        返回值
        如果指定文件的图像读取器可用且文件可以打开,则返回true,否则返回false。注意:该函数检查内置于OpenCV或动态加载的图像编解码器的可用性。它不检查文件的实际存在,而是检查读取指定文件类型的能力。如果无法打开文件或格式不受支持,则该函数将返回false。参见:cv::haveImageWriter,cv::imread,cv::imdecode
      • haveImageWriter

        public static boolean haveImageWriter​(java.lang.String filename)
        检查OpenCV是否能够编码指定的图像文件或指定的扩展名。该函数检查OpenCV是否能够使用指定的文件扩展名写入图像。这对于在尝试保存图像之前验证对给定图像格式的支持非常有用。
        参数
        filename - 文件名或文件扩展名(例如,“.jpg”,“.png”)。建议提供文件扩展名而不是完整的文件名。
        返回值
        如果指定扩展名的图像写入器可用,则返回true,否则返回false。注意:该函数检查内置于OpenCV或动态加载的图像编解码器的可用性。它不检查文件的实际存在,而是检查写入给定类型文件的可能性。参见:cv::haveImageReader,cv::imwrite,cv::imencode