git.sesse.net Git - ffmpeg/blob - compat/avisynth/avxsynth_c.h

   1 // Avisynth C Interface Version 0.20
   2 // Copyright 2003 Kevin Atkinson
   3
   4 // This program is free software; you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation; either version 2 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // This program is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with this program; if not, write to the Free Software
  16 // Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA, or visit
  17 // http://www.gnu.org/copyleft/gpl.html .
  18 //
  19 // As a special exception, I give you permission to link to the
  20 // Avisynth C interface with independent modules that communicate with
  21 // the Avisynth C interface solely through the interfaces defined in
  22 // avisynth_c.h, regardless of the license terms of these independent
  23 // modules, and to copy and distribute the resulting combined work
  24 // under terms of your choice, provided that every copy of the
  25 // combined work is accompanied by a complete copy of the source code
  26 // of the Avisynth C interface and Avisynth itself (with the version
  27 // used to produce the combined work), being distributed under the
  28 // terms of the GNU General Public License plus this exception.  An
  29 // independent module is a module which is not derived from or based
  30 // on Avisynth C Interface, such as 3rd-party filters, import and
  31 // export plugins, or graphical user interfaces.
  32
  33 #ifndef __AVXSYNTH_C__
  34 #define __AVXSYNTH_C__
  35
  36 #include "windowsPorts/windows2linux.h"
  37 #include <stdarg.h>
  38
  39 #ifdef __cplusplus
  40 #  define EXTERN_C extern "C"
  41 #else
  42 #  define EXTERN_C
  43 #endif
  44
  45 #define AVSC_USE_STDCALL 1
  46
  47 #ifndef AVSC_USE_STDCALL
  48 #  define AVSC_CC __cdecl
  49 #else
  50 #  define AVSC_CC __stdcall
  51 #endif
  52
  53 #define AVSC_INLINE static __inline
  54
  55 #ifdef AVISYNTH_C_EXPORTS
  56 #  define AVSC_EXPORT EXTERN_C
  57 #  define AVSC_API(ret, name) EXTERN_C __declspec(dllexport) ret AVSC_CC name
  58 #else
  59 #  define AVSC_EXPORT EXTERN_C __declspec(dllexport)
  60 #  ifndef AVSC_NO_DECLSPEC
  61 #    define AVSC_API(ret, name) EXTERN_C __declspec(dllimport) ret AVSC_CC name
  62 #  else
  63 #    define AVSC_API(ret, name) typedef ret (AVSC_CC *name##_func)
  64 #  endif
  65 #endif
  66
  67 #ifdef __GNUC__
  68 typedef long long int INT64;
  69 #else
  70 typedef __int64 INT64;
  71 #endif
  72
  73
  74 /////////////////////////////////////////////////////////////////////
  75 //
  76 // Constants
  77 //
  78
  79 #ifndef __AVXSYNTH_H__
  80 enum { AVISYNTH_INTERFACE_VERSION = 3 };
  81 #endif
  82
  83 enum {AVS_SAMPLE_INT8  = 1<<0,
  84       AVS_SAMPLE_INT16 = 1<<1,
  85       AVS_SAMPLE_INT24 = 1<<2,
  86       AVS_SAMPLE_INT32 = 1<<3,
  87       AVS_SAMPLE_FLOAT = 1<<4};
  88
  89 enum {AVS_PLANAR_Y=1<<0,
  90       AVS_PLANAR_U=1<<1,
  91       AVS_PLANAR_V=1<<2,
  92       AVS_PLANAR_ALIGNED=1<<3,
  93       AVS_PLANAR_Y_ALIGNED=AVS_PLANAR_Y|AVS_PLANAR_ALIGNED,
  94       AVS_PLANAR_U_ALIGNED=AVS_PLANAR_U|AVS_PLANAR_ALIGNED,
  95       AVS_PLANAR_V_ALIGNED=AVS_PLANAR_V|AVS_PLANAR_ALIGNED};
  96
  97   // Colorspace properties.
  98 enum {AVS_CS_BGR = 1<<28,
  99       AVS_CS_YUV = 1<<29,
 100       AVS_CS_INTERLEAVED = 1<<30,
 101       AVS_CS_PLANAR = 1<<31};
 102
 103   // Specific colorformats
 104 enum {
 105   AVS_CS_UNKNOWN = 0,
 106   AVS_CS_BGR24 = 1<<0 | AVS_CS_BGR | AVS_CS_INTERLEAVED,
 107   AVS_CS_BGR32 = 1<<1 | AVS_CS_BGR | AVS_CS_INTERLEAVED,
 108   AVS_CS_YUY2 = 1<<2 | AVS_CS_YUV | AVS_CS_INTERLEAVED,
 109   AVS_CS_YV12 = 1<<3 | AVS_CS_YUV | AVS_CS_PLANAR,  // y-v-u, planar
 110   AVS_CS_I420 = 1<<4 | AVS_CS_YUV | AVS_CS_PLANAR,  // y-u-v, planar
 111   AVS_CS_IYUV = 1<<4 | AVS_CS_YUV | AVS_CS_PLANAR  // same as above
 112 };
 113
 114 enum {
 115   AVS_IT_BFF = 1<<0,
 116   AVS_IT_TFF = 1<<1,
 117   AVS_IT_FIELDBASED = 1<<2};
 118
 119 enum {
 120   AVS_FILTER_TYPE=1,
 121   AVS_FILTER_INPUT_COLORSPACE=2,
 122   AVS_FILTER_OUTPUT_TYPE=9,
 123   AVS_FILTER_NAME=4,
 124   AVS_FILTER_AUTHOR=5,
 125   AVS_FILTER_VERSION=6,
 126   AVS_FILTER_ARGS=7,
 127   AVS_FILTER_ARGS_INFO=8,
 128   AVS_FILTER_ARGS_DESCRIPTION=10,
 129   AVS_FILTER_DESCRIPTION=11};
 130
 131 enum {  //SUBTYPES
 132   AVS_FILTER_TYPE_AUDIO=1,
 133   AVS_FILTER_TYPE_VIDEO=2,
 134   AVS_FILTER_OUTPUT_TYPE_SAME=3,
 135   AVS_FILTER_OUTPUT_TYPE_DIFFERENT=4};
 136
 137 enum {
 138   AVS_CACHE_NOTHING=0,
 139   AVS_CACHE_RANGE=1,
 140   AVS_CACHE_ALL=2,
 141   AVS_CACHE_AUDIO=3,
 142   AVS_CACHE_AUDIO_NONE=4,
 143   AVS_CACHE_AUDIO_AUTO=5
 144 };
 145
 146 #define AVS_FRAME_ALIGN 16
 147
 148 typedef struct AVS_Clip AVS_Clip;
 149 typedef struct AVS_ScriptEnvironment AVS_ScriptEnvironment;
 150
 151 /////////////////////////////////////////////////////////////////////
 152 //
 153 // AVS_VideoInfo
 154 //
 155
 156 // AVS_VideoInfo is layed out identicly to VideoInfo
 157 typedef struct AVS_VideoInfo {
 158   int width, height;    // width=0 means no video
 159   unsigned fps_numerator, fps_denominator;
 160   int num_frames;
 161
 162   int pixel_type;
 163
 164   int audio_samples_per_second;   // 0 means no audio
 165   int sample_type;
 166   INT64 num_audio_samples;
 167   int nchannels;
 168
 169   // Imagetype properties
 170
 171   int image_type;
 172 } AVS_VideoInfo;
 173
 174 // useful functions of the above
 175 AVSC_INLINE int avs_has_video(const AVS_VideoInfo * p)
 176         { return (p->width!=0); }
 177
 178 AVSC_INLINE int avs_has_audio(const AVS_VideoInfo * p)
 179         { return (p->audio_samples_per_second!=0); }
 180
 181 AVSC_INLINE int avs_is_rgb(const AVS_VideoInfo * p)
 182         { return !!(p->pixel_type&AVS_CS_BGR); }
 183
 184 AVSC_INLINE int avs_is_rgb24(const AVS_VideoInfo * p)
 185         { return (p->pixel_type&AVS_CS_BGR24)==AVS_CS_BGR24; } // Clear out additional properties
 186
 187 AVSC_INLINE int avs_is_rgb32(const AVS_VideoInfo * p)
 188         { return (p->pixel_type & AVS_CS_BGR32) == AVS_CS_BGR32 ; }
 189
 190 AVSC_INLINE int avs_is_yuv(const AVS_VideoInfo * p)
 191         { return !!(p->pixel_type&AVS_CS_YUV ); }
 192
 193 AVSC_INLINE int avs_is_yuy2(const AVS_VideoInfo * p)
 194         { return (p->pixel_type & AVS_CS_YUY2) == AVS_CS_YUY2; }
 195
 196 AVSC_INLINE int avs_is_yv12(const AVS_VideoInfo * p)
 197         { return ((p->pixel_type & AVS_CS_YV12) == AVS_CS_YV12)||((p->pixel_type & AVS_CS_I420) == AVS_CS_I420); }
 198
 199 AVSC_INLINE int avs_is_color_space(const AVS_VideoInfo * p, int c_space)
 200         { return ((p->pixel_type & c_space) == c_space); }
 201
 202 AVSC_INLINE int avs_is_property(const AVS_VideoInfo * p, int property)
 203         { return ((p->pixel_type & property)==property ); }
 204
 205 AVSC_INLINE int avs_is_planar(const AVS_VideoInfo * p)
 206         { return !!(p->pixel_type & AVS_CS_PLANAR); }
 207
 208 AVSC_INLINE int avs_is_field_based(const AVS_VideoInfo * p)
 209         { return !!(p->image_type & AVS_IT_FIELDBASED); }
 210
 211 AVSC_INLINE int avs_is_parity_known(const AVS_VideoInfo * p)
 212         { return ((p->image_type & AVS_IT_FIELDBASED)&&(p->image_type & (AVS_IT_BFF | AVS_IT_TFF))); }
 213
 214 AVSC_INLINE int avs_is_bff(const AVS_VideoInfo * p)
 215         { return !!(p->image_type & AVS_IT_BFF); }
 216
 217 AVSC_INLINE int avs_is_tff(const AVS_VideoInfo * p)
 218         { return !!(p->image_type & AVS_IT_TFF); }
 219
 220 AVSC_INLINE int avs_bits_per_pixel(const AVS_VideoInfo * p)
 221 {
 222   switch (p->pixel_type) {
 223       case AVS_CS_BGR24: return 24;
 224       case AVS_CS_BGR32: return 32;
 225       case AVS_CS_YUY2:  return 16;
 226       case AVS_CS_YV12:
 227       case AVS_CS_I420:  return 12;
 228       default:           return 0;
 229     }
 230 }
 231 AVSC_INLINE int avs_bytes_from_pixels(const AVS_VideoInfo * p, int pixels)
 232         { return pixels * (avs_bits_per_pixel(p)>>3); }   // Will work on planar images, but will return only luma planes
 233
 234 AVSC_INLINE int avs_row_size(const AVS_VideoInfo * p)
 235         { return avs_bytes_from_pixels(p,p->width); }  // Also only returns first plane on planar images
 236
 237 AVSC_INLINE int avs_bmp_size(const AVS_VideoInfo * vi)
 238         { if (avs_is_planar(vi)) {int p = vi->height * ((avs_row_size(vi)+3) & ~3); p+=p>>1; return p;  } return vi->height * ((avs_row_size(vi)+3) & ~3); }
 239
 240 AVSC_INLINE int avs_samples_per_second(const AVS_VideoInfo * p)
 241         { return p->audio_samples_per_second; }
 242
 243
 244 AVSC_INLINE int avs_bytes_per_channel_sample(const AVS_VideoInfo * p)
 245 {
 246     switch (p->sample_type) {
 247       case AVS_SAMPLE_INT8:  return sizeof(signed char);
 248       case AVS_SAMPLE_INT16: return sizeof(signed short);
 249       case AVS_SAMPLE_INT24: return 3;
 250       case AVS_SAMPLE_INT32: return sizeof(signed int);
 251       case AVS_SAMPLE_FLOAT: return sizeof(float);
 252       default: return 0;
 253     }
 254 }
 255 AVSC_INLINE int avs_bytes_per_audio_sample(const AVS_VideoInfo * p)
 256         { return p->nchannels*avs_bytes_per_channel_sample(p);}
 257
 258 AVSC_INLINE INT64 avs_audio_samples_from_frames(const AVS_VideoInfo * p, INT64 frames)
 259         { return ((INT64)(frames) * p->audio_samples_per_second * p->fps_denominator / p->fps_numerator); }
 260
 261 AVSC_INLINE int avs_frames_from_audio_samples(const AVS_VideoInfo * p, INT64 samples)
 262         { return (int)(samples * (INT64)p->fps_numerator / (INT64)p->fps_denominator / (INT64)p->audio_samples_per_second); }
 263
 264 AVSC_INLINE INT64 avs_audio_samples_from_bytes(const AVS_VideoInfo * p, INT64 bytes)
 265         { return bytes / avs_bytes_per_audio_sample(p); }
 266
 267 AVSC_INLINE INT64 avs_bytes_from_audio_samples(const AVS_VideoInfo * p, INT64 samples)
 268         { return samples * avs_bytes_per_audio_sample(p); }
 269
 270 AVSC_INLINE int avs_audio_channels(const AVS_VideoInfo * p)
 271         { return p->nchannels; }
 272
 273 AVSC_INLINE int avs_sample_type(const AVS_VideoInfo * p)
 274         { return p->sample_type;}
 275
 276 // useful mutator
 277 AVSC_INLINE void avs_set_property(AVS_VideoInfo * p, int property)
 278         { p->image_type|=property; }
 279
 280 AVSC_INLINE void avs_clear_property(AVS_VideoInfo * p, int property)
 281         { p->image_type&=~property; }
 282
 283 AVSC_INLINE void avs_set_field_based(AVS_VideoInfo * p, int isfieldbased)
 284         { if (isfieldbased) p->image_type|=AVS_IT_FIELDBASED; else p->image_type&=~AVS_IT_FIELDBASED; }
 285
 286 AVSC_INLINE void avs_set_fps(AVS_VideoInfo * p, unsigned numerator, unsigned denominator)
 287 {
 288     unsigned x=numerator, y=denominator;
 289     while (y) {   // find gcd
 290       unsigned t = x%y; x = y; y = t;
 291     }
 292     p->fps_numerator = numerator/x;
 293     p->fps_denominator = denominator/x;
 294 }
 295
 296 AVSC_INLINE int avs_is_same_colorspace(AVS_VideoInfo * x, AVS_VideoInfo * y)
 297 {
 298         return (x->pixel_type == y->pixel_type)
 299                 || (avs_is_yv12(x) && avs_is_yv12(y));
 300 }
 301
 302 /////////////////////////////////////////////////////////////////////
 303 //
 304 // AVS_VideoFrame
 305 //
 306
 307 // VideoFrameBuffer holds information about a memory block which is used
 308 // for video data.  For efficiency, instances of this class are not deleted
 309 // when the refcount reaches zero; instead they're stored in a linked list
 310 // to be reused.  The instances are deleted when the corresponding AVS
 311 // file is closed.
 312
 313 // AVS_VideoFrameBuffer is layed out identicly to VideoFrameBuffer
 314 // DO NOT USE THIS STRUCTURE DIRECTLY
 315 typedef struct AVS_VideoFrameBuffer {
 316   unsigned char * data;
 317   int data_size;
 318   // sequence_number is incremented every time the buffer is changed, so
 319   // that stale views can tell they're no longer valid.
 320   long sequence_number;
 321
 322   long refcount;
 323 } AVS_VideoFrameBuffer;
 324
 325 // VideoFrame holds a "window" into a VideoFrameBuffer.
 326
 327 // AVS_VideoFrame is layed out identicly to IVideoFrame
 328 // DO NOT USE THIS STRUCTURE DIRECTLY
 329 typedef struct AVS_VideoFrame {
 330   int refcount;
 331   AVS_VideoFrameBuffer * vfb;
 332   int offset, pitch, row_size, height, offsetU, offsetV, pitchUV;  // U&V offsets are from top of picture.
 333 } AVS_VideoFrame;
 334
 335 // Access functions for AVS_VideoFrame
 336 AVSC_INLINE int avs_get_pitch(const AVS_VideoFrame * p) {
 337         return p->pitch;}
 338
 339 AVSC_INLINE int avs_get_pitch_p(const AVS_VideoFrame * p, int plane) {
 340   switch (plane) {
 341   case AVS_PLANAR_U: case AVS_PLANAR_V: return p->pitchUV;}
 342   return p->pitch;}
 343
 344 AVSC_INLINE int avs_get_row_size(const AVS_VideoFrame * p) {
 345         return p->row_size; }
 346
 347 AVSC_INLINE int avs_get_row_size_p(const AVS_VideoFrame * p, int plane) {
 348         int r;
 349     switch (plane) {
 350     case AVS_PLANAR_U: case AVS_PLANAR_V:
 351                 if (p->pitchUV) return p->row_size>>1;
 352                 else            return 0;
 353     case AVS_PLANAR_U_ALIGNED: case AVS_PLANAR_V_ALIGNED:
 354                 if (p->pitchUV) {
 355                         r = ((p->row_size+AVS_FRAME_ALIGN-1)&(~(AVS_FRAME_ALIGN-1)) )>>1; // Aligned rowsize
 356                         if (r < p->pitchUV)
 357                                 return r;
 358                         return p->row_size>>1;
 359                 } else return 0;
 360     case AVS_PLANAR_Y_ALIGNED:
 361                 r = (p->row_size+AVS_FRAME_ALIGN-1)&(~(AVS_FRAME_ALIGN-1)); // Aligned rowsize
 362                 if (r <= p->pitch)
 363                         return r;
 364                 return p->row_size;
 365     }
 366     return p->row_size;
 367 }
 368
 369 AVSC_INLINE int avs_get_height(const AVS_VideoFrame * p) {
 370         return p->height;}
 371
 372 AVSC_INLINE int avs_get_height_p(const AVS_VideoFrame * p, int plane) {
 373         switch (plane) {
 374                 case AVS_PLANAR_U: case AVS_PLANAR_V:
 375                         if (p->pitchUV) return p->height>>1;
 376                         return 0;
 377         }
 378         return p->height;}
 379
 380 AVSC_INLINE const unsigned char* avs_get_read_ptr(const AVS_VideoFrame * p) {
 381         return p->vfb->data + p->offset;}
 382
 383 AVSC_INLINE const unsigned char* avs_get_read_ptr_p(const AVS_VideoFrame * p, int plane)
 384 {
 385         switch (plane) {
 386                 case AVS_PLANAR_U: return p->vfb->data + p->offsetU;
 387                 case AVS_PLANAR_V: return p->vfb->data + p->offsetV;
 388                 default:           return p->vfb->data + p->offset;}
 389 }
 390
 391 AVSC_INLINE int avs_is_writable(const AVS_VideoFrame * p) {
 392         return (p->refcount == 1 && p->vfb->refcount == 1);}
 393
 394 AVSC_INLINE unsigned char* avs_get_write_ptr(const AVS_VideoFrame * p)
 395 {
 396         if (avs_is_writable(p)) {
 397                 ++p->vfb->sequence_number;
 398                 return p->vfb->data + p->offset;
 399         } else
 400                 return 0;
 401 }
 402
 403 AVSC_INLINE unsigned char* avs_get_write_ptr_p(const AVS_VideoFrame * p, int plane)
 404 {
 405         if (plane==AVS_PLANAR_Y && avs_is_writable(p)) {
 406                 ++p->vfb->sequence_number;
 407                 return p->vfb->data + p->offset;
 408         } else if (plane==AVS_PLANAR_Y) {
 409                 return 0;
 410         } else {
 411                 switch (plane) {
 412                         case AVS_PLANAR_U: return p->vfb->data + p->offsetU;
 413                         case AVS_PLANAR_V: return p->vfb->data + p->offsetV;
 414                         default:       return p->vfb->data + p->offset;
 415                 }
 416         }
 417 }
 418
 419 #if defined __cplusplus
 420 extern "C"
 421 {
 422 #endif // __cplusplus
 423 AVSC_API(void, avs_release_video_frame)(AVS_VideoFrame *);
 424 // makes a shallow copy of a video frame
 425 AVSC_API(AVS_VideoFrame *, avs_copy_video_frame)(AVS_VideoFrame *);
 426 #if defined __cplusplus
 427 }
 428 #endif // __cplusplus
 429
 430 #ifndef AVSC_NO_DECLSPEC
 431 AVSC_INLINE void avs_release_frame(AVS_VideoFrame * f)
 432   {avs_release_video_frame(f);}
 433 AVSC_INLINE AVS_VideoFrame * avs_copy_frame(AVS_VideoFrame * f)
 434   {return avs_copy_video_frame(f);}
 435 #endif
 436
 437 /////////////////////////////////////////////////////////////////////
 438 //
 439 // AVS_Value
 440 //
 441
 442 // Treat AVS_Value as a fat pointer.  That is use avs_copy_value
 443 // and avs_release_value appropiaty as you would if AVS_Value was
 444 // a pointer.
 445
 446 // To maintain source code compatibility with future versions of the
 447 // avisynth_c API don't use the AVS_Value directly.  Use the helper
 448 // functions below.
 449
 450 // AVS_Value is layed out identicly to AVSValue
 451 typedef struct AVS_Value AVS_Value;
 452 struct AVS_Value {
 453   short type;  // 'a'rray, 'c'lip, 'b'ool, 'i'nt, 'f'loat, 's'tring, 'v'oid, or 'l'ong
 454                // for some function e'rror
 455   short array_size;
 456   union {
 457     void * clip; // do not use directly, use avs_take_clip
 458     char boolean;
 459     int integer;
 460     INT64 integer64; // match addition of __int64 to avxplugin.h
 461     float floating_pt;
 462     const char * string;
 463     const AVS_Value * array;
 464   } d;
 465 };
 466
 467 // AVS_Value should be initilized with avs_void.
 468 // Should also set to avs_void after the value is released
 469 // with avs_copy_value.  Consider it the equalvent of setting
 470 // a pointer to NULL
 471 static const AVS_Value avs_void = {'v'};
 472
 473 AVSC_API(void, avs_copy_value)(AVS_Value * dest, AVS_Value src);
 474 AVSC_API(void, avs_release_value)(AVS_Value);
 475
 476 AVSC_INLINE int avs_defined(AVS_Value v) { return v.type != 'v'; }
 477 AVSC_INLINE int avs_is_clip(AVS_Value v) { return v.type == 'c'; }
 478 AVSC_INLINE int avs_is_bool(AVS_Value v) { return v.type == 'b'; }
 479 AVSC_INLINE int avs_is_int(AVS_Value v) { return v.type == 'i'; }
 480 AVSC_INLINE int avs_is_float(AVS_Value v) { return v.type == 'f' || v.type == 'i'; }
 481 AVSC_INLINE int avs_is_string(AVS_Value v) { return v.type == 's'; }
 482 AVSC_INLINE int avs_is_array(AVS_Value v) { return v.type == 'a'; }
 483 AVSC_INLINE int avs_is_error(AVS_Value v) { return v.type == 'e'; }
 484
 485 #if defined __cplusplus
 486 extern "C"
 487 {
 488 #endif // __cplusplus
 489 AVSC_API(AVS_Clip *, avs_take_clip)(AVS_Value, AVS_ScriptEnvironment *);
 490 AVSC_API(void, avs_set_to_clip)(AVS_Value *, AVS_Clip *);
 491 #if defined __cplusplus
 492 }
 493 #endif // __cplusplus
 494
 495 AVSC_INLINE int avs_as_bool(AVS_Value v)
 496         { return v.d.boolean; }
 497 AVSC_INLINE int avs_as_int(AVS_Value v)
 498         { return v.d.integer; }
 499 AVSC_INLINE const char * avs_as_string(AVS_Value v)
 500         { return avs_is_error(v) || avs_is_string(v) ? v.d.string : 0; }
 501 AVSC_INLINE double avs_as_float(AVS_Value v)
 502         { return avs_is_int(v) ? v.d.integer : v.d.floating_pt; }
 503 AVSC_INLINE const char * avs_as_error(AVS_Value v)
 504         { return avs_is_error(v) ? v.d.string : 0; }
 505 AVSC_INLINE const AVS_Value * avs_as_array(AVS_Value v)
 506         { return v.d.array; }
 507 AVSC_INLINE int avs_array_size(AVS_Value v)
 508         { return avs_is_array(v) ? v.array_size : 1; }
 509 AVSC_INLINE AVS_Value avs_array_elt(AVS_Value v, int index)
 510         { return avs_is_array(v) ? v.d.array[index] : v; }
 511
 512 // only use these functions on am AVS_Value that does not already have
 513 // an active value.  Remember, treat AVS_Value as a fat pointer.
 514 AVSC_INLINE AVS_Value avs_new_value_bool(int v0)
 515         { AVS_Value v; v.type = 'b'; v.d.boolean = v0 == 0 ? 0 : 1; return v; }
 516 AVSC_INLINE AVS_Value avs_new_value_int(int v0)
 517         { AVS_Value v; v.type = 'i'; v.d.integer = v0; return v; }
 518 AVSC_INLINE AVS_Value avs_new_value_string(const char * v0)
 519         { AVS_Value v; v.type = 's'; v.d.string = v0; return v; }
 520 AVSC_INLINE AVS_Value avs_new_value_float(float v0)
 521         { AVS_Value v; v.type = 'f'; v.d.floating_pt = v0; return v;}
 522 AVSC_INLINE AVS_Value avs_new_value_error(const char * v0)
 523         { AVS_Value v; v.type = 'e'; v.d.string = v0; return v; }
 524 #ifndef AVSC_NO_DECLSPEC
 525 AVSC_INLINE AVS_Value avs_new_value_clip(AVS_Clip * v0)
 526         { AVS_Value v; avs_set_to_clip(&v, v0); return v; }
 527 #endif
 528 AVSC_INLINE AVS_Value avs_new_value_array(AVS_Value * v0, int size)
 529         { AVS_Value v; v.type = 'a'; v.d.array = v0; v.array_size = size; return v; }
 530
 531 /////////////////////////////////////////////////////////////////////
 532 //
 533 // AVS_Clip
 534 //
 535 #if defined __cplusplus
 536 extern "C"
 537 {
 538 #endif // __cplusplus
 539 AVSC_API(void, avs_release_clip)(AVS_Clip *);
 540 AVSC_API(AVS_Clip *, avs_copy_clip)(AVS_Clip *);
 541
 542 AVSC_API(const char *, avs_clip_get_error)(AVS_Clip *); // return 0 if no error
 543
 544 AVSC_API(const AVS_VideoInfo *, avs_get_video_info)(AVS_Clip *);
 545
 546 AVSC_API(int, avs_get_version)(AVS_Clip *);
 547
 548 AVSC_API(AVS_VideoFrame *, avs_get_frame)(AVS_Clip *, int n);
 549 // The returned video frame must be released with avs_release_video_frame
 550
 551 AVSC_API(int, avs_get_parity)(AVS_Clip *, int n);
 552 // return field parity if field_based, else parity of first field in frame
 553
 554 AVSC_API(int, avs_get_audio)(AVS_Clip *, void * buf,
 555                                   INT64 start, INT64 count);
 556 // start and count are in samples
 557
 558 AVSC_API(int, avs_set_cache_hints)(AVS_Clip *,
 559                                         int cachehints, size_t frame_range);
 560 #if defined __cplusplus
 561 }
 562 #endif // __cplusplus
 563
 564 // This is the callback type used by avs_add_function
 565 typedef AVS_Value (AVSC_CC * AVS_ApplyFunc)
 566                         (AVS_ScriptEnvironment *, AVS_Value args, void * user_data);
 567
 568 typedef struct AVS_FilterInfo AVS_FilterInfo;
 569 struct AVS_FilterInfo
 570 {
 571   // these members should not be modified outside of the AVS_ApplyFunc callback
 572   AVS_Clip * child;
 573   AVS_VideoInfo vi;
 574   AVS_ScriptEnvironment * env;
 575   AVS_VideoFrame * (AVSC_CC * get_frame)(AVS_FilterInfo *, int n);
 576   int (AVSC_CC * get_parity)(AVS_FilterInfo *, int n);
 577   int (AVSC_CC * get_audio)(AVS_FilterInfo *, void * buf,
 578                                   INT64 start, INT64 count);
 579   int (AVSC_CC * set_cache_hints)(AVS_FilterInfo *, int cachehints,
 580                                         int frame_range);
 581   void (AVSC_CC * free_filter)(AVS_FilterInfo *);
 582
 583   // Should be set when ever there is an error to report.
 584   // It is cleared before any of the above methods are called
 585   const char * error;
 586   // this is to store whatever and may be modified at will
 587   void * user_data;
 588 };
 589
 590 // Create a new filter
 591 // fi is set to point to the AVS_FilterInfo so that you can
 592 //   modify it once it is initilized.
 593 // store_child should generally be set to true.  If it is not
 594 //    set than ALL methods (the function pointers) must be defined
 595 // If it is set than you do not need to worry about freeing the child
 596 //    clip.
 597 #if defined __cplusplus
 598 extern "C"
 599 {
 600 #endif // __cplusplus
 601 AVSC_API(AVS_Clip *, avs_new_c_filter)(AVS_ScriptEnvironment * e,
 602                                       AVS_FilterInfo * * fi,
 603                                       AVS_Value child, int store_child);
 604 #if defined __cplusplus
 605 }
 606 #endif // __cplusplus
 607
 608
 609 /////////////////////////////////////////////////////////////////////
 610 //
 611 // AVS_ScriptEnvironment
 612 //
 613
 614 // For GetCPUFlags.  These are backwards-compatible with those in VirtualDub.
 615 enum {
 616                                 /* slowest CPU to support extension */
 617   AVS_CPU_FORCE        = 0x01,   // N/A
 618   AVS_CPU_FPU          = 0x02,   // 386/486DX
 619   AVS_CPU_MMX          = 0x04,   // P55C, K6, PII
 620   AVS_CPU_INTEGER_SSE  = 0x08,   // PIII, Athlon
 621   AVS_CPU_SSE          = 0x10,   // PIII, Athlon XP/MP
 622   AVS_CPU_SSE2         = 0x20,   // PIV, Hammer
 623   AVS_CPU_3DNOW        = 0x40,   // K6-2
 624   AVS_CPU_3DNOW_EXT    = 0x80,   // Athlon
 625   AVS_CPU_X86_64       = 0xA0,   // Hammer (note: equiv. to 3DNow + SSE2,
 626                                  // which only Hammer will have anyway)
 627 };
 628
 629 #if defined __cplusplus
 630 extern "C"
 631 {
 632 #endif // __cplusplus
 633 AVSC_API(const char *, avs_get_error)(AVS_ScriptEnvironment *); // return 0 if no error
 634
 635 AVSC_API(long, avs_get_cpu_flags)(AVS_ScriptEnvironment *);
 636 AVSC_API(int, avs_check_version)(AVS_ScriptEnvironment *, int version);
 637
 638 AVSC_API(char *, avs_save_string)(AVS_ScriptEnvironment *, const char* s, int length);
 639 AVSC_API(char *, avs_sprintf)(AVS_ScriptEnvironment *, const char * fmt, ...);
 640
 641 AVSC_API(char *, avs_vsprintf)(AVS_ScriptEnvironment *, const char * fmt, va_list val);
 642  // note: val is really a va_list; I hope everyone typedefs va_list to a pointer
 643
 644 AVSC_API(int, avs_add_function)(AVS_ScriptEnvironment *,
 645                                      const char * name, const char * params,
 646                                      AVS_ApplyFunc apply, void * user_data);
 647
 648 AVSC_API(int, avs_function_exists)(AVS_ScriptEnvironment *, const char * name);
 649
 650 AVSC_API(AVS_Value, avs_invoke)(AVS_ScriptEnvironment *, const char * name,
 651                                AVS_Value args, const char** arg_names);
 652 // The returned value must be be released with avs_release_value
 653
 654 AVSC_API(AVS_Value, avs_get_var)(AVS_ScriptEnvironment *, const char* name);
 655 // The returned value must be be released with avs_release_value
 656
 657 AVSC_API(int, avs_set_var)(AVS_ScriptEnvironment *, const char* name, AVS_Value val);
 658
 659 AVSC_API(int, avs_set_global_var)(AVS_ScriptEnvironment *, const char* name, const AVS_Value val);
 660
 661 //void avs_push_context(AVS_ScriptEnvironment *, int level=0);
 662 //void avs_pop_context(AVS_ScriptEnvironment *);
 663
 664 AVSC_API(AVS_VideoFrame *, avs_new_video_frame_a)(AVS_ScriptEnvironment *,
 665                                           const AVS_VideoInfo * vi, int align);
 666 // align should be at least 16
 667 #if defined __cplusplus
 668 }
 669 #endif // __cplusplus
 670
 671 #ifndef AVSC_NO_DECLSPEC
 672 AVSC_INLINE
 673 AVS_VideoFrame * avs_new_video_frame(AVS_ScriptEnvironment * env,
 674                                      const AVS_VideoInfo * vi)
 675   {return avs_new_video_frame_a(env,vi,AVS_FRAME_ALIGN);}
 676
 677 AVSC_INLINE
 678 AVS_VideoFrame * avs_new_frame(AVS_ScriptEnvironment * env,
 679                                const AVS_VideoInfo * vi)
 680   {return avs_new_video_frame_a(env,vi,AVS_FRAME_ALIGN);}
 681 #endif
 682
 683 #if defined __cplusplus
 684 extern "C"
 685 {
 686 #endif // __cplusplus
 687 AVSC_API(int, avs_make_writable)(AVS_ScriptEnvironment *, AVS_VideoFrame * * pvf);
 688
 689 AVSC_API(void, avs_bit_blt)(AVS_ScriptEnvironment *, unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);
 690
 691 typedef void (AVSC_CC *AVS_ShutdownFunc)(void* user_data, AVS_ScriptEnvironment * env);
 692 AVSC_API(void, avs_at_exit)(AVS_ScriptEnvironment *, AVS_ShutdownFunc function, void * user_data);
 693
 694 AVSC_API(AVS_VideoFrame *, avs_subframe)(AVS_ScriptEnvironment *, AVS_VideoFrame * src, int rel_offset, int new_pitch, int new_row_size, int new_height);
 695 // The returned video frame must be be released
 696
 697 AVSC_API(int, avs_set_memory_max)(AVS_ScriptEnvironment *, int mem);
 698
 699 AVSC_API(int, avs_set_working_dir)(AVS_ScriptEnvironment *, const char * newdir);
 700
 701 // avisynth.dll exports this; it's a way to use it as a library, without
 702 // writing an AVS script or without going through AVIFile.
 703 AVSC_API(AVS_ScriptEnvironment *, avs_create_script_environment)(int version);
 704 #if defined __cplusplus
 705 }
 706 #endif // __cplusplus
 707
 708 // this symbol is the entry point for the plugin and must
 709 // be defined
 710 AVSC_EXPORT
 711 const char * AVSC_CC avisynth_c_plugin_init(AVS_ScriptEnvironment* env);
 712
 713
 714 #if defined __cplusplus
 715 extern "C"
 716 {
 717 #endif // __cplusplus
 718 AVSC_API(void, avs_delete_script_environment)(AVS_ScriptEnvironment *);
 719
 720
 721 AVSC_API(AVS_VideoFrame *, avs_subframe_planar)(AVS_ScriptEnvironment *, AVS_VideoFrame * src, int rel_offset, int new_pitch, int new_row_size, int new_height, int rel_offsetU, int rel_offsetV, int new_pitchUV);
 722 // The returned video frame must be be released
 723 #if defined __cplusplus
 724 }
 725 #endif // __cplusplus
 726
 727 #endif //__AVXSYNTH_C__