Object

(Called internally) Clears all cached transforms, and force-stops caching.

Adds the specified object as a child to this object, and adds it to a stage if it was not added to one previously.
Calls child:onAdd(self).

Adds a DrawFX to the object.
DrawFX are classes that can apply visual effects to an object when drawing it.
Each effect will be applied in sequence, with effects of higher priority rendering later.

Called during drawing to apply cutouts.

(Override)
By default, returns self.debug_select.

Whether the object is colliding with another object or collider.

(Override) Called every frame by its parent during drawing if the object is visible.
By default, draws its children.

End caching the transforms of all objects (started with Object.startCache()).

options:
    | "play_sound" -- Whether it should play the sound. (Defaults to true)

Fades the object's alpha to 0 over time seconds, then removes it.

Fades the object's alpha to 0 at a speed of speed per frame, then removes it.

Fades the object's alpha to the specified value over time seconds.

Fades the object's alpha to the specified value at a speed of speed per frame.

Returns the camera origin of the object, simplifying to be a ratio relative to its width and height if its current camera origin is exact.

Returns the camera origin of the object, multiplying to give the exact pixels if its current camera origin is not exact.

Returns the values of the object's color and alpha values.

Returns the object's cutout values.

(Override)
By default, returns an empty table.

(Override) Defines options that can be used when selecting the object with the Object Selection debug feature.
By default, defines options that all objects use. To define an option, use context:addMenuItem(name: string, description: string, code: function), where:

• name defines the name that appears in the menu.
• description defines the text that appears when hovering over the option.
• code is the function that will be called when selecting the option.

(Override) Returns a table defining the rectangle to use for selecting the object with the Object Selection debug feature.
By default, returns self.debug_rect, or a rectangle with the same width and height as the object if self.debug_rect is nil.

Returns the object's physics.direction, or the object's rotation if physics.match_rotation is true.

Returns the object's color and alpha.
If the object's inherit_color is true, the result is multiplied by its parent's color and alpha, to get the color it should draw at.

Returns a DrawFX added to the object.

Returns the object's scale, multiplied by its parent's full scale.

@return hierarchy — A table of all parents between this object and its stage (inclusive).

Returns the dimensions of the object's collider if that collider is a Hitbox.

Returns the layer of the object.

Returns the origin of the object, simplifying to be a ratio relative to its width and height if its current origin is exact.

Returns the origin of the object, multiplying to give the exact pixels if its current origin is not exact.

Returns the parallax of the object.

Returns the parallax origin of the object.

Returns the position of the object.

Returns the specified position for the object, relative to another object.

Returns the object's position, relative to another object.

Returns the rotation origin of the object, simplifying to be a ratio relative to its width and height if its current rotation origin is exact.
If the object doesn't have a rotation origin defined, it will return self:getOrigin() instead.

Returns the rotation origin of the object, multiplying to give the exact pixels if its current rotation origin is not exact.
If the object doesn't have a rotation origin defined, it will return self:getOriginExact() instead.

Returns the scale of the object.

Returns the scaling origin of the object, simplifying to be a ratio relative to its width and height if its current scaling origin is exact.
If the object doesn't have a scaling origin defined, it will return self:getOrigin() instead.

Returns the scaling origin of the object, multiplying to give the exact pixels if its current scaling origin is not exact.
If the object doesn't have a scaling origin defined, it will return self:getOriginExact() instead.

Returns the height of the object, accounting for scale.

Returns the size of the object, accounting for scale.

Returns the width of the object, accounting for scale.

Returns the object's position relative to the topleft of the game window.

Returns the size of the object.

(Override) Used by World to determine what position should be used when sorting its layer.
By default, returns self:getRelativePos(self.width/2, self.height).

Returns the velocity and direction of the object's physics, converting physics.speed_x and physics.speed_y if necessary.

Returns the horizontal and vertical speed of the object's physics, converting physics.speed and physics.direction if necessary

@return stage — The object's highest parent.

(Override)
By default, returns true.

Returns whether the object and its parents are active, determining whether the object should be updated or not.

Returns whether the object and its parents are visible, determining whether the object should be drawn or not.

@return has_stage — Whether the object has a parent or not.

Returns the specified position for the object, relative to the object's stage.

Moves the object's x and y values by the specified values.

(Override) Called when the object is added to a parent object via parent:addChild(self) or self:setParent(parent).

(Override) Called when the object is first added to the Game stage, via parent:addChild(self) or self:setParent(parent).
Will not be called when changing to a new parent via self:setParent(new_parent) if the object had a parent prior.

