ImageReader.NewInstance 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。