Referencia de la clase RenderTargetView

#include <RenderTargetView.h>

Métodos públicos
void	destroy ()
	Libera el recurso ID3D11RenderTargetView.
HRESULT	init (Device &device, Texture &backBuffer, DXGI_FORMAT Format)
	Inicializa el Render Target View desde el back buffer.
HRESULT	init (Device &device, Texture &inTex, D3D11_RTV_DIMENSION ViewDimension, DXGI_FORMAT Format)
	Inicializa el Render Target View desde una textura genérica.
void	render (DeviceContext &deviceContext, DepthStencilView &depthStencilView, unsigned int numViews, const float ClearColor[4])
	Limpia y asigna el RTV junto con un Depth Stencil View.
void	render (DeviceContext &deviceContext, unsigned int numViews)
	Asigna el RTV al contexto sin limpiar ni usar Depth Stencil.
	RenderTargetView ()=default
	Constructor por defecto.
void	update ()
	Actualiza parámetros internos del RTV.
	~RenderTargetView ()=default
	Destructor por defecto.

Atributos privados
ID3D11RenderTargetView *	m_renderTargetView = nullptr
	Recurso COM de Direct3D 11 para la vista de Render Target.

Descripción detallada

Definición en la línea 15 del archivo RenderTargetView.h.

Documentación de constructores y destructores

RenderTargetView()

RenderTargetView::RenderTargetView ( )

default

~RenderTargetView()

RenderTargetView::~RenderTargetView ( )

default

No libera automáticamente el recurso COM; llamar a destroy().

Documentación de funciones miembro

destroy()

void RenderTargetView::destroy

(

)

Idempotente: puede llamarse múltiples veces de forma segura.

Postcondición

m_renderTargetView == nullptr.

Definición en la línea 123 del archivo RenderTargetView.cpp.

Hace referencia a m_renderTargetView y SAFE_RELEASE.

Referenciado por BaseApp::destroy(), EditorViewportPass::destroy() y BaseApp::onResize().

init() [1/2]

HRESULT RenderTargetView::init	(	Device &	device,
		Texture &	backBuffer,
		DXGI_FORMAT	Format
	)

Parámetros

device	Dispositivo con el que se crea el recurso.
backBuffer	Textura que representa el back buffer (swap chain).
Format	Formato del RTV (ej. DXGI_FORMAT_R8G8B8A8_UNORM).

Devuelve

S_OK si fue exitoso; código HRESULT en caso contrario.

Postcondición

Si retorna S_OK, m_renderTargetView != nullptr.

Definición en la línea 13 del archivo RenderTargetView.cpp.

Hace referencia a ERROR, Device::m_device, m_renderTargetView y Texture::m_texture.

Referenciado por EditorViewportPass::createResources(), BaseApp::init() y BaseApp::onResize().

init() [2/2]

HRESULT RenderTargetView::init	(	Device &	device,
		Texture &	inTex,
		D3D11_RTV_DIMENSION	ViewDimension,
		DXGI_FORMAT	Format
	)

Parámetros

device	Dispositivo con el que se crea el recurso.
inTex	Textura que será usada como destino de renderizado.
ViewDimension	Dimensión de la vista (ej. D3D11_RTV_DIMENSION_TEXTURE2D).
Format	Formato del RTV.

Devuelve

S_OK si fue exitoso; código HRESULT en caso contrario.

Nota

Útil para render targets auxiliares (G-Buffer, mapas de sombra, etc.).

Definición en la línea 47 del archivo RenderTargetView.cpp.

Hace referencia a ERROR, Device::m_device, m_renderTargetView y Texture::m_texture.

render() [1/2]

void RenderTargetView::render	(	DeviceContext &	deviceContext,
		DepthStencilView &	depthStencilView,
		unsigned int	numViews,
		const float	ClearColor[4]
	)

Llama a OMSetRenderTargets y limpia el RTV con un color dado.

Parámetros

deviceContext	Contexto de dispositivo donde se aplicará.
depthStencilView	Depth Stencil View a asociar.
numViews	Número de vistas de render (típicamente 1).
ClearColor	Color RGBA usado para limpiar el RTV.

Precondición

m_renderTargetView debe estar creado con init().

Definición en la línea 85 del archivo RenderTargetView.cpp.

Hace referencia a ERROR, DepthStencilView::m_depthStencilView, DeviceContext::m_deviceContext y m_renderTargetView.

Referenciado por EditorViewportPass::begin() y BaseApp::render().

render() [2/2]

void RenderTargetView::render	(	DeviceContext &	deviceContext,
		unsigned int	numViews
	)

Llama a OMSetRenderTargets solo con el RTV.

Parámetros

deviceContext	Contexto de dispositivo donde se aplicará.
numViews	Número de vistas de render (típicamente 1).

Precondición

m_renderTargetView debe estar creado con init().

Definición en la línea 108 del archivo RenderTargetView.cpp.

Hace referencia a ERROR, DeviceContext::m_deviceContext y m_renderTargetView.

update()

void RenderTargetView::update

(

)

Método de marcador para futuras extensiones (por ejemplo, cambiar dinámicamente la configuración del RTV o recrearlo).

Nota

Actualmente no realiza ninguna operación.

Documentación de datos miembro

m_renderTargetView

ID3D11RenderTargetView* RenderTargetView::m_renderTargetView = nullptr

private

Válido tras init(); nullptr después de destroy().

Definición en la línea 116 del archivo RenderTargetView.h.

Referenciado por destroy(), init(), init(), render() y render().

---

La documentación de esta clase está generada de los siguientes archivos:

• RenderTargetView.h
• RenderTargetView.cpp