Utilizzo delle risorse tridimensionali nel gioco o nell'app
Questo articolo spiega come usare Visual Studio per elaborare asset 3D e includerli nelle build.
Dopo avere creato asset 3D mediante gli strumenti disponibili in Visual Studio, è possibile usarli nell'app. Perché gli asset siano utilizzabili, tuttavia, è necessario convertirli in un formato supportato da DirectX. Per agevolare la conversione degli asset, Visual Studio fornisce personalizzazioni di compilazione per ogni tipo di asset che può produrre. Per includere gli asset nella build, è sufficiente configurare il progetto per l'uso delle personalizzazioni di compilazione, aggiungere gli asset al progetto e configurarli per l'uso della personalizzazione di compilazione appropriata. In seguito è possibile caricare gli asset nell'app e usarli mediante la creazione e compilazione di risorse DirectX, come per qualsiasi altra app DirectX.
Configurazione del progetto
Prima di distribuire gli asset 3D nell'ambito della build, è necessario indicare a Visual Studio quali tipi di asset si intende distribuire. Visual Studio prevede già molti tipi di file comuni, ma dato che gli asset 3D sono usati solo da alcuni tipi di app, Visual Studio non presume che un progetto includerà questi tipi di file. Per indicare a Visual Studio che l'app usa questi tipi di asset, è possibile usare le personalizzazioni di compilazione (file che indicano a Visual Studio come elaborare diversi tipi di file in modo utile) fornite per ogni tipo di risorsa. Dato che queste personalizzazioni vengono applicate a livello di singoli progetti, è sufficiente aggiungere le personalizzazioni appropriate al progetto.
Per aggiungere personalizzazioni di compilazione al progetto
In Esplora soluzioni aprire il menu di scelta rapida del progetto, quindi scegliere Dipendenze di compilazione, Personalizzazioni compilazioni Verrà visualizzata la finestra di dialogo File di personalizzazione compilazioni di Visual C++ .
In File di personalizzazione compilazioni disponibili selezionare le caselle di controllo corrispondenti ai tipi di asset da includere nel progetto, come indicato nella tabella seguente:
Tipo di asset
Nome personalizzazione di compilazione
Trame e immagini
ImageContentTask(.targets, .props)
Modelli 3D
MeshContentTask(.targets, .props)
Shader
ShaderGraphContentTask(.targets, .props)
Fare clic su OK.
Inclusione degli asset nella build
Dopo avere specificato i diversi tipi di asset 3D che si intende usare nel progetto, il passaggio successivo consiste nell'indicare quali file sono asset 3D e di quali tipi di asset si tratta.
Per aggiungere un asset alla build
In Esplora soluzioni all'interno del progetto aprire il menu di scelta rapida di un asset, quindi scegliere Proprietà. Verrà visualizzata la finestra di dialogo Pagina delle proprietà relativa all'asset.
Verificare che le proprietà Configurazione e Piattaforma siano impostate sui valori a cui applicare le modifiche.
In Proprietà di configurazione scegliere Generale, quindi nella sezione Generale della griglia delle proprietà impostare la proprietà Tipo di elemento sul tipo di elemento della pipeline di contenuti appropriato. Ad esempio, per un file di immagine o trama, scegliere Pipeline di contenuti immagine.
Importante
Per impostazione predefinita, Visual Studio presuppone che sia necessario suddividere in categorie molti tipi di file di immagine mediante il tipo di elemento Immagine integrato in Visual Studio.È quindi necessario modificare la proprietà Tipo di elemento di ogni immagine che deve essere elaborata dalla pipeline di contenuti immagine.Per altri tipi di file di origine della pipeline di contenuti per i modelli 3D e la grafica visual shader, viene usato il Tipo di elemento corretto per impostazione predefinita.
Fare clic su OK.
Di seguito sono indicati i tre tipi di elemento della pipeline di contenuti e i corrispondenti tipi di file di origine e output.
Tipo di elemento |
Tipi di file di origine |
Tipi di file di output |
|---|---|---|
Pipeline di contenuti immagine |
Portable Network Graphics (.png) JPEG (.jpg, .jpeg, .jpe, .jfif) Direct Draw Surface (.dds) Graphics Interchange Format (.gif) Bitmap (.bmp, .dib) Tagged Image File Format (.tif, .tiff) Targa (.tga) |
DirectDraw Surface (.dds) |
Pipeline di contenuti mesh |
AutoDesk FBX Interchange File (.fbx) File Collada DAE (.dae) File Wavefront OBJ (.obj) |
File mesh 3D (.cmo) |
Pipeline di contenuti shader |
Visual Shader Graph (.dgsl) |
Compiled Shader Output (.cso) |
Configurazione delle proprietà della pipeline di contenuti degli asset
È possibile impostare le proprietà della pipeline di contenuti di ogni file di asset in modo da costruirla in un modo specifico.
Per configurare le proprietà della pipeline di contenuti degli asset
In Esplora soluzioni all'interno del progetto aprire il menu di scelta rapida per il file di asset, quindi scegliere Proprietà. Verrà visualizzata la finestra di dialogo Pagina delle proprietà relativa all'asset.
Verificare che le proprietà Configurazione e Piattaforma siano impostate sui valori a cui applicare le modifiche.
In Proprietà di configurazione scegliere il nodo della pipeline di contenuti, ad esempio Pipeline di contenuti immagine per gli asset di trama e immagine, quindi nella griglia delle proprietà impostare le proprietà sui valori appropriati. Ad esempio, per generare mipmap per un asset trama in fase di compilazione, impostare la proprietà Genera MIP su Sì.
Fare clic su OK.
Configurazione della pipeline di contenuti immagine
Quando si usa lo strumento della pipeline di contenuti immagine per generare un asset trama, è possibile comprimere la trama in diversi modi, specificare se i livelli MIP devono essere generati in fase di compilazione e cambiare il nome del file di output.
Proprietà |
Descrizione |
|---|---|
Comprimi |
Specifica il tipo di compressione usato per il file di output. Le opzioni disponibili sono:
Per informazioni sui formati di compressione supportati nelle varie versioni di DirectX, vedere la guida alla programmazione per DXGI. |
Converti in formato premoltiplicato per alfa |
Sì per convertire l'immagine in formato premoltiplicato per alfa nel file di output, altrimenti No. Viene modificato solo il file di output, mentre l'immagine di origine resta invariata. |
Genera MIP |
Sì per generare una catena MIP completa in fase di compilazione e includerla nel file di output, altrimenti No. Se si sceglie No e il file di origine contiene già una catena mipmap, nel file di output sarà presente una catena MIP. In caso contrario, non sarà presente alcuna catena MIP. |
Output contenuto |
Specifica il nome del file di output. Importante La modifica dell'estensione del nome del file di output non influisce sul formato di file originale. |
Configurazione della pipeline di contenuti mesh
Quando si usa lo strumento della pipeline di contenuti mesh per generare un asset mesh, è possibile cambiare il nome del file di output.
Proprietà |
Descrizione |
|---|---|
Output contenuto |
Specifica il nome del file di output. Importante La modifica dell'estensione del nome del file di output non influisce sul formato di file originale. |
Configurazione della pipeline di contenuti shader
Quando si usa lo strumento della pipeline di contenuti shader per generare un asset shader, è possibile cambiare il nome del file di output.
Proprietà |
Descrizione |
|---|---|
Output contenuto |
Specifica il nome del file di output. Importante La modifica dell'estensione del nome del file di output non influisce sul formato di file originale. |
Caricamento e uso di asset 3D in fase di esecuzione
Uso di trame e immagini
Direct3D dispone di funzioni per la creazione di risorse di trama. In Direct3D 11 la libreria di utilità D3DX11 fornisce funzioni aggiuntive per la creazione di risorse trama e visualizzazioni di risorse direttamente dai file di immagine. Per altre informazioni su come creare una risorsa trama in Direct3D 11, vedere l'argomento relativo alle trame. Per altre informazioni su come usare la libreria D3DX11 per creare una risorsa trama o una visualizzazione risorsa da un file di immagine, vedere la procedura relativa all'inizializzazione di una trama da un file.
Uso di modelli 3D
Direct3D 11 non fornisce funzioni per la creazione di risorse da modelli 3D. È invece necessario scrivere un codice che legge il file del modello 3D e crea buffer di vertici e indici che rappresentano il modello 3D e le risorse richieste dal modello, ad esempio trame o shader.
Uso degli shader
Direct3D fornisce funzioni per la creazione di risorse shader e per la relativa associazione alla pipeline di grafica programmabile. Per altre informazioni su come creare una risorsa shader in Direct3D e associarla alla pipeline, vedere la guida alla programmazione per HLSL.
Nella pipeline di grafica programmabile, ogni fase della pipeline deve fornire alla fase successiva un risultato che sia formattato in modo tale da essere comprensibile. Dato che la finestra di progettazione shader può solo creare i pixel shader, spetta all'app verificare che i dati che riceve siano nel formato previsto. Il pixel shader è preceduto da molte fasi di shader programmabili che eseguono trasformazioni geometriche, ovvero vertex shader, hull shader, domain shader e geometry shader. Il pixel shader è preceduto anche dalla fase del mosaico non programmabile. Indipendentemente da quale sia la fase che precede immediatamente il pixel shader, deve fornire il risultato in questo 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;
};
A seconda dei nodi della finestra di progettazione shader usati nello shader, può essere necessario fornire anche dati supplementari nel formato appropriato in base alle seguenti definizioni:
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;
};
Argomenti correlati
Titolo |
Descrizione |
|---|---|
Descrive come usare la pipeline di contenuti immagine per esportare una trama che contiene le mipmap precalcolate. |
|
Descrive come usare la pipeline di contenuti immagine per esportare una trama che contiene valori premoltiplicati per alfa. |
|
Procedura: esportare una trama da utilizzare con Direct2D o app Javascript |
Descrive come usare la pipeline di contenuti immagine per esportare una trama che può essere usata in un'app Direct2D o JavaScript. |
Descrive gli strumenti di modifica forniti da Visual Studio per la creazione e la manipolazione di asset 3D, tra cui trame e immagini, modelli 3D e shader. |
|
Descrive come esportare uno shader dalla finestra di progettazione shader. |