SWFLIBReference.zip_swf_visual c_多媒体编程

<html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta charset="utf-8"> <meta name="generator" content="pdf2htmlEX"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <link rel="stylesheet" href="https://static.pudn.com/base/css/base.min.css"> <link rel="stylesheet" href="https://static.pudn.com/base/css/fancy.min.css"> <link rel="stylesheet" href="https://static.pudn.com/prod/directory_preview_static/622b2fa481ded46b7f156f1d/raw.css"> <script src="https://static.pudn.com/base/js/compatibility.min.js"></script> <script src="https://static.pudn.com/base/js/pdf2htmlEX.min.js"></script> <script> try{ pdf2htmlEX.defaultViewer = new pdf2htmlEX.Viewer({}); }catch(e){} </script> <title></title> </head> <body> <div id="sidebar" style="display: none"> <div id="outline"> </div> </div> <div id="pf1" class="pf w0 h0" data-page-no="1"><div class="pc pc1 w0 h0"><img class="bi x0 y0 w1 h1" alt="" src="https://static.pudn.com/prod/directory_preview_static/622b2fa481ded46b7f156f1d/bg1.jpg"><div class="t m0 x1 h2 y1 ff1 fs0 fc0 sc0 ls0 ws0">SWFLIB Library</div><div class="c x2 y2 w2 h3"><div class="t m0 x0 h2 y3 ff1 fs0 fc0 sc0 ls2 ws0"> </div></div><div class="t m0 x3 h4 y4 ff2 fs1 fc1 sc0 ls3 ws0">SWFLIB v1.0 – Programmers reference</div><div class="t m0 x4 h5 y5 ff2 fs2 fc1 sc0 ls6 ws0">SWFLIB is a free SWF authoring tool developed for easy flash movie generation from the </div><div class="t m0 x5 h5 y6 ff2 fs2 fc1 sc0 ls0 ws0">source code. It is a C++ library and can be used to generate flash animations in different </div><div class="t m0 x5 h5 y7 ff2 fs2 fc1 sc0 ls0 ws0">desktop or Web applications. </div><div class="t m0 x4 h5 y8 ff2 fs2 fc1 sc0 ls16 ws0">The SWF file format is platform independent vector image file format that has a very </div><div class="t m0 x5 h5 y9 ff2 fs2 fc1 sc0 ls0 ws0">efficient 2D rendering engine. It is a high-end technology which is widely used all over the </div><div class="t m0 x5 h5 ya ff2 fs2 fc1 sc0 ls0 ws0">Internet today. </div><div class="t m0 x4 h5 yb ff2 fs2 fc1 sc0 ls6 ws0">SWFLIB is a flash generator and not a flash editor or a player. Playing flash movies is not </div><div class="t m0 x5 h5 yc ff2 fs2 fc1 sc0 ls0 ws0">officially allowed by Macromedia to be performed by third companies. With SWFLIB you’ll be </div><div class="t m0 x5 h5 yd ff2 fs2 fc1 sc0 ls0 ws0">able to export animations that can be viewed by any modern browser. </div><div class="t m0 x4 h5 ye ff2 fs2 fc1 sc0 ls6 ws0">SWFLIB is organized as a set off classes that wrap the most important tags of the SWF </div><div class="t m0 x5 h5 yf ff2 fs2 fc1 sc0 ls9 ws0">file format specification. In this release a flash movies of the version 3 can be generated. </div><div class="t m0 x5 h5 y10 ff2 fs2 fc1 sc0 ls0 ws0">However, SWFLIB does not offer complete coverage of the version 3 SWF file format </div><div class="t m0 x5 h5 y11 ff2 fs2 fc1 sc0 ls0 ws0">specification. Since this is just an experimental project it covers just the most important SWF </div><div class="t m0 x5 h5 y12 ff2 fs2 fc1 sc0 ls0 ws0">tags considering flash animation. In the future releases you may expect some extended SWF </div><div class="t m0 x5 h5 y13 ff2 fs2 fc1 sc0 ls0 ws0">tag support considering text, sounds and buttons as also a sprite support. </div><div class="t m0 x4 h5 y14 ff2 fs2 fc1 sc0 ls0 ws0">In this reference manual a quick look at the inner structure of the SWFLIB library is given. </div><div class="t m0 x5 h5 y15 ff2 fs2 fc1 sc0 ls0 ws0">Using this manual you’ll be able in short time to generate a simple or advanced flash animations </div><div class="t m0 x5 h5 y16 ff2 fs2 fc1 sc0 lsb ws0">from your C++ source code. </div><div class="t m0 x4 h5 y17 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y18 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y19 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y1a ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y1b ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y1c ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y1d ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x6 h5 y1e ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y1f ff2 fs2 fc1 sc0 ls6 ws0">SWFLIB library team, </div><div class="t m0 x4 h5 y20 ff2 fs2 fc1 sc0 ls0 ws0">June, 2006. </div><div class="t m0 x4 h5 y21 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y22 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y23 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y24 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y25 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y26 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y27 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y28 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y29 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2a ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2b ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2c ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2d ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2e ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y2f ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x4 h5 y30 ff2 fs2 fc1 sc0 ls0 ws0"> </div></div><div class="pi" data-data='{"ctm":[1.613445,0.000000,0.000000,1.613445,0.000000,0.000000]}'></div></div> </body> </html>

