структура CD3D11_RASTERIZER_DESC1 (d3d11_1.h)

Статья
02/24/2024

Примечание Эта структура поддерживается средой выполнения Direct3D 11.1, которая доступна в Windows 8 и более поздних версиях операционных систем.

Описывает состояние растеризатора.

Синтаксис

struct CD3D11_RASTERIZER_DESC1 : D3D11_RASTERIZER_DESC1 {
  void CD3D11_RASTERIZER_DESC1();
  void CD3D11_RASTERIZER_DESC1(
    const D3D11_RASTERIZER_DESC1 & o
  );
  void CD3D11_RASTERIZER_DESC1(
    CD3D11_DEFAULT unnamedParam1
  );
  void CD3D11_RASTERIZER_DESC1(
    D3D11_FILL_MODE fillMode,
    D3D11_CULL_MODE cullMode,
    BOOL            frontCounterClockwise,
    INT             depthBias,
    FLOAT           depthBiasClamp,
    FLOAT           slopeScaledDepthBias,
    BOOL            depthClipEnable,
    BOOL            scissorEnable,
    BOOL            multisampleEnable,
    BOOL            antialiasedLineEnable,
    UINT            forcedSampleCount
  );
  void ~CD3D11_RASTERIZER_DESC1();
};

Наследование

Структура CD3D11_RASTERIZER_DESC1 реализует D3D11_RASTERIZER_DESC1.

Элементы

void CD3D11_RASTERIZER_DESC1()

void CD3D11_RASTERIZER_DESC1( const D3D11_RASTERIZER_DESC1 & o)

void CD3D11_RASTERIZER_DESC1( CD3D11_DEFAULT unnamedParam1)

void CD3D11_RASTERIZER_DESC1( D3D11_FILL_MODE fillMode, D3D11_CULL_MODE cullMode, BOOL frontCounterClockwise, INT depthBias, FLOAT depthBiasClamp, FLOAT slopeScaledDepthBias, BOOL depthClipEnable, BOOL scissorEnable, BOOL multisampleEnable, BOOL antialiasedLineEnable, UINT forcedSampleCount)

void ~CD3D11_RASTERIZER_DESC1()

Указывает, следует ли включить сглаживание строк; Применяется, только если выполняется рисование линий и multisampleEnable имеет значение FALSE. Дополнительные сведения об этом участнике см. в разделе Примечания.

CullMode

Тип: D3D11_CULL_MODE

Указывает, что треугольники, обращенные к указанному направлению, не рисуются.

DepthBias

Тип: INT

Значение глубины, добавленное к заданному пикселю. Сведения о смещениях глубины см. в разделе См. в разделе См. см. см. раздел См. см. в разделе См. см

DepthBiasClamp

Тип: FLOAT

Максимальное смещение глубины пикселя. Сведения о смещениях глубины см. в разделе См. в разделе См. см. см. раздел См. см. в разделе См. см

DepthClipEnable

Тип: BOOL

Указывает, следует ли включать обрезку на основе расстояния.

Оборудование всегда выполняет обрезку растровых координат по оси x и y. Если параметр DepthClipEnable имеет значение по умолчанию –TRUE, оборудование также обрезает значение z (то есть оборудование выполняет последний шаг следующего алгоритма).


0 &lt; w
-w &lt;= x &lt;= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
-w &lt;= y &lt;= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
0 &lt;= z &lt;= w

Если для depthClipEnable задано значение FALSE, оборудование пропускает обрезку z (т. е. последний шаг в предыдущем алгоритме). Однако оборудование по-прежнему выполняет обрезку "0 < w". Если z-обрезка отключена, может привести к неправильному упорядочению глубины на уровне пикселей. Однако при отключении z-отсечения реализации теневого набора элементов упрощаются. Другими словами, можно избежать сложной обработки особых случаев для геометрии, которая выходит за пределы задней плоскости отсечения.

FillMode

Тип: D3D11_FILL_MODE

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

ForcedSampleCount

Тип: UINT

Число выборок, которое принудительно выполняется при отрисовке или растеризации БПЛА. Допустимые значения: 0, 1, 2, 4, 8 и при необходимости 16. 0 означает, что количество выборок не является принудительным.

Примечание Если вы хотите выполнить отрисовку с параметром ForcedSampleCount , равным 1 или выше, необходимо следовать следующим рекомендациям:

