sprite#

Inherited by: Hero, eweapon, ffc, itemsprite, lweapon, npc

Added in version 3.0: In older versions, most of these are implemented as separate variables on many other classes

Base class for (most) script-exposed engine sprites.

Variables#

const int

SpawnScreen

int

X

int

Y

int

Z

int

FakeZ

int

DrawXOffset

int

DrawYOffset

int

DrawZOffset

int

Rotation

int

Dir

int

Tile

int

ScriptTile

int

Extend

int

TileWidth

int

TileHeight

int

CSet

int

Scale

int

DrawStyle

int

Jump

int

FakeJump

bool

Gravity

int

Flip

int

ScriptFlip

bool

Animation

int

HitWidth

int

HitHeight

int

HitZHeight

int

HitXOffset

int

HitYOffset

int

Falling

int

FallCombo

bool[]

MoveFlags

int

LightRadius

int

LightShape

const bool

SwitchHooked

int

ShadowSprite

int

Drowning

int

DrownCombo

int

ShadowXOffset

int

ShadowYOffset

untyped[]

Misc

Enumerations#

enum ExtendMode: 🔗 Source

Sprite rendering extend modes. Used with sprite::Extend.

ExtendMode EXT_NONE = 0

Not extended.

ExtendMode EXT_16X32 = 1

Sprite is extended as 16x32, or Link is extended in Sprites->Link to 16x32.

ExtendMode EXT_32X32 = 2

Sprite is extended as 32x32, or Link is extended in Sprites->Link to 32x32.

ExtendMode EXT_NORMAL = 3

Extended.

ExtendMode EXT_EXTENDED = 3

Extended.

ExtendMode EXT_NOSHADOW = 4

Extended. NPC has no shadow.

enum MoveFlag: 🔗 Source

MoveFlag MV_OBEYS_GRAVITY = 0

MoveFlag MV_CAN_PITFALL = 1

MoveFlag MV_NO_FAKE_Z = 8

MoveFlag MV_NO_REAL_Z = 9

Variable descriptions#

const int SpawnScreen 🔗 Source

Added in version 3.0.

The screen index this sprite was created on. Does not update as the sprite moves around a region.

Hero: Actually does update as the player moves around. Equivalent to Game->HeroScreen.

int X 🔗 Source

int Y 🔗 Source

int Z 🔗 Source

int FakeZ 🔗 Source

The position of the sprite on the fake Z axis. This value is treated as a second, separate Z axis.

Sprites are offset upwards by this amount when drawn just like the Z axis and shadows will draw if applicable.

However, the sprite’s hitbox is not moved upwards in the Z Axis. Instead, it is moved upwards on the Y axis, mimicking how Vires and Pols Voice worked in the original Zelda.

This value is affected by FakeJump instead of Jump.

int DrawXOffset 🔗 Source

The visual offset, in pixels. Defaults to 0.

ffc: currently not supported.

int DrawYOffset 🔗 Source

The visual offset, in pixels. Defaults to 0.

ffc: currently not supported.

int DrawZOffset 🔗 Source

The Z offset, in pixels.

ffc: currently not supported.

int Rotation 🔗 Source

Rotation of the sprite draw, in degrees.

Does nothing if the QR ‘Old (Faster) Sprite Drawing’ is enabled.

ffc: currently not supported.

int Dir 🔗 Source

value Direction (DIR_)

The direction that the sprite is facing. Used by certain weapon types to determine movement, shield deflection and such.

int Tile 🔗 Source

The currently displaying tile of the sprite’s animation. Set by the engine each frame if Animation is enabled.

ffc: Not used - set ffc::Data to the desired combo instead.

int ScriptTile 🔗 Source

If >-1, this tile is displayed by the engine, regardless of the normal engine animation. Set back to -1 to restore engine animation. Defaults to -1.

ffc: currently not supported.

int Extend 🔗 Source

If the sprite should be extended (large). Set to 3 to extend, 0 otherwise.

ffc: Not used. Hero: Reset every frame based on current action, unless ScriptTile is > 0.

