OS_SpriteOp 49 (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 49 – Plot mask at user coordsOS

OS_SpriteOp 49 – Plot mask at user coords

(SWI &2E)

Use

This call paints a sprite mask to the screen. For sprite pixels where the mask is non-zero, the corresponding screen pixel will be set to the currently selected background colour. If the mask is zero the screen pixel will not be updated.

This call does not attempt to translate between different colour depths. Unless you know the source and destination are in compatible modes, it’s recommended to use OS_SpriteOp 50 - Plot Mask Scaled instead. However due to the overheads involved in OS_SpriteOp 50, using OS_SpriteOp 49 where possible can result in significant performance gains.

Notes

Coordinates are in OS units, and specify the bottom-left corner of the sprite.

No scaling is performed; source pixels will map directly to destination pixels, regardless of the sprite DPI or screen eigen values.

When used on a sprite without a mask, a filled rectangle the size of the scaled sprite will be drawn.

This call does not support plotting of alpha masks.

See also

• Format Of Sprite
• Format Of Sprite Area
• OS_SpriteOp
• OS_SpriteOp 50 - Plot Mask Scaled