Не привязывайте представления трафаретов глубины.
Отключите тестирование глубины.
Убедитесь, что шейдер не выводит глубину.
Если у вас есть какие-либо представления целевого объекта отрисовки, привязанные (D3D11_BIND_RENDER_TARGET), а значение ForcedSampleCount больше 1, убедитесь, что каждый целевой объект отрисовки содержит только одну выборку.
Не управляйте шейдером с частотой выборки. Поэтому ID3D11ShaderReflection::IsSampleFrequencyShader возвращает значение FALSE.

В противном случае поведение отрисовки не определено. Сведения о настройке трафарета глубины см. в разделе Настройка функций Depth-Stencil.

FrontCounterClockwise

Тип: BOOL

Указывает, является ли треугольник передним или задним. Если задано значение TRUE, треугольник будет считаться обращенным спереди, если его вершины находятся против часовой стрелки на целевом объекте отрисовки, и считается обращенным назад, если они находятся по часовой стрелке. Если значение РАВНО FALSE, то имеет значение true.

MultisampleEnable

Тип: BOOL

Указывает, следует ли использовать алгоритм сглаживания четырехугольной или альфа-линии для целевых объектов с сглаживания с несколькими дискретными данными (MSAA). Задайте значение TRUE , чтобы использовать алгоритм сглаживания четырехугольной линии, и значение FALSE , чтобы использовать алгоритм сглаживания альфа-линий. Дополнительные сведения об этом участнике см. в разделе Примечания.

ScissorEnable

Тип: BOOL

Указывает, следует ли включить отбраковку ножницы-прямоугольника. Все пиксели за пределами активного прямоугольника ножницы отбираются.

SlopeScaledDepthBias

Тип: FLOAT

Скалярный на склоне заданного пикселя. Сведения о смещениях глубины см. в разделе См. в разделе См. см. см. раздел См. см. в разделе См. см

Состояние растеризатора определяет поведение этапа растеризатора. Чтобы создать объект состояния растеризатора, вызовите ID3D11Device1::CreateRasterizerState1. Чтобы задать состояние растеризатора, вызовите ID3D11DeviceContext::RSSetState.

Если не указать состояние растеризатора, среда выполнения Direct3D использует следующие значения по умолчанию для состояния растеризатора.

Состояние	Значение по умолчанию
FillMode	Сплошная
CullMode	Назад
FrontCounterClockwise	FALSE
DepthBias	0
SlopeScaledDepthBias	0.0f
DepthBiasClamp	0.0f
DepthClipEnable	TRUE
ScissorEnable	FALSE
MultisampleEnable	FALSE
AntialiasedLineEnable	FALSE
ForcedSampleCount	0

Примечание Для уровней компонентов 9.1, 9.2, 9.3 и 10.0, если для параметра MultisampleEnable задано значение FALSE, среда выполнения отрисовывает все точки, линии и треугольники без сглаживания даже для целевых объектов отрисовки с числом выборок больше 1. Для уровней компонентов 10.1 и выше параметр MultisampleEnable не влияет на точки и треугольники в отношении MSAA и влияет только на выбор алгоритма отрисовки линий, как показано в следующей таблице:

Алгоритм отрисовки линий	MultisampleEnable	AntialiasedLineEnable
Псевдоним	FALSE	FALSE
Альфа-антиалиазированные	FALSE	TRUE
Четырехугольник	TRUE	FALSE
Четырехугольник	TRUE	TRUE

Параметры элементов MultisampleEnable и AntialiasedLineEnable применяются только к целевым объектам отрисовки с несколькими выборками (MSAA) (то есть целевым объектам отрисовки с количеством выборок больше 1). Из-за различий в поведении на уровне признаков и до тех пор, пока вы не выполняете рисование линий или не возражаете против того, чтобы линии отрисовывались как четырехугольные, рекомендуется всегда устанавливать для MultisampleEnable значение TRUE при отрисовке в целевых объектах отрисовки MSAA.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Верхняя часть	d3d11_1.h

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

Основные структуры

Share via

структура CD3D11_RASTERIZER_DESC1 (d3d11_1.h)

Синтаксис

Наследование

Элементы

Комментарии

Требования

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

Обратная связь

Обратная связь

Дополнительные ресурсы