Метод IDirect3DDevice9::SetViewport (d3d9helper.h)

Задает параметры окна просмотра для устройства.

Синтаксис

HRESULT SetViewport(
  [in] const D3DVIEWPORT9 *pViewport
);

Параметры

[in] pViewport

Тип: const D3DVIEWPORT9*

Указатель на структуру D3DVIEWPORT9 , указывающую параметры окна просмотра, которые необходимо задать.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, он возвращает D3DERR_INVALIDCALL. Это произойдет, если pViewport недопустим или pViewport описывает область, которая не может существовать в области целевой области отрисовки.

Комментарии

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

D3DVIEWPORT9 vp;
vp.X      = 0;
vp.Y      = 0;
vp.Width  = RenderTarget.Width;
vp.Height = RenderTarget.Height;
vp.MinZ   = 0.0f;
vp.MaxZ   = 1.0f;

IDirect3DDevice9::SetViewport можно использовать для рисования на части экрана. Обязательно вызовите его перед рисованием геометрии, чтобы параметры окна просмотра вступают в силу.

Чтобы нарисовать несколько представлений в сцене, повторите IDirect3DDevice9::SetViewport и нарисуйте геометрическую последовательность для каждого представления.

Требования

Целевая платформа	Windows
Header	d3d9helper.h (включая D3D9.h)
Библиотека	D3D9.lib

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

IDirect3DDevice9

IDirect3DDevice9::GetViewport