Encoding.com is licensed by Apple to encode and decode the ProRes codecs using the 64 bit Linux Apple ProRes library.
Apple ProRes codecs provide an unparalleled combination of multistream, real-time editing performance, impressive image quality, and reduced storage rates. Apple ProRes codecs take full advantage of multicore processing and feature fast, reduced-resolution decoding modes.
<?xml version="1.0"?>
<query>
<userid>[UserID]</userid> <!-- required -->
<userkey>[UserKey]</userkey> <!-- required -->
<action>[Action]</action> <!-- required -->
<source>[SourceFile]</source> <!-- required -->
<format>
<output>apple_prores</output> <!-- required -->
<type>[ProResType]</type>
<size>[Size]</size>
<framerate>[FrameRate]</framerate>
<force_interlaced>[InterlacedType]</force_interlaced>
<force_clap>[ForceClap]</force_clap>
<color_primaries>[ColorPrimariesIndex]</color_primaries>
<transfer_characteristics>[TransferCharacteristicsIndex]</transfer_characteristics>
<matrix_coefficients>[MatrixCoefficientsIndex]</matrix_coefficients>
<audio_codec>[AudioCodec]</audio_codec>
<audio_stream>
<layout>[LayoutType]</layout>
<layout_in_audio_channel_description>[yes|no]</layout_in_audio_channel_description>
<!-- audio_stream params -->
</audio_stream>
<audio_stream>
<!-- audio_stream params -->
</audio_stream>
<!-- format params -->
</format>
</query>
{
"query": {
"userid": "[UserID]", // required
"userkey": "[UserKey]", // required
"action": "[Action]", // required
"source": "[SourceFile]", //required
"format": {
"output": "apple_prores", //required
"type": "[ProResType]",
"size": "[Size]",
"framerate": "[FrameRate]",
"force_interlaced": "[InterlacedType]",
"force_clap": "[ForceClap]",
"color_primaries": "[ColorPrimariesIndex]",
"transfer_characteristics": "[TransferCharacteristicsIndex]",
"matrix_coefficients": "[MatrixCoefficientsIndex]",
"audio_codec": "[AudioCodec]",
"audio_stream": [
{
"layout": "[LayoutType]",
"layout_in_audio_channel_description": "[yes|no]"
// audio_stream params
},
{
// audio_stream params
}
]
// format params
}
}
}
Parameter | Description | Allowed Value | Default Value |
---|---|---|---|
type | ProRes type | apch — ProRes 422 HQ apcn — ProRes 422 apcs — ProRes 422 LT apco — ProRes 422 Proxy ap4h — ProRes 4444 ap4x — ProRes 4444 XQ copy — copy from source | apch |
color_primaries | Color primaries index | 2 — auto 1 — ITU-R BT.709 5 — ITU-R BT.601 625-line 6 — ITU-R BT.601 525-line 9 — ITU-R BT.2020 copy — copy from source | 2 |
transfer_characteristics | Transfer characteristics index | 2 — auto 1 — ITU-R BT.709 / BT.601 / BT.2020 16 — SMPTE ST 2084 (PQ) 18 — BT.2100 Hybrid Log Gamma copy — copy from source | 2 |
matrix_coefficients | Matrix coefficients index | 2 — auto 1 — ITU-R BT.709 6 — ITU-R BT.601 9 — ITU-R BT.2020 copy — copy from source | 2 |
audio_codec | Specify the audio codec | apple_prores: pcm_s16le, pcm_s24le, pcm_s32le, libfaac | apple_prores: pcm_s24le |
Audio Stream Parameters | - | - | - |
layout | Audio channel layout | - Custom layout with channels notations in format [ChannleName1]+[ChannleName2]+...[ChannleNameN] Channel names: FL — front left FR — front right FC — front center LFE — low frequency BL — back left BR — back right FLC — front left-of-center FRC — front right-of-center BC — back center SL — side left SR — side right TC — top center TFL — top front left TFC — top front center TFR — top front right TBL — top back left TBC — top back center TBR — top back right - One of these channel layouts: mono — FC stereo — FL+FR 2.1 — FL+FR+LFE 3.0 — FL+FR+FC 3.0-back — FL+FR+BC 4.0 — FL+FR+FC+BC quad — FL+FR+BL+BR quad-side — FL+FR+SL+SR 3.1 — FL+FR+FC+LFE 5.0 — FL+FR+FC+BL+BR 5.0-side — FL+FR+FC+SL+SR 4.1 — FL+FR+FC+LFE+BC 5.1 — FL+FR+FC+LFE+BL+BR 5.1-side — FL+FR+FC+LFE+SL+SR 6.0 — FL+FR+FC+BC+SL+SR 6.0-front — FL+FR+FLC+FRC+SL+SR hexagonal — FL+FR+FC+BL+BR+BC 6.1 — FL+FR+FC+LFE+BC+SL+SR 6.1 — FL+FR+FC+LFE+BL+BR+BC 6.1-front — FL+FR+LFE+FLC+FRC+SL+SR 7.0 — FL+FR+FC+BL+BR+SL+SR 7.0-front — FL+FR+FC+FLC+FRC+SL+SR 7.1 — FL+FR+FC+LFE+BL+BR+SL+SR 7.1-wide — FL+FR+FC+LFE+BL+BR+FLC+FRC 7.1-wide-side — FL+FR+FC+LFE+FLC+FRC+SL+SR octagonal — FL+FR+FC+BL+BR+BC+SL+SR | None |
Format Parameters | - | - | - |
size | Specifies the video frame size. | WxH, where W and N are any even integers. copy — copy from source | None |
framerate | Specifies the frame rate. | Any non-zero float or N/M where N and M are non-zero integers copy — copy from source | None |
force_interlaced | Specify the interlaced encoding type. | tff — top field first bff — bottom field first no — no interlacing copy — copy from source | no |
force_clap | Force insert clean aperture metadata | yes — always insert clean aperture metadata no — insert clean aperture metadata only for SDR outputs | None |
layout_in_audio_channel_description | Use audio channel description instead of channel bitmap to tag channel layout in Audio Channel Layout Atom | yes – use audio channel description to tag layout no – use channel bitmap | no |