Apple ProRes

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><<id>></userid> <!-- required -->
    <userkey><<key>></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>
        <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": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", //required
        "format": {
            "output": "apple_prores", //required
            "type": "[ProResType]",
            "size": "[Size]",
            "framerate": "[FrameRate]",
            "force_interlaced": "[InterlacedType]",
            "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

Format Parameters

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

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

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

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