Added toasty example.

Docs/Themerdocs/Examples/Example_Actors/Toasty.lua

@@ -0,0 +1,47 @@
+-- This is an example for the toasty animation used by ScreenGameplay.
+-- To try it out, put it in BGAnimations/ScreenGameplay toasty.lua
+
+-- The toasty animation is loaded as a transition by ScreenGameplay, which
+-- means that StartTransitioningCommand is played to activate it.
+-- However, the details of the toasty are broadcast with the ToastyAchieved
+-- message.  The message is broadcast before StartTransitioningCommand is
+-- played, so we can set some internal variables to store the details.
+
+local pn
+local toasty_combo
+local level
+
+-- These is a table for storing player-specific values to use in the animation.
+
+local rotations= { [PLAYER_1]= 15, [PLAYER_2]= -15 }
+local positions= { [PLAYER_1]= _screen.cx*.5, [PLAYER_2]= _screen.cx*1.5 }
+local colors= { [PLAYER_1]= PlayerColor(PLAYER_1), [PLAYER_2]= PlayerColor(PLAYER_2) }
+
+return Def.BitmapText{
+	Font= "Common Normal", Text= "Toasty!",
+	InitCommand= function(self)
+		self:zoom(0)
+	end,
+	ToastyAchievedMessageCommand= function(self, param)
+		pn= param.PlayerNumber
+		toasty_combo= param.ToastyCombo
+		level= param.Level
+	end,
+	StartTransitioningCommand= function(self)
+		-- The engine calls finishtweening when a transition is reset, and the
+		-- toasty transition is reset before it's run, so we don't have to call
+		-- finishtweening here.
+		-- This is a simple animation that positions the text in the center of
+		-- one half of the screen at zero zoom and rotation.  Then it tweens to
+		-- a higher zoom and rotation, so it appears to spin out of nothing, then
+		-- spin back down to nothing.
+		self:xy(positions[pn], _screen.cy):zoom(0):rotationz(0):diffuse(colors[pn])
+			:spring(level):zoom(level):rotationz(rotations[pn] * level)
+			:spring(level):zoom(0):rotationz(0)
+	end
+}
+
+-- Flaw:  When two players are playing, if they each get a toasty near the
+-- same time, the animation will start playing for one, then switch to the
+-- other.  As an exercise, try to figure out a way to make it play nicely for
+-- multiple players earning a toasty at the same time.