OS_SpriteOp 17 (changes)

Showing changes from revision #1 to #2: Added | Removed | Changed

Programmer's OS Reference SWI Manuals Calls

» Part OS_SpriteOp 15 – SWI Calls

» OS_SpriteOp 17 – Verify sprite areaOS

OS_SpriteOp 17 – Verify sprite area

(SWI &2E)

Use

This call verifies a sprite area by checking that the values in the sprite area header are sensible, that all sprites are within the bounds of the area, and that all sprites have sensible properties.

If the area fails any of the checks, error &71E (“Unrecognised sprite data”) will be returned.

Notes

Old format sprites (where the Sprite Mode Word is just a mode number) have fewer checks performed than new format sprites; this call cannot be used to check if the OS recognises the mode used by an old format sprite.

New format sprites which have an unknown or unsupported sprite type will result in the verification check failing. This allows this call to be used to check if certain sprite types or features (e.g. alpha masks) are supported by the OS.

See also

• Format Of Sprite
• Format Of Sprite Area
• OS_SpriteOp
• Sprite Mode Word