int TileWidth 🔗 Source

The width of the sprite’s graphic, in tiles. Visual only. The upper-left corner is the first tile.

Must set Extend to 3 to use (except for fcc).

Max value is 20.

ffc: max value is 4.

int TileHeight 🔗 Source

The height of the sprite’s graphic, in tiles. Visual only. The upper-left corner is the first tile.

Must set Extend to 3 to use (except for fcc).

Max value is 20.

ffc: max value is 4.

int CSet 🔗 Source

Hero: This changes when the Hero is hurt and flashing. Writing to this does nothing, as the Hero cset is updated by the engine every frame - use Hero->ScriptCSet instead.

int Scale 🔗 Source

The multiplier for scaling the sprite draw.

Scale values are a multiplier: 1.5 == 50% larger (150%). A scale of 0 and a scale of 1 are identical. Negative values are undefined.

Does nothing if the QR ‘Old (Faster) Sprite Drawing’ is enabled.

ffc: currently not supported.

int DrawStyle 🔗 Source

value DrawStyle

The drawing style to use.

int Jump 🔗 Source

Upward velocity, in pixels per frame. Affected by gravity each frame, if Gravity is true.

int FakeJump 🔗 Source

The current velocity on the FakeZ axis. This value is added to FakeZ every frame; and this value is decreased by the gravity value until it is lower than the terminal velocity value.

bool Gravity 🔗 Source

If gravity affects this sprite in sideview mode. True by default.

int Flip 🔗 Source

value TransformationType (FLIP_ or ROT_)

How to flip (or rotate) the sprite.

int ScriptFlip 🔗 Source

If >-1, this flip value will be used instead of Flip. Set back to -1 to restore normal flip.

Defaults to -1.

bool Animation 🔗 Source

If the engine should animate the sprite’s graphics. If set to false, scripts must set Tile to update the sprite’s graphics manually. Defaults to true.

ffc: Not used.

int HitWidth 🔗 Source

The width of the hitbox, in pixels.

int HitHeight 🔗 Source

The height of the hitbox, in pixels.

int HitZHeight 🔗 Source

The height of the hitbox in the Z-axis, in pixels.

int HitXOffset 🔗 Source

The hitbox offset, in pixels.

int HitYOffset 🔗 Source

The hitbox offset, in pixels.

int Falling 🔗 Source

The timer indicating how many more frames the sprite will fall. If 0, the sprite is not falling. Max value of 70, which is the value at the start of falling.

Hero: Setting Hero->Action to LA_FALLING also sets this to 70.

int FallCombo 🔗 Source

The pitfall combo the sprite is falling into, if it is falling.

Hero:

If non-zero, this combo’s attributes will affect things such as if the Hero will warp, and how much damage they will take upon finishing falling.

If 0, the Hero will take 1/4 heart of damage, and not warp.

Setting Hero->Action to LA_FALLING will overwrite this value.

Setting Falling will overwrite this value.

bool[] MoveFlags 🔗 Source

value MoveFlag (MV_)

The sprite’s movement flags.

int LightRadius 🔗 Source

The size of the light emitted by this sprite, in pixels.

int LightShape 🔗 Source

value LightShape

The shape of light emitted by this sprite.

const bool SwitchHooked 🔗 Source

If the sprite is currently being switch-hooked.

Note: currently not supported for ffc, Hero.

int ShadowSprite 🔗 Source

value SpriteID (SP_)

The spritedata ID to use for the sprite’s shadow.

int Drowning 🔗 Source

The timer indicating how long left the sprite will be drowning. If 0, the sprite is not drowning. Max value of 64, which is the value at the start of drowning.

int DrownCombo 🔗 Source

The liquid combo the sprite is drowning in, if it is drowning.

int ShadowXOffset 🔗 Source

Offset for the sprite’s shadow.

int ShadowYOffset 🔗 Source

Offset for the sprite’s shadow.

untyped[] Misc 🔗 Source

An array of 32 misc values for scripts to use.

ffc: only 16 values.