Usar recursos en 3D en un juego o una aplicación
En este artículo se describe cómo se puede utilizar Visual Studio para procesar recursos 3D (también llamados activos) e incluirlos en las compilaciones.
Después de usar las herramientas de Visual Studio para crear recursos 3D, el paso siguiente consiste en utilizarlos en la aplicación. Pero antes de poder usarlos, los recursos tienen que transformarse en un formato que DirectX pueda entender. Para ayudarle a transformar los recursos, Visual Studio proporciona personalizaciones de compilación para cada clase de recurso que puede generar. Para incluir los activos en la compilación, basta con configurar el proyecto para que use las personalizaciones de compilación, agregar los activos al proyecto y configurar los activos para que usen la personalización de compilación correcta. Después, puede cargar los activos en la aplicación y usarlos creando y rellenando los recursos de DirectX igual que haría en cualquier otra aplicación DirectX.
Configurar el proyecto
Para poder implementar los recursos 3D como parte de la compilación, Visual Studio tiene que conocer las clases de recursos que se desea implementar. Visual Studio ya conoce muchos tipos de archivo comunes, pero puesto que solo ciertas clases de aplicaciones utilizan recursos 3D, Visual Studio no supone que un proyecto compilará estas clases de archivos. Puede indicar a Visual Studio que la aplicación usa estas clases de recursos mediante las personalizaciones de compilación (archivos que indican a Visual Studio cómo procesar los distintos tipos de archivos de una manera útil) proporcionadas para cada tipo de recurso. Como estas personalizaciones se aplican por proyecto, basta con agregar las personalizaciones adecuadas al proyecto.
Para agregar las personalizaciones de compilación al proyecto
En el Explorador de soluciones, abra el menú contextual del proyecto y luego elija Dependencias de compilación>Compilar personalizaciones.
Aparece el cuadro de diálogo Archivos de personalizaciones de compilación de Visual C++.
En Archivos de personalizaciones de compilación disponibles, active las casillas correspondientes a los tipos de recursos que quiere usar en el proyecto, como se describe en la siguiente tabla:
Tipo de recurso Nombre de personalización de compilación Texturas e imágenes ImageContentTask(.targets, .props) Modelos 3D MeshContentTask(.targets, .props) Sombreadores ShaderGraphContentTask(.targets, .props) Elija el botón Aceptar .
Incluir recursos en la compilación
Ahora que el proyecto sabe cuáles son las diferentes clases de recursos 3D que desea usar, el paso siguiente consiste en indicarle qué archivos son recursos 3D y qué clases de recursos son.
Para agregar un activo a la compilación
En el Explorador de soluciones, en el proyecto, abra el menú contextual de un recurso y, después, elija Propiedades.
Aparece el cuadro de diálogo Página de propiedades del recurso.
Asegúrese de que las propiedades Configuración y Plataforma estén establecidas en los valores a los que quiere que se apliquen los cambios.
En Propiedades de configuración, elija General y, en la cuadrícula de propiedades, en General, establezca la propiedad Tipo de elemento en el tipo de elemento de canalización de contenido adecuado. Por ejemplo, para un archivo de imagen o de textura, elija Canalización de contenido de la imagen.
Importante
De forma predeterminada, Visual Studio supone que muchas clases de archivos de imagen se deben categorizar mediante el tipo de elemento Imagen que está integrado en Visual Studio. Por tanto, debe cambiar la propiedad Tipo de elemento de cada imagen que quiera que procese la canalización de contenido de la imagen. Otros tipos de archivos de código fuente de canalización de contenido para los modelos 3D y los gráficos del sombreador visual toman el valor predeterminado del Tipo de elemento correcto.
Elija el botón Aceptar .
Estos son los tres tipos de elemento de canalización de contenido y los tipos de archivo de código fuente y de salida asociados.
| Tipo de elemento | Tipos de archivo de código fuente | Formato del archivo de salida |
|---|---|---|
| Canalización de contenido de la imagen | Formato PNG (Portable Network Graphics, .png) JPEG (.jpg, .jpeg, .jpe, .jfif) DirectDraw Surface (.dds) Formato de intercambio de gráficos ( .gif) Mapa de bits ( .bmp, .dib) Tagged Image File Format ( .tif, .tiff) Targa (.tga) |
DirectDraw Surface ( .dds) |
| Canalización de contenido de mallas | Archivo de intercambio FBX de Autodesk (.fbx) Archivo DAE de Collada (.dae) Archivo OBJ de Wavefront (.obj) |
Archivo 3D de malla ( .cmo) |
| Canalización de contenido del sombreador | Gráfico de sombreador visual (.dgsl) | Resultado del sombreador compilado (.cso) |
Configurar las propiedades de la canalización de contenido de recursos
Se pueden establecer las propiedades de la canalización de contenido de cada archivo de activo para que se compile de una manera determinada.
Para configurar las propiedades de la canalización de contenido
En el Explorador de soluciones, en el proyecto, abra el menú contextual del archivo de recursos y, después, elija Propiedades.
Aparece el cuadro de diálogo Página de propiedades del recurso.
Asegúrese de que las propiedades Configuración y Plataforma se establecen en los valores a los que quiere que se apliquen los cambios.
En Propiedades de configuración, elija el nodo de canalización de contenido (por ejemplo, Canalización de contenido de la imagen para los recursos de textura e imagen) y después establezca las propiedades en los valores adecuados en la cuadrícula de propiedades. Por ejemplo, para generar los mapas MIP para un recurso de textura en tiempo de compilación, establezca la propiedad Generar Mips en Sí.
Elija el botón Aceptar .
Configuración de la canalización de contenido de imagen
Cuando se utiliza la herramienta de canalización de contenido de la imagen para compilar un activo de textura, se puede comprimir la textura de varias maneras, indicar si se deben generar niveles de MIP en tiempo de compilación y cambiar el nombre del archivo de salida.
| Propiedad | Description |
|---|---|
| Compress | Especifica el tipo de compresión que se utiliza para el archivo de salida. Las opciones disponibles son: - Sin compresión - Compresión BC1_UNORM - Compresión BC1_UNORM_SRGB - Compresión BC2_UNORM - Compresión BC2_UNORM_SRGB - Compresión BC3_UNORM - Compresión BC3_UNORM_SRGB - Compresión BC4_UNORM - Compresión BC4_SNORM - Compresión BC5_UNORM - Compresión BC5_SNORM - Compresión BC6H_UF16 - Compresión BC6H_SF16 - Compresión BC7_UNORM - Compresión BC7_UNORM_SRGB Para obtener información sobre qué formatos de compresión se admiten en las diferentes versiones de DirectX, vea la Guía de programación para DXGI. |
| Convertir a formato alpha premultiplicado | Sí para convertir la imagen al formato alfa premultiplicado en el archivo de salida, de lo contrario, No. Solo se cambia el archivo de salida, la imagen original no se cambia. |
| Generar MIP | Sí para generar una cadena completa de mapas MIP en tiempo de compilación e incluirla en el archivo de salida; de lo contrario, No. Si es No y el archivo de código fuente ya contiene una cadena de mapas MIP, el archivo de salida tendrá una cadena de mapas MIP; de lo contrario, el archivo de salida no tendrá ninguna cadena de mapas MIP. |
| Salida de contenido | Especifica el nombre del archivo de salida. Importante: Cambiar la extensión del nombre del archivo de salida no tiene ningún efecto sobre el formato de archivo. |
Configuración de la canalización de contenido de mallas
Cuando se utiliza la herramienta de canalización de contenido de mallas para compilar un activo de malla, se puede cambiar el nombre del archivo de salida.
| Propiedad | Description |
|---|---|
| Salida de contenido | Especifica el nombre del archivo de salida. Importante: Cambiar la extensión del nombre del archivo de salida no tiene ningún efecto sobre el formato de archivo. |
Configuración de la canalización de contenido del sombreador
Cuando se utiliza la herramienta de canalización de contenido del sombreador para compilar un activo de sombreador, se puede cambiar el nombre del archivo de salida.
| Propiedad | Description |
|---|---|
| Salida de contenido | Especifica el nombre del archivo de salida. Importante: Cambiar la extensión del nombre del archivo de salida no tiene ningún efecto sobre el formato de archivo. |
Cargar y usar recursos 3D en tiempo de ejecución
Utilizar texturas e imágenes
Direct3D proporciona funciones para crear recursos de textura. En Direct3D 11, la biblioteca de utilidades D3DX11 proporciona funciones adicionales para crear recursos de texturas y vistas de recursos de textura directamente a partir de archivos de imagen. Para más información sobre cómo crear un recurso de textura en Direct3D 11, vea Texturas. Para obtener más información sobre cómo usar la biblioteca D3DX11 para crear un recurso o una vista de recursos de textura a partir de un archivo de imagen, vea How to: Initialize a texture from a file (Cómo: Inicializar una textura a partir de un archivo).
Usar modelos 3D
Direct3D 11 no proporciona funciones para crear recursos a partir de modelos 3D. En su lugar, tiene que escribir código que lea el archivo del modelo 3D y cree búferes de vértices y de índices que representen el modelo 3D y cualquier recurso que requiera el modelo, como texturas o sombreadores.
Usar sombreadores
Direct3D proporciona funciones para crear recursos de sombreador y enlazarlos a la canalización programable de gráficos. Para obtener más información sobre cómo crear un recurso de sombreador en Direct3D y enlazarlo a la canalización, vea Programming guide for HLSL (Guía de programación para HLSL).
En la canalización programable de gráficos, cada fase de la canalización debe aportar a la siguiente fase de la canalización un resultado con formato de forma que se pueda entender. Puesto que el Diseñador de sombras solo puede crear sombreadores de píxeles, esto significa que depende de la aplicación el garantizar que los datos que recibe están en el formato que se espera. Hay varias fases del sombreador programables que tienen lugar antes que el sombreador de píxeles y que realizan transformaciones geométricas: el sombreador de vértices, el sombreador de casco, el sombreador de dominios y el sombreador de geometría. La fase de teselación no programable también tiene lugar antes que el sombreador de píxeles. Independientemente de cuál de estas fases preceda directamente al sombreador de píxeles, debe facilitar su resultado en este formato:
struct PixelShaderInput
{
float4 pos : SV_POSITION;
float4 diffuse : COLOR;
float2 uv : TEXCOORD0;
float3 worldNorm : TEXCOORD1;
float3 worldPos : TEXCOORD2;
float3 toEye : TEXCOORD3;
float4 tangent : TEXCOORD4;
float3 normal : TEXCOORD5;
};
En función de los nodos del Diseñador de sombras que use en el sombreador, puede que tenga que proporcionar también datos adicionales en el formato adecuado según estas definiciones:
Texture2D Texture1 : register( t0 );
Texture2D Texture2 : register( t1 );
Texture2D Texture3 : register( t2 );
Texture2D Texture4 : register( t3 );
Texture2D Texture5 : register( t4 );
Texture2D Texture6 : register( t5 );
Texture2D Texture7 : register( t6 );
Texture2D Texture8 : register( t7 );
TextureCube CubeTexture1 : register( t8 );
TextureCube CubeTexture2 : register( t9 );
TextureCube CubeTexture3 : register( t10 );
TextureCube CubeTexture4 : register( t11 );
TextureCube CubeTexture5 : register( t12 );
TextureCube CubeTexture6 : register( t13 );
TextureCube CubeTexture7 : register( t14 );
TextureCube CubeTexture8 : register( t15 );
SamplerState TexSampler : register( s0 );
cbuffer MaterialVars : register (b0)
{
float4 MaterialAmbient;
float4 MaterialDiffuse;
float4 MaterialSpecular;
float4 MaterialEmissive;
float MaterialSpecularPower;
};
cbuffer LightVars : register (b1)
{
float4 AmbientLight;
float4 LightColor[4];
float4 LightAttenuation[4];
float3 LightDirection[4];
float LightSpecularIntensity[4];
uint IsPointLight[4];
uint ActiveLights;
}
cbuffer ObjectVars : register(b2)
{
float4x4 LocalToWorld4x4;
float4x4 LocalToProjected4x4;
float4x4 WorldToLocal4x4;
float4x4 WorldToView4x4;
float4x4 UVTransform4x4;
float3 EyePosition;
};
cbuffer MiscVars : register(b3)
{
float ViewportWidth;
float ViewportHeight;
float Time;
};
Temas relacionados
| Title | Descripción |
|---|---|
| Cómo: Exportar una textura que contiene mapas MIP | Describe cómo utilizar la canalización de contenido de la imagen para exportar una textura que contiene mapas MIP calculados previamente. |
| Procedimiento: Exportar una textura que tiene valores alfa previamente multiplicados | Describe cómo utilizar la canalización de contenido de imagen para exportar una textura que contiene valores alfa multiplicados previamente. |
| Procedimiento: Exportar una textura para usarla con aplicaciones de Direct2D o JavaScript | Describe cómo utilizar la canalización de contenido de la imagen para exportar una textura que se puede utilizar en una aplicación de Direct2D o JavaScript. |
| Trabajar con activos 3D para juegos y aplicaciones | Describe las herramientas de edición que proporciona Visual Studio para crear y manipular recursos 3D, que incluyen texturas e imágenes, modelos 3D y sombreadores. |
| Procedimiento: Exportar un sombreador | Describe cómo exportar un sombreador desde el Diseñador de sombras. |