Merge pull request #3 from c128lib/intoinside/issue2

Support for sprites

Author: intoinside

lib/common.asm

@@ -144,3 +144,17 @@ upstartEnd:
       }
     }
 }
+
+/**
+ * @brief Generates the negative value for the argument
+ *
+ * @param[in] value Value to negated
+ *
+ * @since 1.2.0
+*/
+.function neg(value) {
+  .return value ^ $FF
+}
+.assert "neg($00) gives $FF", neg($00), $FF
+.assert "neg($FF) gives $00", neg($FF), $00
+.assert "neg(%10101010) gives %01010101", neg(%10101010), %01010101

lib/vic2-global.asm

@@ -157,3 +157,191 @@
  * @since 1.0.0
  */
 .macro @c128lib_SetScreenMemoryAndBitmapPointer(config) { SetScreenMemoryAndBitmapPointer(config) }
+
+/**
+ * @brief Sets X position of given sprite (uses sprite MSB register if necessary)
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] x X position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpriteXPosition(spriteNo, x) { SetSpriteXPosition(spriteNo, x) }
+
+/**
+ * @brief Sets X position of given sprite (uses sprite MSB register if necessary)
+ * using shadow registers
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] x X position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpriteXPositionWithShadow(spriteNo, x) { SetSpriteXPositionWithShadow(spriteNo, x) }
+
+/**
+ * @brief Sets y position of given sprite
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] y Y position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpriteYPosition(spriteNo, y) { SetSpriteYPosition(spriteNo, y) }
+
+/**
+ * @brief Sets y position of given sprite using shadow registers
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] y Y position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpriteYPositionWithShadow(spriteNo, y) { SetSpriteYPositionWithShadow(spriteNo, y) }
+
+/**
+ * @brief Sets x and y position of given sprite
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] x X position of sprite
+ * @param[in] y Y position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpritePosition(spriteNo, x, y) { SetSpritePosition(spriteNo, x, y) }
+
+/**
+ * @brief Sets x and y position of given sprite using shadow registers
+ *
+ * @param[in] spriteNo Number of the sprite to move
+ * @param[in] x X position of sprite
+ * @param[in] y Y position of sprite
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SetSpritePositionWithShadow(spriteNo, x, y) { SetSpritePositionWithShadow(spriteNo, x, y) }
+
+/**
+ * @brief Define sprite movement
+ *
+ * @param[in] spriteNo Number of the sprite to set movement
+ * @param[in] speed Speed of sprite
+ * @param[in] quadrant Determines main direction of sprite (use SPRITE_MAIN_DIR_* labels)
+ * @param[in] deltaX move sprite on X each interrupt
+ * @param[in] deltaY move sprite on Y each interrupt
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteMove(spriteNo, speed, quadrant, deltaX, deltaY) { SpriteMove(spriteNo, speed, quadrant, deltaX, deltaY) }
+
+/**
+ * @brief Enable one or more sprite, preserving status of other sprites.
+ *
+ * @param[in] mask Sprite mask
+ * (use SPRITE_MASK_* eventually with | to enable more sprite at once)
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteEnable(mask) { SpriteEnable(mask) }
+
+/**
+ * @brief Disable one or more sprite, preserving status of other sprites.
+ *
+ * @param[in] mask Sprite mask
+ * (use SPRITE_MASK_* eventually with | to disable more sprite at once)
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteDisable(mask) { SpriteDisable(mask) }
+
+/**
+ * @brief Enable multicolor setting for one or more sprite, preserving status of other sprites.
+ *
+ * @param[in] mask Sprite mask
+ * (use SPRITE_MASK_* eventually with | to set multicolor on more sprite at once)
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteEnableMulticolor(mask) { SpriteEnableMulticolor(mask) }
+
+/**
+ * @brief Disable multicolor setting for one or more sprite, preserving status of other sprites.
+ *
+ * @param[in] mask Sprite mask
+ * (use SPRITE_MASK_* eventually with | to unset multicolor on more sprite at once)
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteDisableMulticolor(mask) { SpriteDisableMulticolor(mask) }
+
+/**
+ * @brief Disable multicolor setting for one or more sprite.
+ *
+ * @param[in] spriteNo Number of the sprite to set movement
+ * @param[in] color Color to set
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteColor(spriteNo, color) { SpriteColor(spriteNo, color) }
+
+/**
+ * @brief Set sprite multi color 0
+ *
+ * @param[in] color Color to set
+ *
+ * @note Use c128lib_SpriteMultiColor0 in vic2-global.asm
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteMultiColor0(color) { SpriteMultiColor0(color) }
+
+/**
+ * @brief Set sprite multi color 1
+ *
+ * @param[in] color Color to set
+ *
+ * @remark Register .A will be modified.
+ * @remark Flags N and Z will be affected.
+ *
+ * @since 1.2.0
+ */
+.macro c128lib_SpriteMultiColor1(color) { SpriteMultiColor1(color) }