vapoursynth-mxfj2ksource 1.3.0

VapourSynth source plugin for JPEG 2000 picture essence in MXF files

MXFJ2KSource

Vapoursynth video source plugin for reading JPEG 2000 picture essence from MXF files (e.g. DCP OP1a).

Usage

Source

Loads a MXF file and returns a clip with the JPEG 2000 picture essence:

core.MXFJ2KSource.Source(string source[, int track, string cache_path, int threads = 1])

• source: MXF file path.
• track: Track number (optional)
• cache_path: Index cache file path (optional). Default: source + ".mxfj2kindex"
  • If you explicitly set cache_path and the cache cannot be written, the filter fails.
  • If you use the default auto cache path and it cannot be written, a warning is logged and indexing continues.
• threads: Grok thread count per frame (optional). 0 = all threads, 1 = single-thread.
  • It is recommended to set this value to 1 (default when not specified), because Vapoursynth's frame-level parallelism offers lower synchronization overhead.

Notes / limitations:

• Supported Formats: Only 12-bit and 16-bit 4:4:4 (full-resolution) JPEG 2000.

Building

Requirements:

• VapourSynth headers
• Grok JPEG 2000 library installed

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

Output:

• build/libMXFJ2KSource.[dll|dylib|so]

Notes

• Unless you are dealing with DCPs or file in XYZ colorspace, standard source filters are recommended.
• To convert XYZ to RGB, refer to scripts/xyz2rgb.vpy (Requires Vapoursynth-llvmexpr to be installed).