itemsprite#

Inherits: sprite

An active item on the screen. See Screen->LoadItem() and Screen->CreateItem().

Variables#

int	Max
int	ID
int	Type
int	Family
int	Level
int	OriginalTile
int	FlashCSet
int	NumFrames
int	Frame
int	ASpeed
int	Delay
bool	Flash
int	Pickup
bool	NoSound
bool	NoHoldSound
untyped[]	InitD
int	AClock
int	PickupString
int	PickupStringFlags
int	Script
int	DroppedBy
bool	ForceGrab
const int	UID deprecated
int	SizeFlags deprecated

Functions#

int	Max() deprecated
void	Max(int value) deprecated
bool	isValid()
void	Explode(int mode)
void	Remove()
bool	Switch(int effect)
void	Own(bitmap b)
void	Own(paldata b)
void	Own(file b)
void	Own(directory b)
void	Own(stack b)
void	Own(randgen b)
void	OwnArray(untyped array)
void	OwnObject(untyped object)

Variable descriptions#

int Max 🔗 Source

Max number of itemsprites currently allowed.

int ID 🔗 Source

The item ID to give when the item is collected.

int Type 🔗 Source

The type itemdata of the item. Uses the IC_ constants.

int Family 🔗 Source

The type itemdata of the item. Uses the IC_ constants.

int Level 🔗 Source

The item’s level

int OriginalTile 🔗 Source

The starting tile of the itemsprite’s animation.

int FlashCSet 🔗 Source

The secondary CSet used for flashing.

int NumFrames 🔗 Source

The number of frames in the itemsprite’s animation.

int Frame 🔗 Source

The current frame number that the animation is on.

int ASpeed 🔗 Source

The speed of the animation, in frames per frame.

int Delay 🔗 Source

The number of delay frames at the start of the itemsprite’s animation.

bool Flash 🔗 Source

If the itemsprite is flashing or not. When flashing, it changes between its’ CSet and FlashCSet.

int Pickup 🔗 Source

The item pickup flags, as a bitwise flagset. Use the IP_ constants to access. Take care when using any INTERNAL flags.

bool NoSound 🔗 Source

If true, picking up the item does not play it’s usual pickup sound assigned in the item editor. Does not affect holdup sound.

bool NoHoldSound 🔗 Source

If true, picking up the item does not play the screen’s holdup sound. Does not affect the usual pickup sound assigned in the item editor.

untyped[] InitD 🔗 Source

The 8 InitD[] arguments for the itemsprite script.

int AClock 🔗 Source

The timer that ASpeed is used with.

int PickupString 🔗 Source

The message string to display upon picking up the item.

int PickupStringFlags 🔗 Source

The flags associated with the pickup string, as bitwise flags. Use the IPSTR_ constants to access this.

int Script 🔗 Source

The itemsprite script running on this itemsprite.

int DroppedBy 🔗 Source

The dropset that this item was dropped by. Will be set for engine-dropped items, can be written by scripts as well.

bool ForceGrab 🔗 Source

If set to true, the item will automatically be collected by the Hero as soon as possible.

const int UID 🔗 Source

Warning

Deprecated!

int SizeFlags 🔗 Source

A flagset that determines how internal engine sizing of items is applied.

Values are ORd together, as follows:

Warning

Deprecated!

Function descriptions#

int Max() 🔗 Source

Returns the max number of itemsprites currently allowed.

Warning

Deprecated! Use Max instead!

void Max(int value) 🔗 Source

Sets the max number of itemsprites allowed to a new value. Range 1-1024.

Warning

Deprecated! Use Max instead!

bool isValid() 🔗 Source

Returns true if this pointer points to a valid itemsprite. If this returns false, using any other value of this pointer will error.

void Explode(int mode) 🔗 Source

Creates an explosion particle effect in mode 0, 1, or 2 of the sprite.

void Remove() 🔗 Source

Instantly deletes the itemsprite.

bool Switch(int effect) 🔗 Source

Switch the Hero with this sprite.

Valid values for effect: SwitchEffect (SW_EFF_).

void Own(bitmap b) 🔗 Source