removed whitespace, added some comments.
[swftools.git] / lib / rfxswf.h
index 624172e..25148df 100644 (file)
 #ifndef __RFX_SWF_INCLUDED__
 #define __RFX_SWF_INCLUDED__
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -34,9 +38,7 @@
 
 /* little/big endian stuff */
 
-//#define SWAP16(s) ((U16) ((U8*)&s)[0] | ((U16) ((U8*)&s)[1] << 8))
-//#define SWAP32(s) ((U32) ((U8*)&s)[0] | ((U32) ((U8*)&s)[1] << 8) | ((U32) ((U8*)&s)[2] << 16) | ((U32) ((U8*)&s)[3] << 24))
-
+#define PUT8(ptr,x) {((U8*)(ptr))[0]=x;}
 #define PUT16(ptr,x) {((U8*)(ptr))[0]=(U8)(x);((U8*)(ptr))[1]=(U8)((x)>>8);}
 #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);}
 #define GET16(ptr) (((U16)(((U8*)(ptr))[0]))+(((U16)(((U8*)(ptr))[1]))<<8))
@@ -95,7 +97,7 @@ typedef struct _MATRIX
 } MATRIX, * LPMATRIX;
 
 typedef struct _CXFORM
-{ S16           a0, a1;
+{ S16           a0, a1; /* mult, add */
   S16           r0, r1;
   S16           g0, g1;
   S16           b0, b1;
@@ -126,22 +128,22 @@ typedef struct _TAG             // NEVER access a Tag-Struct directly !
   
 } TAG, * LPTAG;
 
-typedef struct _ActionTAG 
-{ U8            op;
-  U16           len;
-  U8 *          data;
+typedef struct _SOUNDINFO 
+{
+    U8 stop;
+    U8 nomultiple; //continue playing if already started
 
-  struct _ActionTAG * next;
-  struct _ActionTAG * prev;
+    U32 inpoint;
+    U32 outpoint;
 
-  struct _ActionTAG * parent;
-  U8 tmp[4]; // store small operands here.
-} ActionTAG;
+    U16 loops;
+    U8 envelopes;
 
-typedef struct _ActionMarker
-{
-  ActionTAG* atag;
-} ActionMarker;
+    //envelope:
+    U32* pos;
+    U32* left;
+    U32* right;
+} SOUNDINFO;
 
 typedef struct _SWF
 { U8            fileVersion;
@@ -174,11 +176,24 @@ int  swf_ReadHeader(struct reader_t*reader, SWF * swf);   // Reads SWF Header vi
 // folding/unfolding:
 
 void swf_FoldAll(SWF*swf);
+void swf_UnFoldAll(SWF*swf);
 void swf_FoldSprite(TAG*tag);
+void swf_UnFoldSprite(TAG*tag);
+int swf_IsFolded(TAG*tag);
+
+// tag reordering:
+
+void swf_OptimizeTagOrder(SWF*swf);
+
+// basic routines:
     
 TAG * swf_InsertTag(TAG * after,U16 id);    // updates frames, if necessary
+TAG * swf_InsertTagBefore(SWF*swf, TAG * before,U16 id);     // like InsertTag, but insert tag before argument
 int   swf_DeleteTag(TAG * t);
 
+void  swf_ClearTag(TAG * t);                //frees tag data
+void  swf_ResetTag(TAG*tag, U16 id);        //set's tag position and length to 0, without freeing it
+    
 void  swf_SetTagPos(TAG * t,U32 pos);       // resets Bitcount
 U32   swf_GetTagPos(TAG * t);
 
@@ -203,7 +218,7 @@ U32   swf_GetU32(TAG * t);
 void  swf_GetRGB(TAG * t, RGBA * col);
 void  swf_GetRGBA(TAG * t, RGBA * col);
 void  swf_GetGradient(TAG * t, GRADIENT * gradient, char alpha);
-
+char* swf_GetString(TAG*t);
 int   swf_SetU8(TAG * t,U8 v);              // resets Bitcount
 int   swf_SetU16(TAG * t,U16 v);
 int   swf_SetU32(TAG * t,U32 v);
@@ -220,6 +235,13 @@ int   swf_SetCXForm(TAG * t,CXFORM * cx,U8 alpha);
 int   swf_SetRGB(TAG * t,RGBA * col);
 int   swf_SetRGBA(TAG * t,RGBA * col);
 
+// helper functions:
+
+void swf_ExpandRect(SRECT*src, SPOINT add);
+void swf_ExpandRect2(SRECT*src, SRECT*add);
+SPOINT swf_TurnPoint(SPOINT p, MATRIX* m);
+SRECT swf_TurnRect(SRECT r, MATRIX* m);
+
 // Function Macros
 
 #define swf_GetS8(tag)      ((S8)swf_GetU8(tag))
@@ -235,8 +257,12 @@ int   swf_SetRGBA(TAG * t,RGBA * col);
 #define swf_SetFixed(tag,v) swf_SetU32(tag,(U32)v)
 #define swf_SetString(t,s)  swf_SetBlock(t,s,strlen(s)+1)
 
+#ifndef FAILED
 #define FAILED(b)       ((b)<0)
-#define SUCCEDED(b)     ((b)>=0)
+#endif
+#ifndef SUCCEEDED
+#define SUCCEEDED(b)     ((b)>=0)
+#endif
 
 // Tag IDs (adopted from J. C. Kessels' Form2Flash)
 
@@ -267,6 +293,7 @@ int   swf_SetRGBA(TAG * t,RGBA * col);
 #define ST_PROTECT              24 /* This file should not be importable for editing. */
 #define ST_PLACEOBJECT2         26 /* The new style place w/ alpha color transform and name. */
 #define ST_REMOVEOBJECT2        28 /* A more compact remove object that omits the character tag (just depth). */
+#define ST_FREEALL              31 /* ? */
 #define ST_DEFINESHAPE3         32 /* A shape V3 includes alpha values. */
 #define ST_DEFINETEXT2          33 /* A text V2 includes alpha values. */
 #define ST_DEFINEBUTTON2        34 /* A button V2 includes color transform, alpha and multiple actions */
@@ -288,10 +315,10 @@ int   swf_SetRGBA(TAG * t,RGBA * col);
 #define ST_EXPORTASSETS                56
 #define ST_IMPORTASSETS                57
 #define ST_ENABLEDEBUGGER      58
-#define ST_MX0                 59 /*(?) Components/InitClip */
-#define ST_MX1                 60 /*(?) Sorensen Video*/
-#define ST_MX2                 61 /*(?) Sorensen Video*/
-#define ST_MX3                 62 /*(?) fontinfo2? */
+#define ST_DOINITACTION         59
+#define ST_DEFINEVIDEOSTREAM    60
+#define ST_VIDEOFRAME           61
+#define ST_DEFINEFONTINFO2     62
 #define ST_MX4                 63 /*(?) */
 
 #define ST_REFLEX              777 /* to identify generator software */
@@ -333,6 +360,30 @@ typedef struct _SHAPE           // NEVER access a Shape-Struct directly !
   U32           bitlen;         // length of data in bits
 } SHAPE, * LPSHAPE;
 
+/* SHAPE can be converted into SHAPE2: */
+
+struct _SHAPELINE;
+typedef struct _SHAPE2
+{
+    LINESTYLE * linestyles;
+    int numlinestyles;
+    FILLSTYLE* fillstyles;
+    int numfillstyles;
+    struct _SHAPELINE * lines;
+    SRECT* bbox; // may be NULL
+} SHAPE2;
+
+typedef struct _SHAPELINE
+{
+    enum {moveTo, lineTo, splineTo} type;
+    SCOORD x,y;
+    SCOORD sx,sy; //only if type==splineTo
+    int fillstyle0;
+    int fillstyle1;
+    int linestyle;
+    struct _SHAPELINE * next;
+} SHAPELINE;
+
 // Shapes
 
 int   swf_ShapeNew(SHAPE ** s);
@@ -359,6 +410,12 @@ int   swf_ShapeSetCurve(TAG * t,SHAPE * s,S32 x,S32 y,S32 ax,S32 ay);
 int   swf_ShapeSetCircle(TAG * t,SHAPE * s,S32 x,S32 y,S32 rx,S32 ry);
 int   swf_ShapeSetEnd(TAG * t);
 
+SHAPELINE* swf_ParseShapeData(U8*data, int bits, int fillbits, int linebits);
+SHAPE2*           swf_ShapeToShape2(SHAPE*shape);
+SHAPE*    swf_Shape2ToShape(SHAPE2*shape);
+SRECT     swf_GetShapeBoundingBox(SHAPELINE*shape);
+int       swf_SetShape2(TAG*tag, SHAPE2*shape);
+void      swf_Shape2Free(SHAPE2 * s);
 
 // swffont.c
 
@@ -407,6 +464,7 @@ typedef struct _SWFFONT
   U16  *       glyph2ascii;
   int  *       ascii2glyph;
   SWFGLYPH *   glyph;
+  U8           language;
 } SWFFONT, * LPSWFFONT;
 
 typedef struct _FONTUSAGE
