PathFollow2D

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: 26 Imported by: 0

Documentation

Overview

This node takes its parent Path2D, and returns the coordinates of a point within it, given a distance from the first vertex.

It is useful for making other nodes follow a path, without coding the movement pattern. For that, the nodes must be children of this node. The descendant nodes will then move accordingly when setting the Progress in this node.

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
	AsPathFollow2D() 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]) AsCanvasItem

func (self *Extension[T]) AsCanvasItem() CanvasItem.Instance

func (*Extension[T]) AsNode

func (self *Extension[T]) AsNode() Node.Instance

func (*Extension[T]) AsNode2D

func (self *Extension[T]) AsNode2D() Node2D.Instance

func (*Extension[T]) AsObject

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

func (*Extension[T]) AsPathFollow2D

func (self *Extension[T]) AsPathFollow2D() 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.PathFollow2D

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) AsCanvasItem

func (self Instance) AsCanvasItem() CanvasItem.Instance

func (Instance) AsNode

func (self Instance) AsNode() Node.Instance

func (Instance) AsNode2D

func (self Instance) AsNode2D() Node2D.Instance

func (Instance) AsObject

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

func (Instance) AsPathFollow2D

func (self Instance) AsPathFollow2D() Instance

func (Instance) CubicInterp

func (self Instance) CubicInterp() bool

If true, the position between two cached points is interpolated cubically, and linearly otherwise.

The points along the Curve2D of the Path2D are precomputed before use, for faster calculations. The point at the requested offset is then calculated interpolating between two adjacent cached points. This may present a problem if the curve makes sharp turns, as the cached points may not follow the curve closely enough.

There are two answers to this problem: either increase the number of cached points and increase memory consumption, or make a cubic interpolation between two points at the cost of (slightly) slower calculations.

func (Instance) HOffset

func (self Instance) HOffset() Float.X

The node's offset along the curve.

func (Instance) ID

func (self Instance) ID() ID

func (Instance) Loop

func (self Instance) Loop() bool

If true, any offset outside the path's length will wrap around, instead of stopping at the ends. Use it for cyclic paths.

func (Instance) Progress

func (self Instance) Progress() Float.X

The distance along the path, in pixels. Changing this value sets this node's position to a point within the path.

func (Instance) ProgressRatio

func (self Instance) ProgressRatio() Float.X

The distance along the path as a number in the range 0.0 (for the first vertex) to 1.0 (for the last). This is just another way of expressing the progress within the path, as the offset supplied is multiplied internally by the path's length.

It can be set or get only if the PathFollow2D is the child of a Path2D which is part of the scene tree, and that this Path2D has a Curve2D with a non-zero length. Otherwise, trying to set this field will print an error, and getting this field will return 0.0.

func (Instance) Rotates

func (self Instance) Rotates() bool

If true, this node rotates to follow the path, with the +X direction facing forward on the path.

func (Instance) SetCubicInterp

func (self Instance) SetCubicInterp(value bool)

SetCubicInterp sets the property returned by [GetCubicInterpolation].

func (Instance) SetHOffset

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

SetHOffset sets the property returned by [GetHOffset].

func (Instance) SetLoop

func (self Instance) SetLoop(value bool)

SetLoop sets the property returned by [HasLoop].

func (*Instance) SetObject

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

func (Instance) SetProgress

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

SetProgress sets the property returned by [GetProgress].

func (Instance) SetProgressRatio

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

SetProgressRatio sets the property returned by [GetProgressRatio].

func (Instance) SetRotates

func (self Instance) SetRotates(value bool)

SetRotates sets the property returned by [IsRotating].

func (Instance) SetVOffset

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

SetVOffset sets the property returned by [GetVOffset].

func (Instance) VOffset

func (self Instance) VOffset() Float.X

The node's offset perpendicular to the curve.

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