4 <title>SWFC Manual</title>
7 swfc is a tool for generating flash files. You can write small simple scripts
8 and then have them compiled to SWF Flash Animations.
14 This comment aims to give a short overview over the tags defined in guide.xslt.
17 Markups and Highlights:
23 <f>filename or pathname</f>
24 <c>variable name, command</c> ("c" stands for "code")
38 <uri>http://www.quiss.org</uri> OR
39 <uri link=http://www.quiss.org>Quiss</uri>
41 Shell scripts, commands to execute:
43 <shell>tail /var/log/messages</shell>
47 <code lang="sc"> (The lang= is optional)
56 <tr><td>Apples</td><td>Pears</td></tr>
57 <tr><td>3</td><td>4</td></tr>
70 Something to be careful about
75 <chapter><title>swfc Basics</title>
77 <section><title>Calling swfc</title>
81 swfc is command line based. You call it via
83 <shell>$ swfc file.sc</shell>
85 The filename of what is generated depends on the filename of the script (<f>file.sc</f>),
86 the filename given inside the script, and the optional <c>-o</c> passed to swfc.
91 Though swfc is a command-line utility, there also exists a nice graphical
92 frontend for it, called <uri link="http://www.ucolick.de/~de/Snarf/quiss">Swifty</uri>.
97 <section><title>A simple swfc example</title>
100 Let's create simple SWF file, shall we?
101 The following script creates a red box with a yellow border. On the right side you
102 see the script used, on the left side the swf file that is generated.
106 .flash name="box.swf"
107 .box b1 100 100 color=yellow fill=red
108 .put b1 pin=center scale=0%
110 .change b1 pin=center scale=100%
112 .change b1 pin=center scale=0%
116 The <c>.box</c> command creates the box. Every object that is created must also be explicitly
117 put into the scene using <c>.put</c> to become visible.
121 <section><title>Color transforms</title>
124 .flash name="cxform.swf" version=5
126 .jpeg s1 "photo.jpeg" quality=80%
128 .put s1 x=50 y=50 scalex=110 scaley=110
130 .change s1 x=0 y=0 scalex=210 scaley=210 red=-1+255 green=-1+255 blue=-1+255 #invert
132 .change s1 x=100 y=50 scalex=110 scaley=110 red=0 green=+0 blue=+0 #remove red
134 .change s1 x=0 y=0 scalex=210 scaley=210 red=+0 green=2 blue=-1+255 #amplify green, invert blue
136 .change s1 x=50 y=100 scalex=110 scaley=110 red=2-128 green=-2+255 blue=+0.7+40 #alien glow
138 .change s1 x=0 y=0 scalex=210 scaley=210 red=8-1024 green=8-1024 blue=8-1024 #palette reduce
140 .change s1 x=0 y=0 scalex=210 scaley=210 red=+0 green=+0 blue=+0 #back to normal
142 .change s1 x=105 y=105 scalex=0 scaley=0 luminance=0 #fadeout
151 <chapter><title>Fonts</title>
155 swfc has font support. That means you can also insert texts into
157 The easiest way to load a font is to do something like
159 .font Arial filename="Arial.ttf"
162 You now have a font named <c>Arial</c> to play with.
163 For example, for the obligatory hello world program:
166 .flash name="helloworld.swf"
168 .font Arial filename="Arial.ttf"
169 .text helloworld font=Arial text="Hello World!"
174 Besides TrueType fonts, swfc also supports native SWF fonts.
175 If you have a SWF with a font you would like to use, do a
179 Then write down the font ID of the font, and do a
181 swfextract -f <fontid> file.swf -o myfont.swf
184 This will give you a file named myfont.swf which you can
185 also use in the <c>filename</c> parameter of <c>.font</c>.
190 So much for the basics. Now let's go to the more advanced
195 Apart from being able to define text in your swfc files,
196 you can also define text <c>outlines</c>.
197 Those are not real characters but rather abstract vector
198 objects which you can use in other commands.
202 .flash name="fontoutline.swf"
203 .font Arial "Arial.swf"
204 .textshape helloworld font="arial" text="Hello World"
205 .filled filled_helloworld outline=helloworld fill=blue line=5 color=green
206 .put filled_helloworld
210 Here, <c>.textshape helloworld</c> defines an outline named "helloworld",
211 which is then used to construct a filled outline named filled_helloworld.
213 To make this a little more interesting, let's fill with a gradient instead
217 .flash name="fontgradient.swf"
218 .font Arial "Arial.swf"
219 .textshape helloworld font="arial" text="Hello World"
227 .filled filled_helloworld outline=helloworld fill=blue line=5 color=green
228 .put filled_helloworld
232 But let's get back to normal <c>.text</c> characters.
233 The following demonstrates that you can treat objects defined
234 with <c>.text</c> like normal shapes, i.e., scale them, move them, and use
238 .flash name="text5.swf"
239 .font courier "Courier.swf"
240 .font helvetica "Helvetica.swf"
241 .text hithere text="HELLO" font=courier size=50%
242 .swf scene Scenery50.swf
245 .startclip hithere pin=center x=100 y=75 scale=50% #text clips...
246 .put scene # ...the image "scene"
249 .change hithere rotate+=360 pin=center scale=100%
254 Also, <c>.text</c> takes a color attribute (that's actually
255 the poor man's version of the more advanced filling options
256 that <c>.textshape</c> in conjunction with <c>.filled</c> offers),
257 which is used here together with the alpha parameter of <c>.change</c>:
260 .flash name="text6.swf"
261 .font courier "Courier.swf"
262 .font helvetica "Helvetica.swf"
263 .text hello text="HELLO" font=helvetica size=50% color=blue
264 .text world text="WORLD" font=helvetica size=50% color=red
267 .put hello pin=center x=50 y=50
268 .put world pin=center x=50 y=50 alpha=25%
270 .change hello rotate+=360 pin=center alpha=25%
271 .change world rotate-=360 pin=center alpha=100%