include/VapourSynth.h

   1 /*
   2 * Copyright (c) 2012 Fredrik Mellbin
   3 *
   4 * This file is part of VapourSynth.
   5 *
   6 * VapourSynth is free software; you can redistribute it and/or
   7 * modify it under the terms of the GNU Lesser General Public
   8 * License as published by the Free Software Foundation; either
   9 * version 2.1 of the License, or (at your option) any later version.
  10 *
  11 * VapourSynth is distributed in the hope that it will be useful,
  12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 * Lesser General Public License for more details.
  15 *
  16 * You should have received a copy of the GNU Lesser General Public
  17 * License along with VapourSynth; if not, write to the Free Software
  18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  19 */
  20
  21 #ifndef VAPOURSYNTH_H
  22 #define VAPOURSYNTH_H
  23
  24 #include <stdint.h>
  25
  26 #define VAPOURSYNTH_API_VERSION 3
  27
  28 // Convenience for C++ users.
  29 #ifdef __cplusplus
  30 #       define VS_EXTERN_C extern "C"
  31 #else
  32 #       define VS_EXTERN_C
  33 #endif
  34
  35 #ifdef _WIN32
  36 #       define VS_CC __stdcall
  37 #else
  38 #       define VS_CC
  39 #endif
  40
  41 // And now for some symbol hide-and-seek...
  42 #if defined(_WIN32) // Windows being special
  43 #       define VS_EXTERNAL_API(ret) VS_EXTERN_C __declspec(dllexport) ret VS_CC
  44 #elif defined(__GNUC__) && __GNUC__ >= 4
  45 #       define VS_EXTERNAL_API(ret) VS_EXTERN_C __attribute__((visibility("default"))) ret VS_CC
  46 #else
  47 #       define VS_EXTERNAL_API(ret) VS_EXTERN_C ret VS_CC
  48 #endif
  49
  50 #if !defined(VSCORE_EXPORTS) && defined(_WIN32)
  51 #       define VS_API(ret) VS_EXTERN_C __declspec(dllimport) ret VS_CC
  52 #else
  53 #       define VS_API(ret) VS_EXTERNAL_API(ret)
  54 #endif
  55
  56 typedef struct VSFrameRef VSFrameRef;
  57 typedef struct VSNodeRef VSNodeRef;
  58 typedef struct VSCore VSCore;
  59 typedef struct VSPlugin VSPlugin;
  60 typedef struct VSNode VSNode;
  61 typedef struct VSFuncRef VSFuncRef;
  62 typedef struct VSMap VSMap;
  63 typedef struct VSAPI VSAPI;
  64 typedef struct VSFrameContext VSFrameContext;
  65
  66 typedef enum VSColorFamily {
  67     // all planar formats
  68     cmGray   = 1000000,
  69     cmRGB    = 2000000,
  70     cmYUV    = 3000000,
  71     cmYCoCg  = 4000000,
  72     // special for compatibility
  73     cmCompat = 9000000
  74 } VSColorFamily;
  75
  76 typedef enum VSSampleType {
  77     stInteger = 0,
  78     stFloat = 1
  79 } VSSampleType;
  80
  81 // The +10 is so people won't be using the constants interchangably "by accident"
  82 typedef enum VSPresetFormat {
  83     pfNone = 0,
  84
  85     pfGray8 = cmGray + 10,
  86     pfGray16,
  87
  88     pfGrayH,
  89     pfGrayS,
  90
  91     pfYUV420P8 = cmYUV + 10,
  92     pfYUV422P8,
  93     pfYUV444P8,
  94     pfYUV410P8,
  95     pfYUV411P8,
  96     pfYUV440P8,
  97
  98     pfYUV420P9,
  99     pfYUV422P9,
 100     pfYUV444P9,
 101
 102     pfYUV420P10,
 103     pfYUV422P10,
 104     pfYUV444P10,
 105
 106     pfYUV420P16,
 107     pfYUV422P16,
 108     pfYUV444P16,
 109
 110     pfYUV444PH,
 111     pfYUV444PS,
 112
 113     pfRGB24 = cmRGB + 10,
 114     pfRGB27,
 115     pfRGB30,
 116     pfRGB48,
 117
 118     pfRGBH,
 119     pfRGBS,
 120
 121     // special for compatibility, if you implement these in any filter I'll personally kill you
 122     // I'll also change their ids around to break your stuff regularly
 123     pfCompatBGR32 = cmCompat + 10,
 124     pfCompatYUY2
 125 } VSPresetFormat;
 126
 127 typedef enum VSFilterMode {
 128     fmParallel = 100, // completely parallel execution
 129     fmParallelRequests = 200, // for filters that are serial in nature but can request one or more frames they need in advance
 130     fmUnordered = 300, // for filters that modify their internal state every request
 131     fmSerial = 400 // for source filters and compatibility with other filtering architectures
 132 } VSFilterMode;
 133
 134 typedef struct VSFormat {
 135     char name[32];
 136     int id;
 137     int colorFamily; // see VSColorFamily
 138     int sampleType; // see VSSampleType
 139     int bitsPerSample; // number of significant bits
 140     int bytesPerSample; // actual storage is always in a power of 2 and the smallest possible that can fit the number of bits used per sample
 141
 142     int subSamplingW; // log2 subsampling factor, applied to second and third plane
 143     int subSamplingH;
 144
 145     int numPlanes; // implicit from colorFamily
 146 } VSFormat;
 147
 148 typedef enum VSNodeFlags {
 149     nfNoCache = 1,
 150 } NodeFlags;
 151
 152 typedef enum VSGetPropErrors {
 153     peUnset = 1,
 154     peType  = 2,
 155     peIndex = 4
 156 } GetPropErrors;
 157
 158 typedef enum VSPropAppendMode {
 159     paReplace = 0,
 160     paAppend  = 1,
 161     paTouch   = 2
 162 } PropAppendMode;
 163
 164 typedef struct VSCoreInfo {
 165     const char *versionString;
 166     int core;
 167     int api;
 168     int numThreads;
 169     int64_t maxFramebufferSize;
 170     int64_t usedFramebufferSize;
 171 } VSCoreInfo;
 172
 173 typedef struct VSVideoInfo {
 174     const VSFormat *format;
 175     int64_t fpsNum;
 176     int64_t fpsDen;
 177     int width;
 178     int height;
 179     int numFrames;
 180     int flags;
 181 } VSVideoInfo;
 182
 183 typedef enum VSActivationReason {
 184     arInitial = 0,
 185     arFrameReady = 1,
 186     arAllFramesReady = 2,
 187     arError = -1
 188 } ActivationReason;
 189
 190 typedef enum VSMessageType {
 191     mtDebug = 0,
 192     mtWarnin = 1,
 193     mtCritical = 2,
 194     mtFatal
 195 } VSMessageType;
 196
 197 // core function typedefs
 198 typedef VSCore *(VS_CC *VSCreateCore)(int threads);
 199 typedef void (VS_CC *VSFreeCore)(VSCore *core);
 200 typedef const VSCoreInfo *(VS_CC *VSGetCoreInfo)(VSCore *core);
 201
 202 // function/filter typedefs
 203 typedef void (VS_CC *VSPublicFunction)(const VSMap *in, VSMap *out, void *userData, VSCore *core, const VSAPI *vsapi);
 204 typedef void (VS_CC *VSFreeFuncData)(void *userData);
 205 typedef void (VS_CC *VSFilterInit)(VSMap *in, VSMap *out, void **instanceData, VSNode *node, VSCore *core, const VSAPI *vsapi);
 206 typedef const VSFrameRef *(VS_CC *VSFilterGetFrame)(int n, int activationReason, void **instanceData, void **frameData, VSFrameContext *frameCtx, VSCore *core, const VSAPI *vsapi);
 207 typedef int (VS_CC *VSGetOutputIndex)(VSFrameContext *frameCtx);
 208 typedef void (VS_CC *VSFilterFree)(void *instanceData, VSCore *core, const VSAPI *vsapi);
 209 typedef void (VS_CC *VSRegisterFunction)(const char *name, const char *args, VSPublicFunction argsFunc, void *functionData, VSPlugin *plugin);
 210 typedef void (VS_CC *VSCreateFilter)(const VSMap *in, VSMap *out, const char *name, VSFilterInit init, VSFilterGetFrame getFrame, VSFilterFree free, int filterMode, int flags, void *instanceData, VSCore *core);
 211 typedef VSMap *(VS_CC *VSInvoke)(VSPlugin *plugin, const char *name, const VSMap *args);
 212 typedef void (VS_CC *VSSetError)(VSMap *map, const char *errorMessage);
 213 typedef const char *(VS_CC *VSGetError)(const VSMap *map);
 214 typedef void (VS_CC *VSSetFilterError)(const char *errorMessage, VSFrameContext *frameCtx);
 215
 216 typedef const VSFormat *(VS_CC *VSGetFormatPreset)(int id, VSCore *core);
 217 typedef const VSFormat *(VS_CC *VSRegisterFormat)(int colorFamily, int sampleType, int bitsPerSample, int subSamplingW, int subSamplingH, VSCore *core);
 218
 219 // frame and clip handling
 220 typedef void (VS_CC *VSFrameDoneCallback)(void *userData, const VSFrameRef *f, int n, VSNodeRef *, const char *errorMsg);
 221 typedef void (VS_CC *VSGetFrameAsync)(int n, VSNodeRef *node, VSFrameDoneCallback callback, void *userData);
 222 typedef const VSFrameRef *(VS_CC *VSGetFrame)(int n, VSNodeRef *node, char *errorMsg, int bufSize);
 223 typedef void (VS_CC *VSRequestFrameFilter)(int n, VSNodeRef *node, VSFrameContext *frameCtx);
 224 typedef const VSFrameRef *(VS_CC *VSGetFrameFilter)(int n, VSNodeRef *node, VSFrameContext *frameCtx);
 225 typedef const VSFrameRef *(VS_CC *VSCloneFrameRef)(const VSFrameRef *f);
 226 typedef VSNodeRef *(VS_CC *VSCloneNodeRef)(VSNodeRef *node);
 227 typedef VSFuncRef *(VS_CC *VSCloneFuncRef)(VSFuncRef *f);
 228 typedef void (VS_CC *VSFreeFrame)(const VSFrameRef *f);
 229 typedef void (VS_CC *VSFreeNode)(VSNodeRef *node);
 230 typedef void (VS_CC *VSFreeFunc)(VSFuncRef *f);
 231 typedef VSFrameRef *(VS_CC *VSNewVideoFrame)(const VSFormat *format, int width, int height, const VSFrameRef *propSrc, VSCore *core);
 232 typedef VSFrameRef *(VS_CC *VSNewVideoFrame2)(const VSFormat *format, int width, int height, const VSFrameRef **planeSrc, const int *planes, const VSFrameRef *propSrc, VSCore *core);
 233 typedef VSFrameRef *(VS_CC *VSCopyFrame)(const VSFrameRef *f, VSCore *core);
 234 typedef void (VS_CC *VSCopyFrameProps)(const VSFrameRef *src, VSFrameRef *dst, VSCore *core);
 235 typedef int (VS_CC *VSGetStride)(const VSFrameRef *f, int plane);
 236 typedef const uint8_t *(VS_CC *VSGetReadPtr)(const VSFrameRef *f, int plane);
 237 typedef uint8_t *(VS_CC *VSGetWritePtr)(VSFrameRef *f, int plane);
 238
 239 // property access
 240 typedef const VSVideoInfo *(VS_CC *VSGetVideoInfo)(VSNodeRef *node);
 241 typedef void (VS_CC *VSSetVideoInfo)(const VSVideoInfo *vi, int numOutputs, VSNode *node);
 242 typedef const VSFormat *(VS_CC *VSGetFrameFormat)(const VSFrameRef *f);
 243 typedef int (VS_CC *VSGetFrameWidth)(const VSFrameRef *f, int plane);
 244 typedef int (VS_CC *VSGetFrameHeight)(const VSFrameRef *f, int plane);
 245 typedef const VSMap *(VS_CC *VSGetFramePropsRO)(const VSFrameRef *f);
 246 typedef VSMap *(VS_CC *VSGetFramePropsRW)(VSFrameRef *f);
 247 typedef int (VS_CC *VSPropNumKeys)(const VSMap *map);
 248 typedef const char *(VS_CC *VSPropGetKey)(const VSMap *map, int index);
 249 typedef int (VS_CC *VSPropNumElements)(const VSMap *map, const char *key);
 250 typedef char(VS_CC *VSPropGetType)(const VSMap *map, const char *key);
 251
 252 typedef VSMap *(VS_CC *VSCreateMap)(void);
 253 typedef void (VS_CC *VSFreeMap)(VSMap *map);
 254 typedef void (VS_CC *VSClearMap)(VSMap *map);
 255
 256 typedef int64_t (VS_CC *VSPropGetInt)(const VSMap *map, const char *key, int index, int *error);
 257 typedef double(VS_CC *VSPropGetFloat)(const VSMap *map, const char *key, int index, int *error);
 258 typedef const char *(VS_CC *VSPropGetData)(const VSMap *map, const char *key, int index, int *error);
 259 typedef int (VS_CC *VSPropGetDataSize)(const VSMap *map, const char *key, int index, int *error);
 260 typedef VSNodeRef *(VS_CC *VSPropGetNode)(const VSMap *map, const char *key, int index, int *error);
 261 typedef const VSFrameRef *(VS_CC *VSPropGetFrame)(const VSMap *map, const char *key, int index, int *error);
 262 typedef VSFuncRef *(VS_CC *VSPropGetFunc)(const VSMap *map, const char *key, int index, int *error);
 263
 264 typedef int (VS_CC *VSPropDeleteKey)(VSMap *map, const char *key);
 265 typedef int (VS_CC *VSPropSetInt)(VSMap *map, const char *key, int64_t i, int append);
 266 typedef int (VS_CC *VSPropSetFloat)(VSMap *map, const char *key, double d, int append);
 267 typedef int (VS_CC *VSPropSetData)(VSMap *map, const char *key, const char *data, int size, int append);
 268 typedef int (VS_CC *VSPropSetNode)(VSMap *map, const char *key, VSNodeRef *node, int append);
 269 typedef int (VS_CC *VSPropSetFrame)(VSMap *map, const char *key, const VSFrameRef *f, int append);
 270 typedef int (VS_CC *VSPropSetFunc)(VSMap *map, const char *key, VSFuncRef *func, int append);
 271
 272 // mixed
 273
 274 typedef void (VS_CC *VSConfigPlugin)(const char *identifier, const char *defaultNamespace, const char *name, int apiVersion, int readonly, VSPlugin *plugin);
 275 typedef void (VS_CC *VSInitPlugin)(VSConfigPlugin configFunc, VSRegisterFunction registerFunc, VSPlugin *plugin);
 276
 277 typedef VSPlugin *(VS_CC *VSGetPluginId)(const char *identifier, VSCore *core);
 278 typedef VSPlugin *(VS_CC *VSGetPluginNs)(const char *ns, VSCore *core);
 279
 280 typedef VSMap *(VS_CC *VSGetPlugins)(VSCore *core);
 281 typedef VSMap *(VS_CC *VSGetFunctions)(VSPlugin *plugin);
 282
 283 typedef void (VS_CC *VSCallFunc)(VSFuncRef *func, const VSMap *in, VSMap *out, VSCore *core, const VSAPI *vsapi);
 284 typedef VSFuncRef *(VS_CC *VSCreateFunc)(VSPublicFunction func, void *userData, VSFreeFuncData free);
 285
 286 typedef void (VS_CC *VSQueryCompletedFrame)(VSNodeRef **node, int *n, VSFrameContext *frameCtx);
 287 typedef void (VS_CC *VSReleaseFrameEarly)(VSNodeRef *node, int n, VSFrameContext *frameCtx);
 288
 289 typedef int64_t (VS_CC *VSSetMaxCacheSize)(int64_t bytes, VSCore *core);
 290
 291 typedef void (VS_CC *VSMessageHandler)(int msgType, const char *msg);
 292 typedef void (VS_CC *VSSetMessageHandler)(VSMessageHandler handler);
 293
 294 struct VSAPI {
 295     VSCreateCore createCore;
 296     VSFreeCore freeCore;
 297     VSGetCoreInfo getCoreInfo;
 298
 299     VSCloneFrameRef cloneFrameRef;
 300     VSCloneNodeRef cloneNodeRef;
 301     VSCloneFuncRef cloneFuncRef;
 302
 303     VSFreeFrame freeFrame;
 304     VSFreeNode freeNode;
 305     VSFreeFunc freeFunc;
 306
 307     VSNewVideoFrame newVideoFrame;
 308     VSCopyFrame copyFrame;
 309     VSCopyFrameProps copyFrameProps;
 310
 311     VSRegisterFunction registerFunction;
 312     VSGetPluginId getPluginId;
 313     VSGetPluginNs getPluginNs;
 314     VSGetPlugins getPlugins;
 315     VSGetFunctions getFunctions;
 316     VSCreateFilter createFilter; // do never use inside a filter's getframe function
 317     VSSetError setError; // use to signal errors outside filter getframe functions
 318     VSGetError getError; // use to query errors, returns 0 if no error
 319     VSSetFilterError setFilterError; // use to signal errors in the filter getframe function
 320     VSInvoke invoke; // may not be used inside a filter's getframe method
 321
 322     VSGetFormatPreset getFormatPreset; //threadsafe
 323     VSRegisterFormat registerFormat; // threadsafe
 324
 325     VSGetFrame getFrame; // do never use inside a filter's getframe function, for external applications using the core as a library or for requesting frames in a filter constructor
 326     VSGetFrameAsync getFrameAsync; // do never use inside a filter's getframe function, for external applications using the core as a library or for requesting frames in a filter constructor
 327     VSGetFrameFilter getFrameFilter; // only use inside a filter's getframe function
 328     VSRequestFrameFilter requestFrameFilter; // only use inside a filter's getframe function
 329     VSQueryCompletedFrame queryCompletedFrame; // only use inside a filter's getframe function
 330     VSReleaseFrameEarly releaseFrameEarly; // only use inside a filter's getframe function
 331
 332     VSGetStride getStride;
 333     VSGetReadPtr getReadPtr;
 334     VSGetWritePtr getWritePtr;
 335
 336     VSCreateFunc createFunc;
 337     VSCallFunc callFunc;
 338
 339     //property access functions
 340     VSCreateMap createMap;
 341     VSFreeMap freeMap;
 342     VSClearMap clearMap;
 343
 344     VSGetVideoInfo getVideoInfo;
 345     VSSetVideoInfo setVideoInfo;
 346     VSGetFrameFormat getFrameFormat;
 347     VSGetFrameWidth getFrameWidth;
 348     VSGetFrameHeight getFrameHeight;
 349     VSGetFramePropsRO getFramePropsRO;
 350     VSGetFramePropsRW getFramePropsRW;
 351
 352     VSPropNumKeys propNumKeys;
 353     VSPropGetKey propGetKey;
 354     VSPropNumElements propNumElements;
 355     VSPropGetType propGetType;
 356     VSPropGetInt propGetInt;
 357     VSPropGetFloat propGetFloat;
 358     VSPropGetData propGetData;
 359     VSPropGetDataSize propGetDataSize;
 360     VSPropGetNode propGetNode;
 361     VSPropGetFrame propGetFrame;
 362     VSPropGetFunc propGetFunc;
 363
 364     VSPropDeleteKey propDeleteKey;
 365     VSPropSetInt propSetInt;
 366     VSPropSetFloat propSetFloat;
 367     VSPropSetData propSetData;
 368     VSPropSetNode propSetNode;
 369     VSPropSetFrame propSetFrame;
 370     VSPropSetFunc propSetFunc;
 371
 372     VSSetMaxCacheSize setMaxCacheSize;
 373     VSGetOutputIndex getOutputIndex;
 374     VSNewVideoFrame2 newVideoFrame2;
 375
 376     VSSetMessageHandler setMessageHandler;
 377 };
 378
 379 VS_API(const VSAPI *) getVapourSynthAPI(int version);
 380
 381 #endif // VAPOURSYNTH_H