структура D3DPRIMCAPS (d3dcaps.h)

Устарело в DirectX 8.0 и более поздних версиях; См. примечания.

Структура D3DPRIMCAPS определяет возможности для каждого примитивного типа.

Синтаксис

typedef struct _D3DPrimCaps {
  DWORD dwSize;
  DWORD dwMiscCaps;
  DWORD dwRasterCaps;
  DWORD dwZCmpCaps;
  DWORD dwSrcBlendCaps;
  DWORD dwDestBlendCaps;
  DWORD dwAlphaCmpCaps;
  DWORD dwShadeCaps;
  DWORD dwTextureCaps;
  DWORD dwTextureFilterCaps;
  DWORD dwTextureBlendCaps;
  DWORD dwTextureAddressCaps;
  DWORD dwStippleWidth;
  DWORD dwStippleHeight;
} D3DPRIMCAPS, *LPD3DPRIMCAPS;

Члены

dwSize

Задает размер структуры D3DPRIMCAPS в байтах.

dwMiscCaps

Задает общие возможности для этого примитива. Этот элемент может быть одним или несколькими из следующих элементов:

dwRasterCaps

Содержит сведения о возможностях растрового рисования. Этот элемент может быть одним или несколькими из следующих элементов:

dwZCmpCaps

Задает функции сравнения Z-буфера, которые драйвер может выполнять через D3DRENDERSTATE_ZFUNC состояние отрисовки. Этот элемент может быть одним или несколькими из следующих элементов:

dwSrcBlendCaps

Указывает возможности смешивания исходного кода, поддерживаемые драйвером через состояние D3DRENDERSTATE_SRCBLEND отрисовки. Этот элемент может иметь одно или несколько из следующих значений. (Значения RGBA источника и назначения указываются индексами s и d.)

dwDestBlendCaps

Задает возможности смешивания назначения, поддерживаемые драйвером через состояние D3DRENDERSTATE_DESTBLEND отрисовки. Этот элемент может быть теми же возможностями, которые определены для элемента dwSrcBlendCaps .

dwAlphaCmpCaps

Задает функции сравнения альфа-тестов, которые может выполнять драйвер. Этот элемент использует те же функции сравнения, что и для члена dwZCmpCaps . Если член dwAlphaCmpCaps структуры D3DPRIMCAPS равен 0, драйвер не поддерживает состояния отрисовки альфа-теста D3DRENDERSTATE_ALPHAFUNC, D3DRENDERSTATE_ALPHAREF и D3DRENDERSTATE_ALPHATESTENABLE.

dwShadeCaps

Указывает операции заливки, которые может выполнять устройство. Как правило, предполагается, что если устройство поддерживает определенную команду (например, D3DOP_TRIANGLE), оно поддерживает режим D3DSHADE_FLAT (как указано в D3DSHADEMODE перечислимом типе в документации по пакету SDK Для DirectX). Этот флаг указывает, может ли драйвер также поддерживать заливку Gouraud и Phong и поддерживаются ли компоненты альфа-цвета для каждого из трех режимов создания цвета. Если альфа-компоненты не поддерживаются в заданном режиме, альфа-значение цветов, создаваемых в этом режиме, неявно равно 255. Это максимально возможный альфа-канал (то есть альфа-компонент находится в полной интенсивности).

Цвет, зеркальные выделения, туман и альфа-интерполяции треугольника имеют флаги возможностей, которые приложение может использовать для определения того, как они реализуются драйвером устройства. Они изменяются режимом затенения и цветовой моделью, а также тем, смешивается ли альфа-компонент цвета.

Этот элемент может быть одним или несколькими значениями, перечисленными в следующей таблице. Связанные флаги группируются в этой таблице.

Большинство драйверов оборудования должны предоставлять возможности D3DPSHADECAPS_COLORFLATRGB и D3DPSHADECAPS_COLORGOURAUDRGB. Оборудование, поддерживающее освещение с интенсивностью (в оттенках серого) (дополнительные сведения см. в D3DRENDERSTATE_MONOENABLE), также должно предоставлять возможности D3DPSHADECAPS_COLORFLATMONO и D3DSHADECAPS_COLORGOURAUDMONO.

dwTextureCaps

Задает различные возможности сопоставления текстур. Этот элемент может быть одним или несколькими из следующих элементов:

dwTextureFilterCaps

Задает возможности сопоставления текстур. Этот элемент может быть одним или несколькими из следующих элементов:

dwTextureBlendCaps

Задает возможности наложения текстур. Сведения о различных режимах наложения текстур см. в D3DRENDERSTATE_TEXTUREMAPBLEND перечислимом типе. Этот элемент может быть одним или несколькими из следующих элементов:

dwTextureAddressCaps

Задает возможности адресации текстур. Это может быть один или несколько из следующих элементов, соответствующих D3DTEXTUREADDRESS режимам адресации текстур:

dwStippleWidth

dwStippleHeight

Укажите максимальную ширину и высоту поддерживаемой скобы (до 32 на 32).

Комментарии

Эта структура была заменена D3DCAPS8 (см. документацию по пакету SDK для DirectX 8.0) для сред выполнения DirectX 8.0 и более поздних версий, но требуется для совместимости среды выполнения DirectX 7.0 и более ранних версий. Дополнительные сведения см. в статье Создание отчетов о возможностях Direct3D в стиле DirectX 8.0 .

Эта структура используется при создании устройства и при запросе возможностей устройства. Он определяет несколько элементов в структуре D3DDEVICEDESC_V1 .

Требования

См. также раздел

D3DDEVICEDESC_V1