Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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 時才會使用。