InsertableImage

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mediaconvert/refs/heads/main/json-schema/mediaconvert-api-insertable-image-schema.json",
  "title": "InsertableImage",
  "description": "These settings apply to a specific graphic overlay. You can include multiple overlays in your job.",
  "type": "object",
  "properties": {
    "Duration": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "duration"
          },
          "description": "Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time."
        }
      ]
    },
    "FadeIn": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "fadeIn"
          },
          "description": "Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time."
        }
      ]
    },
    "FadeOut": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "fadeOut"
          },
          "description": "Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration."
        }
      ]
    },
    "Height": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "height"
          },
          "description": "Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank."
        }
      ]
    },
    "ImageInserterInput": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__stringMin14PatternS3BmpBMPPngPNGTgaTGAHttpsBmpBMPPngPNGTgaTGA"
        },
        {
          "xml": {
            "name": "imageInserterInput"
          },
          "description": "Specify the HTTP, HTTPS, or Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file."
        }
      ]
    },
    "ImageX": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "imageX"
          },
          "description": "Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify."
        }
      ]
    },
    "ImageY": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "imageY"
          },
          "description": "Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify."
        }
      ]
    },
    "Layer": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max99"
        },
        {
          "xml": {
            "name": "layer"
          },
          "description": "Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer."
        }
      ]
    },
    "Opacity": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max100"
        },
        {
          "xml": {
            "name": "opacity"
          },
          "description": "Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50."
        }
      ]
    },
    "StartTime": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__stringPattern01D20305D205D"
        },
        {
          "xml": {
            "name": "startTime"
          },
          "description": "Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings."
        }
      ]
    },
    "Width": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "width"
          },
          "description": "Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank."
        }
      ]
    }
  }
}