diff --git a/doc/doc_files/createsprite.html b/doc/doc_files/createsprite.html index d83eab9..d92a5ce 100644 --- a/doc/doc_files/createsprite.html +++ b/doc/doc_files/createsprite.html @@ -9,7 +9,42 @@

function CreateSprite( img )

- Returns new sprite + This function returns a new sprite which you can place in a variable for use in your program. +

+

+ Here is an example of opening a sprite canvas layer, creating a sprite, setting it's position and finally displaying it. +

+

+ isFullScreen = false 
+ vSync = true 
+ winWidth = 640 
+ winHeight = 480 
+ canViewPortX = 0 
+ canViewPortY = 0 
+   
+ OpenWindow("CreateSprite", winWidth, winHeight, isFullScreen, vSync) 
+ sCanvas = OpenCanvasSpriteLayer(canViewPortX, canViewPortY, winWidth, winHeight) 
+ Canvas(sCanvas) 
+   
+ DIM eye 
+ DIM eyeW 
+ DIM eyeH 
+   
+ eye = LoadImage("theEye.png") 
+ GetImageSize(eye, eyeW, eyeH) 
+   
+ eyeSprite = CreateSprite(eye, eyeW, eyeH) 
+ SetSpritePosition(eyeSprite, 100100) 
+   
+ While Not Key(K_ESCAPE) 
+ 'ClearCanvas() For a sprite layer canvas, you don't need to call ClearCanvas. It's automatically called.
+ Update()      'Update automatically deals with drawing the sprites on the sprite canvas.
+ Wend 
+

+

+

Related: + OpenCanvasSpriteLayer + SetSpritePosition

diff --git a/doc/doc_files/images/theEye.png b/doc/doc_files/images/theEye.png new file mode 100644 index 0000000..b14eb0c Binary files /dev/null and b/doc/doc_files/images/theEye.png differ diff --git a/doc/files/createsprite.txt b/doc/files/createsprite.txt index bc7fbf1..44ad67d 100644 --- a/doc/files/createsprite.txt +++ b/doc/files/createsprite.txt @@ -1,4 +1,38 @@ #title CreateSprite [RCBasic Doc] #header function CreateSprite( img ) -Returns new sprite +This function returns a new sprite which you can place in a variable for use in your program. + +Here is an example of opening a sprite canvas layer, creating a sprite, setting it's position and finally displaying it. + +#code + isFullScreen = false + vSync = true + winWidth = 640 + winHeight = 480 + canViewPortX = 0 + canViewPortY = 0 + + OpenWindow("CreateSprite", winWidth, winHeight, isFullScreen, vSync) + sCanvas = OpenCanvasSpriteLayer(canViewPortX, canViewPortY, winWidth, winHeight) + Canvas(sCanvas) + + DIM eye + DIM eyeW + DIM eyeH + + eye = LoadImage("theEye.png") + GetImageSize(eye, eyeW, eyeH) + + eyeSprite = CreateSprite(eye, eyeW, eyeH) + SetSpritePosition(eyeSprite, 100, 100) + + While Not Key(K_ESCAPE) + 'ClearCanvas() For a sprite layer canvas, you don't need to call ClearCanvas. It's automatically called. + Update() 'Update automatically deals with drawing the sprites on the sprite canvas. + Wend +#/code + +#image "images/theEye.png" + +#ref OpenCanvasSpriteLayer SetSpritePosition