ホーム › Graphics.Direct3D11 › D3D11_BLEND_DESC

D3D11_BLEND_DESC

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
AlphaToCoverageEnable	BOOL	4	+0	+0	ピクセルをレンダーターゲットに設定するときに、マルチサンプリング手法として alpha-to-coverage を使用するかどうかを指定します。alpha-to-coverage の使用方法の詳細については、Alpha-To-Coverage を参照してください。
IndependentBlendEnable	BOOL	4	+4	+4	同時レンダーターゲットで独立したブレンドを有効にするかどうかを指定します。独立したブレンドを有効にするには TRUE を設定します。FALSE を設定した場合、RenderTarget[0] のメンバーのみが使用され、RenderTarget[1..7] は無視されます。
RenderTarget	D3D11_RENDER_TARGET_BLEND_DESC	256	+8	+8	レンダーターゲットのブレンドステートを記述する D3D11_RENDER_TARGET_BLEND_DESC 構造体の配列です。これらは、出力マージャーステージに一度にバインドできる 8 個のレンダーターゲットに対応します。

公式ドキュメント

ID3D11Device::CreateBlendState の呼び出しでブレンドステートオブジェクトを作成する際に使用する、ブレンドステートを記述します。

解説(Remarks)

ブレンドステートの既定値を次に示します。

ステート	既定値
AlphaToCoverageEnable	FALSE
IndependentBlendEnable	FALSE
RenderTarget[0].BlendEnable	FALSE
RenderTarget[0].SrcBlend	D3D11_BLEND_ONE
RenderTarget[0].DestBlend	D3D11_BLEND_ZERO
RenderTarget[0].BlendOp	D3D11_BLEND_OP_ADD
RenderTarget[0].SrcBlendAlpha	D3D11_BLEND_ONE
RenderTarget[0].DestBlendAlpha	D3D11_BLEND_ZERO
RenderTarget[0].BlendOpAlpha	D3D11_BLEND_OP_ADD
RenderTarget[0].RenderTargetWriteMask	D3D11_COLOR_WRITE_ENABLE_ALL

メモ D3D11_BLEND_DESC は D3D10_BLEND_DESC1 と同一です。

ドライバーの種類が D3D_DRIVER_TYPE_HARDWARE に設定され、機能レベルが D3D_FEATURE_LEVEL_9_3 以下に設定されていて、レンダーターゲットのピクセル形式が DXGI_FORMAT_R8G8B8A8_UNORM_SRGB、DXGI_FORMAT_B8G8R8A8_UNORM_SRGB、または DXGI_FORMAT_B8G8R8X8_UNORM_SRGB に設定されている場合、ディスプレイデバイスはリニア空間ではなく標準 RGB (sRGB) 空間でブレンドを実行します。ただし、機能レベルが D3D_FEATURE_LEVEL_9_3 より大きく設定されている場合、ディスプレイデバイスはリニア空間でブレンドを実行します。これが理想的です。

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

各言語での定義

#include <windows.h>

// D3D11_RENDER_TARGET_BLEND_DESC  (x64 32 / x86 32 バイト)
typedef struct D3D11_RENDER_TARGET_BLEND_DESC {
    BOOL BlendEnable;
    D3D11_BLEND SrcBlend;
    D3D11_BLEND DestBlend;
    D3D11_BLEND_OP BlendOp;
    D3D11_BLEND SrcBlendAlpha;
    D3D11_BLEND DestBlendAlpha;
    D3D11_BLEND_OP BlendOpAlpha;
    BYTE RenderTargetWriteMask;
} D3D11_RENDER_TARGET_BLEND_DESC;

// D3D11_BLEND_DESC  (x64 264 / x86 264 バイト)
typedef struct D3D11_BLEND_DESC {
    BOOL AlphaToCoverageEnable;
    BOOL IndependentBlendEnable;
    D3D11_RENDER_TARGET_BLEND_DESC RenderTarget[8];
} D3D11_BLEND_DESC;

