Stati di effetto (Direct3D 9)

Gli stati degli effetti vengono usati per inizializzare gli stati della pipeline in preparazione per l'elaborazione dei vertici e dei pixel.

effect state [ [index] ] = expression;

Dove:

• stato dell'effetto: simile agli stati tradizionali della pipeline di funzioni fisse. Di seguito è riportato un elenco completo di stati.
• [ [index] ] - Indice intero facoltativo. L'indice identifica uno stato specifico all'interno di una matrice di stati di effetto. Le parentesi esterne indicano che un indice è facoltativo. Se viene usato un indice, assicurarsi di usare le parentesi quadre interne.
• expression - Espressione di assegnazione di stato. Vedere Espressioni (Direct3D 9).

Ogni stato ha un tipo di dati nativo. Si tratta del tipo di dati in cui lo stato prevede che i valori siano presenti quando l'effetto li assegna. I tipi di dati previsti per ogni stato sono elencati di seguito.

Si noti che l'interfaccia dell'effetto tenterà di eseguire il cast dei valori al tipo appropriato il prima possibile. I valori letterali possono essere cast in fase di compilazione. È necessario eseguire il cast di variabili non letterali (ad esempio variabili regolari) quando vengono chiamati i metodi Set appropriati. Ad esempio, l'interfaccia dell'effetto eseguirà il cast dei valori impostati usando SetBool, SetValue e altre funzioni simili, se necessario. Per migliorare le prestazioni, assicurarsi che i valori passati all'interfaccia dell'effetto siano già il tipo corretto e non saranno necessari il cast. Se il runtime non è in grado di eseguire il cast di un valore, viene restituito un errore.

Gli stati degli effetti possono essere suddivisi nelle categorie seguenti:

• Stati di luce
• Stati materiali
• Stati di rendering
  • Stati di rendering della pipe pixel
  • Stati di rendering della pipe vertex
• Stati dell'esempio
• Stati di fase sampler
• Stati shader
• Stati costanti shader
• Stati trama
• Stati della fase trama
• Trasforma stati

Stati di luce

Per abilitare le prestazioni migliori per l'applicazione di un effetto, tutti i componenti di una luce o di un materiale devono essere specificati nel file di effetto. Gli stati che non si dichiarano sono impostati su un valore predefinito perché non è possibile impostare singolarmente gli stati di luce direct3D.

Esempio:

LightEnable[0] = TRUE;
LightType[0] = POINT;
LightPosition[0] = float3<10.0f, 1.0f, 23.0f>;
LightAmbient[0] = float4<0.7f, 0.0f, 0.0f, 1.0f>;

In questo modo, l'illuminazione, il punto di illuminazione, imposta la posizione di luce su float3<10.0f, 1.0f, 23.0f> e imposta il colore dell'ambiente su float4<0.7f, 0.0f, 0.0f, 1.0f>.

Stati materiali

Gli stati che non si dichiarano sono impostati su un valore predefinito perché non esiste alcun modo per Direct3D di impostare singolarmente gli stati del materiale.

Esempio:

MaterialDiffuse = float4<0.7f, 0.0f, 0.0f, 1.0f>;
MaterialPower = 3.0f;

Verrà impostato il colore diffuso su float4<0,7f, 0,0f, 0,0f, 1,0f e rendere la potenza del materiale 3.0f> .

Stati di rendering

Esistono due tipi di stati di rendering:

• Stati di rendering della pipe pixel
• Stati di rendering della pipe vertex

Stati di rendering della pipe pixel

Gli stati di rendering dei file di effetto hanno nomi simili agli stati fissi della pipeline della funzione, spesso con il prefisso rimosso.

Esempio:

AlphaBlendEnable = TRUE;
FillMode = WIREFRAME;

In questo modo verrà abilitata la fusione alfa e verrà eseguito il rendering di tutte le geometrie in wireframe.

Stati di rendering della pipe dei vertici

Gli stati di rendering dei file di effetto hanno nomi simili agli stati della pipeline di funzioni fisse, spesso con il prefisso rimosso.

Esempio:

Ambient = float4<0.7f, 0.0f, 0.0f, 1.0f>;
CullMode = CCW;
FogColor = 0xff0000;

In questo modo il colore ambientale float4<0.7f, 0.0f, 0.0f, 1.0f>, imposta la modalità di sbattemento backface su antiorario e imposta il colore della nebbia su rosso.

Stati dell'esempio

Uno stato di esempio rappresenta un oggetto sampler.

Stati di fase sampler

Gli stati della fase di esempio vengono usati per esempi di trame. Lo stato del sampler determina i tipi di filtro e le modalità di indirizzamento della trama.

Esempio:

AddressU[0] = CLAMP;
AddressV[0] = CLAMP;
AddressW[0] = CLAMP;

Questo blocca i valori UVW in modo che siano compresi tra 0 e 1.

Stati shader

Esistono solo due stati di effetto shader: uno associato a un oggetto vertex shader e l'altro associato a un oggetto pixel shader.

Esempio:

VertexShader = compile vs_1_1 VSTexture();
PixelShader  = NULL;

Verrà compilato VSTexture, un vertex shader definito in precedenza nel file con estensione fx, nel vertex shader versione 1.1 e quindi imposterà tale shader compilato come vertex shader. Il pixel shader viene assegnato a NULL.

Stati costanti shader

Gli stati delle costanti shader vengono usati per accedere ai parametri costanti dello shader.

Stati trama

Gli stati delle trame inizializzano le trame usate dal frullatore multitextura.

Stati della fase trama

Gli stati della fase della trama configurano trame e le fasi della trama nel frullatore multitextura.

Stati di trasformazione

Impostare gli stati di trasformazione per inizializzare le matrici di trasformazione. Gli effetti usano matrici trasposte per l'efficienza. È possibile fornire matrici trasposte a un effetto oppure un effetto trasporrà automaticamente le matrici prima di usarle.

Argomenti correlati

Formato effetto