CanvasTexture

package
v0.0.0-...-357ca8a Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 20, 2025 License: MIT Imports: 28 Imported by: 0

Documentation

Overview

CanvasTexture is an alternative to ImageTexture for 2D rendering. It allows using normal maps and specular maps in any node that inherits from CanvasItem. CanvasTexture also allows overriding the texture's filter and repeat mode independently of the node's properties (or the project settings).

Note: CanvasTexture cannot be used in 3D. It will not display correctly when applied to any VisualInstance3D, such as Sprite3D or Decal. For physically-based materials in 3D, use BaseMaterial3D instead.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Advanced

type Advanced = class

Advanced exposes a 1:1 low-level instance of the class, undocumented, for those who know what they are doing.

type Any

type Any interface {
	gd.IsClass
	AsCanvasTexture() Instance
}

type Extension

type Extension[T gdclass.Interface] struct{ gdclass.Extension[T, Instance] }

Extension can be embedded in a new struct to create an extension of this class. T should be the type that is embedding this Extension

func (*Extension[T]) AsCanvasTexture

func (self *Extension[T]) AsCanvasTexture() Instance

func (*Extension[T]) AsObject

func (self *Extension[T]) AsObject() [1]gd.Object

func (*Extension[T]) AsRefCounted

func (self *Extension[T]) AsRefCounted() [1]gd.RefCounted

func (*Extension[T]) AsResource

func (self *Extension[T]) AsResource() Resource.Instance

func (*Extension[T]) AsTexture

func (self *Extension[T]) AsTexture() Texture.Instance

func (*Extension[T]) AsTexture2D

func (self *Extension[T]) AsTexture2D() Texture2D.Instance

type ID

type ID Object.ID

ID is a typed object ID (reference) to an instance of this class, use it to store references to objects with unknown lifetimes, as an ID will not panic on use if the underlying object has been destroyed.

func (ID) Instance

func (id ID) Instance() (Instance, bool)

type Instance

type Instance [1]gdclass.CanvasTexture

Instance of the class with convieniently typed arguments and results.

var Nil Instance

Nil is a nil/null instance of the class. Equivalent to the zero value.

func New

func New() Instance

func (Instance) AsCanvasTexture

func (self Instance) AsCanvasTexture() Instance

func (Instance) AsObject

func (self Instance) AsObject() [1]gd.Object

func (Instance) AsRefCounted

func (self Instance) AsRefCounted() [1]gd.RefCounted

func (Instance) AsResource

func (self Instance) AsResource() Resource.Instance

func (Instance) AsTexture

func (self Instance) AsTexture() Texture.Instance

func (Instance) AsTexture2D

func (self Instance) AsTexture2D() Texture2D.Instance

func (Instance) DiffuseTexture

func (self Instance) DiffuseTexture() Texture2D.Instance

The diffuse (color) texture to use. This is the main texture you want to set in most cases.

func (Instance) ID

func (self Instance) ID() ID

func (Instance) NormalTexture

func (self Instance) NormalTexture() Texture2D.Instance

The normal map texture to use. Only has a visible effect if Light2Ds are affecting this CanvasTexture.

Note: Godot expects the normal map to use X+, Y+, and Z+ coordinates. See this page for a comparison of normal map coordinates expected by popular engines.

func (Instance) SetDiffuseTexture

func (self Instance) SetDiffuseTexture(value Texture2D.Instance)

SetDiffuseTexture sets the property returned by [GetDiffuseTexture].

func (Instance) SetNormalTexture

func (self Instance) SetNormalTexture(value Texture2D.Instance)

SetNormalTexture sets the property returned by [GetNormalTexture].

func (*Instance) SetObject

func (self *Instance) SetObject(obj [1]gd.Object) bool

func (Instance) SetSpecularColor

func (self Instance) SetSpecularColor(value Color.RGBA)

SetSpecularColor sets the property returned by [GetSpecularColor].

func (Instance) SetSpecularShininess

func (self Instance) SetSpecularShininess(value Float.X)

SetSpecularShininess sets the property returned by [GetSpecularShininess].

func (Instance) SetSpecularTexture

func (self Instance) SetSpecularTexture(value Texture2D.Instance)

SetSpecularTexture sets the property returned by [GetSpecularTexture].

func (Instance) SetTextureFilter

func (self Instance) SetTextureFilter(value CanvasItem.TextureFilter)

SetTextureFilter sets the property returned by [GetTextureFilter].

func (Instance) SetTextureRepeat

func (self Instance) SetTextureRepeat(value CanvasItem.TextureRepeat)

SetTextureRepeat sets the property returned by [GetTextureRepeat].

func (Instance) SpecularColor

func (self Instance) SpecularColor() Color.RGBA

The multiplier for specular reflection colors. The Light2D's color is also taken into account when determining the reflection color. Only has a visible effect if Light2Ds are affecting this CanvasTexture.

func (Instance) SpecularShininess

func (self Instance) SpecularShininess() Float.X

The specular exponent for Light2D specular reflections. Higher values result in a more glossy/"wet" look, with reflections becoming more localized and less visible overall. The default value of 1.0 disables specular reflections entirely. Only has a visible effect if Light2Ds are affecting this CanvasTexture.

func (Instance) SpecularTexture

func (self Instance) SpecularTexture() Texture2D.Instance

The specular map to use for Light2D specular reflections. This should be a grayscale or colored texture, with brighter areas resulting in a higher SpecularShininess value. Using a colored SpecularTexture allows controlling specular shininess on a per-channel basis. Only has a visible effect if Light2Ds are affecting this CanvasTexture.

func (Instance) TextureFilter

func (self Instance) TextureFilter() CanvasItem.TextureFilter

The texture filtering mode to use when drawing this CanvasTexture.

func (Instance) TextureRepeat

func (self Instance) TextureRepeat() CanvasItem.TextureRepeat

The texture repeat mode to use when drawing this CanvasTexture.

func (Instance) Virtual

func (self Instance) Virtual(name string) reflect.Value

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL