Struct Handle 

pub struct Handle<const FOD: bool, Sp, T, H>(/* private fields */)
where
    T: Sized,
    Sp: TypedSprite,
    H: SpriteDraw;

Implementations

impl<const FOD: bool, Sp, T, H> Handle<FOD, Sp, T, H>

where T: AsRef<Sp>, Sp: TypedSprite, H: SpriteDraw,

pub fn into_inner(self) -> T

• Unregister inner callback for sprite
• Unwrap, return the underlying sprite
• Remove the collision response handler

impl<UD, Api, const FOD: bool, H, H0> Handle<FOD, Sprite<UD, Api, FOD>, Handle<FOD, Sprite<UD, Api, FOD>, H0>, H>

where Api: Api, H: SpriteDraw, H0: SpriteCollisionResponse,

pub fn into_update_handler<T: SpriteUpdate<Userdata = UD>>( self, ) -> Handle<FOD, Sprite<UD, Api, FOD>, Self, T>

where T::Api: Default,

Sets the update function for the this sprite.

impl<UD, Api, const FOD: bool, H, H0> Handle<FOD, Sprite<UD, Api, FOD>, Handle<FOD, Sprite<UD, Api, FOD>, H0>, H>

where Api: Api, H: SpriteDraw, H0: SpriteUpdate,

pub fn into_collision_response_handler<T: SpriteCollisionResponse<Userdata = UD>>( self, ) -> Handle<FOD, Sprite<UD, Api, FOD>, Self, T>

where T::Api: Default,

Sets the collision response function for the this sprite.

Methods from Deref<Target = Sprite<Sp::Userdata, Sp::Api, FOD>>

pub fn add(&self)

Adds the this sprite to the display list, so that it is drawn in the current scene.

Equivalent to sys::ffi::playdate_sprite::addSprite

pub fn remove(&self)

Removes the this sprite from the display list.

Equivalent to sys::ffi::playdate_sprite::removeSprite

pub fn set_bounds(&self, bounds: PDRect)

Sets the bounds of the sprite with bounds.

Equivalent to sys::ffi::playdate_sprite::setBounds

pub fn bounds(&self) -> PDRect

Returns the bounds of the sprite.

Equivalent to sys::ffi::playdate_sprite::getBounds

pub fn move_to(&self, x: c_float, y: c_float)

Moves the sprite to x, y and resets its bounds based on the bitmap dimensions and center.

Equivalent to sys::ffi::playdate_sprite::moveTo

pub fn move_by(&self, dx: c_float, dy: c_float)

Moves the sprite to by offsetting its current position by dx, dy.

Equivalent to sys::ffi::playdate_sprite::moveBy

pub fn set_image(&self, image: impl AnyBitmap, flip: BitmapFlip)

Sets the sprite’s image to the given bitmap.

⚠️ Caution: Using with draw function, call this method before set callback. Setting image after setting draw callback is mostly crashes with SIGBUS.

See also set_opaque.

Equivalent to sys::ffi::playdate_sprite::setImage

pub fn image<'t>(&'t self) -> Option<BitmapRef<'t>>

Returns the bitmap currently assigned to the given sprite.

Equivalent to sys::ffi::playdate_sprite::getImage

pub fn set_size(&self, width: c_float, height: c_float)

Sets the size. The size is used to set the sprite’s bounds when calling move_to.

Equivalent to sys::ffi::playdate_sprite::setSize

pub fn set_z_index(&self, z_index: i16)

Sets the Z order of the sprite. Higher Z sprites are drawn on top of those with lower Z order.

Equivalent to sys::ffi::playdate_sprite::setZIndex

pub fn z_index(&self) -> i16

Returns the Z index of the sprite.

Equivalent to sys::ffi::playdate_sprite::getZIndex

pub fn set_draw_mode(&self, mode: BitmapDrawMode)

Sets the mode for drawing the sprite’s bitmap.

Equivalent to sys::ffi::playdate_sprite::setDrawMode

pub fn set_image_flip(&self, flip: BitmapFlip)

Flips the sprite’s bitmap.

Equivalent to sys::ffi::playdate_sprite::setImageFlip

pub fn image_flip(&self) -> BitmapFlip

Returns the flip setting of the sprite’s bitmap.

Equivalent to sys::ffi::playdate_sprite::getImageFlip

pub fn set_stencil(&self, stencil: impl AnyBitmap)