<div id="pf2" class="pf w0 h0" data-page-no="2"><div class="pc pc2 w0 h0"><img class="bi x0 y0 w1 h1" alt="" src="https://static.pudn.com/prod/directory_preview_static/622b2fa481ded46b7f156f1d/bg2.jpg"><div class="t m0 x7 h2 y1 ff1 fs0 fc0 sc0 ls0 ws0">CSWFMovie class </div><div class="t m0 x8 h4 y4 ff2 fs1 fc1 sc0 ls3 ws0">SWFLIB v1.0 – Class reference</div><div class="t m0 x4 h5 y5 ff2 fs2 fc1 sc0 ls16 ws0">This is the main SWFLIB library class. Its performs general I/O operations on the external </div><div class="t m0 x5 h5 y6 ff2 fs2 fc1 sc0 ls0 ws0">.SWF file. It holds the internal .SWF bit-stream which is created while you build your flash movie </div><div class="t m0 x5 h5 y7 ff2 fs2 fc1 sc0 lsa ws0">from the source code, and finally writes these bits in the external file. Also, it manipulates with </div><div class="t m0 x5 h5 y31 ff2 fs2 fc1 sc0 ls0 ws0">all flash objects and transformations that make up the animation. The public methods of this </div><div class="t m0 x5 h5 y32 ff2 fs2 fc1 sc0 ls0 ws0">class are grouped in categories so you can easily understand them. </div><div class="t m0 x4 h5 ya ff2 fs2 fc1 sc0 ls0 ws0">In the first group there are methods that create the .SWF file, so you can call them the </div><div class="t m0 x5 h5 y33 ff2 fs2 fc1 sc0 ls9 ws0">file-methods. Those are: </div><div class="t m0 x4 h6 y34 ff3 fs2 fc2 sc0 ls0 ws0">// .SWF file methods </div><div class="t m0 x4 h6 y35 ff3 fs2 fc1 sc0 ls0 ws0">BOOL OpenSWFFile(LPTSTR filename); </div><div class="t m0 x4 h6 y36 ff3 fs2 fc1 sc0 ls0 ws0">BOOL OpenSWFFile(LPTSTR filename, SIZE movieSize, int frameRate); </div><div class="t m0 x4 h6 y37 ff3 fs2 fc3 sc0 ls0 ws0">void CloseSWFFile(); </div><div class="t m0 x4 h5 y38 ff2 fs2 fc1 sc0 ls16 ws0">The name of the methods are intuitive. You can use the first two methods to open the </div><div class="t m0 x5 h5 y39 ff2 fs2 fc1 sc0 ls0 ws0">.SWF file on disk, and the last one to close it</div><div class="t m0 x9 h7 y3a ff2 fs3 fc1 sc0 ls0 ws0">1</div><div class="t m0 xa h5 y39 ff2 fs2 fc1 sc0 ls0 ws0">. You must open the file before you add any </div><div class="t m0 x5 h5 y3b ff2 fs2 fc1 sc0 ls0 ws0">objects to the movie, and close it when you finish your animation. After closing the file you won’t </div><div class="t m0 x5 h5 y3c ff2 fs2 fc1 sc0 ls0 ws0">be able to re-open it for further editing. That is, the SWFLIB is a SWF generator and not a SWF </div><div class="t m0 x5 h5 y3d ff2 fs2 fc1 sc0 ls0 ws0">editor. </div><div class="t m0 x4 h5 y3e ff2 fs2 fc1 sc0 ls0 ws0">By calling file-opening function (the second version) you can specify the size of the flash </div><div class="t m0 x5 h5 y3f ff2 fs2 fc1 sc0 lsf ws0">movie and the frame rate. The SWF player will try to follow the stated frame rate but there is no </div><div class="t m0 x5 h5 y40 ff2 fs2 fc1 sc0 ls0 ws0">guarantee for this. </div><div class="t m0 x4 h5 y41 ff2 fs2 fc1 sc0 ls16 ws0">The next group is made of so called dictionary-methods: </div><div class="t m0 x4 h6 y42 ff3 fs2 fc2 sc0 ls0 ws0">// Dictionary methods </div><div class="t m0 x4 h6 y43 ff3 fs2 fc3 sc0 ls0 ws0">void AddShape(CSWFShape* pShape, int depth); </div><div class="t m0 x4 h6 y44 ff3 fs2 fc3 sc0 ls0 ws0">void AddMorphShape(CSWFMorphShape* pShape, int depth); </div><div class="t m0 x4 h6 y45 ff3 fs2 fc3 sc0 ls0 ws0">void AddBitmap(CSWFBitmap* pBitmap); </div><div class="t m0 x4 h5 y46 ff2 fs2 fc1 sc0 ls16 ws0">There is an internal structure (or something else) in the SWF player which is called a </div><div class="t m0 x5 h8 y47 ff4 fs2 fc1 sc0 ls0 ws0">Dictionary. All objects that make up the movie must be defined in the dictionary. You can add an </div><div class="t m0 x5 h5 y48 ff2 fs2 fc1 sc0 ls0 ws0">object to the dictionary by calling any of these functions. Since there are many different objects </div><div class="t m0 x5 h5 y49 ff2 fs2 fc1 sc0 ls0 ws0">(with the unique properties) there is a method for each object that can be defined. </div><div class="t m0 x4 h5 y4a ff2 fs2 fc1 sc0 ls1f ws0">With the first method AddShape() you add custom shapes that you create using this </div><div class="t m0 x5 h8 y4b ff2 fs2 fc1 sc0 ls0 ws0">library. Those are of the type CSWFShape class which is explained below. These objects are </div><div class="t m0 x5 h5 y4c ff2 fs2 fc1 sc0 lsf ws0">made of edges which are drawn with a specified line-style (that is a color and the thickness of </div><div class="t m0 x5 h5 y4d ff2 fs2 fc1 sc0 ls0 ws0">the pen), and filled with a certain fill-style (that can be a solid color, a multicolor gradient or a </div><div class="t m0 x5 h5 y4e ff2 fs2 fc1 sc0 ls0 ws0">bitmap). Next, all these objects are placed somewhere in the movie space. That is, they are at </div><div class="t m0 x5 h5 y4f ff2 fs2 fc1 sc0 ls0 ws0">the certain depth. There can be only one object on the defined depth value. </div><div class="t m0 x4 h8 y50 ff2 fs2 fc1 sc0 ls0 ws0">A bitmap object is a simple image that is loaded using an instance of CSWFBitmap class. </div><div class="t m0 x5 h5 y51 ff2 fs2 fc1 sc0 ls0 ws0">It has no edges or style definitions, but is rather used as a fill for shape objects interior. It can be </div><div class="t m0 x5 h5 y52 ff2 fs2 fc1 sc0 ls0 ws0">added to the movie by using AddBitmap() method. It has no depth information since it can not </div><div class="t m0 x5 h5 y53 ff2 fs2 fc1 sc0 ls0 ws0">be a stand-alone object. </div><div class="t m0 x4 h8 y54 ff2 fs2 fc1 sc0 ls0 ws0">Another special object is a morphing shape object as an instance of CSWFMorphShape </div><div class="t m0 x5 h5 y55 ff2 fs2 fc1 sc0 ls0 ws0">class which is added to the movie by using AddMorphShape() method. The morphing is a </div><div class="t m0 x5 h5 y56 ff2 fs2 fc1 sc0 ls0 ws0">process of transformation of the source object into the destination object. SWF player is </div><div class="t m0 x5 h5 y57 ff2 fs2 fc1 sc0 ls0 ws0">responsible for interpolation between start and end objects, but there are some restrictions </div><div class="t m0 x5 h5 y58 ff2 fs2 fc1 sc0 ls0 ws0">connected to the morphing objects: </div><div class="t m0 xb h9 y59 ff5 fs2 fc1 sc0 ls0 ws0">§ the start and the end object must have the same number of edges. </div><div class="t m0 xb h9 y5a ff5 fs2 fc1 sc0 ls0 ws0">§ the start and the end object must have the same type of fill (solid, gradient or a </div><div class="t m0 xc h5 y5b ff2 fs2 fc1 sc0 ls0 ws0">bitmap). </div><div class="t m0 x4 h5 y5c ff2 fs2 fc1 sc0 ls0 ws0">During the morphing process you can change the following: </div><div class="t m0 x6 ha y5d ff6 fs4 fc1 sc0 ls0 ws0"> </div><div class="t m0 x6 h7 y5e ff2 fs3 fc1 sc0 ls0 ws0">1</div><div class="t m0 xd h4 y5f ff2 fs1 fc1 sc0 ls0 ws0"> Nothing is written in the output file until you call CloseSWFFile() method. </div></div><div class="pi" data-data='{"ctm":[1.613445,0.000000,0.000000,1.613445,0.000000,0.000000]}'></div></div>

