lib/rfxswf.h

   1 /* rfxswf.h
   2
   3    Headers for rfxswf.c and modules
   4
   5    Part of the swftools package.
   6
   7    Copyright (c) 2000, 2001 Rainer Böhme <rfxswf@reflex-studio.de>
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
  22
  23
  24 #ifndef __RFX_SWF_INCLUDED__
  25 #define __RFX_SWF_INCLUDED__
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif
  30
  31 #include <stdio.h>
  32 #include <stdlib.h>
  33 #include <math.h>
  34 #include <string.h>
  35 #include <unistd.h>
  36 #include <fcntl.h>
  37 #include <ctype.h>
  38 #include "../config.h"
  39 #include "./bitio.h"
  40 #include "./drawer.h"
  41
  42 #define DEBUG_RFXSWF
  43 #ifdef RFXSWF_DISABLESOUND
  44 #define NO_MP3
  45 #endif
  46
  47 #ifndef TRUE
  48 #define TRUE (1)
  49 #endif
  50 #ifndef FALSE
  51 #define FALSE (0)
  52 #endif
  53
  54
  55 /* little/big endian stuff */
  56
  57 #define PUT8(ptr,x) {((U8*)(ptr))[0]=x;}
  58 #define PUT16(ptr,x) {((U8*)(ptr))[0]=(U8)(x);((U8*)(ptr))[1]=(U8)((x)>>8);}
  59 #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);}
  60 #define GET16(ptr) (((U16)(((U8*)(ptr))[0]))+(((U16)(((U8*)(ptr))[1]))<<8))
  61 #define GET32(ptr) (((U16)(((U8*)(ptr))[0]))+(((U16)(((U8*)(ptr))[1]))<<8)+(((U16)(((U8*)(ptr))[2]))<<16)+(((U16)(((U8*)(ptr))[3]))<<24))
  62
  63 #ifdef WORDS_BIGENDIAN
  64 #define SWAP16(s) ((((s)>>8)&0x00ff)|(((s)<<8)&0xff00))
  65 #define SWAP32(s) (SWAP16(((s)>>16)&0x0000ffff)|((SWAP16(s)<<16)&0xffff0000))
  66 #define REVERSESWAP16(x) (x)
  67 #define REVERSESWAP32(x) (x)
  68 #else
  69 #define SWAP16(x) (x)
  70 #define SWAP32(x) (x)
  71 #define REVERSESWAP16(s) ((((s)>>8)&0x00ff)|(((s)<<8)&0xff00))
  72 #define REVERSESWAP32(s) (REVERSESWAP16(((s)>>16)&0x0000ffff)|((REVERSESWAP16(s)<<16)&0xffff0000))
  73 #endif
  74
  75 #define ALLOC_ARRAY(type, num) (((type)*)rfxalloc(sizeof(type)*(num)))
  76 void* rfx_alloc(int size);
  77 void* rfx_calloc(int size);
  78 void* rfx_realloc(void*data, int size);
  79 void rfx_free(void*data);
  80 #ifdef MEMORY_INFO
  81 long rfx_memory_used();
  82 char* rfx_memory_used_str();
  83 #endif
  84
  85 // SWF Types
  86
  87 typedef         unsigned long   U32;
  88 typedef         signed long     S32;
  89 typedef         unsigned short  U16;
  90 typedef         signed short    S16;
  91 typedef         unsigned char   U8;
  92 typedef         signed char     S8;
  93 typedef         signed long     SFIXED;
  94 typedef         signed long     SCOORD;
  95
  96 #define SCOORD_MAX 0x7fffffff
  97 #define SCOORD_MIN -0x80000000
  98
  99 // Basic Structures
 100
 101 typedef struct _SPOINT
 102 { SCOORD        x;
 103   SCOORD        y;
 104 } SPOINT;
 105
 106 typedef struct _RGBA
 107 { U8    a;
 108   U8    r;
 109   U8    g;
 110   U8    b;
 111 } RGBA;
 112
 113 typedef struct _YUV
 114 {
 115   U8    y,u,v;
 116 } YUV;
 117
 118 typedef struct _SRECT
 119 { SCOORD        xmin;
 120   SCOORD        ymin;
 121   SCOORD        xmax;
 122   SCOORD        ymax;
 123 } SRECT;
 124
 125 typedef struct _MATRIX
 126 { SFIXED        sx,r1, tx;
 127   SFIXED        r0,sy, ty;
 128 } MATRIX;
 129
 130 typedef struct _CXFORM
 131 { S16           a0, a1; /* mult, add */
 132   S16           r0, r1;
 133   S16           g0, g1;
 134   S16           b0, b1;
 135 } CXFORM;
 136
 137 #define GRADIENT_LINEAR 0x10
 138 #define GRADIENT_RADIAL 0x12
 139 typedef struct _GRADIENT
 140 {
 141     int num;
 142     U8 ratios[8];
 143     RGBA rgba[8];
 144 } GRADIENT;
 145
 146 typedef struct _TAG             // NEVER access a Tag-Struct directly !
 147 { U16           id;
 148   U8 *          data;
 149   U32           memsize;        // to minimize realloc() calls
 150
 151   U32         len;            // for Set-Access
 152   U32         pos;            // for Get-Access
 153
 154   struct _TAG * next;
 155   struct _TAG * prev;
 156
 157   U8            readBit;        // for Bit-Manipulating Functions [read]
 158   U8            writeBit;       // [write]
 159
 160 } TAG;
 161
 162 #define swf_ResetReadBits(tag)   if (tag->readBit)  { tag->pos++; tag->readBit = 0; }
 163 #define swf_ResetWriteBits(tag)  if (tag->writeBit) { tag->writeBit = 0; }
 164
 165 typedef struct _SOUNDINFO
 166 {
 167     U8 stop;
 168     U8 nomultiple; //continue playing if already started
 169
 170     U32 inpoint;
 171     U32 outpoint;
 172
 173     U16 loops;
 174     U8 envelopes;
 175
 176     //envelope:
 177     U32* pos;
 178     U32* left;
 179     U32* right;
 180 } SOUNDINFO;
 181
 182 typedef struct _SWF
 183 { U8            fileVersion;
 184   U8            compressed;     // SWF or SWC?
 185   U32           fileSize;       // valid after load and save
 186   SRECT         movieSize;
 187   U16           frameRate;
 188   U16           frameCount;     // valid after load and save
 189   TAG *         firstTag;
 190 } SWF;
 191
 192 // Basic Functions
 193
 194 int  swf_ReadSWF2(struct reader_t*reader, SWF * swf);   // Reads SWF via callback
 195 int  swf_ReadSWF(int handle,SWF * swf);     // Reads SWF to memory (malloc'ed), returns length or <0 if fails
 196 int  swf_WriteSWF2(struct writer_t*writer, SWF * swf);     // Writes SWF via callback, returns length or <0 if fails
 197 int  swf_WriteSWF(int handle,SWF * swf);    // Writes SWF to file, returns length or <0 if fails
 198 int  swf_WriteSWC(int handle, SWF * swf);   // for convenience, equal to swf->compressed=1;swf_WriteSWF(..)
 199 int  swf_WriteCGI(SWF * swf);               // Outputs SWF with valid CGI header to stdout
 200 void swf_FreeTags(SWF * swf);               // Frees all malloc'ed memory for swf
 201 SWF* swf_CopySWF(SWF*swf);
 202
 203 // for streaming:
 204 int  swf_WriteHeader(int handle,SWF * swf);    // Writes Header of swf to file
 205 int  swf_WriteHeader2(struct writer_t*writer,SWF * swf);    // Writes Header of swf to file
 206 int  swf_WriteTag(int handle,TAG * tag);    // Writes TAG to file
 207 int  swf_WriteTag2(struct writer_t*writer, TAG * t); //Write TAG via callback
 208
 209 int  swf_ReadHeader(struct reader_t*reader, SWF * swf);   // Reads SWF Header via callback
 210
 211 // folding/unfolding:
 212
 213 void swf_FoldAll(SWF*swf);
 214 void swf_UnFoldAll(SWF*swf);
 215 void swf_FoldSprite(TAG*tag);
 216 void swf_UnFoldSprite(TAG*tag);
 217 int swf_IsFolded(TAG*tag);
 218
 219 // tag reordering:
 220
 221 void swf_OptimizeTagOrder(SWF*swf);
 222
 223 // basic routines:
 224
 225 TAG * swf_InsertTag(TAG * after,U16 id);    // updates frames, if necessary
 226 TAG * swf_InsertTagBefore(SWF*swf, TAG * before,U16 id);     // like InsertTag, but insert tag before argument
 227 int   swf_DeleteTag(TAG * t);
 228
 229 void  swf_ClearTag(TAG * t);                //frees tag data
 230 void  swf_ResetTag(TAG*tag, U16 id);        //set's tag position and length to 0, without freeing it
 231 TAG*  swf_CopyTag(TAG*tag, TAG*to_copy);     //stores a copy of another tag into this taglist
 232
 233 void  swf_SetTagPos(TAG * t,U32 pos);       // resets Bitcount
 234 U32   swf_GetTagPos(TAG * t);
 235
 236 TAG * swf_NextTag(TAG * t);
 237 TAG * swf_PrevTag(TAG * t);
 238
 239 U16   swf_GetTagID(TAG * t);                // ... TagGetID
 240 U32   swf_GetTagLen(TAG * t);             // ... TagGetTagLen
 241 U8*   swf_GetTagLenPtr(TAG * t);
 242
 243 U32   swf_GetBits(TAG * t,int nbits);
 244 S32   swf_GetSBits(TAG * t,int nbits);
 245 int   swf_SetBits(TAG * t,U32 v,int nbits);
 246
 247 int   swf_GetBlock(TAG * t,U8 * b,int l);   // resets Bitcount
 248 int   swf_SetBlock(TAG * t,U8 * b,int l);
 249
 250 U8    swf_GetU8(TAG * t);                   // resets Bitcount
 251 U16   swf_GetU16(TAG * t);
 252 #define swf_GetS16(tag)     ((S16)swf_GetU16(tag))
 253 U32   swf_GetU32(TAG * t);
 254 void  swf_GetRGB(TAG * t, RGBA * col);
 255 void  swf_GetRGBA(TAG * t, RGBA * col);
 256 void  swf_GetGradient(TAG * t, GRADIENT * gradient, char alpha);
 257 char* swf_GetString(TAG*t);
 258 int   swf_SetU8(TAG * t,U8 v);              // resets Bitcount
 259 int   swf_SetU16(TAG * t,U16 v);
 260 void  swf_SetS16(TAG * t,int v);
 261 int   swf_SetU32(TAG * t,U32 v);
 262 #define swf_SetString(t,s)  swf_SetBlock(t,s,strlen(s)+1)
 263
 264 //int   swf_GetPoint(TAG * t,SPOINT * p);     // resets Bitcount
 265 int   swf_GetRect(TAG * t,SRECT * r);
 266 int   swf_GetMatrix(TAG * t,MATRIX * m);
 267 int   swf_GetCXForm(TAG * t,CXFORM * cx,U8 alpha);
 268
 269 //int   swf_SetPoint(TAG * t,SPOINT * p);     // resets Bitcount
 270 int   swf_SetRect(TAG * t,SRECT * r);
 271 int   swf_SetMatrix(TAG * t,MATRIX * m);
 272 int   swf_SetCXForm(TAG * t,CXFORM * cx,U8 alpha);
 273 int   swf_SetRGB(TAG * t,RGBA * col);
 274 int   swf_SetRGBA(TAG * t,RGBA * col);
 275 void  swf_SetPassword(TAG * t, const char * password);
 276
 277 int   swf_VerifyPassword(TAG * t, const char * password);
 278
 279 // helper functions:
 280
 281 void swf_ExpandRect(SRECT*src, SPOINT add);
 282 void swf_ExpandRect2(SRECT*src, SRECT*add);
 283 void swf_ExpandRect3(SRECT*src, SPOINT center, int radius);
 284 SPOINT swf_TurnPoint(SPOINT p, MATRIX* m);
 285 SRECT swf_TurnRect(SRECT r, MATRIX* m);
 286
 287 #ifndef FAILED
 288 #define FAILED(b)       ((b)<0)
 289 #endif
 290
 291 // Tag IDs (adopted from J. C. Kessels' Form2Flash)
 292
 293 #define ST_END                  0
 294 #define ST_SHOWFRAME            1
 295 #define ST_DEFINESHAPE          2
 296 #define ST_FREECHARACTER        3
 297 #define ST_PLACEOBJECT          4
 298 #define ST_REMOVEOBJECT         5
 299 #define ST_DEFINEBITS           6
 300 #define ST_DEFINEBITSJPEG       6
 301 #define ST_DEFINEBUTTON         7
 302 #define ST_JPEGTABLES           8
 303 #define ST_SETBACKGROUNDCOLOR   9
 304 #define ST_DEFINEFONT           10
 305 #define ST_DEFINETEXT           11
 306 #define ST_DOACTION             12
 307 #define ST_DEFINEFONTINFO       13
 308 #define ST_DEFINESOUND          14 /* Event sound tags. */
 309 #define ST_STARTSOUND           15
 310 #define ST_DEFINEBUTTONSOUND    17
 311 #define ST_SOUNDSTREAMHEAD      18
 312 #define ST_SOUNDSTREAMBLOCK     19
 313 #define ST_DEFINEBITSLOSSLESS   20 /* A bitmap using lossless zlib compression. */
 314 #define ST_DEFINEBITSJPEG2      21 /* A bitmap using an internal JPEG compression table. */
 315 #define ST_DEFINESHAPE2         22
 316 #define ST_DEFINEBUTTONCXFORM   23
 317 #define ST_PROTECT              24 /* This file should not be importable for editing. */
 318 #define ST_PLACEOBJECT2         26 /* The new style place w/ alpha color transform and name. */
 319 #define ST_REMOVEOBJECT2        28 /* A more compact remove object that omits the character tag (just depth). */
 320 #define ST_FREEALL              31 /* ? */
 321 #define ST_DEFINESHAPE3         32 /* A shape V3 includes alpha values. */
 322 #define ST_DEFINETEXT2          33 /* A text V2 includes alpha values. */
 323 #define ST_DEFINEBUTTON2        34 /* A button V2 includes color transform, alpha and multiple actions */
 324 #define ST_DEFINEBITSJPEG3      35 /* A JPEG bitmap with alpha info. */
 325 #define ST_DEFINEBITSLOSSLESS2  36 /* A lossless bitmap with alpha info. */
 326 #define ST_DEFINEEDITTEXT       37
 327 #define ST_DEFINEMOVIE          38
 328 #define ST_DEFINESPRITE         39 /* Define a sequence of tags that describe the behavior of a sprite. */
 329 #define ST_NAMECHARACTER        40 /* Name a character definition, character id and a string, (used for buttons, bitmaps, sprites and sounds). */
 330 #define ST_SERIALNUMBER         41
 331 #define ST_GENERATORTEXT        42 /* contains an id */
 332 #define ST_FRAMELABEL           43 /* A string label for the current frame. */
 333 #define ST_SOUNDSTREAMHEAD2     45 /* For lossless streaming sound, should not have needed this... */
 334 #define ST_DEFINEMORPHSHAPE     46 /* A morph shape definition */
 335 #define ST_DEFINEFONT2          48
 336 #define ST_TEMPLATECOMMAND      49
 337 #define ST_GENERATOR3           51
 338 #define ST_EXTERNALFONT         52
 339 #define ST_EXPORTASSETS         56
 340 #define ST_IMPORTASSETS         57
 341 #define ST_ENABLEDEBUGGER       58
 342 #define ST_DOINITACTION         59
 343 #define ST_DEFINEVIDEOSTREAM    60
 344 #define ST_VIDEOFRAME           61
 345 #define ST_DEFINEFONTINFO2      62
 346 #define ST_MX4                  63 /*(?) */
 347 #define ST_SCRIPTLIMITS         65 /* version 7- u16 maxrecursedepth, u16 scripttimeoutseconds */
 348 #define ST_SETTABINDEX          66 /* version 7- u16 depth(!), u16 tab order value */
 349
 350 /* custom tags- only valid for swftools */
 351 #define ST_REFLEX              777 /* to identify generator software */
 352 #define ST_GLYPHNAMES          778
 353
 354 // Advanced Funtions
 355
 356 // swfshape.c
 357
 358 typedef struct _LINESTYLE
 359 { U16           width;
 360   RGBA          color;
 361 } LINESTYLE;
 362
 363 #define FILL_SOLID      0x00
 364 #define FILL_LINEAR     0x10  // Gradient
 365 #define FILL_RADIAL     0x12
 366 #define FILL_TILED      0x40  // Bitmap
 367 #define FILL_CLIPPED    0x41
 368
 369 typedef struct _FILLSTYLE
 370 { U8        type;
 371   RGBA      color;
 372   MATRIX    m;
 373   U16       id_bitmap;
 374   GRADIENT  gradient;
 375 } FILLSTYLE;
 376
 377 typedef struct _SHAPE           // NEVER access a Shape-Struct directly !
 378 {
 379   struct
 380   { LINESTYLE * data;
 381     U16         n;
 382   } linestyle;
 383
 384   struct
 385   { FILLSTYLE * data;
 386     U16         n;
 387   } fillstyle;
 388
 389   struct
 390   { U16         fill;
 391     U16         line;
 392   } bits;
 393                                 // used by Get/SetSimpleShape and glyph handling
 394   U8 *          data;
 395   U32           bitlen;         // length of data in bits
 396 } SHAPE;
 397
 398 /* SHAPE can be converted into SHAPE2: */
 399
 400 struct _SHAPELINE;
 401 typedef struct _SHAPE2
 402 {
 403     LINESTYLE * linestyles;
 404     int numlinestyles;
 405     FILLSTYLE* fillstyles;
 406     int numfillstyles;
 407     struct _SHAPELINE * lines;
 408     SRECT* bbox; // may be NULL
 409 } SHAPE2;
 410
 411 typedef struct _SHAPELINE
 412 {
 413     enum {moveTo, lineTo, splineTo} type;
 414     SCOORD x,y;
 415     SCOORD sx,sy; //only if type==splineTo
 416     int fillstyle0;
 417     int fillstyle1;
 418     int linestyle;
 419     struct _SHAPELINE * next;
 420 } SHAPELINE;
 421
 422 // Shapes
 423
 424 int   swf_ShapeNew(SHAPE ** s);
 425 void  swf_ShapeFree(SHAPE * s);
 426
 427 int   swf_GetSimpleShape(TAG * t,SHAPE ** s); // without Linestyle/Fillstyle Record
 428 int   swf_SetSimpleShape(TAG * t,SHAPE * s);   // without Linestyle/Fillstyle Record
 429
 430 int   swf_ShapeAddLineStyle(SHAPE * s,U16 width,RGBA * color);
 431 int   swf_ShapeAddSolidFillStyle(SHAPE * s,RGBA * color);
 432 int   swf_ShapeAddBitmapFillStyle(SHAPE * s,MATRIX * m,U16 id_bitmap,int clip);
 433 int   swf_ShapeAddGradientFillStyle(SHAPE * s,MATRIX * m,GRADIENT* gradient,int radial);
 434 int   swf_ShapeAddFillStyle2(SHAPE * s,FILLSTYLE*fs);
 435
 436 int   swf_SetShapeStyles(TAG * t,SHAPE * s);
 437 int   swf_ShapeCountBits(SHAPE * s,U8 * fbits,U8 * lbits);
 438 int   swf_SetShapeBits(TAG * t,SHAPE * s);
 439 int   swf_SetShapeHeader(TAG * t,SHAPE * s); // one call for upper three functions
 440
 441 int   swf_ShapeSetMove(TAG * t,SHAPE * s,S32 x,S32 y);
 442 int   swf_ShapeSetStyle(TAG * t,SHAPE * s,int line,int fill0,int fill1);
 443 #define UNDEFINED_COORD 0x7fffffff
 444 int   swf_ShapeSetAll(TAG * t,SHAPE * s,S32 x,S32 y,int line,int fill0,int fill1);
 445
 446 int   swf_ShapeSetLine(TAG * t,SHAPE * s,S32 x,S32 y);
 447 int   swf_ShapeSetCurve(TAG * t,SHAPE * s,S32 x,S32 y,S32 ax,S32 ay);
 448 int   swf_ShapeSetCircle(TAG * t,SHAPE * s,S32 x,S32 y,S32 rx,S32 ry);
 449 int   swf_ShapeSetEnd(TAG * t);
 450
 451 void  swf_ShapeSetBitmapRect(TAG * t, U16 gfxid, int width, int height);
 452
 453 //SHAPELINE* swf_ParseShapeData(U8*data, int bits, int fillbits, int linebits);
 454 SHAPE2*    swf_ShapeToShape2(SHAPE*shape);
 455 void       swf_Shape2ToShape(SHAPE2*shape2, SHAPE*shape);
 456 SRECT      swf_GetShapeBoundingBox(SHAPE2*shape);
 457 void        swf_SetShape2(TAG*tag, SHAPE2*shape);
 458 SHAPE2*    swf_Shape2Clone(SHAPE2 * s);
 459 void       swf_Shape2Free(SHAPE2 * s);
 460 void    swf_DumpShape(SHAPE2*shape2);
 461
 462 void swf_ParseDefineShape(TAG*tag, SHAPE2*shape);
 463 void swf_Shape2ToShape(SHAPE2*shape2, SHAPE*shape);
 464 void swf_SetShape2(TAG*tag, SHAPE2*shape2);
 465
 466 void swf_RecodeShapeData(U8*data, int bitlen, int in_bits_fill, int in_bits_line,
 467                          U8**destdata, U32*destbitlen, int out_bits_fill, int out_bits_line);
 468
 469 // swfdraw.c
 470
 471 void swf_Shape10DrawerInit(drawer_t*draw, TAG*tag);
 472 void swf_Shape01DrawerInit(drawer_t*draw, TAG*tag);
 473 void swf_Shape11DrawerInit(drawer_t*draw, TAG*tag);
 474 SHAPE* swf_ShapeDrawerToShape(drawer_t*draw);
 475 SRECT swf_ShapeDrawerGetBBox(drawer_t*draw);
 476
 477 void swf_DrawString(drawer_t*draw, const char*source);
 478
 479 // swftext.c
 480
 481 typedef struct _KERNING
 482 {
 483   U16         char1;
 484   U16         char2;
 485   U16         adjustment;
 486 } SWFKERNING;
 487
 488 typedef struct _SWFLAYOUT
 489 { S16          ascent;
 490   S16          descent;
 491   S16          leading;
 492   SRECT      * bounds;
 493   U16          kerningcount;
 494   SWFKERNING * kerning;
 495 } SWFLAYOUT;
 496
 497 typedef struct
 498 { S16         advance;
 499   SHAPE *     shape;
 500 } SWFGLYPH;
 501
 502 typedef struct _FONTUSAGE
 503 { int* chars;
 504   char is_reduced;
 505 } FONTUSAGE;
 506
 507 #define FONT_STYLE_BOLD 1
 508 #define FONT_STYLE_ITALIC 2
 509 #define FONT_ENCODING_UNICODE 1
 510 #define FONT_ENCODING_ANSI 2
 511 #define FONT_ENCODING_SHIFTJIS 4
 512
 513 typedef struct _SWFFONT
 514 { int           id; // -1 = not set
 515   U8            version; // 0 = not set, 1 = definefont, 2 = definefont2
 516   U8 *          name;
 517   SWFLAYOUT *   layout;
 518   U16           numchars;
 519   U16           maxascii; // highest mapped ascii value
 520
 521   U8            style;
 522   U8            encoding;
 523
 524   U16   *       glyph2ascii;
 525   int   *       ascii2glyph;
 526   SWFGLYPH *    glyph;
 527   U8            language;
 528   char **       glyphnames;
 529
 530   FONTUSAGE *   use;
 531
 532 } SWFFONT;
 533
 534
 535 #define ET_HASTEXT 32768
 536 #define ET_WORDWRAP 16384
 537 #define ET_MULTILINE 8192
 538 #define ET_PASSWORD 4096
 539 #define ET_READONLY 2048
 540 #define ET_HASTEXTCOLOR 1024
 541 #define ET_HASMAXLENGTH 512
 542 #define ET_HASFONT 256
 543 #define ET_X3 128
 544 #define ET_AUTOSIZE 64 /* MX */
 545 #define ET_HASLAYOUT 32
 546 #define ET_NOSELECT 16
 547 #define ET_BORDER 8
 548 #define ET_X1 4
 549 #define ET_HTML 2 /* MX? */
 550 #define ET_USEOUTLINES 1
 551
 552 #define ET_ALIGN_LEFT 0
 553 #define ET_ALIGN_RIGHT  1
 554 #define ET_ALIGN_CENTER 2
 555 #define ET_ALIGN_JUSTIFY 3
 556
 557 typedef struct _EditTextLayout
 558 {
 559     U8 align; // 0=left, 1=right, 2=center, 3=justify
 560     U16 leftmargin;
 561     U16 rightmargin;
 562     U16 indent;
 563     U16 leading;
 564 } EditTextLayout;
 565
 566 int swf_FontEnumerate(SWF * swf,void (*FontCallback) (void*,U16,U8*), void*self);
 567 // -> void fontcallback(U16 id,U8 * name); returns number of defined fonts
 568
 569 int swf_FontExtract(SWF * swf,int id,SWFFONT ** f);
 570 // Fetches all available information from DefineFont, DefineFontInfo, DefineText, ...
 571 // id = FontID, id=0 -> Extract first Font
 572
 573 int swf_FontIsItalic(SWFFONT * f);
 574 int swf_FontIsBold(SWFFONT * f);
 575
 576 int swf_FontSetID(SWFFONT * f,U16 id);
 577 int swf_FontReduce(SWFFONT * f);
 578
 579 int swf_FontInitUsage(SWFFONT * f);
 580 int swf_FontUseGlyph(SWFFONT * f, int glyph);
 581 int swf_FontUse(SWFFONT* f,U8 * s);
 582
 583 int swf_FontSetDefine(TAG * t,SWFFONT * f);
 584 int swf_FontSetDefine2(TAG * t,SWFFONT * f);
 585 int swf_FontSetInfo(TAG * t,SWFFONT * f);
 586
 587 void swf_FontCreateLayout(SWFFONT*f);
 588 void swf_FontAddLayout(SWFFONT * f, int ascent, int descent, int leading);
 589
 590 int swf_ParseDefineText(TAG * t, void(*callback)(void*self, int*chars, int*xpos, int nr, int fontid, int fontsize, int xstart, int ystart, RGBA* color), void*self);
 591
 592 void swf_WriteFont(SWFFONT* font, char* filename);
 593 SWFFONT* swf_ReadFont(char* filename);
 594
 595 void swf_FontFree(SWFFONT * f);
 596
 597 U32 swf_TextGetWidth(SWFFONT * font,U8 * s,int scale);
 598 int swf_TextCountBits(SWFFONT * font,U8 * s,int scale,U8 * gbits,U8 * abits);
 599
 600 #define SET_TO_ZERO 0x80000000
 601 int swf_TextSetInfoRecord(TAG * t,SWFFONT * font,U16 size,RGBA * color,int dx,int dy);
 602 int swf_TextSetCharRecord(TAG * t,SWFFONT * font,U8 * s,int scale,U8 gbits,U8 abits);
 603
 604 int swf_TextPrintDefineText(TAG * t,SWFFONT * f);
 605 // Prints text defined in tag t with font f to stdout
 606
 607 void swf_FontPrepareForEditText(SWFFONT * f);
 608
 609 /* notice: if you set the fontid, make sure you call swf_FontPrepareForEditText() for the font first */
 610 void swf_SetEditText(TAG*tag, U16 flags, SRECT r, char*text, RGBA*color,
 611         int maxlength, U16 font, U16 height, EditTextLayout*layout, char*variable);
 612
 613 SRECT swf_SetDefineText(TAG*tag, SWFFONT*font, RGBA*rgb, char*text, int scale);
 614
 615 void swf_DrawText(drawer_t*draw, SWFFONT*font, int size, char*text);
 616
 617 // swffont.c
 618
 619 SWFFONT* swf_LoadTrueTypeFont(char*filename);
 620 SWFFONT* swf_LoadT1Font(char*filename);
 621 SWFFONT* swf_LoadFont(char*filename);
 622
 623 void swf_SetLoadFontParameters(int scale, int skip_unused, int full_unicode);
 624
 625 // swfdump.c
 626
 627 void swf_DumpHeader(FILE * f,SWF * swf);
 628 void swf_DumpMatrix(FILE * f,MATRIX * m);
 629 void swf_DumpTag(FILE * f,TAG * t);
 630 void swf_DumpSWF(FILE * f,SWF*swf);
 631 char* swf_TagGetName(TAG*tag);
 632 void swf_DumpFont(SWFFONT * font);
 633
 634 // swfbutton.c
 635
 636 // Button States
 637
 638 #define BS_HIT          0x08
 639 #define BS_DOWN         0x04
 640 #define BS_OVER         0x02
 641 #define BS_UP           0x01
 642
 643 // Button Conditions
 644
 645 /* missing: IDLE_OUTDOWN
 646             OUTDOWN_OVERUP
 647             OVERUP_OUTDOWN
 648 */
 649 #define BC_OVERDOWN_IDLE        0x0100
 650 #define BC_IDLE_OVERDOWN        0x0080
 651 #define BC_OUTDOWN_IDLE         0x0040
 652 #define BC_OUTDOWN_OVERDOWN     0x0020
 653 #define BC_OVERDOWN_OUTDOWN     0x0010
 654 #define BC_OVERDOWN_OVERUP      0x0008
 655 #define BC_OVERUP_OVERDOWN      0x0004
 656 #define BC_OVERUP_IDLE          0x0002
 657 #define BC_IDLE_OVERUP          0x0001
 658
 659 #define BC_KEY(c) (c<<9)
 660
 661 #define BC_CURSORLEFT           0x0200
 662 #define BC_CURSORRIGHT          0x0400
 663 #define BC_POS1                 0x0600
 664 #define BC_END                  0x0800
 665 #define BC_INSERT               0x0a00
 666 #define BC_DELETE               0x0c00
 667 #define BC_CLEAR                0x0e00
 668 #define BC_BACKSPACE            0x1000
 669 #define BC_ENTER                0x1a00
 670 #define BC_CURSORUP             0x1c00
 671 #define BC_CURSORDOWN           0x1e00
 672 #define BC_PAGEUP               0x2000
 673 #define BC_PAGEDOWN             0x2200
 674 #define BC_TAB                  0x2400
 675 #define BC_ESCAPE               0x3600
 676 #define BC_SPACE                0x4000
 677
 678 /* these are probably only valid with linux:
 679    Ctrl-A        0x0200
 680    Ctrl-X        0x3000
 681    Ctrl-Y        0x3200
 682    Ctrl-Z        0x3400
 683    Escape/Ctrl-[ 0x3600
 684    Ctrl-\        0x3800
 685    Ctrl-]        0x3a00
 686    Ctrl-^        0x3c00
 687    Ctrl-/        0x3e00
 688    */
 689
 690 /* everything above 0x4000 is standard ascii:
 691    0x4000 ' ' 0x4200 '!' 0x4600 '#' 0x4800 '$' 0x4a00 '%' 0x4c00 '&' ...
 692    0x6000 '0' ... 0x7200 '9'
 693    0x8000 '@'
 694    0x8200 'A' ...  0xb400 'Z'
 695    ...
 696    0xfc00 '~'
 697  */
 698
 699 // Button Flag
 700
 701 #define BF_TRACKMENU            0x01
 702
 703 int swf_ButtonSetRecord(TAG * t,U8 state,U16 id,U16 layer,MATRIX * m,CXFORM * cx);
 704 int swf_ButtonSetCondition(TAG * t,U16 condition); // for DefineButton2
 705 int swf_ButtonSetFlags(TAG * t,U8 flags);  // necessary for DefineButton2
 706 int swf_ButtonPostProcess(TAG * t,int anz_action); // Set all offsets in DefineButton2-Tags (how many conditions to process)
 707
 708 // swfbits.c
 709
 710 int swf_ImageHasAlpha(RGBA*img, int width, int height);
 711 int swf_ImageGetNumberOfPaletteEntries(RGBA*img, int width, int height, RGBA*palette);
 712
 713 typedef int JPEGBITS;
 714 JPEGBITS * swf_SetJPEGBitsStart(TAG * t,int width,int height,int quality); // deprecated
 715 int swf_SetJPEGBitsLines(JPEGBITS * jpegbits,U8 ** data,int n); // deprecated
 716 int swf_SetJPEGBitsLine(JPEGBITS * jpegbits,U8 * data); // deprecated
 717 int swf_SetJPEGBitsFinish(JPEGBITS * jpegbits); // deprecated
 718
 719 void swf_GetJPEGSize(char * fname, int*width, int*height);
 720
 721 int swf_SetJPEGBits(TAG * t,char * fname,int quality);
 722 void swf_SetJPEGBits2(TAG * t,U16 width,U16 height,RGBA * bitmap,int quality);
 723 int swf_SetJPEGBits3(TAG * tag,U16 width,U16 height,RGBA* bitmap, int quality);
 724 RGBA* swf_JPEG2TagToImage(TAG*tag, int*width, int*height);
 725 void swf_RemoveJPEGTables(SWF*swf);
 726
 727 #define BYTES_PER_SCANLINE(width) ((width+3)&0xfffffffc)
 728
 729 #define BMF_8BIT        3               // Bitmap formats
 730 #define BMF_16BIT       4
 731 #define BMF_32BIT       5
 732
 733 int swf_SetLosslessBits(TAG * t,U16 width,U16 height,void * bitmap,U8 bitmap_flags);
 734 int swf_SetLosslessBitsIndexed(TAG * t,U16 width,U16 height,U8 * bitmap,RGBA * palette,U16 ncolors);
 735 int swf_SetLosslessBitsGrayscale(TAG * t,U16 width,U16 height,U8 * bitmap);
 736 void swf_SetLosslessImage(TAG*tag, RGBA*data, int width, int height); //WARNING: will change tag->id
 737
 738 RGBA* swf_DefineLosslessBitsTagToImage(TAG*tag, int*width, int*height);
 739
 740 RGBA* swf_ExtractImage(TAG*tag, int*dwidth, int*dheight);
 741 RGBA* swf_ImageScale(RGBA*data, int width, int height, int newwidth, int newheight);
 742 TAG* swf_AddImage(TAG*tag, int bitid, RGBA*mem, int width, int height, int quality);
 743
 744 // swfsound.c
 745 void swf_SetSoundStreamHead(TAG*tag, int avgnumsamples);
 746 void swf_SetSoundStreamBlock(TAG*tag, S16*samples, int seek, char first); /* expects 2304 samples */
 747 void swf_SetSoundDefine(TAG*tag, S16*samples, int num);
 748 void swf_SetSoundInfo(TAG*tag, SOUNDINFO*info);
 749
 750 // swftools.c
 751
 752 void swf_Optimize(SWF*swf);
 753 U8 swf_isDefiningTag(TAG * t);
 754 U8 swf_isPseudoDefiningTag(TAG * t);
 755 U8 swf_isAllowedSpriteTag(TAG * t);
 756 U8 swf_isImageTag(TAG*tag);
 757 U8 swf_isShapeTag(TAG*tag);
 758
 759 U16 swf_GetDefineID(TAG * t);
 760 SRECT swf_GetDefineBBox(TAG * t);
 761 void swf_SetDefineBBox(TAG * t, SRECT r);
 762
 763 void swf_SetDefineID(TAG * t, U16 newid);
 764 U16 swf_GetPlaceID(TAG * t); //PLACEOBJECT, PLACEOBJECT2 (sometimes), REMOVEOBJECT
 765 int swf_GetDepth(TAG * t); //PLACEOBJECT,PLACEOBJECT2,REMOVEOBJECT,REMOVEOBJECT2,SETTABINDEX
 766 char* swf_GetName(TAG * t); //PLACEOBJECT2, FRAMELABEL
 767 MATRIX * swf_MatrixJoin(MATRIX * d,MATRIX * s1,MATRIX * s2);
 768 MATRIX * swf_MatrixMapTriangle(MATRIX * m,int dx,int dy,
 769                     int x0,int y0,int x1,int y1,int x2,int y2);
 770 int swf_GetNumUsedIDs(TAG * t);
 771 void swf_GetUsedIDs(TAG * t, int * positions);
 772 void swf_Relocate(SWF*swf, char*bitmap); // bitmap is 65536 bytes, bitmap[a]==0 means id a is free
 773 void swf_RelocateDepth(SWF*swf, char*bitmap); // bitmap is 65536 bytes, bitmap[d]==0 means depth d is free
 774
 775 TAG* swf_Concatenate (TAG*list1,TAG*list2); // warning: both list1 and list2 are invalid after this call.
 776
 777 // swfcgi.c
 778
 779 void swf_uncgi();  // same behaviour as Steven Grimm's uncgi-library
 780
 781 // swfaction.c
 782
 783 typedef struct _ActionTAG
 784 { U8            op;
 785   U16           len;
 786   U8 *          data;
 787
 788   struct _ActionTAG * next;
 789   struct _ActionTAG * prev;
 790
 791   struct _ActionTAG * parent;
 792   U8 tmp[4]; // store small operands here.
 793 } ActionTAG;
 794
 795 typedef struct _ActionMarker
 796 {
 797   ActionTAG* atag;
 798 } ActionMarker;
 799
 800 ActionTAG* swf_ActionGet(TAG*tag);
 801 void swf_ActionFree(ActionTAG*tag);
 802 void swf_ActionSet(TAG*tag, ActionTAG*actions);
 803 void swf_DumpActions(ActionTAG*atag, char*prefix);
 804 void swf_ActionEnumerateURLs(ActionTAG*atag, char*(*callback)(char*));
 805 void swf_ActionEnumerateTargets(ActionTAG*atag, char*(*callback)(char*));
 806 void swf_ActionEnumerateStrings(ActionTAG*atag, char*(*callback)(char*));
 807
 808 // using action/actioncompiler.h:
 809 ActionTAG* swf_ActionCompile(const char* source, int version);
 810
 811 ActionTAG* action_End(ActionTAG*atag);
 812 ActionTAG* action_NextFrame(ActionTAG*atag);
 813 ActionTAG* action_PreviousFrame(ActionTAG*atag);
 814 ActionTAG* action_Play(ActionTAG*atag);
 815 ActionTAG* action_Stop(ActionTAG*atag);
 816 ActionTAG* action_ToggleQuality(ActionTAG*atag);
 817 ActionTAG* action_StopSounds(ActionTAG*atag);
 818 ActionTAG* action_Add(ActionTAG*atag);
 819 ActionTAG* action_Subtract(ActionTAG*atag);
 820 ActionTAG* action_Multiply(ActionTAG*atag);
 821 ActionTAG* action_Divide(ActionTAG*atag);
 822 ActionTAG* action_Equals(ActionTAG*atag);
 823 ActionTAG* action_Less(ActionTAG*atag);
 824 ActionTAG* action_And(ActionTAG*atag);
 825 ActionTAG* action_Or(ActionTAG*atag);
 826 ActionTAG* action_Not(ActionTAG*atag);
 827 ActionTAG* action_StringEquals(ActionTAG*atag);
 828 ActionTAG* action_StringLength(ActionTAG*atag);
 829 ActionTAG* action_StringExtract(ActionTAG*atag);
 830 ActionTAG* action_Pop(ActionTAG*atag);
 831 ActionTAG* action_ToInteger(ActionTAG*atag);
 832 ActionTAG* action_GetVariable(ActionTAG*atag);
 833 ActionTAG* action_SetVariable(ActionTAG*atag);
 834 ActionTAG* action_SetTarget2(ActionTAG*atag);
 835 ActionTAG* action_StringAdd(ActionTAG*atag);
 836 ActionTAG* action_GetProperty(ActionTAG*atag);
 837 ActionTAG* action_SetProperty(ActionTAG*atag);
 838 ActionTAG* action_CloneSprite(ActionTAG*atag);
 839 ActionTAG* action_RemoveSprite(ActionTAG*atag);
 840 ActionTAG* action_Trace(ActionTAG*atag);
 841 ActionTAG* action_StartDrag(ActionTAG*atag);
 842 ActionTAG* action_EndDrag(ActionTAG*atag);
 843 ActionTAG* action_StringLess(ActionTAG*atag);
 844 ActionTAG* action_RandomNumber(ActionTAG*atag);
 845 ActionTAG* action_MBStringLength(ActionTAG*atag);
 846 ActionTAG* action_CharToAscii(ActionTAG*atag);
 847 ActionTAG* action_AsciiToChar(ActionTAG*atag);
 848 ActionTAG* action_GetTime(ActionTAG*atag);
 849 ActionTAG* action_MBStringExtract(ActionTAG*atag);
 850 ActionTAG* action_MBCharToAscii(ActionTAG*atag);
 851 ActionTAG* action_MBAsciiToChar(ActionTAG*atag);
 852 ActionTAG* action_Delete(ActionTAG*atag);
 853 ActionTAG* action_Delete2(ActionTAG*atag);
 854 ActionTAG* action_DefineLocal(ActionTAG*atag);
 855 ActionTAG* action_CallFunction(ActionTAG*atag);
 856 ActionTAG* action_Return(ActionTAG*atag);
 857 ActionTAG* action_Modulo(ActionTAG*atag);
 858 ActionTAG* action_NewObject(ActionTAG*atag);
 859 ActionTAG* action_DefineLocal2(ActionTAG*atag);
 860 ActionTAG* action_InitArray(ActionTAG*atag);
 861 ActionTAG* action_Makehash(ActionTAG*atag);
 862 ActionTAG* action_TypeOf(ActionTAG*atag);
 863 ActionTAG* action_TargetPath(ActionTAG*atag);
 864 ActionTAG* action_Enumerate(ActionTAG*atag);
 865 ActionTAG* action_Add2(ActionTAG*atag);
 866 ActionTAG* action_Less2(ActionTAG*atag);
 867 ActionTAG* action_Equals2(ActionTAG*atag);
 868 ActionTAG* action_ToNumber(ActionTAG*atag);
 869 ActionTAG* action_ToString(ActionTAG*atag);
 870 ActionTAG* action_PushDuplicate(ActionTAG*atag);
 871 ActionTAG* action_StackSwap(ActionTAG*atag);
 872 ActionTAG* action_GetMember(ActionTAG*atag);
 873 ActionTAG* action_SetMember(ActionTAG*atag);
 874 ActionTAG* action_Increment(ActionTAG*atag);
 875 ActionTAG* action_Decrement(ActionTAG*atag);
 876 ActionTAG* action_CallMethod(ActionTAG*atag);
 877 ActionTAG* action_NewMethod(ActionTAG*atag);
 878 ActionTAG* action_BitAnd(ActionTAG*atag);
 879 ActionTAG* action_BitOr(ActionTAG*atag);
 880 ActionTAG* action_BitXor(ActionTAG*atag);
 881 ActionTAG* action_BitLShift(ActionTAG*atag);
 882 ActionTAG* action_BitRShift(ActionTAG*atag);
 883 ActionTAG* action_BitURShift(ActionTAG*atag);
 884 ActionTAG* action_GotoFrame(ActionTAG*atag, U16 frame);
 885 ActionTAG* action_GetUrl(ActionTAG*atag, char* url, char* label);
 886 ActionTAG* action_StoreRegister(ActionTAG*atag, U8 reg);
 887 ActionTAG* action_Constantpool(ActionTAG*atag, char* constantpool);
 888 ActionTAG* action_WaitForFrame(ActionTAG*atag, U16 frame, U8 skip);
 889 ActionTAG* action_SetTarget(ActionTAG*atag, char* target);
 890 ActionTAG* action_GotoLabel(ActionTAG*atag, char* label);
 891 ActionTAG* action_WaitForFrame2(ActionTAG*atag, U8 skip);
 892 ActionTAG* action_With(ActionTAG*atag, char*object);
 893 ActionTAG* action_PushString(ActionTAG*atag, char*str);
 894 ActionTAG* action_PushFloat(ActionTAG*atag, float f);
 895 ActionTAG* action_PushNULL(ActionTAG*atag);
 896 ActionTAG* action_PushRegister(ActionTAG*atag, U8 reg);
 897 ActionTAG* action_PushBoolean(ActionTAG*atag, char c);
 898 ActionTAG* action_PushDouble(ActionTAG*atag, double d);
 899 ActionTAG* action_PushInt(ActionTAG*atag, int i);
 900 ActionTAG* action_PushLookup(ActionTAG*atag, U8 index);
 901 ActionTAG* action_Jump(ActionTAG*atag, U16 branch);
 902 ActionTAG* action_GetUrl2(ActionTAG*atag, U8 method);
 903 ActionTAG* action_DefineFunction(ActionTAG*atag, U8*data, int len);
 904 ActionTAG* action_If(ActionTAG*atag, U16 branch);
 905 ActionTAG* action_Call(ActionTAG*atag);
 906 ActionTAG* action_GotoFrame2(ActionTAG*atag, U8 method);
 907 ActionMarker action_setMarker(ActionTAG*atag);
 908 void action_fixjump(ActionMarker m1, ActionMarker m2);
 909
 910 // swfobject.c
 911
 912 // The following 3 routines only use placeobject2:
 913
 914 int swf_ObjectPlace(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name);
 915 int swf_ObjectPlaceClip(TAG * t,U16 id,U16 depth,MATRIX * m,CXFORM * cx,U8 * name, U16 clipaction);
 916 int swf_ObjectMove(TAG * t,U16 depth,MATRIX * m,CXFORM * cx);
 917
 918 typedef struct _SWFPLACEOBJECT {
 919     U16 depth;
 920     U16 id; // may be 0
 921     char move; //true: move/replace character, false: set character
 922     MATRIX matrix;
 923     CXFORM cxform;
 924     U16 ratio;
 925     U8*name;
 926     U16 clipdepth;
 927     ActionTAG* actions;
 928 } SWFPLACEOBJECT;
 929
 930 void swf_SetPlaceObject(TAG * t,SWFPLACEOBJECT* obj);
 931 void swf_GetPlaceObject(TAG * t,SWFPLACEOBJECT* obj);
 932 void swf_PlaceObjectFree(SWFPLACEOBJECT* obj);
 933
 934 // swfvideo.c
 935
 936 typedef struct _VIDEOSTREAM
 937 {
 938     int width;
 939     int height;
 940     int linex;
 941
 942     int owidth;
 943     int oheight;
 944     int olinex;
 945
 946     int frame;
 947     YUV*oldpic;
 948     YUV*current;
 949     int bbx;
 950     int bby;
 951     int*mvdx;
 952     int*mvdy;
 953     int quant;
 954
 955     /* modifyable: */
 956     int do_motion; //enable motion compensation (slow!)
 957
 958 } VIDEOSTREAM;
 959
 960 void swf_SetVideoStreamDefine(TAG*tag, VIDEOSTREAM*stream, U16 frames, U16 width, U16 height);
 961 void swf_SetVideoStreamIFrame(TAG*tag, VIDEOSTREAM*s, RGBA*pic, int quant/* 1-31, 1=best quality, 31=best compression*/);
 962 void swf_SetVideoStreamBlackFrame(TAG*tag, VIDEOSTREAM*s);
 963 void swf_SetVideoStreamPFrame(TAG*tag, VIDEOSTREAM*s, RGBA*pic, int quant/* 1-31, 1=best quality, 31=best compression*/);
 964 void swf_SetVideoStreamMover(TAG*tag, VIDEOSTREAM*s, signed char* movex, signed char* movey, void** image, int quant);
 965 void swf_VideoStreamClear(VIDEOSTREAM*stream);
 966
 967 // swfrender.c
 968
 969 typedef struct RENDERBUF
 970 {
 971     int width;
 972     int height;
 973     int posx,posy;
 974     void*internal;
 975 } RENDERBUF;
 976
 977 void swf_Render_Init(RENDERBUF*buf, int posx, int posy, int width, int height, char antialize, int scale);
 978 void swf_Render_SetBackground(RENDERBUF*buf, RGBA*img, int width, int height);
 979 void swf_Render_SetBackgroundColor(RENDERBUF*buf, RGBA color);
 980 RGBA* swf_Render(RENDERBUF*dest);
 981 void swf_RenderShape(RENDERBUF*dest, SHAPE2*shape, MATRIX*m, CXFORM*c, U16 depth,U16 clipdepth);
 982 void swf_Render_AddImage(RENDERBUF*buf, U16 id, RGBA*img, int width, int height);
 983 void swf_Render_ClearCanvas(RENDERBUF*dest);
 984 void swf_Render_Delete(RENDERBUF*dest);
 985
 986 #ifdef __cplusplus
 987 }
 988 #endif
 989
 990 #endif
 991