@@ -422,12 +480,12 @@ typedef struct _FONTUSAGE
 #define ET_HASMAXLENGTH 512
 #define ET_HASFONT 256
 #define ET_X3 128
-#define ET_X2 64
+#define ET_AUTOSIZE 64 /* MX */
 #define ET_HASLAYOUT 32
 #define ET_NOSELECT 16
 #define ET_BORDER 8
 #define ET_X1 4
-#define ET_X0 2
+#define ET_HTML 2 /* MX? */
 #define ET_USEOUTLINES 1
 
 typedef struct _EditTextLayout
@@ -459,15 +517,12 @@ int swf_FontSetDefine(TAG * t,SWFFONT * f);
 int swf_FontSetDefine2(TAG * t,SWFFONT * f);
 int swf_FontSetInfo(TAG * t,SWFFONT * f);
 
+void swf_FontCreateLayout(SWFFONT*f);
 void swf_FontAddLayout(SWFFONT * f, int ascent, int descent, int leading);
 
 int swf_FontExtract_DefineTextCallback(int id,SWFFONT * f,TAG * t,int jobs, 
        void(*callback)(int*chars, int nr, int id));
 
-// the following two functions are obsolete and will be removed soon
-int swf_FontExport(int handle,SWFFONT * f);
-int swf_FontImport(int handle,SWFFONT * * f);
-
 void swf_WriteFont(SWFFONT* font, char* filename);
 SWFFONT* swf_ReadFont(char* filename);
 
