Win32 API 日本語リファレンス
ホーム › Graphics.Direct3D12 › D3D12_BLEND_DESC

D3D12_BLEND_DESC

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 328 バイト / x86: 328 バイト

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

フィールド

フィールド型サイズx64x86説明
AlphaToCoverageEnableBOOL4+0+0ピクセルをレンダーターゲットに設定する際に、マルチサンプリング手法として alpha-to-coverage を使用するかどうかを指定します。alpha-to-coverage の使用方法の詳細については、Alpha-To-Coverage を参照してください。
IndependentBlendEnableBOOL4+4+4

同時レンダーターゲットで独立したブレンドを有効にするかどうかを指定します。独立したブレンドを有効にするには TRUE を設定します。FALSE を設定した場合、RenderTarget[0] のメンバーのみが使用され、RenderTarget[1..7] は無視されます。

制限事項については 解説 セクションを参照してください。

RenderTargetD3D12_RENDER_TARGET_BLEND_DESC320+8+8レンダーターゲットのブレンド状態を記述する D3D12_RENDER_TARGET_BLEND_DESC 構造体の配列です。これらは、出力マージャーステージに同時にバインドできる 8 つのレンダーターゲットに対応します。

公式ドキュメント

ブレンド状態を記述します。

解説(Remarks)

D3D12_GRAPHICS_PIPELINE_STATE_DESC オブジェクトには、出力マージャーステージによるブレンドを制御するブレンド状態の構造体が含まれます。

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

状態 既定値
AlphaToCoverageEnable FALSE
IndependentBlendEnable FALSE
RenderTarget[0].BlendEnable FALSE
RenderTarget[0].LogicOpEnable FALSE
RenderTarget[0].SrcBlend D3D12_BLEND_ONE
RenderTarget[0].DestBlend D3D12_BLEND_ZERO
RenderTarget[0].BlendOp D3D12_BLEND_OP_ADD
RenderTarget[0].SrcBlendAlpha D3D12_BLEND_ONE
RenderTarget[0].DestBlendAlpha D3D12_BLEND_ZERO
RenderTarget[0].BlendOpAlpha D3D12_BLEND_OP_ADD
RenderTarget[0].LogicOp D3D12_LOGIC_OP_NOOP
RenderTarget[0].RenderTargetWriteMask D3D12_COLOR_WRITE_ENABLE_ALL

RenderTarget 配列の最初の要素 (RenderTarget[0]) の LogicOpEnable メンバーに TRUE を設定する場合は、RenderTarget[0] の BlendEnable メンバーに FALSE を設定し、さらにこの構造体の IndependentBlendEnable メンバーにも FALSE を設定する必要があります。これは、複数のレンダーターゲットにまたがって論理演算とブレンドを混在させることができず、論理演算を使用する場合はすべてのレンダーターゲットに同じ論理演算を適用しなければならないという、ハードウェア上の制限を反映したものです。

ヘルパー構造体である CD3DX12_BLEND_DESC にも留意してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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;

// D3D12_BLEND_DESC  (x64 328 / x86 328 バイト)
typedef struct D3D12_BLEND_DESC {
    BOOL AlphaToCoverageEnable;
    BOOL IndependentBlendEnable;
    D3D12_RENDER_TARGET_BLEND_DESC RenderTarget[8];
} D3D12_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;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D12_BLEND_DESC
{
    [MarshalAs(UnmanagedType.Bool)] public bool AlphaToCoverageEnable;
    [MarshalAs(UnmanagedType.Bool)] public bool IndependentBlendEnable;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public D3D12_RENDER_TARGET_BLEND_DESC[] RenderTarget;
}
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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D12_BLEND_DESC
    <MarshalAs(UnmanagedType.Bool)> Public AlphaToCoverageEnable As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public IndependentBlendEnable As Boolean
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public RenderTarget() As D3D12_RENDER_TARGET_BLEND_DESC
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),
    ]

class D3D12_BLEND_DESC(ctypes.Structure):
    _fields_ = [
        ("AlphaToCoverageEnable", wintypes.BOOL),
        ("IndependentBlendEnable", wintypes.BOOL),
        ("RenderTarget", D3D12_RENDER_TARGET_BLEND_DESC * 8),
    ]
#[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,
}

#[repr(C)]
pub struct D3D12_BLEND_DESC {
    pub AlphaToCoverageEnable: i32,
    pub IndependentBlendEnable: i32,
    pub RenderTarget: [D3D12_RENDER_TARGET_BLEND_DESC; 8],
}
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_BLEND_DESC struct {
	AlphaToCoverageEnable int32
	IndependentBlendEnable int32
	RenderTarget [8]D3D12_RENDER_TARGET_BLEND_DESC
}
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;

  D3D12_BLEND_DESC = record
    AlphaToCoverageEnable: BOOL;
    IndependentBlendEnable: BOOL;
    RenderTarget: array[0..7] of D3D12_RENDER_TARGET_BLEND_DESC;
  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,
};

const D3D12_BLEND_DESC = extern struct {
    AlphaToCoverageEnable: i32,
    IndependentBlendEnable: i32,
    RenderTarget: [8]D3D12_RENDER_TARGET_BLEND_DESC,
};
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

  D3D12_BLEND_DESC {.bycopy.} = object
    AlphaToCoverageEnable: int32
    IndependentBlendEnable: int32
    RenderTarget: array[8, D3D12_RENDER_TARGET_BLEND_DESC]
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;
}

struct D3D12_BLEND_DESC
{
    int AlphaToCoverageEnable;
    int IndependentBlendEnable;
    D3D12_RENDER_TARGET_BLEND_DESC[8] RenderTarget;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; D3D12_BLEND_DESC サイズ: 328 バイト(x64)
dim st, 82    ; 4byte整数×82(構造体サイズ 328 / 4 切り上げ)
; AlphaToCoverageEnable : BOOL (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; IndependentBlendEnable : BOOL (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; RenderTarget : D3D12_RENDER_TARGET_BLEND_DESC (+8, 320byte)  varptr(st)+8 を基点に操作(320byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#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

#defstruct global D3D12_BLEND_DESC
    #field bool AlphaToCoverageEnable
    #field bool IndependentBlendEnable
    #field D3D12_RENDER_TARGET_BLEND_DESC RenderTarget 8
#endstruct

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