Associated Email list Windows_For_Shockwave


Site Nav

css drop down menu by

Tutorial 7: wfsWriteMultiSpriteFamily

Tutorial 7: wfsWriteMultiSpriteFamily

wfsWriteMultiSpriteFamily is a handler defined in the "Script Writer" script. wfsWriteMultiSpriteFamily writes Lingo code for you that allows you to make dynamic copies of families of multi-sprites you have constructed models of in the Score.

Static sprites are sprites that you see in the Score. Normally you drag Cast Members into the Score and compose movies that way, ie, normally you compose movies entirely of static sprites. But you cannot destroy static sprites and remain in the same frame of the movie. The way static sprites are destroyed is to move to a different frame and have the static sprite not be present in that frame. This can pose problems for the number of features and options you can present users at the same time.

Dynamic sprites are created by WFS via the makeScriptedSprite command (in DMX 2004+) or by puppeting sprite channels (in earlier versions of Director) and populating the channel with a cast member. You cannot see dynamic sprites in the Score while the movie runs in authoring mode. But you can see them on the stage.

Tutorial 7 is about how to use wfsWriteMultiSpriteFamily to create dynamic families of multi-sprites. It goes step by step through an example of the use of wfsWriteMultiSpriteFamily in the WFS48x.DIR source code. WFS48x.DIR is in the 'samples' folder of your WFS documentation.

The tutorial also shows you how to destroy families of dynamic multi-sprites.

There are 10 steps involved in using either wfsWriteMultiSprite, wfsWriteMultiSpriteFamily, or wfsWriteElement. The documentation about the "Script Writer" script outlines the generic 10 steps. But the documentation of each of the three public handlers of the "Script Writer" script (wfsWriteMultiSprite, wfsWriteMultiSpriteFamily, and wfsWriteElement) each contains a very detailed example that goes step by step through the 10 steps of each particular handler.

It is recommended that you just go through the whole documentation of wfsWriteMultiSpriteFamily to get a detailed picture of how to use wfsWriteMultiSpriteFamily.



Tutorial 7: wfsWriteMultiSpriteFamily