语言

ImageReader.NewInstance 方法

定义

重载

名称 说明
NewInstance(Int32, Int32, ImageFormatType, Int32)

为所需大小和格式的图像创建新的读取器。

NewInstance(Int32, Int32, ImageFormatType, Int32, Int64)

为所需大小、格式和使用者使用标志的图像创建新的读取器。

NewInstance(Int32, Int32, ImageFormatType, Int32)

为所需大小和格式的图像创建新的读取器。

[Android.Runtime.Register("newInstance", "(IIII)Landroid/media/ImageReader;", "")]
public static Android.Media.ImageReader NewInstance(int width, int height, Android.Graphics.ImageFormatType format, int maxImages);
[<Android.Runtime.Register("newInstance", "(IIII)Landroid/media/ImageReader;", "")>]
static member NewInstance : int * int * Android.Graphics.ImageFormatType * int -> Android.Media.ImageReader

参数

width
Int32

此读取器将生成的图像的默认宽度(以像素为单位)。

height
Int32

此读取器将生成的图像的默认高度(以像素为单位)。

format
ImageFormatType

此读取器将生成的图像的格式。 这必须是其中 android.graphics.ImageFormat 一个或 android.graphics.PixelFormat 常量。 请注意,并非所有格式都受支持,如 ImageFormat.NV21。

maxImages
Int32

用户希望同时访问的最大图像数。 这应该尽可能小,以限制内存使用。 用户获取 maxImages 映像后,必须先释放其中一个映像,然后才能通过 #acquireLatestImage() 或 #acquireNextImage()访问新的映像。 必须大于 0。

返回

使用请求的维度、图像格式和最大获取的图像计数初始化的读取器。

特性

注解

为所需大小和格式的图像创建新的读取器。

该maxImages参数确定可从同时获取Image的最大对象数ImageReader。 请求更多缓冲区会占用更多内存,因此请务必仅使用用例所需的最小数目。

有效大小和格式取决于图像数据的源。

format ImageFormat#PRIVATE PRIVATE如果是,则创建ImageReader后将生成应用程序无法直接访问的映像。 应用程序仍可以从中 ImageReader获取图像,并通过接口将其发送到 android.hardware.camera2.CameraDevice camera 重新处理 ImageWriter 。 但是, Image#getPlanes() getPlanes() 将返回格式图像的 ImageFormat#PRIVATE PRIVATE 空数组。 应用程序可以通过调用 #getImageFormat()来检查现有读取器的格式。

ImageFormat#PRIVATE PRIVATE与使用其他格式(例如ImageFormat#YUV_420_888 YUV_420_888)的 ImageReaders 相比,当应用程序访问图像数据时,格式ImageReader ImageReaders更加高效。

Java文档android.media.ImageReader.newInstance(int, int, int, int)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

另请参阅

适用于

NewInstance(Int32, Int32, ImageFormatType, Int32, Int64)

为所需大小、格式和使用者使用标志的图像创建新的读取器。

[Android.Runtime.Register("newInstance", "(IIIIJ)Landroid/media/ImageReader;", "", ApiSince=29)]
public static Android.Media.ImageReader NewInstance(int width, int height, Android.Graphics.ImageFormatType format, int maxImages, long usage);
[<Android.Runtime.Register("newInstance", "(IIIIJ)Landroid/media/ImageReader;", "", ApiSince=29)>]
static member NewInstance : int * int * Android.Graphics.ImageFormatType * int * int64 -> Android.Media.ImageReader

参数

width
Int32

此读取器将生成的图像的默认宽度(以像素为单位)。

height
Int32

此读取器将生成的图像的默认高度(以像素为单位)。

format
ImageFormatType

此读取器将生成的图像的格式。 这必须是其中 android.graphics.ImageFormat 一个或 android.graphics.PixelFormat 常量。 请注意,并非所有格式都受支持,如 ImageFormat.NV21。

maxImages
Int32

用户希望同时访问的最大图像数。 这应该尽可能小,以限制内存使用。 用户获取 maxImages 映像后,必须先释放其中一个映像,然后才能通过 #acquireLatestImage() 或 #acquireNextImage()访问新的映像。 必须大于 0。

