/AWS1/CL_MDCPRORESSETTINGS¶
Required when you set Codec to the value PRORES.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
IV_CHROMASAMPLING TYPE /AWS1/MDCPRORESCHROMASAMPLING /AWS1/MDCPRORESCHROMASAMPLING¶
This setting applies only to ProRes 4444 and ProRes 4444 XQ outputs that you create from inputs that use 4:4:4 chroma sampling. Set Preserve 4:4:4 sampling to allow outputs to also use 4:4:4 chroma sampling. You must specify a value for this setting when your output codec profile supports 4:4:4 chroma sampling. Related Settings: For Apple ProRes outputs with 4:4:4 chroma sampling: Choose Preserve 4:4:4 sampling. Use when your input has 4:4:4 chroma sampling and your output codec Profile is Apple ProRes 4444 or 4444 XQ. Note that when you choose Preserve 4:4:4 sampling, you cannot include any of the following Preprocessors: Dolby Vision, HDR10+, or Noise reducer.
IV_CODECPROFILE TYPE /AWS1/MDCPRORESCODECPROFILE /AWS1/MDCPRORESCODECPROFILE¶
Use Profile to specify the type of Apple ProRes codec to use for this output.
IV_FRAMERATECONTROL TYPE /AWS1/MDCPRORESFRAMERATECTL /AWS1/MDCPRORESFRAMERATECTL¶
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction.
IV_FRAMERATECONVERSIONALG TYPE /AWS1/MDCPRORESFRAMERATECONV00 /AWS1/MDCPRORESFRAMERATECONV00¶
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
IV_FRAMERATEDENOMINATOR TYPE /AWS1/MDC__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.
IV_FRAMERATENUMERATOR TYPE /AWS1/MDC__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.
IV_INTERLACEMODE TYPE /AWS1/MDCPRORESINTERLACEMODE /AWS1/MDCPRORESINTERLACEMODE¶
Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.
IV_PARCONTROL TYPE /AWS1/MDCPRORESPARCONTROL /AWS1/MDCPRORESPARCONTROL¶
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source, uses the PAR from your input video for your output. To specify a different PAR, choose any value other than Follow source. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
IV_PARDENOMINATOR TYPE /AWS1/MDC__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
Required when you set Pixel aspect ratio to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.
IV_PARNUMERATOR TYPE /AWS1/MDC__INTEGERMIN1MAX21400 /AWS1/MDC__INTEGERMIN1MAX21400¶
Required when you set Pixel aspect ratio to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.
IV_SCANTYPECONVERSIONMODE TYPE /AWS1/MDCPRORESSCANTYPECONVR00 /AWS1/MDCPRORESSCANTYPECONVR00¶
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
IV_SLOWPAL TYPE /AWS1/MDCPRORESSLOWPAL /AWS1/MDCPRORESSLOWPAL¶
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.
IV_TELECINE TYPE /AWS1/MDCPRORESTELECINE /AWS1/MDCPRORESTELECINE¶
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine to create a smoother picture. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
Queryable Attributes¶
ChromaSampling¶
This setting applies only to ProRes 4444 and ProRes 4444 XQ outputs that you create from inputs that use 4:4:4 chroma sampling. Set Preserve 4:4:4 sampling to allow outputs to also use 4:4:4 chroma sampling. You must specify a value for this setting when your output codec profile supports 4:4:4 chroma sampling. Related Settings: For Apple ProRes outputs with 4:4:4 chroma sampling: Choose Preserve 4:4:4 sampling. Use when your input has 4:4:4 chroma sampling and your output codec Profile is Apple ProRes 4444 or 4444 XQ. Note that when you choose Preserve 4:4:4 sampling, you cannot include any of the following Preprocessors: Dolby Vision, HDR10+, or Noise reducer.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CHROMASAMPLING() |
Getter for CHROMASAMPLING, with configurable default |
ASK_CHROMASAMPLING() |
Getter for CHROMASAMPLING w/ exceptions if field has no valu |
HAS_CHROMASAMPLING() |
Determine if CHROMASAMPLING has a value |
CodecProfile¶
Use Profile to specify the type of Apple ProRes codec to use for this output.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CODECPROFILE() |
Getter for CODECPROFILE, with configurable default |
ASK_CODECPROFILE() |
Getter for CODECPROFILE w/ exceptions if field has no value |
HAS_CODECPROFILE() |
Determine if CODECPROFILE has a value |
FramerateControl¶
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FRAMERATECONTROL() |
Getter for FRAMERATECONTROL, with configurable default |
ASK_FRAMERATECONTROL() |
Getter for FRAMERATECONTROL w/ exceptions if field has no va |
HAS_FRAMERATECONTROL() |
Determine if FRAMERATECONTROL has a value |
FramerateConversionAlgorithm¶
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. For numerically simple conversions, such as 60 fps to 30 fps: We recommend that you keep the default value, Drop duplicate. For numerically complex conversions, to avoid stutter: Choose Interpolate. This results in a smooth picture, but might introduce undesirable video artifacts. For complex frame rate conversions, especially if your source video has already been converted from its original cadence: Choose FrameFormer to do motion-compensated interpolation. FrameFormer uses the best conversion method frame by frame. Note that using FrameFormer increases the transcoding time and incurs a significant add-on cost. When you choose FrameFormer, your input video resolution must be at least 128x96.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FRAMERATECONVERSIONALG() |
Getter for FRAMERATECONVERSIONALGORITHM, with configurable d |
ASK_FRAMERATECONVERSIONALG() |
Getter for FRAMERATECONVERSIONALGORITHM w/ exceptions if fie |
HAS_FRAMERATECONVERSIONALG() |
Determine if FRAMERATECONVERSIONALGORITHM has a value |
FramerateDenominator¶
When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FRAMERATEDENOMINATOR() |
Getter for FRAMERATEDENOMINATOR, with configurable default |
ASK_FRAMERATEDENOMINATOR() |
Getter for FRAMERATEDENOMINATOR w/ exceptions if field has n |
HAS_FRAMERATEDENOMINATOR() |
Determine if FRAMERATEDENOMINATOR has a value |
FramerateNumerator¶
When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FRAMERATENUMERATOR() |
Getter for FRAMERATENUMERATOR, with configurable default |
ASK_FRAMERATENUMERATOR() |
Getter for FRAMERATENUMERATOR w/ exceptions if field has no |
HAS_FRAMERATENUMERATOR() |
Determine if FRAMERATENUMERATOR has a value |
InterlaceMode¶
Choose the scan line type for the output. Keep the default value, Progressive to create a progressive output, regardless of the scan type of your input. Use Top field first or Bottom field first to create an output that's interlaced with the same field polarity throughout. Use Follow, default top or Follow, default bottom to produce outputs with the same field polarity as the source. For jobs that have multiple inputs, the output field polarity might change over the course of the output. Follow behavior depends on the input scan type. If the source is interlaced, the output will be interlaced with the same polarity as the source. If the source is progressive, the output will be interlaced with top field bottom field first, depending on which of the Follow options you choose.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_INTERLACEMODE() |
Getter for INTERLACEMODE, with configurable default |
ASK_INTERLACEMODE() |
Getter for INTERLACEMODE w/ exceptions if field has no value |
HAS_INTERLACEMODE() |
Determine if INTERLACEMODE has a value |
ParControl¶
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source, uses the PAR from your input video for your output. To specify a different PAR, choose any value other than Follow source. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PARCONTROL() |
Getter for PARCONTROL, with configurable default |
ASK_PARCONTROL() |
Getter for PARCONTROL w/ exceptions if field has no value |
HAS_PARCONTROL() |
Determine if PARCONTROL has a value |
ParDenominator¶
Required when you set Pixel aspect ratio to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PARDENOMINATOR() |
Getter for PARDENOMINATOR, with configurable default |
ASK_PARDENOMINATOR() |
Getter for PARDENOMINATOR w/ exceptions if field has no valu |
HAS_PARDENOMINATOR() |
Determine if PARDENOMINATOR has a value |
ParNumerator¶
Required when you set Pixel aspect ratio to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PARNUMERATOR() |
Getter for PARNUMERATOR, with configurable default |
ASK_PARNUMERATOR() |
Getter for PARNUMERATOR w/ exceptions if field has no value |
HAS_PARNUMERATOR() |
Determine if PARNUMERATOR has a value |
ScanTypeConversionMode¶
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing to create a better quality interlaced output. In this case, each progressive frame from the input corresponds to an interlaced field in the output. Keep the default value, Basic interlacing, for all other output frame rates. With basic interlacing, MediaConvert performs any frame rate conversion first and then interlaces the frames. When you choose Optimized interlacing and you set your output frame rate to a value that isn't suitable for optimized interlacing, MediaConvert automatically falls back to basic interlacing. Required settings: To use optimized interlacing, you must set Telecine to None or Soft. You can't use optimized interlacing for hard telecine outputs. You must also set Interlace mode to a value other than Progressive.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SCANTYPECONVERSIONMODE() |
Getter for SCANTYPECONVERSIONMODE, with configurable default |
ASK_SCANTYPECONVERSIONMODE() |
Getter for SCANTYPECONVERSIONMODE w/ exceptions if field has |
HAS_SCANTYPECONVERSIONMODE() |
Determine if SCANTYPECONVERSIONMODE has a value |
SlowPal¶
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL, MediaConvert relabels the video frames to 25 fps and resamples your audio to keep it synchronized with the video. Note that enabling this setting will slightly reduce the duration of your video. Required settings: You must also set Framerate to 25.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SLOWPAL() |
Getter for SLOWPAL, with configurable default |
ASK_SLOWPAL() |
Getter for SLOWPAL w/ exceptions if field has no value |
HAS_SLOWPAL() |
Determine if SLOWPAL has a value |
Telecine¶
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard telecine to create a smoother picture. When you keep the default value, None, MediaConvert does a standard frame rate conversion to 29.97 without doing anything with the field polarity to create a smoother picture.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TELECINE() |
Getter for TELECINE, with configurable default |
ASK_TELECINE() |
Getter for TELECINE w/ exceptions if field has no value |
HAS_TELECINE() |
Determine if TELECINE has a value |