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

D3D10_BLEND_DESC1

構造体
サイズx64: 264 バイト / x86: 264 バイト

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

フィールド

フィールドサイズx64x86説明
AlphaToCoverageEnableBOOL4+0+0レンダー ターゲットのピクセルを設定するときに、alpha-to-coverage マルチサンプリング手法を使用するかどうかを決定します。
IndependentBlendEnableBOOL4+4+4複数のレンダー ターゲットで独立したブレンドを有効にするには TRUE を設定します。FALSE を設定した場合は RenderTarget[0] のメンバーのみが使用され、RenderTarget[1..7] は無視されます。
RenderTargetD3D10_RENDER_TARGET_BLEND_DESC1256+8+8レンダー ターゲットのブレンドを記述する構造体の配列です (D3D10_RENDER_TARGET_BLEND_DESC1 を参照してください)。これらは、出力マージャー ステージに同時に設定できる 8 つのレンダー ターゲットに対応します。

公式ドキュメント

Direct3D 10.1 デバイスのブレンド ステートを記述します。

解説(Remarks)

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

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

ステート 既定値
AlphaToCoverageEnable FALSE
IndependentBlendEnable FALSE
RenderTarget[0].BlendEnable FALSE
RenderTarget[0].SrcBlend D3D10_BLEND_ONE
RenderTarget[0].DestBlend D3D10_BLEND_ZERO
RenderTarget[0].BlendOp D3D10_BLEND_OP_ADD
RenderTarget[0].SrcBlendAlpha D3D10_BLEND_ONE
RenderTarget[0].DestBlendAlpha D3D10_BLEND_ZERO
RenderTarget[0].BlendOpAlpha D3D10_BLEND_OP_ADD
RenderTarget[0].RenderTargetWriteMask D3D10_COLOR_WRITE_ENABLE_ALL

この構造体を使用するには Windows Vista Service Pack 1 が必要です。

ドライバーの種類が D3D_DRIVER_TYPE_HARDWARE に設定され、機能レベルが D3D_FEATURE_LEVEL_9_3 以下に設定され、レンダー ターゲットのピクセル形式が DXGI_FORMAT_R8G8B8A8_UNORM_SRGBDXGI_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>

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

// D3D10_BLEND_DESC1  (x64 264 / x86 264 バイト)
typedef struct D3D10_BLEND_DESC1 {
    BOOL AlphaToCoverageEnable;
    BOOL IndependentBlendEnable;
    D3D10_RENDER_TARGET_BLEND_DESC1 RenderTarget[8];
} D3D10_BLEND_DESC1;
using System;
using System.Runtime.InteropServices;

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

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure D3D10_RENDER_TARGET_BLEND_DESC1
    <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 D3D10_BLEND_DESC1
    <MarshalAs(UnmanagedType.Bool)> Public AlphaToCoverageEnable As Boolean
    <MarshalAs(UnmanagedType.Bool)> Public IndependentBlendEnable As Boolean
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=8)> Public RenderTarget() As D3D10_RENDER_TARGET_BLEND_DESC1
End Structure
import ctypes
from ctypes import wintypes

class D3D10_RENDER_TARGET_BLEND_DESC1(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 D3D10_BLEND_DESC1(ctypes.Structure):
    _fields_ = [
        ("AlphaToCoverageEnable", wintypes.BOOL),
        ("IndependentBlendEnable", wintypes.BOOL),
        ("RenderTarget", D3D10_RENDER_TARGET_BLEND_DESC1 * 8),
    ]
#[repr(C)]
pub struct D3D10_RENDER_TARGET_BLEND_DESC1 {
    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 D3D10_BLEND_DESC1 {
    pub AlphaToCoverageEnable: i32,
    pub IndependentBlendEnable: i32,
    pub RenderTarget: [D3D10_RENDER_TARGET_BLEND_DESC1; 8],
}
import "golang.org/x/sys/windows"

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

type D3D10_BLEND_DESC1 struct {
	AlphaToCoverageEnable int32
	IndependentBlendEnable int32
	RenderTarget [8]D3D10_RENDER_TARGET_BLEND_DESC1
}
type
  D3D10_RENDER_TARGET_BLEND_DESC1 = record
    BlendEnable: BOOL;
    SrcBlend: Integer;
    DestBlend: Integer;
    BlendOp: Integer;
    SrcBlendAlpha: Integer;
    DestBlendAlpha: Integer;
    BlendOpAlpha: Integer;
    RenderTargetWriteMask: Byte;
  end;

  D3D10_BLEND_DESC1 = record
    AlphaToCoverageEnable: BOOL;
    IndependentBlendEnable: BOOL;
    RenderTarget: array[0..7] of D3D10_RENDER_TARGET_BLEND_DESC1;
  end;
const D3D10_RENDER_TARGET_BLEND_DESC1 = extern struct {
    BlendEnable: i32,
    SrcBlend: i32,
    DestBlend: i32,
    BlendOp: i32,
    SrcBlendAlpha: i32,
    DestBlendAlpha: i32,
    BlendOpAlpha: i32,
    RenderTargetWriteMask: u8,
};

const D3D10_BLEND_DESC1 = extern struct {
    AlphaToCoverageEnable: i32,
    IndependentBlendEnable: i32,
    RenderTarget: [8]D3D10_RENDER_TARGET_BLEND_DESC1,
};
type
  D3D10_RENDER_TARGET_BLEND_DESC1 {.bycopy.} = object
    BlendEnable: int32
    SrcBlend: int32
    DestBlend: int32
    BlendOp: int32
    SrcBlendAlpha: int32
    DestBlendAlpha: int32
    BlendOpAlpha: int32
    RenderTargetWriteMask: uint8

  D3D10_BLEND_DESC1 {.bycopy.} = object
    AlphaToCoverageEnable: int32
    IndependentBlendEnable: int32
    RenderTarget: array[8, D3D10_RENDER_TARGET_BLEND_DESC1]
struct D3D10_RENDER_TARGET_BLEND_DESC1
{
    int BlendEnable;
    int SrcBlend;
    int DestBlend;
    int BlendOp;
    int SrcBlendAlpha;
    int DestBlendAlpha;
    int BlendOpAlpha;
    ubyte RenderTargetWriteMask;
}

struct D3D10_BLEND_DESC1
{
    int AlphaToCoverageEnable;
    int IndependentBlendEnable;
    D3D10_RENDER_TARGET_BLEND_DESC1[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 レイアウト)
; D3D10_BLEND_DESC1 サイズ: 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 : D3D10_RENDER_TARGET_BLEND_DESC1 (+8, 256byte)  varptr(st)+8 を基点に操作(256byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global D3D10_RENDER_TARGET_BLEND_DESC1
    #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 D3D10_BLEND_DESC1
    #field bool AlphaToCoverageEnable
    #field bool IndependentBlendEnable
    #field D3D10_RENDER_TARGET_BLEND_DESC1 RenderTarget 8
#endstruct

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