3 Headers for rfxswf.c and modules
5 Part of the swftools package.
7 Copyright (c) 2000, 2001 Rainer Böhme <rfxswf@reflex-studio.de>
9 This file is distributed under the GPL, see file COPYING for details
13 #ifndef __RFX_SWF_INCLUDED__
14 #define __RFX_SWF_INCLUDED__
21 #include "../config.h"
33 /* little/big endian stuff */
35 //#define SWAP16(s) ((U16) ((U8*)&s)[0] | ((U16) ((U8*)&s)[1] << 8))
36 //#define SWAP32(s) ((U32) ((U8*)&s)[0] | ((U32) ((U8*)&s)[1] << 8) | ((U32) ((U8*)&s)[2] << 16) | ((U32) ((U8*)&s)[3] << 24))
38 #define PUT16(ptr,x) ((U8*)(ptr))[0]=(U8)(x);((U8*)(ptr))[1]=(U8)(x>>8);
39 #define PUT32(ptr,x) ((U8*)(ptr))[0]=(U8)(x);((U8*)(ptr))[1]=(U8)(x>>8);((U8*)(ptr))[2]=(U8)(x>>16);((U8*)(ptr))[3]=(U8)(x>>24);
40 #define GET16(ptr) (((U16)(((U8*)(ptr))[0]))+(((U16)(((U8*)(ptr))[1]))<<8))
41 #define GET32(ptr) (((U16)(((U8*)(ptr))[0]))+(((U16)(((U8*)(ptr))[1]))<<8)+(((U16)(((U8*)(ptr))[2]))<<16)+(((U16)(((U8*)(ptr))[3]))<<24))
43 #ifdef WORDS_BIGENDIAN
44 #define SWAP16(s) ((((s)>>8)&0x00ff)|(((s)<<8)&0xff00))
45 #define SWAP32(s) (SWAP16(((s)>>16)&0x0000ffff)|((SWAP16(s)<<16)&0xffff0000))
46 #define REVERSESWAP16(x) (x)
47 #define REVERSESWAP32(x) (x)
51 #define REVERSESWAP16(s) ((((s)>>8)&0x00ff)|(((s)<<8)&0xff00))
52 #define REVERSESWAP32(s) (REVERSESWAP16(((s)>>16)&0x0000ffff)|((REVERSESWAP16(s)<<16)&0xffff0000))
56 typedef unsigned long U32;
57 typedef signed long S32;
58 typedef unsigned short U16;
59 typedef signed short S16;
60 typedef unsigned char U8;
61 typedef signed char S8;
62 typedef signed long SFIXED;
63 typedef signed long SCOORD;
67 typedef struct _SPOINT
86 typedef struct _MATRIX
87 { SFIXED sx; // factor x
89 SFIXED r0; // rotation
95 typedef struct _CXFORM
100 } CXFORM, * LPCXFORM;
102 typedef struct _TAG // NEVER access a Tag-Struct directly !
105 U32 memsize; // to minimize realloc() calls
107 U32 len; // for Set-Access
108 U32 pos; // for Get-Access
110 int frame; // not really up-to-date
115 U8 readBit; // for Bit-Manipulating Functions [read]
116 U8 writeBit; // [write]
120 typedef struct _ActionTAG
125 struct _ActionTAG * next;
126 struct _ActionTAG * prev;
128 TAG* parent; // may be null
129 U8 tmp[4]; // store small operands here.
132 typedef struct _ActionMarker
139 U32 fileSize; // valid after load and save
142 U16 frameCount; // valid after load and save
148 int swf_ReadSWF(int handle,SWF * swf); // Reads SWF to memory (malloc'ed), returns length or <0 if fails
149 int swf_WriteSWF(int handle,SWF * swf); // Writes SWF to file, returns length or <0 if fails
150 int swf_WriteCGI(SWF * swf); // Outputs SWF with valid CGI header to stdout
151 void swf_FreeTags(SWF * swf); // Frees all malloc'ed memory for swf
154 int swf_WriteHeader(int handle,SWF * swf); // Writes Header of swf to file
155 int swf_WriteTag(int handle,TAG * tag); // Writes TAG to file
157 TAG * swf_InsertTag(TAG * after,U16 id); // updates frames, if necessary
158 int swf_DeleteTag(TAG * t);
160 void swf_SetTagPos(TAG * t,U32 pos); // resets Bitcount
161 U32 swf_GetTagPos(TAG * t);
163 TAG * swf_NextTag(TAG * t);
164 TAG * swf_PrevTag(TAG * t);
166 int swf_GetFrameNo(TAG * t); // should be renamed to TagGetFrame
167 U16 swf_GetTagID(TAG * t); // ... TagGetID
168 U32 swf_GetTagLen(TAG * t); // ... TagGetTagLen
169 U8* swf_GetTagLenPtr(TAG * t);
171 U32 swf_GetBits(TAG * t,int nbits);
172 S32 swf_GetSBits(TAG * t,int nbits);
173 int swf_SetBits(TAG * t,U32 v,int nbits);
175 int swf_GetBlock(TAG * t,U8 * b,int l); // resets Bitcount
176 int swf_SetBlock(TAG * t,U8 * b,int l);
178 U8 swf_GetU8(TAG * t); // resets Bitcount
179 U16 swf_GetU16(TAG * t);
180 U32 swf_GetU32(TAG * t);
182 int swf_SetU8(TAG * t,U8 v); // resets Bitcount
183 int swf_SetU16(TAG * t,U16 v);
184 int swf_SetU32(TAG * t,U32 v);
186 int swf_GetPoint(TAG * t,SPOINT * p); // resets Bitcount
187 int swf_GetRect(TAG * t,SRECT * r);
188 int swf_GetMatrix(TAG * t,MATRIX * m);
189 int swf_GetCXForm(TAG * t,CXFORM * cx,U8 alpha);
191 int swf_SetPoint(TAG * t,SPOINT * p); // resets Bitcount
192 int swf_SetRect(TAG * t,SRECT * r);
193 int swf_SetMatrix(TAG * t,MATRIX * m);
194 int swf_SetCXForm(TAG * t,CXFORM * cx,U8 alpha);
195 int swf_SetRGB(TAG * t,RGBA * col);
196 int swf_SetRGBA(TAG * t,RGBA * col);
200 #define swf_GetS8(tag) ((S8)swf_GetU8(tag))
201 #define swf_GetS16(tag) ((S16)swf_GetU16(tag))
202 #define swf_GetS32(tag) ((S32)swf_GetU32(tag))
203 #define swf_GetCoord(tag) ((SCOORD)swf_GetU32(tag))
204 #define swf_GetFixed(tag) ((SFIXED)swf_GetU32(tag))
206 #define swf_SetS8(tag,v) swf_SetU8(tag,(U8)v)
207 #define swf_SetS16(tag,v) swf_SetU16(tag,(U16)v)
208 #define swf_SetS32(tag,v) swf_SetU32(tag,(U32)v)
209 #define swf_SetCoord(tag,v) swf_SetU32(tag,(U32)v)
210 #define swf_SetFixed(tag,v) swf_SetU32(tag,(U32)v)
211 #define swf_SetString(t,s) swf_SetBlock(t,s,strlen(s)+1)
213 #define FAILED(b) ((b)<0)
214 #define SUCCEDED(b) ((b)>=0)
216 // Tag IDs (adopted from J. C. Kessels' Form2Flash)
219 #define ST_SHOWFRAME 1
220 #define ST_DEFINESHAPE 2
221 #define ST_FREECHARACTER 3
222 #define ST_PLACEOBJECT 4
223 #define ST_REMOVEOBJECT 5
224 #define ST_DEFINEBITS 6
225 #define ST_DEFINEBITSJPEG 6
226 #define ST_DEFINEBUTTON 7
227 #define ST_JPEGTABLES 8
228 #define ST_SETBACKGROUNDCOLOR 9
229 #define ST_DEFINEFONT 10
230 #define ST_DEFINETEXT 11
231 #define ST_DOACTION 12
232 #define ST_DEFINEFONTINFO 13
233 #define ST_DEFINESOUND 14 /* Event sound tags. */
234 #define ST_STARTSOUND 15
235 #define ST_DEFINEBUTTONSOUND 17
236 #define ST_SOUNDSTREAMHEAD 18
237 #define ST_SOUNDSTREAMBLOCK 19
238 #define ST_DEFINEBITSLOSSLESS 20 /* A bitmap using lossless zlib compression. */
239 #define ST_DEFINEBITSJPEG2 21 /* A bitmap using an internal JPEG compression table. */
240 #define ST_DEFINESHAPE2 22
241 #define ST_DEFINEBUTTONCXFORM 23
242 #define ST_PROTECT 24 /* This file should not be importable for editing. */
243 #define ST_PLACEOBJECT2 26 /* The new style place w/ alpha color transform and name. */
244 #define ST_REMOVEOBJECT2 28 /* A more compact remove object that omits the character tag (just depth). */
245 #define ST_DEFINESHAPE3 32 /* A shape V3 includes alpha values. */
246 #define ST_DEFINETEXT2 33 /* A text V2 includes alpha values. */
247 #define ST_DEFINEBUTTON2 34 /* A button V2 includes color transform, alpha and multiple actions */
248 #define ST_DEFINEBITSJPEG3 35 /* A JPEG bitmap with alpha info. */
249 #define ST_DEFINEBITSLOSSLESS2 36 /* A lossless bitmap with alpha info. */
250 #define ST_DEFINEEDITTEXT 37
251 #define ST_DEFINEMOVIE 38
252 #define ST_DEFINESPRITE 39 /* Define a sequence of tags that describe the behavior of a sprite. */
253 #define ST_NAMECHARACTER 40 /* Name a character definition, character id and a string, (used for buttons, bitmaps, sprites and sounds). */
254 #define ST_SERIALNUMBER 41
255 #define ST_GENERATORTEXT 42 /* contains an id */
256 #define ST_FRAMELABEL 43 /* A string label for the current frame. */
257 #define ST_SOUNDSTREAMHEAD2 45 /* For lossless streaming sound, should not have needed this... */
258 #define ST_DEFINEMORPHSHAPE 46 /* A morph shape definition */
259 #define ST_DEFINEFONT2 48
260 #define ST_TEMPLATECOMMAND 49
261 #define ST_GENERATOR3 51
262 #define ST_EXTERNALFONT 52
263 #define ST_EXPORTASSETS 56
264 #define ST_IMPORTASSETS 57
265 #define ST_ENABLEDEBUGGER 58
267 #define ST_REFLEX 777 /* to identify generator software */
273 typedef struct _LINESTYLE
276 } LINESTYLE, * LPLINESTYLE;
278 typedef struct _FILLSTYLE
283 } FILLSTYLE, * LPFILLSTYLE;
285 typedef struct _SHAPE // NEVER access a Shape-Struct directly !
301 // used by Get/SetSimpleShape and glyph handling
303 U32 bitlen; // length of data in bits
308 int swf_ShapeNew(SHAPE ** s);
309 void swf_ShapeFree(SHAPE * s);
311 int swf_GetSimpleShape(TAG * t,SHAPE ** s); // without Linestyle/Fillstyle Record
312 int swf_SetSimpleShape(TAG * t,SHAPE * s); // without Linestyle/Fillstyle Record
314 int swf_ShapeAddLineStyle(SHAPE * s,U16 width,RGBA * color);
315 int swf_ShapeAddSolidFillStyle(SHAPE * s,RGBA * color);
316 int swf_ShapeAddBitmapFillStyle(SHAPE * s,MATRIX * m,U16 id_bitmap,int clip);
318 int swf_SetShapeStyles(TAG * t,SHAPE * s);
319 int swf_ShapeCountBits(SHAPE * s,U8 * fbits,U8 * lbits);
320 int swf_SetShapeBits(TAG * t,SHAPE * s);
321 int swf_SetShapeHeader(TAG * t,SHAPE * s); // one call for upper three functions
323 int swf_ShapeSetMove(TAG * t,SHAPE * s,S32 x,S32 y);
324 int swf_ShapeSetStyle(TAG * t,SHAPE * s,U16 line,U16 fill0,U16 fill1);
325 int swf_ShapeSetAll(TAG * t,SHAPE * s,S32 x,S32 y,U16 line,U16 fill0,U16 fill1);
327 int swf_ShapeSetLine(TAG * t,SHAPE * s,S32 x,S32 y);
328 int swf_ShapeSetCurve(TAG * t,SHAPE * s,S32 x,S32 y,S32 ax,S32 ay);
329 int swf_ShapeSetCircle(TAG * t,SHAPE * s,S32 x,S32 y,S32 rx,S32 ry);
330 int swf_ShapeSetEnd(TAG * t);
335 // does not support wide characters !
337 #define MAX_CHAR_PER_FONT 512
339 typedef struct _KERNING
346 typedef struct _SWFLAYOUT
352 SWFKERNING * kerning;
353 } SWFLAYOUT, * LPSWFLAYOUT;
360 typedef struct _SWFFONT
361 { int id; // -1 = not set
362 U8 version; // 0 = not set, 1 = definefont, 2 = definefont2
366 U16 maxascii; // highest mapped ascii value
367 U8 flags; // bold/italic/unicode/ansi ...
371 } SWFFONT, * LPSWFFONT;
373 typedef struct _FONTUSAGE
374 { U8 code[MAX_CHAR_PER_FONT];
375 } FONTUSAGE, * LPFONTUSAGE;
377 #define ET_HASTEXT 32768
378 #define ET_WORDWRAP 16384
379 #define ET_MULTILINE 8192
380 #define ET_PASSWORD 4096
381 #define ET_READONLY 2048
382 #define ET_HASTEXTCOLOR 1024
383 #define ET_HASMAXLENGTH 512
384 #define ET_HASFONT 256
387 #define ET_HASLAYOUT 32
388 #define ET_NOSELECT 16
392 #define ET_USEOUTLINES 1
394 typedef struct _EditTextLayout
396 U8 align; // 0=left, 1=right, 2=center, 3=justify
403 int swf_FontEnumerate(SWF * swf,void (*FontCallback) (U16,U8*));
404 // -> void fontcallback(U16 id,U8 * name); returns number of defined fonts
406 int swf_FontExtract(SWF * swf,int id,SWFFONT ** f);
407 // Fetches all available information from DefineFont, DefineFontInfo, DefineText, ...
408 // id = FontID, id=0 -> Extract first Font
410 int swf_FontIsItalic(SWFFONT * f);
411 int swf_FontIsBold(SWFFONT * f);
413 int swf_FontSetID(SWFFONT * f,U16 id);
414 int swf_FontReduce(SWFFONT * f,FONTUSAGE * use);
416 int swf_FontInitUsage(FONTUSAGE * use);
417 int swf_FontUse(FONTUSAGE * use,U8 * s);
419 int swf_FontSetDefine(TAG * t,SWFFONT * f);
420 int swf_FontSetInfo(TAG * t,SWFFONT * f);
422 int swf_FontExtract_DefineTextCallback(int id,SWFFONT * f,TAG * t,int jobs,
423 void(*callback)(int*chars, int nr, int id));
425 // the following two functions are obsolete and will be removed soon
426 int swf_FontExport(int handle,SWFFONT * f);
427 int swf_FontImport(int handle,SWFFONT * * f);
429 void swf_WriteFont(SWFFONT* font, char* filename);
430 SWFFONT* swf_ReadFont(char* filename);
432 void swf_FontFree(SWFFONT * f);
434 U32 swf_TextGetWidth(SWFFONT * font,U8 * s,int scale);
435 int swf_TextCountBits(SWFFONT * font,U8 * s,int scale,U8 * gbits,U8 * abits);
437 int swf_TextSetInfoRecord(TAG * t,SWFFONT * font,U16 size,RGBA * color,S16 dx,S16 dy);
438 int swf_TextSetCharRecord(TAG * t,SWFFONT * font,U8 * s,int scale,U8 gbits,U8 abits);
440 int swf_TextPrintDefineText(TAG * t,SWFFONT * f);
441 // Prints text defined in tag t with font f to stdout
443 void swf_SetEditText(TAG*tag, U16 flags, SRECT r, char*text, RGBA*color,
444 int maxlength, U16 font, U16 height, EditTextLayout*layout, char*variable);
448 void swf_DumpHeader(FILE * f,SWF * swf);
449 void swf_DumpMatrix(FILE * f,MATRIX * m);
450 void swf_DumpTag(FILE * f,TAG * t);
451 char* swf_TagGetName(TAG*tag);
452 void swf_DumpFont(SWFFONT * font);
456 // Always use ST_PLACEOBJECT2 !!!
458 int swf_ObjectPlace(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name);
459 int swf_ObjectPlaceClip(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name, U16 clipaction);
460 int swf_ObjectMove(TAG * t,U16 depth,MATRIX * m,CXFORM * cx);
473 #define BC_OVERDOWN_IDLE 0x0100
474 #define BC_IDLE_OVERDOWN 0x0080
475 #define BC_OUTDOWN_IDLE 0x0040
476 #define BC_OUTDOWN_OVERDOWN 0x0020
477 #define BC_OVERDOWN_OUTDOWN 0x0010
478 #define BC_OVERDOWN_OVERUP 0x0008
479 #define BC_OVERUP_OVERDOWN 0x0004
480 #define BC_OVERUP_IDLE 0x0002
481 #define BC_IDLE_OVERUP 0x0001
483 #define BC_KEY(c) (c<<9)
485 #define BC_CURSORLEFT 0x0200
486 #define BC_CURSORRIGHT 0x0400
487 #define BC_POS1 0x0600
488 #define BC_END 0x0800
489 #define BC_INSERT 0x0a00
490 #define BC_DELETE 0x0c00
491 #define BC_CLEAR 0x0e00
492 #define BC_BACKSPACE 0x1000
493 #define BC_ENTER 0x1a00
494 #define BC_CURSORUP 0x1c00
495 #define BC_CURSORDOWN 0x1e00
496 #define BC_PAGEUP 0x2000
497 #define BC_PAGEDOWN 0x2200
498 #define BC_TAB 0x2400
499 #define BC_ESCAPE 0x3600
500 #define BC_SPACE 0x4000
502 /* these are probably only valid with linux:
514 /* everything above 0x4000 is standard ascii:
515 0x4000 ' ' 0x4200 '!' 0x4600 '#' 0x4800 '$' 0x4a00 '%' 0x4c00 '&' ...
516 0x6000 '0' ... 0x7200 '9'
518 0x8200 'A' ... 0xb400 'Z'
525 #define BF_TRACKMENU 0x01
527 int swf_ButtonSetRecord(TAG * t,U8 state,U16 id,U16 layer,MATRIX * m,CXFORM * cx);
528 int swf_ButtonSetCondition(TAG * t,U16 condition); // for DefineButton2
529 int swf_ButtonSetFlags(TAG * t,U8 flags); // necessary for DefineButton2
530 int swf_ButtonPostProcess(TAG * t,int anz_action); // Set all offsets in DefineButton2-Tags (how many conditions to process)
534 typedef int JPEGBITS,* LPJPEGBITS; // cover libjpeg structures
536 JPEGBITS * swf_SetJPEGBitsStart(TAG * t,int width,int height,int quality);
537 int swf_SetJPEGBitsLines(JPEGBITS * jpegbits,U8 ** data,int n);
538 int swf_SetJPEGBitsLine(JPEGBITS * jpegbits,U8 * data);
539 int swf_SetJPEGBitsFinish(JPEGBITS * jpegbits);
541 int swf_SetJPEGBits(TAG * t,char * fname,int quality); // paste jpg file into swf stream
543 #define BYTES_PER_SCANLINE(width) ((width+3)&0xfffffffc)
545 #define BMF_8BIT 3 // Bitmap formats
549 #define BM16_BLUE 0xf800 // Bitmasks for 16 Bit Color
550 #define BM16_RED 0x00f0
551 #define BM16_GREEN 0x000f
553 #define BM32_BLUE 0xff000000 // Bitmasks for 32 Bit Color
554 #define BM32_GREEN 0x00ff0000
555 #define BM32_RED 0x0000ff00
557 int swf_SetLosslessBits(TAG * t,U16 width,U16 height,void * bitmap,U8 bitmap_flags);
558 int swf_SetLosslessBitsIndexed(TAG * t,U16 width,U16 height,U8 * bitmap,RGBA * palette,U16 ncolors);
559 int swf_SetLosslessBitsGrayscale(TAG * t,U16 width,U16 height,U8 * bitmap);
563 U8 swf_isDefiningTag(TAG * t);
564 U8 swf_isPseudoDefiningTag(TAG * t);
565 U8 swf_isAllowedSpriteTag(TAG * t);
566 U16 swf_GetDefineID(TAG * t);
567 U16 swf_GetPlaceID(TAG * t); //PLACEOBJECT, PLACEOBJECT2 (sometimes), REMOVEOBJECT
568 U16 swf_GetDepth(TAG * t); //PLACEOBJECT,PLACEOBJECT2,REMOVEOBJECT,REMOVEOBJECT2
569 char* swf_GetName(TAG * t); //PLACEOBJECT2, FRAMELABEL
570 MATRIX * swf_MatrixJoin(MATRIX * d,MATRIX * s1,MATRIX * s2);
571 MATRIX * swf_MatrixMapTriangle(MATRIX * m,int dx,int dy,
572 int x0,int y0,int x1,int y1,int x2,int y2);
577 void swf_uncgi(); // same behaviour as Steven Grimm's uncgi-library
581 ActionTAG* swf_ActionGet(TAG*tag);
582 void swf_ActionFree(ActionTAG*tag);
583 void swf_ActionSet(TAG*tag, ActionTAG*actions);
584 void swf_DumpActions(ActionTAG*atag, char*prefix);
585 void swf_ActionEnumerateURLs(ActionTAG*atag, char*(*callback)(char*));
586 void swf_ActionEnumerateTargets(ActionTAG*atag, char*(*callback)(char*));
587 void swf_ActionEnumerateStrings(ActionTAG*atag, char*(*callback)(char*));
589 ActionTAG* swf_ActionStart();
591 void action_NextFrame();
592 void action_PreviousFrame();
595 void action_ToggleQuality();
596 void action_StopSounds();
598 void action_Subtract();
599 void action_Multiply();
600 void action_Divide();
601 void action_Equals();
606 void action_StringEquals();
607 void action_StringLength();
608 void action_StringExtract();
610 void action_ToInteger();
611 void action_GetVariable();
612 void action_SetVariable();
613 void action_SetTarget2();
614 void action_StringAdd();
615 void action_GetProperty();
616 void action_SetProperty();
617 void action_CloneSprite();
618 void action_RemoveSprite();
620 void action_StartDrag();
621 void action_EndDrag();
622 void action_StringLess();
623 void action_RandomNumber();
624 void action_MBStringLength();
625 void action_CharToAscii();
626 void action_AsciiToChar();
627 void action_GetTime();
628 void action_MBStringExtract();
629 void action_MBCharToAscii();
630 void action_MBAsciiToChar();
631 void action_Delete();
632 void action_Delete2();
633 void action_DefineLocal();
634 void action_CallFunction();
635 void action_Return();
636 void action_Modulo();
637 void action_NewObject();
638 void action_DefineLocal2();
639 void action_InitArray();
640 void action_Makehash();
641 void action_TypeOf();
642 void action_TargetPath();
643 void action_Enumerate();
646 void action_Equals2();
647 void action_ToNumber();
648 void action_ToString();
649 void action_PushDuplicate();
650 void action_StackSwap();
651 void action_GetMember();
652 void action_SetMember();
653 void action_Increment();
654 void action_Decrement();
655 void action_CallMethod();
656 void action_NewMethod();
657 void action_BitAnd();
659 void action_BitXor();
660 void action_BitLShift();
661 void action_BitRShift();
662 void action_BitURShift();
663 void action_GotoFrame(U16 frame);
664 void action_GetUrl(char* url, char* label);
665 void action_StoreRegister(U8 reg);
666 void action_Constantpool(char* constantpool);
667 void action_WaitForFrame(U16 frame, U8 skip);
668 void action_SetTarget(char* target);
669 void action_GotoLabel(char* label);
670 void action_WaitForFrame2(U8 skip);
671 void action_With(char*object);
672 void action_PushString(char*str);
673 void action_PushFloat(float f);
674 void action_PushNULL();
675 void action_PushRegister(U8 reg);
676 void action_PushBoolean(char c);
677 void action_PushDouble(double d);
678 void action_PushInt(int i);
679 void action_PushLookup(U8 index);
680 void action_Jump(U16 branch);
681 void action_GetUrl2(U8 method);
682 void action_DefineFunction(U8*data, int len);
683 void action_If(U16 branch);
685 void action_GotoFrame2(U8 method);
686 void swf_ActionEnd();
687 ActionMarker action_setMarker();
688 void action_fixjump(ActionMarker m1, ActionMarker m2);