<div id="pf3" class="pf w0 h0" data-page-no="3"><div class="pc pc3 w0 h0"><img class="bi x0 y0 w1 h1" alt="" src="https://static.pudn.com/prod/directory_preview_static/622b2fa481ded46b7f156f1d/bg3.jpg"><div class="t m0 xb h9 y60 ff5 fs2 fc1 sc0 ls0 ws0">§ the position of each edge in the object. </div><div class="t m0 xb h9 y61 ff5 fs2 fc1 sc0 ls0 ws0">§ the color and the thickness of the line. </div><div class="t m0 xb h9 y62 ff5 fs2 fc1 sc0 ls0 ws0">§ the fill color of the object. </div><div class="t m0 xb h9 y63 ff5 fs2 fc1 sc0 ls0 ws0">§ the bitmap fill transformation. </div><div class="t m0 xb h9 y64 ff5 fs2 fc1 sc0 ls0 ws0">§ the gradient fill transformation. </div><div class="t m0 xb h9 y65 ff5 fs2 fc1 sc0 ls0 ws0">§ the color and the position of the gradient control points. </div><div class="t m0 x4 h5 ya ff2 fs2 fc1 sc0 ls16 ws0">The following are a display-list-methods: </div><div class="t m0 x4 h6 y66 ff3 fs2 fc2 sc0 ls0 ws0">// Display list methods </div><div class="t m0 x4 h6 y67 ff3 fs2 fc3 sc0 ls0 ws0">void AddObject(void* pObject, int depth); </div><div class="t m0 x4 h6 y68 ff3 fs2 fc3 sc0 ls0 ws0">void AddObject(void* pObject, int depth, USHORT ratio); </div><div class="t m0 x4 h6 y69 ff3 fs2 fc3 sc0 ls0 ws0">void UpdateObject(void* pObject, int depth); </div><div class="t m0 x4 h6 y6a ff3 fs2 fc3 sc0 ls0 ws0">void UpdateObject(void* pObject, int depth, SWF_COLOR_TRANSFORM* </div><div class="t m0 x5 h6 y6b ff3 fs2 fc1 sc0 ls0 ws0">pColorTransform); </div><div class="t m0 x4 h6 y6c ff3 fs2 fc3 sc0 ls0 ws0">void UpdateObject(void* pObject, int depth, SWF_COLOR_TRANSFORM* </div><div class="t m0 x5 h6 y6d ff3 fs2 fc1 sc0 ls0 ws0">pColorTransform, USHORT ratio); </div><div class="t m0 x4 h6 y6e ff3 fs2 fc3 sc0 ls0 ws0">void RemoveObject(int depth); </div><div class="t m0 x4 h8 y6f ff2 fs2 fc1 sc0 ls0 ws0">Again, there is a structure inside the SWF player called Display List. In each frame of the </div><div class="t m0 x5 h5 y70 ff2 fs2 fc1 sc0 ls0 ws0">animation everything that is in the display list is rendered on the screen. To add a certain object </div><div class="t m0 x5 h5 y71 ff2 fs2 fc1 sc0 ls0 ws0">(shape, morphing shape, etc.) to the display list call AddObject() method. This method takes </div><div class="t m0 x5 h5 y72 ff2 fs2 fc1 sc0 ls0 ws0">only pointer to the object and the depth value. That means that you can change the depth of the </div><div class="t m0 x5 h5 y73 ff2 fs2 fc1 sc0 ls0 ws0">object during the animation, but remember that there can be only one object at the stated depth </div><div class="t m0 x5 h5 y74 ff2 fs2 fc1 sc0 ls0 ws0">value at the time frame is rendered. </div><div class="t m0 x4 h5 y75 ff2 fs2 fc1 sc0 ls0 ws0">Since you can have also morphing objects the second version of the function is specially </div><div class="t m0 x5 h5 y76 ff2 fs2 fc1 sc0 ls9 ws0">for those objects (but you are free to use it on any object you like). Here you will state the </div><div class="t m0 x5 hb y77 ff2 fs2 fc1 sc0 lsf ws0">morphing ratio parameter. It has a value of 0 (zero) at the beginning of the morphing process </div><div class="t m0 x5 hb y78 ff2 fs2 fc1 sc0 ls0 ws0">and the value of 0xFFFF (65535) at the end of the morphing process. </div><div class="t m0 x4 h5 y79 ff2 fs2 fc1 sc0 ls16 ws0">The first time you add your object to the dictionary, the SWFLIB calls this method for you </div><div class="t m0 x5 h5 y7a ff2 fs2 fc1 sc0 ls0 ws0">so you don’t need to call it again. From that moment you should call only UpdateObject() </div><div class="t m0 x5 h5 y7b ff2 fs2 fc1 sc0 lsf ws0">method in each frame that is rendered to update the current object transformation. There are </div><div class="t m0 x5 h5 y7c ff2 fs2 fc1 sc0 ls0 ws0">three versions of this function. The first one is for non-morphing objects that have no color </div><div class="t m0 x5 h5 y7d ff2 fs2 fc1 sc0 ls0 ws0">transformation. The second one is for the same non-morphing objects but with included color </div><div class="t m0 x5 h5 y7e ff2 fs2 fc1 sc0 ls0 ws0">transformation. Finally, the third one is for morphing objects (it has a ratio parameter) with </div><div class="t m0 x5 h5 y7f ff2 fs2 fc1 sc0 ls0 ws0">included color transformation. </div><div class="t m0 x4 h5 y80 ff2 fs2 fc1 sc0 ls0 ws0">At any time you are free to remove object from the display list. That object is not going to </div><div class="t m0 x5 h5 y81 ff2 fs2 fc1 sc0 ls0 ws0">be rendered in the next frames. That is the RemoveObject() method. It takes only object depth </div><div class="t m0 x5 h5 y82 ff2 fs2 fc1 sc0 ls0 ws0">value as an argument since that there can be only one object at the time at that depth value. To </div><div class="t m0 x5 h5 y83 ff2 fs2 fc1 sc0 ls0 ws0">show object again, you’ll have to use the first described method, an AddObject() method. </div><div class="t m0 x4 h5 y84 ff2 fs2 fc1 sc0 ls0 ws0">Finally, we have reached to so called control-methods: </div><div class="t m0 x4 h6 y85 ff3 fs2 fc2 sc0 ls0 ws0">// Control methods </div><div class="t m0 x4 h6 y86 ff3 fs2 fc1 sc0 ls0 ws0">BOOL SetBackgroundColor(SWF_RGB bgColor); </div><div class="t m0 x4 h6 y87 ff3 fs2 fc1 sc0 ls0 ws0">BOOL ShowFrame(); </div><div class="t m0 x4 h5 y88 ff2 fs2 fc1 sc0 ls0 ws0">Using the first method, a SetBackgroundColor() method, you are free to set the color of </div><div class="t m0 x5 h5 y89 ff2 fs2 fc1 sc0 ls0 ws0">the movie background. </div><div class="t m0 x4 h5 y8a ff2 fs2 fc1 sc0 ls16 ws0">The ShowFrame() method simply adds a new frame to the movie, that is, orders the SWF </div><div class="t m0 x5 h5 y8b ff2 fs2 fc1 sc0 ls0 ws0">player to render the contents of the display list. </div><div class="t m0 x4 h8 y8c ff2 fs2 fc1 sc0 ls0 ws0">So, you can see that the interface of the CSWFMovie class is rather simple. It wraps just </div><div class="t m0 x5 h5 y8d ff2 fs2 fc1 sc0 ls0 ws0">the most important tags of the SWF file format specification that users will found to be most </div><div class="t m0 x5 h5 y8e ff2 fs2 fc1 sc0 ls0 ws0">useful. </div><div class="t m0 x6 h5 y8f ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x6 h5 y90 ff2 fs2 fc1 sc0 ls0 ws0"> </div><div class="t m0 x6 h5 y91 ff2 fs2 fc1 sc0 ls0 ws0"> </div></div><div class="pi" data-data='{"ctm":[1.613445,0.000000,0.000000,1.613445,0.000000,0.000000]}'></div></div>