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