@@ -486,6 +541,8 @@ int swf_TextPrintDefineText(TAG * t,SWFFONT * f);
 void swf_SetEditText(TAG*tag, U16 flags, SRECT r, char*text, RGBA*color, 
        int maxlength, U16 font, U16 height, EditTextLayout*layout, char*variable);
 
+SRECT swf_SetDefineText(TAG*tag, SWFFONT*font, RGBA*rgb, char*text, int scale);
+
 // swfdump.c
 
 void swf_DumpHeader(FILE * f,SWF * swf);
@@ -494,14 +551,6 @@ void swf_DumpTag(FILE * f,TAG * t);
 char* swf_TagGetName(TAG*tag);
 void swf_DumpFont(SWFFONT * font);
 
-// swfobject.c
-
-// Always use ST_PLACEOBJECT2 !!!
-
-int swf_ObjectPlace(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name);
-int swf_ObjectPlaceClip(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name, U16 clipaction);
-int swf_ObjectMove(TAG * t,U16 depth,MATRIX * m,CXFORM * cx);
-
 // swfbutton.c
 
 // Button States
@@ -583,6 +632,7 @@ int swf_SetJPEGBitsFinish(JPEGBITS * jpegbits);
 
 int swf_SetJPEGBits(TAG * t,char * fname,int quality);
 void swf_SetJPEGBits2(TAG * t,U16 width,U16 height,RGBA * bitmap,int quality);
