CreateRenderTexture

CreateRenderTexture()

Syntax

Ergebnis = CreateRenderTexture(#Textur, CameraID, Breite, Höhe [, Flags [, RenderTexturName$]])

Beschreibung

Erstellt eine neue "Render-Textur". Die mit der Textur verknüpfte Kamera wird ihre Anzeige direkt auf die Textur ausgeben ("rendern"), ohne sie auf dem Bildschirm darzustellen. Dies kann sehr nützlich für Objekte sein, die nur einen Teil einer Szene (wie einen TV-Bildschirm, einen Spiegel, etc.) darstellen.

Parameter

#Textur Eine Nummer zum Identifizieren der neuen Textur. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.

CameraID Die ID der mit der Textur zu verknüpfenden Kamera. Diese ID kann mit Hilfe von CameraID() ermittelt werden.

Breite Die Breite der neuen Textur (in Pixel).

Höhe Die Höhe der neuen Textur (in Pixel).
Flags (optional)
Flags kann einer der folgenden Werte sein:
  #PB_Texture_AutomaticUpdate: die Textur wird bei jedem RenderWorld() automatisch aktualisiert (Standard)
  #PB_Texture_ManualUpdate:    die Textur wird nicht automatisch aktualisiert, UpdateRenderTexture() muss
                               manuell aufgerufen werden.
  #PB_Texture_CameraViewPort:  das Kamera-Ansichtsfenster (englisch "Viewport") wird nicht entfernt - 
                               nützlich, um immer noch ein "Capture" (Bild) von der Kamera zu machen.
RenderTexturName$ (optional) Der Name der neuen Textur im OGRE-System. Dies ermöglicht die Verwendung dieses Namens in einem Skript, um dieser Textur einen Shader zuzuweisen.

Rückgabewert

Gibt null zurück, wenn die Textur nicht erstellt werden kann. Wenn #PB_Any als '#Texture' Parameter verwendet wurde, dann wird die neue Textur-Nummer zurückgegeben.

Anmerkungen

TextureOutput() wird nicht bei gerenderten Texturen unterstützt.

Siehe auch

UpdateRenderTexture()

Unterstützte OS

Alle

<- CreateCubicTexture() - Texture Inhaltsverzeichnis - CreateTexture() ->

#Textur	Eine Nummer zum Identifizieren der neuen Textur. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
CameraID	Die ID der mit der Textur zu verknüpfenden Kamera. Diese ID kann mit Hilfe von CameraID() ermittelt werden.
Breite	Die Breite der neuen Textur (in Pixel).
Höhe	Die Höhe der neuen Textur (in Pixel).
Flags (optional)	Flags kann einer der folgenden Werte sein: #PB_Texture_AutomaticUpdate: die Textur wird bei jedem RenderWorld() automatisch aktualisiert (Standard) #PB_Texture_ManualUpdate: die Textur wird nicht automatisch aktualisiert, UpdateRenderTexture() muss manuell aufgerufen werden. #PB_Texture_CameraViewPort: das Kamera-Ansichtsfenster (englisch "Viewport") wird nicht entfernt - nützlich, um immer noch ein "Capture" (Bild) von der Kamera zu machen.
RenderTexturName$ (optional)	Der Name der neuen Textur im OGRE-System. Dies ermöglicht die Verwendung dieses Namens in einem Skript, um dieser Textur einen Shader zuzuweisen.