This is a minor release with implemented MXF HDR Metadata
Features:
1) MXF Metadata editor (HDR Metadata)
Windows Installer x86_64
MacOS Installer x86_64
Centos Installer x86_64
UI less Vesrion
AMCDXVideoPatcherCLI Windows x86_ 64
AMCDXVideoPatcherCLI OSX x86_64
AMCDXVideoPatcherCLI Centos x86_64
There was big enough interest in the Command Line version of AMCDX Video Patcher so at some point I made a fast solution to be able to run the app in command line mode. The only problem it still had all UI (Qt) dependencies. I finally found some free time and made UI less CLI version. JSON structure and implemented features are the same
NOTE: when you pass JSON as a string don’t forget to handle correctly string in the string case. eg:
./AMCDXVideoPatcherCLI “{“processor”: “mov_meta”} ” is wrong
./AMCDXVideoPatcherCLI “{\”processor\”: \”mov_meta\”}” is correct
AMCDXVideoPatcherCLI Windows x86_ 64
AMCDXVideoPatcherCLI OSX x86_64
AMCDXVideoPatcherCLI Centos x86_64
This is a minor release with some critical bugs fixed and MXF Metadata edit initial work
Features:
1) MXF Metadata editor (color range and color characteristics)
2) Added Linux Installer
Bugs Fixed:
1) Fixed crash when patching from ProRes 422 to ProRes 444
2) Fixed support of mxf files with size > 4GB
3) Fixed CLI JSON as a string input
After I released the early beta I received a couple of messages. Most of them to be fair something like: “80fps I`m not impressed…”
But there was one message from a company which as well work on GPU optimized decoder/encoder. And to be fair it’s good to know someone else works on it as probably at some point I hope to have a chance to compare performance/quality.
I don’t have much info on what exactly they try to do (most probably just optimize FFmpeg version) but as far as I know, their initial goals to be able to decode/encode 1000 fps ProRes 4:2:2 HD.
As my decoder is in the early-stage and the encoder way behind of decoder, I still not sure if 1000 is a limit, but I guess it will be the first goal I will try to achieve.
Even though I didn’t have much time last weeks I was inspired but the fact someone else works on it, so today I ready to release a new version of the decoder.
V0.2b is still early beta it still decodes only Progressive frames, but it’s twice faster than the previous version. (~150fps 4K and ~ 610fps HD)
API was not changed
I don’t have a lot of free time last months, so really struggle to release a new Version of AMCDX Video Patcher. And to be fair when the main challenges solved I don’t have that much motivation.
I still interested in the performance part of the project what was to be fair the main goal.
There is though not really much left to optimize on CPU size (Prores Encoder/Decoder overperforms FFmpeg implementation, Frame Editor and File To File are fast enough)…
So I finally found some time to start the part of the project I was dreaming of during last year – GPU optimization.
So today I officially release ProRes Cuda optimized decoder. Its early beta: It doesn’t support interlaced frames yet, there plenty of room for extra optimizations, but it’s still good enough to show it.
So what supported in v0.1b?
1) Decoding of progressive ProRes frames on GPU (both 444 and 422 supported)
2) Always decodes to 12 bit
API
amcdx_cu_prores_decoder.dll exports functions:
1) void * amcdx_cupr_decoder_create() – creates decoder instance allocates memory so on.
Returns decoder handle.
2) int amcdx_cupr_decoder_decode(void * decoder, void * buffer, int size) – decodes passed frame
decoder – decoder handle returned by amcdx_cupr_decoder_create
buffer – encoded ProRes frame
size – frame size
Returns 0 if success, otherwise returns error code.
3) unsigned int amcdx_cupr_get_pitch(void * decoder) – returns plane line size. in 444 case line size same for all 3 planes, in 422 case line size of chroma planes equals amcdx_cupr_get_pitch / 2
decoder – decoder handle returned by amcdx_cupr_decoder_create
4) unsigned int amcdx_cupr_get_width(void * decoder) – returns width of decoded frame
decoder – decoder handle returned by amcdx_cupr_decoder_create
5) unsigned int amcdx_cupr_get_height(void * decoder) – returns height of decoded frame
decoder – decoder handle returned by amcdx_cupr_decoder_create
6) int amcdx_cupr_is_444(void * decoder) – returns 1 if we have 444 chroma subsampling, otherwise returns 0
decoder – decoder handle returned by amcdx_cupr_decoder_create
7) void amcdx_cupr_decoder_read(void * decoder, void ** buffer) – copies decoded frame from GPU to CPU. this function should be called if you frame buffer line sizes equals to amcdx_cupr_get_pitch
decoder – decoder handle returned by amcdx_cupr_decoder_create
buffer – output frame plane buffers
8) void amcdx_cupr_decoder_read_pitch(void * decoder, void ** buffer, int * pitch) – copies decoded frame from GPU to CPU. this function should be called if you frame buffer line sizes are not equal to amcdx_cupr_get_pitch
decoder – decoder handle returned by amcdx_cupr_decoder_create
buffer – output frame plane buffers
pitch – output frame plane line sizes
9) void amcdx_cupr_decoder_destroy(void * decoder) – destroys decoder instance
decoder – decoder handle returned by amcdx_cupr_decoder_create
10) const char * amcdx_cupr_version() – returns library version string
I added a simple wrapper so it could be used with FFmpeg
Pre-built Binaries
P.S. As I mentioned before it’s an early beta, so I didn’t do a lot of benchmarking. Currently, I have ~80 FPS decoding ProRes XQ 4444, 4K on Quadro P4000
Version 0.6.0 Released:
1) VC3 support (works only VC3 to VC3 profiles should be identical)
2) Added command-line version
3) File To File improved performance on Windows
4) Blur functionality was disabled
Windows Installer
Mac OS Installer
Linux Build available upon request
Starting v0.6.0 you can run AMCDX Video Patcher without UI, in other words, you can run it as a command-line app. AMCDX Video Patcher accept as a parameter JSON (it could be JSON string or path to JSON file) for example:AMCDXVideoPathcer /Users/test/test.json
orAMCDXVideoPathcer "{ "processor": "f2f", "params": {...}}"
there are 2 fields: “processor” and “params”
a) processor defines what processor do you want to run. The value should be a String and should have one of 3 values:
1) “f2f” – run File To File processor
2) “frame” – run Frame Editor
3) “mov_meta” – run MOV/MP4 Metadata Editor
b) params define processor parameters. The value should be a JSON object each processor has a different structure.
f2f params
{
"src_file": String,
"dst_file": String,
"src_in_frame": Integer,
"dst_in_frame": Integer,
"duration": Integer,
"src_rect": {
"x": Integer,
"y": Integer,
"width": Integer,
"height": Integer
},
"dst_rect": {
"x": Integer,
"y": Integer,
"width": Integer,
"height": Integer
}
}| src_file | path to the source file (String) |
| dst_file | path to the target file (String) |
| src_in_frame | Source file IN Point (Integer, frame number) |
| dst_in_frame | Target file IN Point (Integer, frame number) |
| duration | Number of frames to insert from the Source to the Target file (Integer) |
| src_rect | A rectangle of the Source file frame that should be inserted to the Target file frame (*), (**) |
| dst_rect | Rectangle of Target file frame where should be inserted rectangle from the Source file (*), (**) |
(*) rect fields are optional if these fields are not set – the full-frame will be processed
(**) rect fields work only for ProRes codec, in VC3/AVCI/XAVC case these properties will be ignored
Frame Editor params
{
"video_file": String,
"png_path": String,
"in_point": Integer,
"duration": Integer,
"mode": String,
"rect": {
"x": Integer,
"y": Integer,
"width": Integer,
"height": Integer,
}
}| video_file | path to the source video file (String) |
| png_path | path to png file to apply or a folder where to save PNGs (String) |
| in_point | Video file IN Point (Integer, frame number) |
| duration | Number of frames to modify with PNG image or Number of frames to save to png (Integer) |
| mode | Can be one of 2 values “to_png” or “from_png”(String) to_png means we save selected rectangle to PNG files to the folder set by “png_path” from_png means we modify the selected rectangle by PNG files set by “png_path” |
| rect | A rectangle of the Video file that should be modified or saved to PNG |
MOV/MP4 Metadata Editor Params
{
"video_file": String,
"headers_to_the_end": Boolean,
"timecode": {
"in_file": Boolean,
"tc": String,
"drop_flag": Boolean,
"reel": {
"in_file": Boolean,
"text": String
},
},
"nclc": {
"in_file": Boolean,
"primaries": Integer,
"transfer": Integer,
"matrix": Integer
},
"gama": {
"in_file": Boolean,
"gamma": Float
}
"pasp": {
"in_file": Boolean,
"h_spacing": Integer,
"v_spacing": Integer
}
"fiel": {
"in_file": Boolean,
"order": Integer
}
"mdcv": {
"in_file": Boolean,
"preset": Integer,
"max_lum": Float,
"min_lum": Float
}
"clli": {
"in_file": Boolean,
"max_cll": Integer,
"max_fall": Integer
}
}*All fields are optional
*“in_file” is a Boolean field if it set to false it means Atom will be removed and other fields will be ignored. if “in_file” set to true it means we modify existing atom or add and modify newly added atom
| headers_to_the_end | Defines if we should move headers to the end of the file or leave it as it (Boolean, Optional) |
| timecode | in_file: if set to true Timecode track will be added (Boolean, Optional) tc: timecode in format “hh:mm:ss:frame” (String, Optional) drop_flag: set DF/NDF (Boolean, Optional) reel: { in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) text: Reel name (String, Optional) } |
| nclc | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) primaries: Color Primaries (Integer, Optional) transfer: Transfer Function (Integer, Optional) matrix: Color Matrix (Integer, Optional) |
| gama | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) gamma: Gamma value (Float, Optional) |
| pasp | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) h_spacing: Pixel width (Integer, Optional) v_spacing: Pixel height (Integer, Optional) |
| fiel | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) order: Field Order (Integer, Optional) |
| mdcv | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) preset: MDCV Presets (Integer, Optional) max_lum: Max display mastering luminance (Float, Optional) min_lum: Min display mastering luminance (Float, Optional) |
| clli | in_file: if set to false atom will be deleted otherwise added or edited existing (Boolean, Optional) max_cll: Max content light level (Integer, Optional) max_fall: Max frame average light level (Integer, Optional) |
| 0 | Unknown |
| 1 | ITU-R BT.709 |
| 2 | Unspecified |
| 3 | Reserved |
| 4 | ITU-R BT.470M |
| 5 | ITU-R BT.601 625 |
| 6 | ITU-R BT.601 525 |
| 7 | SMPTE 240M |
| 8 | FILM |
| 9 | ITU-R BT.2020 |
| 10 | SMPTE ST 428-1 |
| 11 | DCI P3 |
| 12 | P3 D65 |
| 0 | Unknown |
| 1 | ITU-R BT.709 |
| 2 | Unspecified |
| 3 | Reserved |
| 4 | Gamma 2.2 |
| 5 | Gamma 2.8 |
| 6 | SMPTE 170M |
| 7 | SMPTE 240M |
| 8 | Linear |
| 9 | Logarithmic (100:1 range) |
| 10 | Logarithmic (316:1 range) |
| 11 | IEC 61966-2-4 |
| 12 | ITU-R BT.1361 (Extended Colour Gamut) |
| 13 | IEC 61966-2-1 |
| 14 | ITU-R BT.2020 10 bit |
| 15 | ITU-R BT.2020 12 bit |
| 16 | SMPTE ST 2084 (PQ) |
| 17 | SMPTE ST 428-1 |
| 18 | ARIB STD-B67 (Hybrid Log Gamma) |
| 0 | Unknown |
| 1 | ITU-R BT.709 |
| 2 | Unspecified |
| 3 | Reserved |
| 4 | FCC |
| 5 | BT470BG |
| 6 | ITU-R BT.601 |
| 7 | SMPTE 240M |
| 8 | YCOCG |
| 9 | ITU-R BT.2020 Non-constant Luminance |
| 10 | ITU-R BT.2020 Constant Luminance |
| 0 | Progressive |
| 1 | Top Field stored first, Top Field displayed first |
| 2 | Bottom Field stored first, Bottom Field displayed first |
| 3 | Top Field stored first, Bottom Field displayed first |
| 4 | Bottom Field stored first, Top Field displayed first |
| 0 | REC 709 |
| 1 | REC 601 – 625 |
| 2 | REC 601 – 525 |
| 3 | BT 2020 |
| 4 | DCI P3 |
| 5 | P3 D65 |
Samples:
File To File
Frame To PNG
Frame From PNG
Mov Metadata (Remove Gama, Edit nclc)
Mov Metadata (Edit Gama)
I decided to post a roadmap of features planned on this 2020 year
1) [File To File] VC3 to VC3 (MOV, MXF) – Done
2) [File To File] AVCI to AVCI (MOV, MXF) – In Progress
3) [Metadata Editor] MOV Edit list editing
4) [Metadata Editor] MXF Metadata Editing – In Progress
5) [File To File] Apply to File stored on AWS S3 – In Progress
6) [File To File] Apply to File stored on Google Drive
P.S. Feature requests for the year 2021 can be posted in the comments for this post
This is a minor release to fix App on MacOS without AVX2 Instruction set support.
Windows Installer
MacOS Installer
AMCDX Video Patcher v0.5.5 released
Starting v0.5.5 there is no more required to have CPU which supports AVX2 Instruction Set (so you can use it on old Intel/AMD CPUs and on ARM CPUs)
Features:
1) You can type exact frame you want to position to (instead of moving scrubber)
2) Added “Show Shortcuts” Menu Item
Bugs Fixed:
1) Fixed bug when after some manipulations Keyboard shortcuts got inactive
Windows Installer
OSX Installer
Linux Build available upon request
What’s Next?
1) Insert directly to file stored on AWS S3
2) VC-3 playback and Insert support