ホーム › Graphics.Direct3D12 › D3D12_RENDER_TARGET_BLEND_DESC

D3D12_RENDER_TARGET_BLEND_DESC

構造体

サイズx64: 40 バイト / x86: 40 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
BlendEnable	BOOL	4	+0	+0	ブレンドを有効にする (または無効にする) かどうかを指定します。ブレンドを有効にするには TRUE を設定します。メモ LogicOpEnable と BlendEnable の両方を TRUE にすることはできません。
LogicOpEnable	BOOL	4	+4	+4	論理演算を有効にする (または無効にする) かどうかを指定します。論理演算を有効にするには TRUE を設定します。メモ LogicOpEnable と BlendEnable の両方を TRUE にすることはできません。
SrcBlend	D3D12_BLEND	4	+8	+8	ピクセルシェーダーが出力する RGB 値に対して実行する演算を指定する D3D12_BLEND 型の値です。BlendOp メンバーは、SrcBlend と DestBlend の演算を組み合わせる方法を定義します。
DestBlend	D3D12_BLEND	4	+12	+12	レンダーターゲット内の現在の RGB 値に対して実行する演算を指定する D3D12_BLEND 型の値です。BlendOp メンバーは、SrcBlend と DestBlend の演算を組み合わせる方法を定義します。
BlendOp	D3D12_BLEND_OP	4	+16	+16	SrcBlend と DestBlend の演算を組み合わせる方法を定義する D3D12_BLEND_OP 型の値です。
SrcBlendAlpha	D3D12_BLEND	4	+20	+20	ピクセルシェーダーが出力するアルファ値に対して実行する演算を指定する D3D12_BLEND 型の値です。_COLOR で終わるブレンドオプションは指定できません。BlendOpAlpha メンバーは、SrcBlendAlpha と DestBlendAlpha の演算を組み合わせる方法を定義します。
DestBlendAlpha	D3D12_BLEND	4	+24	+24	レンダーターゲット内の現在のアルファ値に対して実行する演算を指定する D3D12_BLEND 型の値です。_COLOR で終わるブレンドオプションは指定できません。BlendOpAlpha メンバーは、SrcBlendAlpha と DestBlendAlpha の演算を組み合わせる方法を定義します。
BlendOpAlpha	D3D12_BLEND_OP	4	+28	+28	SrcBlendAlpha と DestBlendAlpha の演算を組み合わせる方法を定義する D3D12_BLEND_OP 型の値です。
LogicOp	D3D12_LOGIC_OP	4	+32	+32	レンダーターゲットに対して構成する論理演算を指定する D3D12_LOGIC_OP 型の値です。
RenderTargetWriteMask	BYTE	1	+36	+36	ビット単位のOR演算で組み合わせた D3D12_COLOR_WRITE_ENABLE 型の値の組み合わせです。結果として得られる値は書き込みマスクを指定します。

公式ドキュメント

レンダーターゲットのブレンド状態を記述します。

解説(Remarks)

メモ

LogicOpEnable と BlendEnable の両方を TRUE にすることはできません。

レンダーターゲットのブレンド状態を記述するには、D3D12_BLEND_DESC 構造体の RenderTarget メンバーに D3D12_RENDER_TARGET_BLEND_DESC 構造体の配列を指定します。出力マージャーステージには、同時に最大 8 つのレンダーターゲットをバインドできます。

ブレンドがどのように行われるかについては、出力マージャーステージを参照してください。

ブレンド状態の既定値は次のとおりです。

状態	既定値
BlendEnable	FALSE
LogicOpEnable	FALSE
SrcBlend	D3D12_BLEND_ONE
DestBlend	D3D12_BLEND_ZERO
BlendOp	D3D12_BLEND_OP_ADD
SrcBlendAlpha	D3D12_BLEND_ONE
DestBlendAlpha	D3D12_BLEND_ZERO
BlendOpAlpha	D3D12_BLEND_OP_ADD
LogicOp	D3D12_LOGIC_OP_NOOP
RenderTargetWriteMask	D3D12_COLOR_WRITE_ENABLE_ALL

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

各言語での定義

#include <windows.h>

