HolisticLandmarker

公开最终类 HolisticLandmarker

对图片执行整体地标检测。

此 API 需要一个预训练的整体地标模型资源包。

嵌套类

类别 HolisticLandmarker.HolisticLandmarkerOptions 用于设置 HolisticLandmarker 的选项。 

公共方法

静态 HolisticLandmarker
createFromBuffer(Context context, ByteBuffer modelAssetBuffer)
根据模型资源包缓冲区和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。
静态 HolisticLandmarker
createFromFile(Context context, String modelAssetPath)
根据模型资源包路径和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。
静态 HolisticLandmarker
createFromFile(Context context, File modelAssetFile)
根据模型资源包文件和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。
静态 HolisticLandmarker
HolisticLandmarkerResult
detectMPImage 图片)
使用默认的图片处理选项(即
HolisticLandmarkerResult
detectMPImage 图片、ImageProcessingOptions imageProcessingOptions)
对提供的单张图片执行整体地标检测。
void
detectAsyncMPImage 图片、ImageProcessingOptions imageProcessingOptions、long timestampMs)
发送实时图像数据以执行整体地标检测,结果将通过 HolisticLandmarker.HolisticLandmarkerOptions 中提供的 OutputHandler.ResultListener 获取。
void
detectAsyncMPImage 图片,长 timestampMs)
发送实时图像数据,以使用默认图像处理选项(即
HolisticLandmarkerResult
detectForVideoMPImage 图片、ImageProcessingOptions imageProcessingOptions、long timestampMs)
对提供的视频帧执行整体地标检测。
HolisticLandmarkerResult
detectForVideoMPImage 图片,长 timestampMs)
使用默认的图片处理选项(即

继承的方法

公共方法

public static HolisticLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)

根据模型资源包缓冲区和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。

参数
context 一个 Android ERROR(/Context)
modelAssetBuffer 检测模型的直接 ByteBufferERROR(/MappedByteBuffer)
抛出
如果 HolisticLandmarker 创建过程中出错,则会发生该错误。

public static HolisticLandmarker createFromFile (Context context, String modelAssetPath)

根据模型资源包路径和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。

参数
context 一个 Android ERROR(/Context)
modelAssetPath 包含资源中元数据的整体地标模型的路径。
抛出
如果 HolisticLandmarker 创建过程中出错,则会发生该错误。

public static HolisticLandmarker createFromFile (Context context, File modelAssetFile)

根据模型资源包文件和默认的 HolisticLandmarker.HolisticLandmarkerOptions 创建 HolisticLandmarker 实例。

参数
context 一个 Android ERROR(/Context)
modelAssetFile 整体地标模型 File 实例。
抛出
IOException 如果在打开 tflite 模型文件时发生 I/O 错误,则会发生该错误。
如果 HolisticLandmarker 创建过程中出错,则会发生该错误。

public static HolisticLandmarker createFromOptions (Context context, HolisticLandmarker.HolisticLandmarkerOptions mappingerOptions)

参数
context 一个 Android ERROR(/Context)
landmarkerOptions 一个 HolisticLandmarker.HolisticLandmarkerOptions 实例。
抛出
如果 HolisticLandmarker 创建过程中出错,则会发生该错误。

public HolisticLandmarkerResult detect MPImage 图片)

使用默认图片处理选项(即未应用任何旋转)对提供的单张图片执行整体地标检测。仅当使用 ERROR(/RunningMode.IMAGE) 创建 HolisticLandmarker 时,才使用此方法。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
抛出
出现内部错误。

public HolisticLandmarkerResult detect MPImage image、ImageProcessingOptions imageProcessingOptions)

对提供的单张图片执行整体地标检测。只有在使用 ERROR(/RunningMode.IMAGE) 创建 HolisticLandmarker 时,才应使用此方法。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
imageProcessingOptions ImageProcessingOptions,用于指定在运行推断之前如何处理输入图片。请注意,此任务支持相关区域:指定 ImageProcessingOptions.regionOfInterest() 会导致此方法抛出 IllegalArgumentException。
抛出
IllegalArgumentException 如果 ImageProcessingOptions 指定了关注区域,则会发生该错误。
出现内部错误。

public void detectAsync (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

发送实时图像数据以执行整体地标检测,结果将通过 HolisticLandmarker.HolisticLandmarkerOptions 中提供的 OutputHandler.ResultListener 获取。仅当使用 ERROR(/RunningMode.LIVE_STREAM) 创建 HolisticLandmarker 时,才使用此方法。

必须提供时间戳(以毫秒为单位),以指明输入图片何时发送到整体地标。输入时间戳必须单调递增。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
imageProcessingOptions ImageProcessingOptions,用于指定在运行推断之前如何处理输入图片。请注意,此任务支持相关区域:指定 ImageProcessingOptions.regionOfInterest() 会导致此方法抛出 IllegalArgumentException。
timestampMs 输入时间戳(以毫秒为单位)。
抛出
IllegalArgumentException 如果 ImageProcessingOptions 指定了关注区域,则会发生该错误。
出现内部错误。

public void detectAsync (MPImage image, long timestampMs)

发送实时图片数据,以使用默认的图片处理选项(即不应用任何旋转)执行整体地标检测,并且结果将通过 HolisticLandmarker.HolisticLandmarkerOptions 中提供的 OutputHandler.ResultListener 获取。只有在使用 ERROR(/RunningMode.LIVE_STREAM) 创建 HolisticLandmarker 时,才应使用此方法。

必须提供时间戳(以毫秒为单位),以指明输入图片何时发送到整体地标。输入时间戳必须单调递增。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
timestampMs 输入时间戳(以毫秒为单位)。
抛出
出现内部错误。

public HolisticLandmarkerResult detectForVideo MPImage image、ImageProcessingOptions imageProcessingOptions, long timestampMs)

对提供的视频帧执行整体地标检测。只有在使用 ERROR(/RunningMode.VIDEO) 创建 HolisticLandmarker 时,才应使用此方法。

必须提供视频帧的时间戳(以毫秒为单位)。输入时间戳必须单调递增。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
imageProcessingOptions ImageProcessingOptions,用于指定在运行推断之前如何处理输入图片。请注意,此任务支持相关区域:指定 ImageProcessingOptions.regionOfInterest() 会导致此方法抛出 IllegalArgumentException。
timestampMs 输入时间戳(以毫秒为单位)。
抛出
IllegalArgumentException 如果 ImageProcessingOptions 指定了关注区域,则会发生该错误。
出现内部错误。

public HolisticLandmarkerResult detectForVideo MPImage 图片,长 timestampMs)

使用默认的图片处理选项(即不应用任何旋转)对提供的视频帧执行整体地标检测。仅当使用 ERROR(/RunningMode.VIDEO) 创建 HolisticLandmarker 时,才使用此方法。

必须提供视频帧的时间戳(以毫秒为单位)。输入时间戳必须单调递增。

HolisticLandmarker 支持以下颜色空间类型:

参数
图片 用于处理的 MediaPipe MPImage 对象。
timestampMs 输入时间戳(以毫秒为单位)。
抛出
出现内部错误。