структура D3D11_VIEWPORT (d3d11.h)

  • Статья

Определяет размеры окна просмотра.

Синтаксис

typedef struct D3D11_VIEWPORT {
  FLOAT TopLeftX;
  FLOAT TopLeftY;
  FLOAT Width;
  FLOAT Height;
  FLOAT MinDepth;
  FLOAT MaxDepth;
} D3D11_VIEWPORT;

Члены

TopLeftX

Тип: FLOAT

Положение X левой стороны окна просмотра. Диапазоны от D3D11_VIEWPORT_BOUNDS_MIN до D3D11_VIEWPORT_BOUNDS_MAX.

TopLeftY

Тип: FLOAT

Позиция Y в верхней части окна просмотра. Диапазоны от D3D11_VIEWPORT_BOUNDS_MIN до D3D11_VIEWPORT_BOUNDS_MAX.

Width

Тип: FLOAT

Ширина окна просмотра.

Height

Тип: FLOAT

Высота окна просмотра.

MinDepth

Тип: FLOAT

Минимальная глубина окна просмотра. Диапазоны от 0 до 1.

MaxDepth

Тип: FLOAT

Максимальная глубина окна просмотра. Диапазоны от 0 до 1.

Комментарии

Во всех случаях значения Width и Height должны быть >равны 0, а TopLeftX + Width и TopLeftY + Height должны быть <= D3D11_VIEWPORT_BOUNDS_MAX.

Размеры окна просмотра и поддержка уровня компонентов Различия между Direct3D 11 и Direct3D 10:

Диапазон минимального и максимального размера окна просмотра зависит от уровня компонентов, определенного D3D_FEATURE_LEVEL.

  • Direct3D 11 поддерживает дробные окна просмотра; Типы параметров являются числами с плавающей запятой. Уровень компонентов, D3D_FEATURE_LEVEL_11_0, поддерживает (D3D11_VIEWPORT_BOUNDS_MIN, D3D11_VIEWPORT_BOUNDS_MAX) значения между (-32768, 32 767).
  • Direct3D 10 не поддерживает дробные окна просмотра. Уровни компонентов, D3D_FEATURE_LEVEL_10_1 (или ниже), поддерживают (D3D10_VIEWPORT_BOUNDS_MIN, D3D10_VIEWPORT_BOUNDS_MAX) значения между (-16384, 16383).
 
Примечание Несмотря на то, что значения float указываются членам структуры D3D11_VIEWPORT для массива pViewports в вызове ID3D11DeviceContext::RSSetViewports для уровней компонентов 9_x, RSSetViewports использует DWORD внутри организации. Из-за этого при использовании отрицательного левого верхнего угла окна просмотра вызов RSSetViewports для уровней компонентов 9_x завершается ошибкой. Эта ошибка возникает из-за того, что RSSetViewports для 9_x приводит значения с плавающей запятой к неподписанным целым числам без проверки, что приводит к переполнению целых чисел.
 

Требования

Требование Значение
Заголовок d3d11.h

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

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