<![CDATA[
<html><head>
<title>Overview</title>
<meta name="generator" content="HelpMaker">
<meta name="keywords" content="">
<link rel="stylesheet" type="text/css" href="hm.css"></head>
<body bgcolor="#FFFCEA">
<table width="100%" border="0" cellspacing="0" cellpadding="2" bgcolor="#C0C0C0">
<tr>
<td align="left">
<div align="left"><font face="Arial" color="#010101" size="4"><span style=" font-size:14pt; font-family:Arial; color:#010101">Overview</span></font></div>
</td>
<td align="right">
<font face="Arial" size="2">
<a href="overview.htm">Top</a> <a href="checkforspritecollision.htm">Next</a>
</font>
</td>
</tr></table>
<hr><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">The Sprite library allows you to easily manage animated moving sprites.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">This library is based on Andy Beaulieo's </span></font><a href="http://www.andybeaulieu.com/Overview/tabid/87/Default.aspx" target="_blank"><font face="Times New Roman" color="#0000ff"><span style=" font-size:12pt; font-family:Times New Roman; color:#0000ff"><u>Asprite.Net</u></span></font></a><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"> which is an open source project.</span></font></div><div align="left"><font face="Times New Roman"><span style=" font-size:12pt; font-family:Times New Roman; color:#000000">The code was heavily modified and improved by Andrew Graham.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">You can use this library in commercial projects.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">It can be used on both the desktop and the device.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">The sprites engine advances in discrete steps.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">In each step (tick) sprites move to their next position, sprites are animated and collisions
are checked.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">Usually a timer will be used to create these ticks.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">There are two objects types in this library.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">The first type is GameWindow. The GameWindow is the surface that holds, manages and
displays the active and inactive sprites.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">It should be added to a form using GameWindow.New1.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">The second type is Sprite which represents a single sprite.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">Sprites could be animated by loading an image that includes the frames sequence.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">See the </span></font><a href="http://www.basic4ppc.com/Downloads.html" target="_blank"><font face="Times New Roman" color="#0000ff"><span style=" font-size:12pt; font-family:Times New Roman; color:#0000ff"><u>Sprites
example</u></span></font></a><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"> for a complete demonstration.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">Most code snippets in this manual are based on that example.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">Version 1.3 of this library adds some new Sprite methods - LoadBitmap, LoadFile and
LoadFrames, New4 and some additional Sprite properties - Data, DataArray,
DestinationX, DestinationY, HasDestination, FrameBitmaps, FrameCount,
FrameForward, ID, IsAnimated, IsCollider, IsContained and IsVisible. GameWindow
aquires some new methods - EraseSprite(index), GetSpriteID(id), SpriteOnScreen(index),
SpriteOnScreenID(ID), SpriteReplace(sprite, index), a new property -
CheckSpriteCollisions and a new event CollisionDestination.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">GameWindow is now AutoScale aware in that its size will scale properly. All other
library operations are carried out at native display resolution.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">The default settings for new properties are all compatible with existing code, however
version 1.3 of this library introduces some changes in behaviour over earlier versions that
might affect existing code. The changes were necessary to provide a consistent model of
how Sprites are moved and drawn. The changes are as follows.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">a) The GameWindow now draws itself properly as a Windows Control should, that is in
response to Paint events. Previously it didn't and this could cause flashing of the
GameWindow and even its' non-appearance under certain conditions.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">b) When a collision event occurs the Sprite X and Y positions now correspond to those
displayed in the game window. Previously the X and Y positions were one tick ahead of
the displayed position because the library drew then moved and then checked for
collisions. Now the library moves then draws then checks for collisions so giving
consistency between Sprite properties and the game window. Any code that compensated
for this may need changing. Note because of this sequence of operations a Sprite added
with a velocity will first be drawn after it's first move with that velocity. </span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">c) Sprite.IntersectsPoint fixes a bug that gave illogical intersection results and didn't
permit single pixel Sprites so it may now produce different results to previously.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">d) CollisionMouse events now occur in the reverse order to what they did previously to
conform to the order that you might expect. Sprites added later than earlier Sprites are
drawn on top of the earlier ones and their CollisionMouse events occur first.</span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101">e) Sprite to Sprite collisions now only cause a single Collision event whereas previously
the event occurred twice, once for each Sprite. This improvement increases performance
by halving the time taken in the Tick method for processing Sprite collisions and
simplifies the code in situations where the result of two Sprites colliding is only wanted
to be invoked once. </span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"><font face="Times New Roman" color="#010101"><span style=" font-size:12pt; font-family:Times New Roman; color:#010101"><br></span></font></div><div align="left"> </div>
</body></html>
]]>