Sprite - Revision history

JoeStrout: add uvs and setUVs

2025-08-05T22:46:18Z

add uvs and setUVs

Shellrider: Change pare to pair. Either it was a mistake before, or it was less accessible language. Pair is more easily understood.

2025-07-04T09:36:52Z

Change pare to pair. Either it was a mistake before, or it was less accessible language. Pair is more easily understood.

Turtlezero: /* See also */ Added a link to orphaned "sprite sheet" page.

2025-02-17T14:44:13Z

See also: Added a link to orphaned "sprite sheet" page.

Duck Mim: Fixing

2025-01-29T17:19:18Z

Fixing

Duck Mim: /* Methods and properties used with Sprite objects */ Better look

2025-01-29T17:18:48Z

Methods and properties used with Sprite objects: Better look

Duck Mim: /* Methods and properties used with Sprite objects */ Add feedback features

2025-01-29T16:13:33Z

Methods and properties used with Sprite objects: Add feedback features

Duck Mim: /* Methods and properties used with Sprite objects */

2025-01-29T11:26:22Z

Methods and properties used with Sprite objects

JoeStrout: /* Usage Notes (Soda) */

2022-02-28T20:40:40Z

Usage Notes (Soda)

JoeStrout: /* Methods and properties used with Sprite objects */

2022-02-28T20:40:19Z

Methods and properties used with Sprite objects

JoeStrout: added corners and setCorners

2022-02-28T20:39:32Z

added corners and setCorners

@@ Line 34: / Line 34: @@
 |-
 | [[Sprite.corners]] || return <c>[x,y]</c> screen positions of the four corners of this sprite, counter-clockwise from bottom left || 4 pairs of numbers
 |-
 | colspan=3  style="text-align: center;"| '''Run'''
 |-
 |-
-| [[Sprite.setCorners]] ''corners''|| set new screen positions for the four sprite corners (counter-clockwise from bottom left)
+| [[Sprite.setUVs]] ''uvs''|| set new texture coordinates for the four sprite corners (counter-clockwise from bottom left)
 |-
 |}

@@ Line 27: / Line 27: @@
 |-
 |-
-| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position || pare of numbers
+| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position || pair of numbers
 |-
 | [[Sprite.contains]](''x'', ''y'') || return whether the sprite contains the given world point || bool
@@ Line 33: / Line 33: @@
 | [[Sprite.overlaps]](''other'') || return whether this sprite is touching another sprite or [[Bounds]] || bool
 |-
-| [[Sprite.corners]] || return <c>[x,y]</c> screen positions of the four corners of this sprite, counter-clockwise from bottom left || 4 pares of numbers
+| [[Sprite.corners]] || return <c>[x,y]</c> screen positions of the four corners of this sprite, counter-clockwise from bottom left || 4 pairs of numbers
 |-
 | colspan=3  style="text-align: center;"| '''Run'''

@@ Line 71: / Line 71: @@
 * [[How to move a sprite towards a target]]
 * [[How to point a sprite at a target]]
 [[Category: Mini Micro]]
 [[Category: Soda]]

@@ Line 37: / Line 37: @@
 | colspan=3  style="text-align: center;"| '''Run'''
 |-
 |-
 | [[Sprite.setCorners]] ''corners''|| set new screen positions for the four sprite corners (counter-clockwise from bottom left)

@@ Line 4: / Line 4: @@
 Use these methods on Sprite instances, created with <c>[[new]] Sprite</c>.
 {| class="wikitable"
 |-
 ! Method or Property !! Purpose !! Type
 |-
 | [[Sprite.image]] || image displayed  by the sprite || [[Image]]
 |-
-| [[Sprite.x]] || horizontal position of the sprite || Number
+| [[Sprite.x]] || horizontal position of the sprite || number
 |-
-| [[Sprite.y]] || vertical position of the sprite || Number
+| [[Sprite.y]] || vertical position of the sprite || number
 |-
-| [[Sprite.scale]] || sprite scale (default 1.0) || Number
+| [[Sprite.scale]] || sprite scale (default 1.0) || number
 |-
-| [[Sprite.rotation]] || sprite rotation (degrees counter-clockwise) || Number
+| [[Sprite.rotation]] || sprite rotation (degrees counter-clockwise) || number
 |-
-| [[Sprite.tint]] || tint color (defaults to white) || String (color)
+| [[Sprite.tint]] || tint color (defaults to white) || string (color)
 |-
 | [[Sprite.localBounds]] || stores the local bounds of the sprite || [[Bounds]]
 |-
-|}
+| colspan=3 style="text-align: center;" | '''Read only'''
 |-
 |-
-| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position || Pare of numbers
+| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position || pare of numbers
 |-
-| [[Sprite.contains]](''x'', ''y'') || return whether the sprite contains the given world point || Bool
+| [[Sprite.contains]](''x'', ''y'') || return whether the sprite contains the given world point || bool
 |-
-| [[Sprite.overlaps]](''other'') || return whether this sprite is touching another sprite or [[Bounds]] || Bool
+| [[Sprite.overlaps]](''other'') || return whether this sprite is touching another sprite or [[Bounds]] || bool
 |-
 | [[Sprite.corners]] || return <c>[x,y]</c> screen positions of the four corners of this sprite, counter-clockwise from bottom left || 4 pares of numbers
 |-
-|}
+| colspan=3  style="text-align: center;"| '''Run'''
 |-
 ! Method or Property !! Purpose

@@ Line 1: / Line 1: @@
 <c>Sprite</c> is a built-in class in the [[Mini Micro]] API.  It represents an image which can be added to a [[SpriteDisplay]], enabling it to be drawn to the screen very efficiently while also being scaled, rotated, or tinted, and layered consistently with other sprites and the surrounding displays.
-=== Methods and properties used with Sprite objects ===
+== Methods and properties used with Sprite objects ==
 Use these methods on Sprite instances, created with <c>[[new]] Sprite</c>.
 {| class="wikitable"
 |-
-! Method or Property !! Purpose
+! Method or Property !! Purpose !! Value
 |-
-| [[Sprite.image]] || image displayed by the sprite
+| [[Sprite.image]] || image displayed  by the sprite || Input: image
 |-
-| [[Sprite.x]] || horizontal position of the sprite
+| [[Sprite.x]] || horizontal position of the sprite || Input: number
 |-
-| [[Sprite.y]] || vertical position of the sprite
+| [[Sprite.y]] || vertical position of the sprite || Input: number
 |-
-| [[Sprite.scale]] || sprite scale (default 1.0)
+| [[Sprite.scale]] || sprite scale (default 1.0) || Input: number
 |-
-| [[Sprite.rotation]] || sprite rotation (degrees counter-clockwise)
+| [[Sprite.localBounds]] || stores the local bounds of the sprite || Input: [[Bounds]]
 |-
-| [[Sprite.tint]] || tint color (defaults to white)
+|}
 |-
-| [[Sprite.localBounds]] || stores the local bounds of the sprite
+! Method or Property !! Purpose !! Value
 |-
-| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position
+| [[Sprite.worldBounds]] || computes world bounds from local bounds and current position || Input: NULL
 |-
-| [[Sprite.contains]](''x'', ''y'') || return whether the sprite contains the given world point
+| [[Sprite.contains]](''x'', ''y'') || return whether the sprite contains the given world point || Input: x: number; y: number
 |-
-| [[Sprite.overlaps]](''other'') || return whether this sprite is touching another sprite or [[Bounds]]
+| [[Sprite.overlaps]](''other'') || return whether this sprite is touching another sprite or [[Bounds]] || Input: [[Sprite]]
 |-
-| [[Sprite.corners]] || return <c>[x,y]</c> screen positions of the four corners of this sprite, counter-clockwise from bottom left
+! Method or Property !! Purpose !! Value
 |-
-| [[Sprite.setCorners]] ''corners''|| set new screen positions for the four sprite corners (counter-clockwise from bottom left)
+| [[Sprite.setCorners]] ''corners''|| set new screen positions for the four sprite corners (counter-clockwise from bottom left) || Input: 4 pares of numbers
 |-
 |}

← Older revision		Revision as of 20:40, 28 February 2022
Line 38:		Line 38:

	In [[Soda]] there is currently only one, implicit, [[Display]]. So to add sprites to this display, push them onto a global list called <c>sprites</c>.		In [[Soda]] there is currently only one, implicit, [[Display]]. So to add sprites to this display, push them onto a global list called <c>sprites</c>.
		+
		+	[[Soda]] does not currently support [[Sprite.corners]] or [[Sprite.setCorners]].

	== Example ==		== Example ==