Specifies a stencil image to be set on the frame buffer before the sprite is drawn.

Equivalent to sys::ffi::playdate_sprite::setStencil

pub fn set_clip_rect(&self, clip: LCDRect)

Sets the clipping rectangle for sprite drawing.

Equivalent to sys::ffi::playdate_sprite::setClipRect

pub fn clear_clip_rect(&self)

Clears the sprite’s clipping rectangle.

Equivalent to sys::ffi::playdate_sprite::clearClipRect

pub fn set_updates_enabled(&self, value: bool)

Set the updates_enabled flag of the sprite (determines whether the sprite has its update function called).

Equivalent to sys::ffi::playdate_sprite::setUpdatesEnabled

pub fn updates_enabled(&self) -> bool

Get the updates_enabled flag of the sprite.

Equivalent to sys::ffi::playdate_sprite::updatesEnabled

pub fn set_collisions_enabled(&self, value: bool)

Set the collisions_enabled flag of the sprite (along with the collide_rect, this determines whether the sprite participates in collisions).

Set to true by default.

See also collide_rect, set_collide_rect, clear_collide_rect.

Equivalent to sys::ffi::playdate_sprite::setCollisionsEnabled

pub fn collisions_enabled(&self) -> bool

Get the collisions_enabled flag of the sprite.

Equivalent to sys::ffi::playdate_sprite::collisionsEnabled

pub fn set_visible(&self, value: bool)

Set the visible flag of the given sprite (determines whether the sprite has its draw function called).

Equivalent to sys::ffi::playdate_sprite::setVisible

pub fn is_visible(&self) -> bool

Get the visible flag of the sprite.

Equivalent to sys::ffi::playdate_sprite::isVisible

pub fn set_opaque(&self, value: bool)

Marking a sprite opaque tells the sprite system that it doesn’t need to draw anything underneath the sprite, since it will be overdrawn anyway.

If you set an image without a mask/alpha channel on the sprite, it automatically sets the opaque flag.

Equivalent to sys::ffi::playdate_sprite::setOpaque

pub fn mark_dirty(&self)

Forces the sprite to redraw.

Equivalent to sys::ffi::playdate_sprite::markDirty

pub fn set_tag(&self, tag: u8)

Sets the tag of the sprite.

This can be useful for identifying sprites or types of sprites when using the collision API.

Equivalent to sys::ffi::playdate_sprite::setTag

pub fn tag(&self) -> u8

Returns the tag of the given sprite.

Equivalent to sys::ffi::playdate_sprite::getTag

pub fn set_ignores_draw_offset(&self, value: bool)

When flag is set to true, the sprite will draw in screen coordinates, ignoring the currently-set draw_offset.

This only affects drawing, and should not be used on sprites being used for collisions, which will still happen in world-space.

See also gfx::set_draw_offset.

Equivalent to sys::ffi::playdate_sprite::setIgnoresDrawOffset

pub fn position(&self) -> (c_float, c_float)

Sets x and y to the current position of sprite.

Equivalent to get_position_to and sys::ffi::playdate_sprite::getPosition

pub fn position_to(&self, x: &mut c_float, y: &mut c_float)

Sets x and y to the current position of sprite.

Equivalent to sys::ffi::playdate_sprite::getPosition

pub fn set_collide_rect(&self, collide: PDRect)

Marks the area of the sprite, relative to its bounds, to be checked for collisions with other sprites’ collide rects.

Equivalent to sys::ffi::playdate_sprite::setCollideRect

pub fn collide_rect(&self) -> PDRect

Returns the sprite’s collide rect.

Equivalent to sys::ffi::playdate_sprite::getCollideRect

pub fn clear_collide_rect(&self)

Clears the sprite’s collide rect.

Equivalent to sys::ffi::playdate_sprite::clearCollideRect

pub fn check_collisions( &self, goal_x: c_float, goal_y: c_float, actual_x: &mut c_float, actual_y: &mut c_float, ) -> Option<Arr<'_, SpriteCollisionInfo>>

Returns the same values as [move_with_collisions] but does not actually move the sprite.

Equivalent to sys::ffi::playdate_sprite::checkCollisions

pub fn move_with_collisions<'t>( &'t self, goal_x: c_float, goal_y: c_float, actual_x: &mut c_float, actual_y: &mut c_float, ) -> Option<Arr<'t, SpriteCollisionInfo>>