usage
Int64

此 ImageReader 生成的映像的预期用法。 有关有效使用位的列表,请参阅其上的 HardwareBuffer 用法。 另 HardwareBuffer#isSupported(int, int, int, int, long) 请参阅检查是否支持组合。 如果不支持,则会引发一个 IllegalArgumentException。

返回

使用请求的维度、图像格式、最大获取的图像计数和缓冲区使用标志初始化的读取器。

特性

注解

为所需大小、格式和使用者使用标志的图像创建新的读取器。

该maxImages参数确定可从同时获取Image的最大对象数ImageReader。 请求更多缓冲区会占用更多内存,因此请务必仅使用用例所需的最小数目。

有效大小和格式取决于图像数据的源。

格式和用法标志组合描述使用者终结点如何使用缓冲区。 例如,如果应用程序打算将图像 android.media.MediaCodec 发送到硬件视频编码或 android.media.MediaRecorder 用于硬件视频编码,则格式和用法标志组合需要是 ImageFormat#PRIVATE PRIVATE 和 HardwareBuffer#USAGE_VIDEO_ENCODE。 ImageReader使用有效大小和此类格式/用法标志组合创建对象时,应用程序可以向使用或Image imagesImageWriter提供的输入android.view.Surface创建的对象发送android.media.MediaCodecandroid.media.MediaRecorder该对象。

format ImageFormat#PRIVATE PRIVATE如果是,则创建ImageReader后将生成应用程序无法直接访问的映像。 应用程序仍然可以从中ImageReader获取图像,并将其发送到重新处理,或通过接口将其发送到android.hardware.camera2.CameraDevice cameraandroid.media.MediaCodec / android.media.MediaRecorder硬件视频编码。ImageWriter 但是, Image#getPlanes() getPlanes() 将返回格式图像的 ImageFormat#PRIVATE PRIVATE 空数组。 应用程序可以通过调用 #getImageFormat()来检查现有读取器的格式。

ImageFormat#PRIVATE PRIVATE与使用其他格式(例如ImageFormat#YUV_420_888 YUV_420_888)的 ImageReaders 相比,当应用程序访问图像数据时,格式ImageReader ImageReaders更加高效。

请注意,并非所有格式和用法标志组合都受 ImageReader此支持。 下面是受支持的组合 ImageReader (假设使用者终结点支持此类图像消耗,例如硬件视频编码)。 <table><tr><th>Format</>><th Compatible usage flags</th<>/tr><tr<>td>non-formatsandroid.graphics.ImageFormat#PRIVATE PRIVATE defined by android.graphics.ImageFormat ImageFormat or<android.graphics.PixelFormat PixelFormat /td><td>HardwareBuffer#USAGE_CPU_READ_RARELY 或 HardwareBuffer#USAGE_CPU_READ_OFTEN</td></><tr><td/td td<>td>HardwareBuffer#USAGE_VIDEO_ENCODEandroid.graphics.ImageFormat#PRIVATE>< orHardwareBuffer#USAGE_GPU_SAMPLED_IMAGE, or combined</td<>/tr<>/table> Using other combins IllegalArgumentException 此外,指定 HardwareBuffer#USAGE_CPU_WRITE_RARELY 或 HardwareBuffer#USAGE_CPU_WRITE_OFTEN 写入 ImageReader 缓冲区可能会破坏某些生成者的假设,并且应谨慎使用。

如果用作 ImageReader a 的输出目标,并且使用标志包含android.hardware.camera2.CameraDevice,则生成的HardwareBuffer#USAGE_VIDEO_ENCODE时间戳Image images不会与原ImageReaderandroid.os.SystemClock#elapsedRealtimeNanos样位于同一时间基android.hardware.camera2.CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE。android.hardware.camera2.CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME 相反,时间戳大致与原 android.os.SystemClock#uptimeMillis样,以便 A/V 同步可用于视频录制。 在这种情况下,使用ImageReader标志中的HardwareBuffer#USAGE_VIDEO_ENCODE时间戳可能与其他流的时间戳或捕获结果元数据不直接相提并论。

Java文档android.media.ImageReader.newInstance(int, int, int, int, long)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于