Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Legt einen Vertexpuffer, einen entsprechenden Vertex-Shader und Optionen fest, um zu steuern, wie die Scheitelpunkte vom Direct2D-Kontext behandelt werden sollen.
Syntax
HRESULT SetVertexProcessing(
[in, optional] ID2D1VertexBuffer *vertexBuffer,
D2D1_VERTEX_OPTIONS vertexOptions,
[in, optional] const D2D1_BLEND_DESCRIPTION *blendDescription,
[in, optional] const D2D1_VERTEX_RANGE *vertexRange,
const GUID *vertexShader
);
Parameter
[in, optional] vertexBuffer
Typ: ID2D1VertexBuffer*
Der Vertexpuffer, wenn dies gelöscht wird, werden der Standard-Vertex-Shader und die Zuordnung zu den Transformationsrechtecken verwendet.
vertexOptions
Typ: D2D1_VERTEX_OPTIONS
Optionen, die beeinflussen, wie der Renderer mit dem Vertex-Shader interagiert.
[in, optional] blendDescription
Typ: const D2D1_BLEND_DESCRIPTION*
Wie die Scheitelpunkte mit der Ausgabetextur gemischt werden.
[in, optional] vertexRange
Typ: const D2D1_VERTEX_RANGE*
Der Satz von Scheitelpunkten, die aus dem Puffer verwendet werden sollen.
vertexShader
Typ: GUID*
Die GUID des Vertex-Shaders.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Die Vertex-Shader, die dem Vertexpuffer über die Vertex-Shader-GUID zugeordnet sind, müssen über die ID2D1EffectContext::LoadVertexShader-Methode geladen worden sein, bevor dieser Aufruf erfolgt.
Wenn Sie die Scheitelpunktoption D2D1_VERTEX_OPTIONS_DO_NOT_CLEAR übergeben, tritt für die Methode ein Fehler auf, es sei denn, die Mischbeschreibung lautet genau wie folgt:
D2D1_BLEND_DESCRIPTION blendDesc =
{
D2D1_BLEND_ONE,
D2D1_BLEND_ZERO,
D2D1_BLEND_OPERATION_ADD,
D2D1_BLEND_ONE,
D2D1_BLEND_ZERO,
D2D1_BLEND_OPERATION_ADD,
{ 1.0f, 1.0f, 1.0f, 1.0f }
};
Wenn dieser Aufruf fehlschlägt, wird der entsprechende ID2D1Effect-instance in einen Fehlerzustand versetzt und kann nicht gezeichnet werden.
Wenn blendDescription NULL ist, wird ein Überblendmodus verwendet.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | d2d1effectauthor.h |
Bibliothek | D2d1.lib |