(Override) Called when the object is removed from its parent object via self:remove(), parent:removeChild(self), or self:setParent(new_parent).

(Override) Called when the object is removed from the Game stage via self:remove() or parent:removeChild(self).
Will not be called when changing to a new parent via self:setParent(new_parent).

Removes the object from its parent.

Removes the specified object from this object's children, and removes it from its stage.
Calls child:onRemove(self).

Removes the specified DrawFX from the object.

Resets all of the object's graphics table values to their default values,
making it so it will stop transforming if it was before.

Resets all of the object's physics table values to their default values,
making it so it will stop moving if it was before.

Returns the specified position for the object's stage, relative to this object.

Sets the object's camera_origin_x and camera_origin_y values to the specified origin, and sets camera_origin_exact to false.
The camera origin set by this function will therefore be a ratio relative to the object's width and height.

Sets the object's camera_origin_x and camera_origin_y values to the specified origin, and sets camera_origin_exact to true.
The camera origin set by this function will therefore be in exact pixels.

Sets the object's color and alpha values to the specified color.

Sets the object's cutout values to the specified cutout.

Sets the object's movement direction to the specified direction, or its rotation if physics.match_rotation is true.

Resets the object's graphics and sets new values for it.

Sets the object's collider to a new Hitbox with the specified dimensions.

Sets the object's layer, and updates its position in its parent's children list.

Sets the object's origin_x and origin_y values to the specified origin, and sets origin_exact to false.
The origin set by this function will therefore be a ratio relative to the object's width and height.

Sets the object's origin_x and origin_y values to the specified origin, and sets origin_exact to true.
The origin set by this function will therefore be in exact pixels.

Sets the object's parallax_x and parallax_y to the specified parallax.

Sets the object's parallax_origin_x and parallax_origin_y values to the specified origin.

Sets the object's parent, removing it from its previous parent if it had one.

Resets the object's physics and sets new values for it.

Sets the object's x and y values to the specified position.

Sets the object's rotation_origin_x and rotation_origin_y values to the specified origin, and sets rotation_origin_exact to false.
The rotation origin set by this function will therefore be a ratio relative to the object's width and height.

Sets the object's rotation_origin_x and rotation_origin_y values to the specified origin, and sets rotation_origin_exact to true.
The rotation origin set by this function will therefore be in exact pixels.

Sets the object's scale_x and scale_y values to the specified scale.

Sets the object's scale_origin_x and scale_origin_y values to the specified origin, and sets scale_origin_exact to false.
The scaling origin set by this function will therefore be a ratio relative to the object's width and height.

Sets the object's scale_origin_x and scale_origin_y values to the specified origin, and sets scale_origin_exact to true.
The scaling origin set by this function will therefore be in exact pixels.

Sets the object's position relative to the topleft of the game window.

Sets the object's width and height values to the specified size.

Sets the object's speed in its physics table.

Makes the object shake by the specified amount.

Sets the object's relative origin to the specified values, and adjusts its position so that it stays in the same place visually.

Sets the object's exact origin to the specified values, and adjusts its position so that it stays in the same place visually.

Moves the object along a path of points.

options:
    | "time" -- The amount of time, in seconds, that the object should take to travel along the full path.
    | "speed" -- The speed at which the object should travel along the path, in pixels per frame at 30FPS.
    | "ease" -- The ease type to use when travelling along the path. Unused if `speed` is specified instead of `time`. (Defaults to "linear")
    | "after" -- A function that will be called when the end of the path is reached. Receives no arguments.
    | "move_func" -- A function called every frame while the object is travelling along the path. Receives `self` and the `x` and `y` offset from the previous frame as arguments.
    | "relative" -- Whether the path should be relative to the object's current position, or simply set its position directly.
    | "loop" -- Whether the path should loop back to the first point when reaching the end, or if it should stop.
    | "reverse" -- If true, reverse all of the points on the path.
    | "skip" -- A number defining how many points of the path to skip.
    | "snap" -- Whether the object's position should immediately "snap" to the first point, or if its initial position should be counted as a point on the path.

Moves the object's x and y values to the new specified position over time seconds.

Moves the object's x and y values to the new specified position at a speed of speed pixels per frame.

Begin caching the transforms of all objects.
This should be called before any collision checks, and ended with Object.endCache().
If an object is moved mid-cache, call Object.uncache() on it.

Stops the object from shaking.

Uncache an object's transform, if Object.startCache() is active.
This recalculates the object's transform and all of its children, incase it was moved.

(Called internally) Uncaches an object's full transform, including all of its children.

