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...
CanvasGroup
繼承: Node2D < CanvasItem < Node < Object
將若干 2D 節點合併至單次繪製操作。
說明
CanvasGroup 的子 CanvasItem 節點被繪製成單個物件。例如,它可以繪製重疊的半透明 2D 節點,而不會使重疊部分比預期更不透明(在 CanvasGroup 上設定 CanvasItem.self_modulate 屬性即可實現該效果)。
注意:CanvasGroup 使用一個自訂著色器從後台緩衝區讀取以繪製其子節點。為 CanvasGroup 指定一個 Material 會覆蓋內建著色器。要在自訂 Shader 中複製內建著色器的行為,請使用以下方法:
shader_type canvas_item;
render_mode unshaded;
uniform sampler2D screen_texture : hint_screen_texture, repeat_disable, filter_nearest;
void fragment() {
vec4 c = textureLod(screen_texture, SCREEN_UV, 0.0);
if (c.a > 0.0001) {
c.rgb /= c.a;
}
COLOR *= c;
}
注意:由於 CanvasGroup 和 CanvasItem.clip_children 都使用後台緩衝區,因此 CanvasGroup 的子級如果將其 CanvasItem.clip_children 設定為 CanvasItem.CLIP_CHILDREN_DISABLED 以外的其他值將無法正常工作。
屬性
|
||
|
||
|
屬性說明
設定用於擴充該 CanvasGroup 清除矩形的邊距大小。會對該 CanvasGroup 所使用的後臺緩衝的區域進行擴充。邊距較小時可以減少後臺緩衝的區域大小,從而提升效能,但如果啟用了 use_mipmaps,較小的邊距可能在該 CanvasGroup 邊緣造成 mipmap 錯誤。因此,這個值應該儘量調小,但是如果畫布組的邊緣出現問題,就應該將其調大。
設定用於擴充該 CanvasGroup 繪圖矩形的邊距大小。確定該 CanvasGroup 大小的方法是:首先框定子節點的矩形區域,然後將該矩形按照 fit_margin 進行擴充。會增大該 CanvasGroup 所使用的後臺緩衝的區域,也會增大該 CanvasGroup 所覆蓋的面積,兩者都會降低效能。這個值應該儘量調小,僅在需要時調大(例如自訂著色器效果)。
如果為 true,則會在繪製該 CanvasGroup 之前為其後臺緩衝計算 mipmap,附加到該 CanvasGroup 的自訂 ShaderMaterial 就可以使用 mipmap。Mipmap 的生成會造成效能消耗,所以應在必要時才啟用。