BackBufferCopy

繼承： Node2D < CanvasItem < Node < Object

這個節點能夠將螢幕中的某個區域複製到緩衝中，方便著色器程式碼存取。

說明

用於對目前顯示畫面進行後緩衝的節點。會依據 copy_mode，將 BackBufferCopy 節點所設定的區域或整個螢幕內容複製到緩衝中。之後可於著色器腳本中透過螢幕紋理存取（亦即帶有 hint_screen_texture 的 uniform 取樣器）。

注意：由於此節點繼承自 Node2D（而非 Control），錨點與邊距不會套用到子系 Control 節點。視窗大小變更時可能因此產生問題。為避免此情形，請將 Control 衍生節點作為 BackBufferCopy 的同層節點，而非子節點。

教學

• 螢幕讀取著色器

屬性

CopyMode	copy_mode	1
Rect2	rect	Rect2(-100, -100, 200, 200)

---

列舉

enum CopyMode: 🔗

CopyMode COPY_MODE_DISABLED = 0

停用緩衝模式。這代表 BackBufferCopy 節點會直接使用它所覆蓋的螢幕區域。

CopyMode COPY_MODE_RECT = 1

BackBufferCopy 會緩衝一個矩形區域。

CopyMode COPY_MODE_VIEWPORT = 2

BackBufferCopy 會緩衝整個螢幕。

---

屬性說明

CopyMode copy_mode = 1 🔗

• void set_copy_mode(value: CopyMode)

• CopyMode get_copy_mode()

緩衝模式。

---

Rect2 rect = Rect2(-100, -100, 200, 200) 🔗

• void set_rect(value: Rect2)

• Rect2 get_rect()

此 BackBufferCopy 所覆蓋的區域。只有當 copy_mode 為 COPY_MODE_RECT 時才會使用。