(Override) Called every frame by its parent if the object is active.
By default, updates its physics and graphics tables, and its children.

(Used internally) Whether the object should draw its children or not.

Whether the object should update itself and its children.

The alpha transparency of the object, between 0 (invisible) and 1 (fully visible).

A camera instance that will automatically move and scale the object and its children. Should be nil for most objects.

Whether the object's camera origin is measured as a ratio of its width and height, or in exact pixels. (Defaults to false)

The horizontal camera origin of the object. (Defaults to 0.5)
Camera origin defines what position on the object a camera attached to it should follow.

The vertical camera origin of the object. (Defaults to 0.5)
Camera origin defines what position on the object a camera attached to it should follow.

A list of all of this object's children.

(Used internally) A list of children for the object to remove next time it updates.

Whether the object should be able to collide with other objects.

A Collider class used to check collision with other objects.

The color of the object in the form {R, G, B}.
The values of R, G, and B are between 0 and 1.

The amount of pixels to cut from the bottom of the object when drawing.

The amount of pixels to cut from the left of the object when drawing.

The amount of pixels to cut from the right of the object when drawing.

The amount of pixels to cut from the top of the object when drawing.

Defines the rectangle used for selecting the object with the Object Selection debug feature.

Whether the object can be selected by the Object Selection debug feature. (Defaults to true)

If defined, children with a layer greater than this value will be drawn above the object.

If defined, children with a layer less than this value will be drawn underneath the object.

A list of all DrawFX that are being applied to the object.

Whether the object is flipped horizontally.

Whether the object is flipped vertically.

A table of data, defining ways the object's properties should automatically update.

The height of the object.

Whether the object's color will be multiplied by its parent's color.

The horizontal position of the object when it was created.

The vertical position of the object when it was created.

The horizontal position of the object in the previous frame.

The vertical position of the object in the previous frame.

The layer of the object within its parent.
Objects update and draw their children in order sorted by layer. Objects with a higher layer will update and draw later than objects with lower layers.

All children of an object will draw at the same visual layer as the parent. In other words, a child cannot render above an object that is higher than its parent, even if its own layer is higher.

Whether the object's origin is measured as a ratio of its width and height, or in exact pixels. (Defaults to false)

The horizontal origin of the object.
Origin is used to define the point that the object is scaled, rotated, and positioned from.
This determines where the position (0, 0) is within the object.

If origin_exact is false, the origin will be a ratio relative to the object's width and height, meaning an origin of 0.5, 0.5 will cause the object to be centered.
If it is true, then the origin will be measured in exact pixels.

The vertical origin of the object.
Origin is used to define the point that the object is scaled, rotated, and positioned from.
This determines where the position (0, 0) is within the object.

If origin_exact is false, the origin will be a ratio relative to the object's width and height, meaning an origin of 0.5, 0.5 will cause the object to be centered.
If it is true, then the origin will be measured in exact pixels.

The horizontal position on the object's parent that the object's parallax will orient around.

The vertical position on the object's parent that the object's parallax will orient around.

How much an object's position will be affected by the camera horizontally.
A value of 1 means it fully moves with the camera (aka default behavior), and a value of 0 means it will not move at all when the camera moves.
Parallax will only affect an object if its parent has a camera.

How much an object's position will be affected by the camera vertically.
A value of 1 means it fully moves with the camera (aka default behavior), and a value of 0 means it will not move at all when the camera moves.
Parallax will only affect an object if its parent has a camera.

The object's parent.

A table of data, defining ways the object should automatically move when updating.

The rotation of the object, in radians. (0 is right, positive is clockwise)

Whether the object's rotation origin is measured as a ratio of its width and height, or in exact pixels. (Defaults to false)

The horizontal rotation origin of the object.
Rotation origin overrides the object's origin, and defines where the object will rotate from.

The vertical rotation origin of the object.
Rotation origin overrides the object's origin, and defines where the object will rotate from.

Whether the object's scale origin is measured as a ratio of its width and height, or in exact pixels. (Defaults to false)

The horizontal scale origin of the object.
Scale origin overrides the object's origin, and defines where the object will scale from.

The vertical scale origin of the object.
Scale origin overrides the object's origin, and defines where the object will scale from.

The horizontal scale of the object.

The vertical scale of the object.

A multiplier that determines the speed at which the object updates.

(Used internally) If true, the object will re-sort its children list.

Whether the object should draw itself and its children.

The width of the object.

The horizontal position of the object, relative to its parent.

The vertical position of the object, relative to its parent.