PositionSprite - Learn To Code - PlayBASIC Documentation

PositionSprite

PositionSprite SpriteIndex, Xpos#, Ypos#

Parameters:

    SpriteIndex = The identifier of the sprite you wish to position
    Xpos# = X position of sprite
    Ypos# = Y position of sprite

Returns: NONE

PositionSprite positions a sprite to specific X and Y position.

FACTS:

* PositionSprite does not alter the Z position of this sprite. If you wish to the change the depth of the sprite either use PositionSpriteZ, or PositionSpriteXYZ

* Also See MoveSprite

Mini Tutorial:

Create a sprite, set it's position, then display this position to the screen.

; Create the Sprite
  CreateSprite 1

; Set this sprites entities X and Y Positions to 100x,200y
  PositionSprite 1, 100,200

; Read and display sprite 1's position X,Y and Z position
; to the screen.
  Print GetSpriteX(1)
  Print GetSpriteY(1)
  Print GetSpriteZ(1)


; Display the Screen and wait for the user to press a key
  Sync
  WaitKey

This example would output.

  100.0
  200.0
  0.0

Example Source: Download This Example

;----------------------------------------------------------
; PositionSPRITE Example
;----------------------------------------------------------


; =========================================================
; First Create an Image, with a random circle pattern on it.
; =========================================================

  Circle_Image=CreateBallImage(100)



; =========================================================
; Create 4 sprites  and randomly position them on screen
; =========================================================

  For ThisSprite=1 To 4

   ;Create this sprite
     CreateSprite ThisSprite

   ; Set each Sprite to use our circle image for
   ; it's artwork
     SpriteImage ThisSprite,Circle_Image

   ; Randomly position this sprite within the screen
     PositionSprite ThisSprite,Rnd(800),Rnd(600)
  Next



; Tell PB to limit speed of the program to
; 60 Frames (updates) per second or bellow
  SetFPS 60

; --------------------------------
; Start program Main update loop
; --------------------------------
  Do

   ; Clear the Screen to black
     Cls RGB(0,0,0)

   ; Display a message
     Print "Rendering our four created sprites"

   ; Tell Pb to DRaw all the srpites now
     DrawAllSprites

   ; Display the screen and loop back to the DO
   ;statement to continue the loop
     Sync

  Loop



; =========================================================
; Create an Image with a shaded circle pattern on it.
; =========================================================

Function CreateBallImage(Size)
  ThisImage=NewImage(size,size)
  RenderPhongImage ThisIMage,size/2,size/2,RGB(128+Rnd(127),128+Rnd(127),128+Rnd(127)),200,255.0/(size/2)
EndFunction ThisImage


Related Info:	GetSpriteOldX \| GetSpriteOldY \| GetSpriteOldZ \| GetSpriteX \| GetSpriteY \| GetSpriteZ \| PositionSpriteX \| PositionSpriteXYZ \| PositionSpriteY \| PositionSpriteZ :