// D3D12_RENDER_TARGET_BLEND_DESC  (x64 40 / x86 40 バイト)
typedef struct D3D12_RENDER_TARGET_BLEND_DESC {
    BOOL BlendEnable;
    BOOL LogicOpEnable;
    D3D12_BLEND SrcBlend;
    D3D12_BLEND DestBlend;
    D3D12_BLEND_OP BlendOp;
    D3D12_BLEND SrcBlendAlpha;
    D3D12_BLEND DestBlendAlpha;
    D3D12_BLEND_OP BlendOpAlpha;
    D3D12_LOGIC_OP LogicOp;
    BYTE RenderTargetWriteMask;
} D3D12_RENDER_TARGET_BLEND_DESC;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_RENDER_TARGET_BLEND_DESC
{
    [MarshalAs(UnmanagedType.Bool)] public bool BlendEnable;
    [MarshalAs(UnmanagedType.Bool)] public bool LogicOpEnable;
    public int SrcBlend;
    public int DestBlend;
    public int BlendOp;
    public int SrcBlendAlpha;
    public int DestBlendAlpha;
    public int BlendOpAlpha;
    public int LogicOp;
    public byte RenderTargetWriteMask;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_RENDER_TARGET_BLEND_DESC
    <MarshalAs(UnmanagedType.Bool)> Public BlendEnable As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public LogicOpEnable As Boolean
    Public SrcBlend As Integer
    Public DestBlend As Integer
    Public BlendOp As Integer
    Public SrcBlendAlpha As Integer
    Public DestBlendAlpha As Integer
    Public BlendOpAlpha As Integer
    Public LogicOp As Integer
    Public RenderTargetWriteMask As Byte
End Structure

import ctypes
from ctypes import wintypes

class D3D12_RENDER_TARGET_BLEND_DESC(ctypes.Structure):
    _fields_ = [
        ("BlendEnable", wintypes.BOOL),
        ("LogicOpEnable", wintypes.BOOL),
        ("SrcBlend", ctypes.c_int),
        ("DestBlend", ctypes.c_int),
        ("BlendOp", ctypes.c_int),
        ("SrcBlendAlpha", ctypes.c_int),
        ("DestBlendAlpha", ctypes.c_int),
        ("BlendOpAlpha", ctypes.c_int),
        ("LogicOp", ctypes.c_int),
        ("RenderTargetWriteMask", ctypes.c_ubyte),
    ]

#[repr(C)]
pub struct D3D12_RENDER_TARGET_BLEND_DESC {
    pub BlendEnable: i32,
    pub LogicOpEnable: i32,
    pub SrcBlend: i32,
    pub DestBlend: i32,
    pub BlendOp: i32,
    pub SrcBlendAlpha: i32,
    pub DestBlendAlpha: i32,
    pub BlendOpAlpha: i32,
    pub LogicOp: i32,
    pub RenderTargetWriteMask: u8,
}

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

type D3D12_RENDER_TARGET_BLEND_DESC struct {
	BlendEnable int32
	LogicOpEnable int32
	SrcBlend int32
	DestBlend int32
	BlendOp int32
	SrcBlendAlpha int32
	DestBlendAlpha int32
	BlendOpAlpha int32
	LogicOp int32
	RenderTargetWriteMask byte
}

type
  D3D12_RENDER_TARGET_BLEND_DESC = record
    BlendEnable: BOOL;
    LogicOpEnable: BOOL;
    SrcBlend: Integer;
    DestBlend: Integer;
    BlendOp: Integer;
    SrcBlendAlpha: Integer;
    DestBlendAlpha: Integer;
    BlendOpAlpha: Integer;
    LogicOp: Integer;
    RenderTargetWriteMask: Byte;
  end;

const D3D12_RENDER_TARGET_BLEND_DESC = extern struct {
    BlendEnable: i32,
    LogicOpEnable: i32,
    SrcBlend: i32,
    DestBlend: i32,
    BlendOp: i32,
    SrcBlendAlpha: i32,
    DestBlendAlpha: i32,
    BlendOpAlpha: i32,
    LogicOp: i32,
    RenderTargetWriteMask: u8,
};

type
  D3D12_RENDER_TARGET_BLEND_DESC {.bycopy.} = object
    BlendEnable: int32
    LogicOpEnable: int32
    SrcBlend: int32
    DestBlend: int32
    BlendOp: int32
    SrcBlendAlpha: int32
    DestBlendAlpha: int32
    BlendOpAlpha: int32
    LogicOp: int32
    RenderTargetWriteMask: uint8

struct D3D12_RENDER_TARGET_BLEND_DESC
{
    int BlendEnable;
    int LogicOpEnable;
    int SrcBlend;
    int DestBlend;
    int BlendOp;
    int SrcBlendAlpha;
    int DestBlendAlpha;
    int BlendOpAlpha;
    int LogicOp;
    ubyte RenderTargetWriteMask;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_RENDER_TARGET_BLEND_DESC サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; BlendEnable : BOOL (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; LogicOpEnable : BOOL (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; SrcBlend : D3D12_BLEND (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DestBlend : D3D12_BLEND (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; BlendOp : D3D12_BLEND_OP (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; SrcBlendAlpha : D3D12_BLEND (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; DestBlendAlpha : D3D12_BLEND (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; BlendOpAlpha : D3D12_BLEND_OP (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; LogicOp : D3D12_LOGIC_OP (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; RenderTargetWriteMask : BYTE (+36, 1byte)  poke st,36,値  /  値 = peek(st,36)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global D3D12_RENDER_TARGET_BLEND_DESC
    #field bool BlendEnable
    #field bool LogicOpEnable
    #field int SrcBlend
    #field int DestBlend
    #field int BlendOp
    #field int SrcBlendAlpha
    #field int DestBlendAlpha
    #field int BlendOpAlpha
    #field int LogicOp
    #field byte RenderTargetWriteMask
#endstruct

stdim st, D3D12_RENDER_TARGET_BLEND_DESC        ; NSTRUCT 変数を確保
st->BlendEnable = 100
mes "BlendEnable=" + st->BlendEnable