using System;
using System.Runtime.InteropServices;

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct D3D11_BLEND_DESC
{
    [MarshalAs(UnmanagedType.Bool)] public bool AlphaToCoverageEnable;
    [MarshalAs(UnmanagedType.Bool)] public bool IndependentBlendEnable;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 8)] public D3D11_RENDER_TARGET_BLEND_DESC[] RenderTarget;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_RENDER_TARGET_BLEND_DESC
    <MarshalAs(UnmanagedType.Bool)> Public BlendEnable 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 RenderTargetWriteMask As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D11_BLEND_DESC
    <MarshalAs(UnmanagedType.Bool)> Public AlphaToCoverageEnable As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public IndependentBlendEnable As Boolean
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public RenderTarget() As D3D11_RENDER_TARGET_BLEND_DESC
End Structure

import ctypes
from ctypes import wintypes

class D3D11_RENDER_TARGET_BLEND_DESC(ctypes.Structure):
    _fields_ = [
        ("BlendEnable", 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),
        ("RenderTargetWriteMask", ctypes.c_ubyte),
    ]

class D3D11_BLEND_DESC(ctypes.Structure):
    _fields_ = [
        ("AlphaToCoverageEnable", wintypes.BOOL),
        ("IndependentBlendEnable", wintypes.BOOL),
        ("RenderTarget", D3D11_RENDER_TARGET_BLEND_DESC * 8),
    ]

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

#[repr(C)]
pub struct D3D11_BLEND_DESC {
    pub AlphaToCoverageEnable: i32,
    pub IndependentBlendEnable: i32,
    pub RenderTarget: [D3D11_RENDER_TARGET_BLEND_DESC; 8],
}

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

type D3D11_RENDER_TARGET_BLEND_DESC struct {
	BlendEnable int32
	SrcBlend int32
	DestBlend int32
	BlendOp int32
	SrcBlendAlpha int32
	DestBlendAlpha int32
	BlendOpAlpha int32
	RenderTargetWriteMask byte
}

type D3D11_BLEND_DESC struct {
	AlphaToCoverageEnable int32
	IndependentBlendEnable int32
	RenderTarget [8]D3D11_RENDER_TARGET_BLEND_DESC
}

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

  D3D11_BLEND_DESC = record
    AlphaToCoverageEnable: BOOL;
    IndependentBlendEnable: BOOL;
    RenderTarget: array[0..7] of D3D11_RENDER_TARGET_BLEND_DESC;
  end;

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

const D3D11_BLEND_DESC = extern struct {
    AlphaToCoverageEnable: i32,
    IndependentBlendEnable: i32,
    RenderTarget: [8]D3D11_RENDER_TARGET_BLEND_DESC,
};

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

  D3D11_BLEND_DESC {.bycopy.} = object
    AlphaToCoverageEnable: int32
    IndependentBlendEnable: int32
    RenderTarget: array[8, D3D11_RENDER_TARGET_BLEND_DESC]

struct D3D11_RENDER_TARGET_BLEND_DESC
{
    int BlendEnable;
    int SrcBlend;
    int DestBlend;
    int BlendOp;
    int SrcBlendAlpha;
    int DestBlendAlpha;
    int BlendOpAlpha;
    ubyte RenderTargetWriteMask;
}

struct D3D11_BLEND_DESC
{
    int AlphaToCoverageEnable;
    int IndependentBlendEnable;
    D3D11_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 レイアウト)
; D3D11_BLEND_DESC サイズ: 264 バイト(x64)
dim st, 66    ; 4byte整数×66(構造体サイズ 264 / 4 切り上げ)
; AlphaToCoverageEnable : BOOL (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; IndependentBlendEnable : BOOL (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; RenderTarget : D3D11_RENDER_TARGET_BLEND_DESC (+8, 256byte)  varptr(st)+8 を基点に操作(256byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global D3D11_RENDER_TARGET_BLEND_DESC
    #field bool BlendEnable
    #field int SrcBlend
    #field int DestBlend
    #field int BlendOp
    #field int SrcBlendAlpha
    #field int DestBlendAlpha
    #field int BlendOpAlpha
    #field byte RenderTargetWriteMask
#endstruct

#defstruct global D3D11_BLEND_DESC
    #field bool AlphaToCoverageEnable
    #field bool IndependentBlendEnable
    #field D3D11_RENDER_TARGET_BLEND_DESC RenderTarget 8
#endstruct

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