Metodo Device.Clear (ClearFlags, Color, Single, Int32)
Aggiornamento: novembre 2007
Cancella il riquadro di visualizzazione o un insieme di rettangoli nel riquadro di visualizzazione su un colore RGBA specificato, cancella il buffer di profondità e lo stencil buffer.
Spazio dei nomi: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Sintassi
'Dichiarazione
Public Sub Clear ( _
flags As ClearFlags, _
color As Color, _
zdepth As Single, _
stencil As Integer _
)
'Utilizzo
Dim instance As Device
Dim flags As ClearFlags
Dim color As Color
Dim zdepth As Single
Dim stencil As Integer
instance.Clear(flags, color, zdepth, stencil)
public void Clear(
ClearFlags flags,
Color color,
float zdepth,
int stencil
)
public:
void Clear(
ClearFlags flags,
Color color,
float zdepth,
int stencil
)
public function Clear(
flags : ClearFlags,
color : Color,
zdepth : float,
stencil : int
)
Parametri
flags
Tipo: Microsoft.WindowsMobile.DirectX.Direct3D.ClearFlagsFlag che indicano quali superfici cancellare. Questo parametro può essere dato da qualsiasi combinazione dei flag riportati di seguito, ma è necessario utilizzare almeno un flag:
color
Tipo: System.Drawing.ColorOggetto Color che rappresenta il colore su cui viene cancellata la superficie di destinazione di rendering.
zdepth
Tipo: System.SingleNuovo valore zdepth che questo metodo archivia nel buffer di profondità. Questo parametro può essere compreso nell'intervallo tra 0.0 e 1.0 (per i Z-Buffer e i W-Buffer). Un valore pari a 0.0 reppresenta la distanza più vicina a colui che osserva; un valore pari a 1.0 rappresenta la distanza più lontana.
stencil
Tipo: System.Int32Valore integer da archiviare in ogni voce dello stencil buffer. Questo parametro può essere compreso nell'intervallo tra 0 e 2n-1, dove n è la profondità in bit dello stencil buffer.
Eccezioni
Eccezione | Condizione |
---|---|
InvalidCallException | La chiamata al metodo non è valida. Un parametro potrebbe, ad esempio, contenere un valore non valido. |
Note
Questo metodo avrà esito negativo se viene specificato il flag ZBuffer o Stencil quando alla destinazione di rendering non è associato alcun buffer di profondità. Analogamente, il metodo avrà esito negativo se viene specificato il flag Stencil quando il formato del buffer di profondità non contiene informazioni sullo stencil buffer.
Esempi
Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà Clear.
Private Sub Render()
If device Is Nothing Then
Return
End If
'Clear the backbuffer to a blue color.
device.Clear(ClearFlags.Target, System.Drawing.Color.Blue, 1.0F, 0)
'Begin the scene.
device.BeginScene()
'Render scene objects, if desired.
'End the scene.
device.EndScene()
device.Present()
End Sub
private void Render()
{
if (device == null)
return;
//Clear the backbuffer to a blue color.
device.Clear(ClearFlags.Target, System.Drawing.Color.Blue, 1.0f, 0);
//Begin the scene.
device.BeginScene();
// Rendering scene objects, if desired.
//End the scene.
device.EndScene();
device.Present();
}
Autorizzazioni
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.
Piattaforme
Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Compact Framework
Supportato in: 3.5, 2.0