CreateDummySprite

Family: Sprite · 2 forms

What it does

CreateDummySprite brings a Sprite object into being: it is how the rest of the program comes to have one. It takes iSpriteIndex (an integer), and returns nothing. That is the first of 2 forms. iSpriteIndex is the id you are giving a Sprite object: every later call names it by that number.

Syntax

1
CreateDummySprite(iSpriteIndex integer)
2
CreateDummySprite() → integer

Parameters

NameTypeIn forms
iSpriteIndexinteger1

What each form returns

1CreateDummySprite(1)nothing
2dummySprite = CreateDummySprite()integer

Example · generated

Form 1, you choose the id yourself

CreateDummySprite(1)DO  Sync()LOOP

Form 2, the command hands back the id

dummySprite = CreateDummySprite()DO  Sync()LOOP

CreateDummySprite is called with values of the types its signature asks for. The DO … LOOP is not decoration: a classic BASIC program ends the moment it runs out of lines, and Sync() is what draws the frame.

Related commands

135 commands in Sprite