Commit | Line | Data |
---|---|---|
2ba45a60 DM |
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__ |