Moves the sprite towards goal_x, goal_y taking collisions into account and returns a slice of SpriteCollisionInfo.

actual_x, actual_y are set to the sprite’s position after collisions. If no collisions occurred, this will be the same as goal_x, goal_y.

Resulting slice with entire content can be freely dropped.

Equivalent to sys::ffi::playdate_sprite::moveWithCollisions

pub fn overlapping_sprites(&self) -> Option<Arr<'_, SpriteRef>>

Returns an slice of sprites that have collide rects that are currently overlapping the given sprite’s collide rect.

Equivalent to sys::ffi::playdate_sprite::overlappingSprites

pub fn set_stencil_pattern(&self, pattern: &mut [u8; 8])

Sets the sprite’s stencil to the given pattern.

Equivalent to sys::ffi::playdate_sprite::setStencilPattern

pub fn set_stencil_image(&self, stencil: impl AnyBitmap, tile: bool)

Specifies a stencil image to be set on the frame buffer before the sprite is drawn.

If tile is set, the stencil will be tiled.

Tiled stencils must have width evenly divisible by 32.

Equivalent to sys::ffi::playdate_sprite::setStencilImage

pub fn clear_stencil(&self)

Clears the sprite’s stencil.

Equivalent to sys::ffi::playdate_sprite::clearStencil

pub fn set_center(&self, x: c_float, y: c_float)

Sets the sprite’s drawing center as a fraction (ranging from 0.0 to 1.0) of the height and width.

Default is 0.5, 0.5 (the center of the sprite).

This means that when you call Sprite::move_to(x, y), the center of your sprite will be positioned at x, y.

If you want x and y to represent the upper left corner of your sprite, specify the center as 0, 0.

Equivalent to sys::ffi::playdate_sprite::setCenter.

pub fn center(&self) -> (c_float, c_float)

Returns the sprite’s drawing center as a fraction (ranging from 0.0 to 1.0) of the height and width.

Equivalent to sys::ffi::playdate_sprite::getCenter.

pub fn set_userdata(&self, data: Userdata)

Sets custom data to the sprite.

Used for associating the sprite with other data.

Equivalent to sys::ffi::playdate_sprite::setUserdata

pub fn userdata(&self) -> Option<&mut Userdata>

Gets the mutable_ reference to sprite’s userdata.

Used for associating the sprite with other data.

Equivalent to sys::ffi::playdate_sprite::getUserdata

Trait Implementations

impl<const FOD: bool, Sp, T, H> AsRaw for Handle<FOD, Sp, T, H>

where Sp: TypedSprite, T: AsRaw, H: SpriteDraw,

type Type = <T as AsRaw>::Type

unsafe fn as_raw(&self) -> *mut Self::Type

This method ia actually safe. Unsafety is because so we’re removing owners lifetime that used by some API parts.

impl<const FOD: bool, Sp, T, H> AsRef<Sprite<<Sp as TypedSprite>::Userdata, <Sp as SpriteApi>::Api, FOD>> for Handle<FOD, Sp, T, H>

where T: AsRef<Sprite<Sp::Userdata, Sp::Api, FOD>>, Sp: TypedSprite, H: SpriteDraw,

fn as_ref(&self) -> &Sprite<Sp::Userdata, Sp::Api, FOD>

Converts this type into a shared reference of the (usually inferred) input type.

impl<const FOD: bool, Sp, T, H> Deref for Handle<FOD, Sp, T, H>

where T: AsRef<Sprite<Sp::Userdata, Sp::Api, FOD>>, Sp: TypedSprite, H: SpriteDraw,

type Target = Sprite<<Sp as TypedSprite>::Userdata, <Sp as SpriteApi>::Api, FOD>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<const FOD: bool, Sp, T, H> SpriteApi for Handle<FOD, Sp, T, H>

where Sp: TypedSprite, T: SpriteApi, H: SpriteDraw,

type Api = <T as SpriteApi>::Api

Type of inner API access-point.

fn api(&self) -> Self::Api

where Self::Api: Copy,

Get a copy of inner api access point.

fn api_ref(&self) -> &Self::Api

Get a ref to inner api access point.

impl<const FOD: bool, Sp, T, H> AnySprite for Handle<FOD, Sp, T, H>

where Sp: TypedSprite, T: AnySprite, H: SpriteDraw,

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.