feat(client-mediaconvert): This release adds a new SPECIFIED_OPTIMAL option for handling DDS when using DVB-Sub with high resolution video.

awstools · awstools · commit fed23d708596 · 2025-06-20T19:24:40.000Z
diff --git a/clients/client-mediaconvert/src/commands/CreateJobCommand.ts b/clients/client-mediaconvert/src/commands/CreateJobCommand.ts
@@ -906,7 +906,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *                     ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  *                     BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  *                     BackgroundOpacity: Number("int"),
- *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  *                     DdsXCoordinate: Number("int"),
  *                     DdsYCoordinate: Number("int"),
  *                     FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
@@ -2511,7 +2511,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //                       ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                       BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                       BackgroundOpacity: Number("int"),
- * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                       DdsXCoordinate: Number("int"),
  * //                       DdsYCoordinate: Number("int"),
  * //                       FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/CreateJobTemplateCommand.ts b/clients/client-mediaconvert/src/commands/CreateJobTemplateCommand.ts
@@ -887,7 +887,7 @@ export interface CreateJobTemplateCommandOutput extends CreateJobTemplateRespons
  *                     ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  *                     BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  *                     BackgroundOpacity: Number("int"),
- *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  *                     DdsXCoordinate: Number("int"),
  *                     DdsYCoordinate: Number("int"),
  *                     FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
@@ -2434,7 +2434,7 @@ export interface CreateJobTemplateCommandOutput extends CreateJobTemplateRespons
  * //                       ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                       BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                       BackgroundOpacity: Number("int"),
- * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                       DdsXCoordinate: Number("int"),
  * //                       DdsYCoordinate: Number("int"),
  * //                       FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/CreatePresetCommand.ts b/clients/client-mediaconvert/src/commands/CreatePresetCommand.ts
@@ -228,7 +228,7 @@ export interface CreatePresetCommandOutput extends CreatePresetResponse, __Metad
  *             ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  *             BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  *             BackgroundOpacity: Number("int"),
- *             DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ *             DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  *             DdsXCoordinate: Number("int"),
  *             DdsYCoordinate: Number("int"),
  *             FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
@@ -1085,7 +1085,7 @@ export interface CreatePresetCommandOutput extends CreatePresetResponse, __Metad
  * //               ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //               BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //               BackgroundOpacity: Number("int"),
- * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //               DdsXCoordinate: Number("int"),
  * //               DdsYCoordinate: Number("int"),
  * //               FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/GetJobCommand.ts b/clients/client-mediaconvert/src/commands/GetJobCommand.ts
@@ -950,7 +950,7 @@ export interface GetJobCommandOutput extends GetJobResponse, __MetadataBearer {}
  * //                       ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                       BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                       BackgroundOpacity: Number("int"),
- * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                       DdsXCoordinate: Number("int"),
  * //                       DdsYCoordinate: Number("int"),
  * //                       FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/GetJobTemplateCommand.ts b/clients/client-mediaconvert/src/commands/GetJobTemplateCommand.ts
@@ -896,7 +896,7 @@ export interface GetJobTemplateCommandOutput extends GetJobTemplateResponse, __M
  * //                       ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                       BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                       BackgroundOpacity: Number("int"),
- * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                       DdsXCoordinate: Number("int"),
  * //                       DdsYCoordinate: Number("int"),
  * //                       FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/GetPresetCommand.ts b/clients/client-mediaconvert/src/commands/GetPresetCommand.ts
@@ -237,7 +237,7 @@ export interface GetPresetCommandOutput extends GetPresetResponse, __MetadataBea
  * //               ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //               BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //               BackgroundOpacity: Number("int"),
- * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //               DdsXCoordinate: Number("int"),
  * //               DdsYCoordinate: Number("int"),
  * //               FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/ListJobTemplatesCommand.ts b/clients/client-mediaconvert/src/commands/ListJobTemplatesCommand.ts
@@ -901,7 +901,7 @@ export interface ListJobTemplatesCommandOutput extends ListJobTemplatesResponse,
  * //                         ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                         BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                         BackgroundOpacity: Number("int"),
- * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                         DdsXCoordinate: Number("int"),
  * //                         DdsYCoordinate: Number("int"),
  * //                         FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/ListJobsCommand.ts b/clients/client-mediaconvert/src/commands/ListJobsCommand.ts
@@ -955,7 +955,7 @@ export interface ListJobsCommandOutput extends ListJobsResponse, __MetadataBeare
  * //                         ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                         BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                         BackgroundOpacity: Number("int"),
- * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                         DdsXCoordinate: Number("int"),
  * //                         DdsYCoordinate: Number("int"),
  * //                         FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/ListPresetsCommand.ts b/clients/client-mediaconvert/src/commands/ListPresetsCommand.ts
@@ -243,7 +243,7 @@ export interface ListPresetsCommandOutput extends ListPresetsResponse, __Metadat
  * //                 ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                 BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                 BackgroundOpacity: Number("int"),
- * //                 DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                 DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                 DdsXCoordinate: Number("int"),
  * //                 DdsYCoordinate: Number("int"),
  * //                 FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/SearchJobsCommand.ts b/clients/client-mediaconvert/src/commands/SearchJobsCommand.ts
@@ -956,7 +956,7 @@ export interface SearchJobsCommandOutput extends SearchJobsResponse, __MetadataB
  * //                         ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                         BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                         BackgroundOpacity: Number("int"),
- * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                         DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                         DdsXCoordinate: Number("int"),
  * //                         DdsYCoordinate: Number("int"),
  * //                         FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/UpdateJobTemplateCommand.ts b/clients/client-mediaconvert/src/commands/UpdateJobTemplateCommand.ts
@@ -887,7 +887,7 @@ export interface UpdateJobTemplateCommandOutput extends UpdateJobTemplateRespons
  *                     ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  *                     BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  *                     BackgroundOpacity: Number("int"),
- *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ *                     DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  *                     DdsXCoordinate: Number("int"),
  *                     DdsYCoordinate: Number("int"),
  *                     FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
@@ -2431,7 +2431,7 @@ export interface UpdateJobTemplateCommandOutput extends UpdateJobTemplateRespons
  * //                       ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //                       BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //                       BackgroundOpacity: Number("int"),
- * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //                       DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //                       DdsXCoordinate: Number("int"),
  * //                       DdsYCoordinate: Number("int"),
  * //                       FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/commands/UpdatePresetCommand.ts b/clients/client-mediaconvert/src/commands/UpdatePresetCommand.ts
@@ -228,7 +228,7 @@ export interface UpdatePresetCommandOutput extends UpdatePresetResponse, __Metad
  *             ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  *             BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  *             BackgroundOpacity: Number("int"),
- *             DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ *             DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  *             DdsXCoordinate: Number("int"),
  *             DdsYCoordinate: Number("int"),
  *             FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
@@ -1082,7 +1082,7 @@ export interface UpdatePresetCommandOutput extends UpdatePresetResponse, __Metad
  * //               ApplyFontColor: "WHITE_TEXT_ONLY" || "ALL_TEXT",
  * //               BackgroundColor: "NONE" || "BLACK" || "WHITE" || "AUTO",
  * //               BackgroundOpacity: Number("int"),
- * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW",
+ * //               DdsHandling: "NONE" || "SPECIFIED" || "NO_DISPLAY_WINDOW" || "SPECIFIED_OPTIMAL",
  * //               DdsXCoordinate: Number("int"),
  * //               DdsYCoordinate: Number("int"),
  * //               FallbackFont: "BEST_MATCH" || "MONOSPACED_SANSSERIF" || "MONOSPACED_SERIF" || "PROPORTIONAL_SANSSERIF" || "PROPORTIONAL_SERIF",
diff --git a/clients/client-mediaconvert/src/models/models_0.ts b/clients/client-mediaconvert/src/models/models_0.ts
@@ -2380,6 +2380,7 @@ export const DvbddsHandling = {
   NONE: "NONE",
   NO_DISPLAY_WINDOW: "NO_DISPLAY_WINDOW",
   SPECIFIED: "SPECIFIED",
+  SPECIFIED_OPTIMAL: "SPECIFIED_OPTIMAL",
 } as const;
 
 /**
@@ -2533,7 +2534,7 @@ export interface DvbSubDestinationSettings {
   BackgroundOpacity?: number | undefined;
 
   /**
-   * Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match.
+   * Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match. To include the DDS, with optimized subtitle placement and reduced data overhead: We recommend that you choose Specified (optimal). This option provides the same visual positioning as Specified while using less bandwidth. This also supports resolutions higher than 1080p while maintaining full DVB-Sub compatibility. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate.
    * @public
    */
   DdsHandling?: DvbddsHandling | undefined;
diff --git a/codegen/sdk-codegen/aws-models/mediaconvert.json b/codegen/sdk-codegen/aws-models/mediaconvert.json
@@ -7599,7 +7599,7 @@
         "DdsHandling": {
           "target": "com.amazonaws.mediaconvert#DvbddsHandling",
           "traits": {
-            "smithy.api#documentation": "Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match.",
+            "smithy.api#documentation": "Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match. To include the DDS, with optimized subtitle placement and reduced data overhead: We recommend that you choose Specified (optimal). This option provides the same visual positioning as Specified while using less bandwidth. This also supports resolutions higher than 1080p while maintaining full DVB-Sub compatibility. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate.",
             "smithy.api#jsonName": "ddsHandling"
           }
         },
@@ -8160,10 +8160,16 @@
           "traits": {
             "smithy.api#enumValue": "NO_DISPLAY_WINDOW"
           }
+        },
+        "SPECIFIED_OPTIMAL": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "SPECIFIED_OPTIMAL"
+          }
         }
       },
       "traits": {
-        "smithy.api#documentation": "Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match."
+        "smithy.api#documentation": "Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS: Choose Specified. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate. To include the DDS, but not include display window data: Choose No display window. When you do, you can write position metadata to the page composition segment (PCS) with DDS x-coordinate and DDS y-coordinate. For video resolutions with a height of 576 pixels or less, MediaConvert doesn't include the DDS, regardless of the value you choose for DDS handling. All burn-in and DVB-Sub font settings must match. To include the DDS, with optimized subtitle placement and reduced data overhead: We recommend that you choose Specified (optimal). This option provides the same visual positioning as Specified while using less bandwidth. This also supports resolutions higher than 1080p while maintaining full DVB-Sub compatibility. When you do, also specify the offset coordinates of the display window with DDS x-coordinate and DDS y-coordinate."
       }
     },
     "com.amazonaws.mediaconvert#DynamicAudioSelector": {