+int swf_SetJPEGBits3(TAG * tag,U16 width,U16 height,RGBA* bitmap, int quality);
 
 #define BYTES_PER_SCANLINE(width) ((width+3)&0xfffffffc)
 
@@ -606,8 +656,11 @@ int swf_SetLosslessBitsGrayscale(TAG * t,U16 width,U16 height,U8 * bitmap);
 
 // swfsound.c
 void swf_SetSoundStreamHead(TAG*tag, int avgnumsamples);
-/* expects 2304 samples */
-void swf_SetSoundStreamBlock(TAG*tag, S16*samples, char first);
+void swf_SetSoundStreamBlock(TAG*tag, S16*samples, int seek, char first); /* expects 2304 samples */
+
+void swf_SetSoundDefine(TAG*tag, S16*samples, int num);
+
+void swf_SetSoundInfo(TAG*tag, SOUNDINFO*info);
 
 #endif // RFXSWF_DISABLESOUND
 
@@ -617,6 +670,7 @@ U8 swf_isDefiningTag(TAG * t);
 U8 swf_isPseudoDefiningTag(TAG * t);
 U8 swf_isAllowedSpriteTag(TAG * t);
 U16 swf_GetDefineID(TAG * t);
+SRECT swf_GetDefineBBox(TAG * t);
 void swf_SetDefineID(TAG * t, U16 newid);
 U16 swf_GetPlaceID(TAG * t); //PLACEOBJECT, PLACEOBJECT2 (sometimes), REMOVEOBJECT
 U16 swf_GetDepth(TAG * t); //PLACEOBJECT,PLACEOBJECT2,REMOVEOBJECT,REMOVEOBJECT2
@@ -634,6 +688,23 @@ void swf_uncgi();  // same behaviour as Steven Grimm's uncgi-library
 
 // swfaction.c
 
+typedef struct _ActionTAG 
+{ U8            op;
+  U16           len;
+  U8 *          data;
+
+  struct _ActionTAG * next;
+  struct _ActionTAG * prev;
+
+  struct _ActionTAG * parent;
+  U8 tmp[4]; // store small operands here.
+} ActionTAG;
+
+typedef struct _ActionMarker
+{
+  ActionTAG* atag;
+} ActionMarker;
+
 ActionTAG* swf_ActionGet(TAG*tag);
 void swf_ActionFree(ActionTAG*tag);
 void swf_ActionSet(TAG*tag, ActionTAG*actions);
@@ -741,4 +812,33 @@ ActionTAG* action_GotoFrame2(ActionTAG*atag, U8 method);
 ActionMarker action_setMarker(ActionTAG*atag);
 void action_fixjump(ActionMarker m1, ActionMarker m2);
 
+// swfobject.c
+
+// The following 3 routines only use placeobject2:
+
+int swf_ObjectPlace(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name);
+int swf_ObjectPlaceClip(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name, U16 clipaction);
+int swf_ObjectMove(TAG * t,U16 depth,MATRIX * m,CXFORM * cx);
+
+typedef struct _SWFPLACEOBJECT {
+    U16 depth;
+    U16 id; // may be 0
+    bool move; //true: move/replace character, false: set character
+    MATRIX matrix;
+    CXFORM cxform;
+    U16 ratio;
+    U8*name;
+    U16 clipdepth;
+    ActionTAG* actions;
+} SWFPLACEOBJECT;
+
+void swf_SetPlaceObject(TAG * t,SWFPLACEOBJECT* obj);
+void swf_GetPlaceObject(TAG * t,SWFPLACEOBJECT* obj);
+void swf_PlaceObjectFree(SWFPLACEOBJECT* obj);
+
+#ifdef __cplusplus
+}
+#endif
+
 #endif
+