ImageFeatureDescriptor クラス

  • リファレンス

定義

名前空間:
Windows.AI.MachineLearning
編集

モデルが期待するイメージのプロパティについて説明します。

public ref class ImageFeatureDescriptor sealed : ILearningModelFeatureDescriptor
/// [Windows.Foundation.Metadata.ContractVersion(Windows.AI.MachineLearning.MachineLearningContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ImageFeatureDescriptor final : ILearningModelFeatureDescriptor
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.AI.MachineLearning.MachineLearningContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ImageFeatureDescriptor : ILearningModelFeatureDescriptor
Public NotInheritable Class ImageFeatureDescriptor
Implements ILearningModelFeatureDescriptor
継承
Object Platform::Object IInspectable ImageFeatureDescriptor
属性
ContractVersionAttribute MarshalingBehaviorAttribute
実装
ILearningModelFeatureDescriptor

Windows の要件

デバイス ファミリ
Windows 10, version 1809 (10.0.17763.0 で導入)
API contract
Windows.AI.MachineLearning.MachineLearningContract (v1.0 で導入)

例

次の例では、ローカル ファイルからモデルを読み込み、そこからセッションを作成し、入力機能と出力機能を取得します。

private async Task LoadModelAsync(string _modelFileName)
{
    LearningModel _model;
    LearningModelSession _session;
    ImageFeatureDescriptor _inputImageDescription;
    TensorFeatureDescriptor _outputImageDescription;

    try
    {
        // Load and create the model
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
        _model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Create the evaluation session with the model
        _session = new LearningModelSession(_model);

        //Get input and output features of the model
        List<ILearningModelFeatureDescriptor> inputFeatures = _model.InputFeatures.ToList();
        List<ILearningModelFeatureDescriptor> outputFeatures = _model.OutputFeatures.ToList();

        // Retrieve the first input feature which is an image
        _inputImageDescription = inputFeatures.FirstOrDefault(
            feature => feature.Kind == LearningModelFeatureKind.Image) as ImageFeatureDescriptor;

        // Retrieve the first output feature which is a tensor
        _outputImageDescription = outputFeatures.FirstOrDefault(
            feature => feature.Kind == LearningModelFeatureKind.Tensor) as TensorFeatureDescriptor;
    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        _model = null;
    }
}

注釈

Windows Server

Windows Server でこの API を使用するには、Windows Server 2019 とデスクトップ エクスペリエンスを使用する必要があります。

スレッド セーフ

この API はスレッド セーフです。

プロパティ

BitmapAlphaMode

イメージの予想されるアルファ モードを指定します。
BitmapPixelFormat

想定されるピクセル形式 (チャネルの順序付け、ビット深度、データ型) を指定します。
Description

モデルでこの機能が使用される内容の説明。
Height

予想されるイメージの高さ。
IsRequired

true の場合は、 LearningModelSession.Evaluate を呼び出す前に、この機能に値をバインドする必要があります。
Kind

機能の種類 — これを使用して、使用する派生クラスを把握します。
Name

この機能に値をバインドするために使用する名前。
PixelRange

モデルで使用するために必要な LearningModelPixelRange 情報を提供します。
Width

予想されるイメージの幅。

適用対象

こちらもご覧ください