ホーム › AI.MachineLearning.DirectML › DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC

DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC

構造体

サイズx64: 48 バイト / x86: 32 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド	型	サイズ	x64	x86	説明
InputTensor	DML_TENSOR_DESC*	8/4	+0	+0	読み取り元となる入力テンソルです。
OutputTensor	DML_TENSOR_DESC*	8/4	+8	+4	結果を書き込む出力テンソルです。
ScaleBias	DML_SCALE_BIAS*	8/4	+16	+8	入力に適用する省略可能なスケールとバイアスです。指定した場合、この演算子を計算する前に、各入力要素に対して関数 `g(x) = x * scale + bias` を適用する効果があります。
MinMaxDataType	DML_TENSOR_DATA_TYPE	4	+24	+12	Min および Max メンバーのデータ型です。OutputTensor.DataType と一致していなければなりません。
Min	DML_SCALAR_UNION	8	+32	+16	最小値です。この値を下回る値は、演算子によって Min に置き換えられます。このフィールドをどのように解釈するかは MinMaxDataType によって決まります。
Max	DML_SCALAR_UNION	8	+40	+24	最大値です。この値を上回る値は、演算子によって Max に置き換えられます。このフィールドをどのように解釈するかは MinMaxDataType によって決まります。

公式ドキュメント

InputTensor の各要素に対して次の操作を実行し、その結果を OutputTensor の対応する要素に格納します。この演算子は、入力内のすべての要素を閉区間 [Min, Max] にクランプ (制限) します。

f(x) = max(Min, min(x, Max))

ここで max(a,b) は 2 つの値のうち大きい方を返し、min(a,b) は 2 つの値 a,b のうち小さい方を返します。

この演算子はインプレース実行をサポートします。つまり、バインド時に OutputTensor が InputTensor をエイリアスすることが許可されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// DML_SCALAR_UNION  (x64 8 / x86 8 バイト)
typedef struct DML_SCALAR_UNION {
    BYTE Bytes[8];
    CHAR Int8;
    BYTE UInt8;
    SHORT Int16;
    WORD UInt16;
    INT Int32;
    DWORD UInt32;
    LONGLONG Int64;
    ULONGLONG UInt64;
    FLOAT Float32;
    DOUBLE Float64;
} DML_SCALAR_UNION;

// DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC  (x64 48 / x86 32 バイト)
typedef struct DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC {
    DML_TENSOR_DESC* InputTensor;
    DML_TENSOR_DESC* OutputTensor;
    DML_SCALE_BIAS* ScaleBias;
    DML_TENSOR_DATA_TYPE MinMaxDataType;
    DML_SCALAR_UNION Min;
    DML_SCALAR_UNION Max;
} DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_SCALAR_UNION
{
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public byte[] Bytes;
    public sbyte Int8;
    public byte UInt8;
    public short Int16;
    public ushort UInt16;
    public int Int32;
    public uint UInt32;
    public long Int64;
    public ulong UInt64;
    public float Float32;
    public double Float64;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC
{
    public IntPtr InputTensor;
    public IntPtr OutputTensor;
    public IntPtr ScaleBias;
    public int MinMaxDataType;
    public DML_SCALAR_UNION Min;
    public DML_SCALAR_UNION Max;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_SCALAR_UNION
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public Bytes() As Byte
    Public Int8 As SByte
    Public UInt8 As Byte
    Public Int16 As Short
    Public UInt16 As UShort
    Public Int32 As Integer
    Public UInt32 As UInteger
    Public Int64 As Long
    Public UInt64 As ULong
    Public Float32 As Single
    Public Float64 As Double
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC
    Public InputTensor As IntPtr
    Public OutputTensor As IntPtr
    Public ScaleBias As IntPtr
    Public MinMaxDataType As Integer
    Public Min As DML_SCALAR_UNION
    Public Max As DML_SCALAR_UNION
End Structure

import ctypes
from ctypes import wintypes

class DML_SCALAR_UNION(ctypes.Structure):
    _fields_ = [
        ("Bytes", ctypes.c_ubyte * 8),
        ("Int8", ctypes.c_byte),
        ("UInt8", ctypes.c_ubyte),
        ("Int16", ctypes.c_short),
        ("UInt16", ctypes.c_ushort),
        ("Int32", ctypes.c_int),
        ("UInt32", wintypes.DWORD),
        ("Int64", ctypes.c_longlong),
        ("UInt64", ctypes.c_ulonglong),
        ("Float32", ctypes.c_float),
        ("Float64", ctypes.c_double),
    ]

class DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC(ctypes.Structure):
    _fields_ = [
        ("InputTensor", ctypes.c_void_p),
        ("OutputTensor", ctypes.c_void_p),
        ("ScaleBias", ctypes.c_void_p),
        ("MinMaxDataType", ctypes.c_int),
        ("Min", DML_SCALAR_UNION),
        ("Max", DML_SCALAR_UNION),
    ]

#[repr(C)]
pub struct DML_SCALAR_UNION {
    pub Bytes: [u8; 8],
    pub Int8: i8,
    pub UInt8: u8,
    pub Int16: i16,
    pub UInt16: u16,
    pub Int32: i32,
    pub UInt32: u32,
    pub Int64: i64,
    pub UInt64: u64,
    pub Float32: f32,
    pub Float64: f64,
}

#[repr(C)]
pub struct DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC {
    pub InputTensor: *mut core::ffi::c_void,
    pub OutputTensor: *mut core::ffi::c_void,
    pub ScaleBias: *mut core::ffi::c_void,
    pub MinMaxDataType: i32,
    pub Min: DML_SCALAR_UNION,
    pub Max: DML_SCALAR_UNION,
}

import "golang.org/x/sys/windows"

type DML_SCALAR_UNION struct {
	Bytes [8]byte
	Int8 int8
	UInt8 byte
	Int16 int16
	UInt16 uint16
	Int32 int32
	UInt32 uint32
	Int64 int64
	UInt64 uint64
	Float32 float32
	Float64 float64
}

type DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC struct {
	InputTensor uintptr
	OutputTensor uintptr
	ScaleBias uintptr
	MinMaxDataType int32
	Min DML_SCALAR_UNION
	Max DML_SCALAR_UNION
}

type
  DML_SCALAR_UNION = record
    Bytes: array[0..7] of Byte;
    Int8: Shortint;
    UInt8: Byte;
    Int16: Smallint;
    UInt16: Word;
    Int32: Integer;
    UInt32: DWORD;
    Int64: Int64;
    UInt64: UInt64;
    Float32: Single;
    Float64: Double;
  end;

  DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC = record
    InputTensor: Pointer;
    OutputTensor: Pointer;
    ScaleBias: Pointer;
    MinMaxDataType: Integer;
    Min: DML_SCALAR_UNION;
    Max: DML_SCALAR_UNION;
  end;

const DML_SCALAR_UNION = extern struct {
    Bytes: [8]u8,
    Int8: i8,
    UInt8: u8,
    Int16: i16,
    UInt16: u16,
    Int32: i32,
    UInt32: u32,
    Int64: i64,
    UInt64: u64,
    Float32: f32,
    Float64: f64,
};

const DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC = extern struct {
    InputTensor: ?*anyopaque,
    OutputTensor: ?*anyopaque,
    ScaleBias: ?*anyopaque,
    MinMaxDataType: i32,
    Min: DML_SCALAR_UNION,
    Max: DML_SCALAR_UNION,
};

type
  DML_SCALAR_UNION {.bycopy.} = object
    Bytes: array[8, uint8]
    Int8: int8
    UInt8: uint8
    Int16: int16
    UInt16: uint16
    Int32: int32
    UInt32: uint32
    Int64: int64
    UInt64: uint64
    Float32: float32
    Float64: float64

  DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC {.bycopy.} = object
    InputTensor: pointer
    OutputTensor: pointer
    ScaleBias: pointer
    MinMaxDataType: int32
    Min: DML_SCALAR_UNION
    Max: DML_SCALAR_UNION

struct DML_SCALAR_UNION
{
    ubyte[8] Bytes;
    byte Int8;
    ubyte UInt8;
    short Int16;
    ushort UInt16;
    int Int32;
    uint UInt32;
    long Int64;
    ulong UInt64;
    float Float32;
    double Float64;
}

struct DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC
{
    void* InputTensor;
    void* OutputTensor;
    void* ScaleBias;
    int MinMaxDataType;
    DML_SCALAR_UNION Min;
    DML_SCALAR_UNION Max;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ScaleBias : DML_SCALE_BIAS* (+8, 4byte)  varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; MinMaxDataType : DML_TENSOR_DATA_TYPE (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Min : DML_SCALAR_UNION (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; Max : DML_SCALAR_UNION (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; InputTensor : DML_TENSOR_DESC* (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; OutputTensor : DML_TENSOR_DESC* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ScaleBias : DML_SCALE_BIAS* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; MinMaxDataType : DML_TENSOR_DATA_TYPE (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; Min : DML_SCALAR_UNION (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; Max : DML_SCALAR_UNION (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC
    #field intptr InputTensor
    #field intptr OutputTensor
    #field intptr ScaleBias
    #field int MinMaxDataType
    #field byte Min 8
    #field byte Max 8
#endstruct

stdim st, DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC        ; NSTRUCT 変数を確保
st->MinMaxDataType = 100
mes "MinMaxDataType=" + st->MinMaxDataType
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。

DML_ELEMENT_WISE_CLIP1_OPERATOR_DESC

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義