PerceptionColorFrameSource 类

定义

提供颜色帧的帧源。

public ref class PerceptionColorFrameSource sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PerceptionColorFrameSource final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Deprecated("PerceptionColorFrameSource may be unavailable after Windows Creator Update.  Use Windows.Media.Frames.MediaFrameSource instead.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
class PerceptionColorFrameSource final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class PerceptionColorFrameSource
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Deprecated("PerceptionColorFrameSource may be unavailable after Windows Creator Update.  Use Windows.Media.Frames.MediaFrameSource instead.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
public sealed class PerceptionColorFrameSource
Public NotInheritable Class PerceptionColorFrameSource
继承
Object Platform::Object IInspectable PerceptionColorFrameSource
属性

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

版本历史记录

Windows 版本 SDK 版本 已添加值
1511 10586 DeviceId

属性

Active

获取一个布尔值,该值指示源是否处于活动状态。

Available

获取一个布尔值,该值指示源是否可用。

AvailableVideoProfiles

获取当前可从颜色帧源获取的视频配置文件的只读集合。

CameraIntrinsics

获取一个 CameraIntrinsics 值,该值指定色帧源相机设备的内部属性。

DeviceId

获取一个字符串值,该值标识系统上的设备。

DeviceKind

获取一个字符串值,该值指示为此源生成颜色帧的物理设备的类型。

DisplayName

获取一个字符串值,该值指示颜色帧源的显示名称。

Id

获取一个字符串值,该值指示颜色帧源的唯一 ID。

IsControlled

获取一个布尔值,该值指示源是否是控制器模式的主题。

Properties

获取帧源属性的只读集合。

SupportedVideoProfiles

获取颜色帧源支持的视频配置文件的只读集合。

VideoProfile

获取指示当前视频配置文件的 PerceptionVideoProfile 对象。

方法

AcquireControlSession()

尝试获取颜色帧源上的控制器模式。

CanControlIndependentlyFrom(String)

此方法返回一个布尔值,该值指示是否可以从另一个帧源单独控制颜色帧源。

CreateWatcher()

创建新的颜色帧源观察程序。

FindAllAsync()

查找所有颜色帧源。

FromIdAsync(String)

通过查找颜色帧源的唯一 ID 来查找颜色帧源。

IsCorrelatedWith(String)

检查颜色帧源是否与目标实体相关联。 如果结果为 true,则可以检索转换矩阵,以将坐标基从此颜色帧源更改为实体,反之亦然。

OpenReader()

获取从此颜色帧源读取帧的帧读取器。

RequestAccessAsync()

请求访问以使用颜色框架源。

TryGetDepthCorrelatedCameraIntrinsicsAsync(PerceptionDepthFrameSource)

尝试获取与该颜色源相关的深度相机的内部属性。

TryGetDepthCorrelatedCoordinateMapperAsync(String, PerceptionDepthFrameSource)

尝试获取从色框图像空间映射到深度帧空间的坐标映射器。

TryGetTransformTo(String, Matrix4x4)

此方法返回从颜色帧源到目标实体的转换,并将 hasResult 设置为 true(如果存在关联)。 如果相关性不存在,hasResult 设置为 false 且不修改 result。

TrySetVideoProfileAsync(PerceptionControlSession, PerceptionVideoProfile)

尝试在此颜色帧源上设置视频配置文件。 需要此帧源上的活动控制器模式控制会话。

事件

ActiveChanged

订阅 ActiveChanged 事件。

AvailableChanged

订阅 AvailableChanged 事件。

CameraIntrinsicsChanged

订阅 CameraIntrinsicsChanged 事件。

PropertiesChanged

订阅 PropertiesChanged 事件。

VideoProfileChanged

订阅 VideoProfileChanged 事件。

适用于