Expand description
Raw bindings to VapourSynth.
Modules§
- helper
- VSHelper4.h
Structs§
- VSAPI
- This giant struct is the way to access
VapourSynth
’s public API. - VSAudio
Format - Describes the format of a clip.
- VSAudio
Info - Contains information about a clip.
- VSCore
- The core represents one instance of VapourSynth. Every core individually loads plugins and keeps track of memory.
- VSCore
Info - Contains information about a
VSCore
instance. - VSFilter
Dependency - Specifies the dependency of a filter on other nodes.
- VSFrame
- A frame that can hold audio or video data.
- VSFrame
Context - Opaque type representing the current frame request in a filter.
- VSFunction
- Holds a reference to a function that may be called. This type primarily exists so functions can be shared between the scripting layer and plugins in the core.
- VSLog
Handle - Opaque type representing a registered logger.
- VSMap
VSMap
is a container that stores (key, value) pairs. The keys are strings and the values can be (arrays of) integers, floating point numbers, arrays of bytes,VSNode
,VSFrame
, orVSFunction
.- VSNode
- A reference to a node in the constructed filter graph. Its primary use is as an argument to other filter or to request frames from.
- VSPLUGINAPI
- This struct is used to access
VapourSynth
’s API when a plugin is initially loaded. - VSPlugin
- A VapourSynth plugin. There are a few of these built into the core,
and therefore available at all times: the basic filters (identifier
com.vapoursynth.std
, namespacestd
), the resizers (identifiercom.vapoursynth.resize
, namespaceresize
), and the Avisynth compatibility module, if running in Windows (identifiercom.vapoursynth.avisynth
, namespaceavs
). - VSPlugin
Function - A function belonging to a Vapoursynth plugin. This object primarily exists so a plugin’s name, argument list and return type can be queried by editors.
- VSSCRIPTAPI
- This struct is the way to access VSScript’s public API.
- VSScript
- A script environment. All evaluation and communication with evaluated scripts happens
through a
VSScript
object. - VSVideo
Format - Describes the format of a clip.
- VSVideo
Info - Contains information about a clip.
Enums§
- VSActivation
Reason - See
VSFilterGetFrame
. - VSAudio
Channels - Audio channel positions as an enum. Mirrors the
FFmpeg
audio channel constants in older api versions. - VSCache
Mode - Describes how the output of a node is cached.
- VSChroma
Location - VSColor
Family - VSColor
Primaries - VSColor
Range - VSCore
Creation Flags - Options when creating a core.
- VSData
Type Hint - Since the data type can contain both pure binary data and printable strings, the type also contains a hint for whether or not it is human readable. Generally the unknown type should be very rare and is almost only created as an artifact of API3 compatibility.
- VSField
Based - VSFilter
Mode - Controls how a filter will be multithreaded, if at all.
- VSMap
Append Mode - Controls the behaviour of
mapSetInt()
and friends. - VSMap
Property Error - When a
mapGet*
function fails, it returns one of these in the err parameter. - VSMatrix
Coefficients - VSMedia
Type - Used to indicate the type of a
VSFrame
orVSNode
object. - VSMessage
Type - See
addLogHandler()
. - VSPlugin
Config Flags - Options when loading a plugin.
- VSPreset
Video Format - The presets suffixed with H and S have floating point sample type. The H and S suffixes stand for half precision and single precision, respectively. All formats are planar.
- VSProperty
Type - Types of properties that can be stored in a
VSMap
. - VSRequest
Pattern - Describes the upstream frame request pattern of a filter.
- VSSample
Type - VSTransfer
Characteristics
Constants§
- VAPOURSYNTH_
API_ MAJOR - Major API version.
- VAPOURSYNTH_
API_ MINOR - Minor API version. It is bumped when new functions are added to
VSAPI
or core behavior is noticeably changed. - VAPOURSYNTH_
API_ VERSION - API version. The high 16 bits are
VAPOURSYNTH_API_MAJOR
, the low 16 bits areVAPOURSYNTH_API_MINOR
. - VSSCRIPT_
API_ MAJOR - VSSCRIPT_
API_ MINOR - VSSCRIPT_
API_ VERSION - VS_
AUDIO_ FRAME_ SAMPLES - The number of audio samples in an audio frame. It is a static number to make it possible to calculate which audio frames are needed to retrieve specific samples.
Functions§
- getVS
ScriptAPI ⚠ - Returns a struct containing function pointer for the api.
Will return
NULL
is the specified version isn’t supported. - getVapour
SynthAPI ⚠ - Returns a pointer to the global
VSAPI
instance. - vs_
make_ version - Used to create version numbers. The first argument is the major version and second is the minor.
Type Aliases§
- VSFilter
Free - A filter’s “free” function.
- VSFilter
GetFrame - A filter’s “getFrame” function. It is called by the core when it needs the filter to generate a frame.
- VSFrame
Done Callback - Function of the client application called by the core when a requested frame is ready,
after a call to
getFrameAsync()
. - VSFree
Function Data - Free function type
- VSGet
Vapour SynthAPI - Core entry point
- VSInit
Plugin - A plugin’s entry point. It must be called
VapourSynthPluginInit2
. This function is called after the core loads the shared library. Its purpose is to configure the plugin and to register the filters the plugin wants to export. - VSLog
Handler - Arguments
- VSLog
Handler Free - VSPublic
Function - User-defined function called by the core to create an instance of the filter.
This function is often named
fooCreate
.