You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::MediaConvert::Types::InsertableImage

Inherits:

Struct

• Object
• Struct
• Aws::MediaConvert::Types::InsertableImage

Defined in:

gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb

Overview

Note:

When making an API call, you may pass InsertableImage data as a hash:

{
  duration: 1,
  fade_in: 1,
  fade_out: 1,
  height: 1,
  image_inserter_input: "__stringMin14PatternS3BmpBMPPngPNGTgaTGA",
  image_x: 1,
  image_y: 1,
  layer: 1,
  opacity: 1,
  start_time: "__stringPattern01D20305D205D",
  width: 1,
}

Settings that specify how your still graphic overlay appears.

See Also:

• AWS API Documentation

Instance Attribute Summary

• #duration ⇒ Integer

  Specify the time, in milliseconds, for the image to remain on the output video.

• #fade_in ⇒ Integer

  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.

• #fade_out ⇒ Integer

  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.

• #height ⇒ Integer

  Specify the height of the inserted image in pixels.

• #image_inserter_input ⇒ String

  Specify the Amazon S3 location of the image that you want to overlay on the video.

• #image_x ⇒ Integer

  Specify the distance, in pixels, between the inserted image and the left edge of the video frame.

• #image_y ⇒ Integer

  Specify the distance, in pixels, between the overlaid image and the top edge of the video frame.

• #layer ⇒ Integer

  Specify how overlapping inserted images appear.

• #opacity ⇒ Integer

  Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image.

• #start_time ⇒ String

  Specify the timecode of the frame that you want the overlay to first appear on.

• #width ⇒ Integer

  Specify the width of the inserted image in pixels.

Instance Attribute Details

#duration ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#fade_in ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#fade_out ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#height ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#image_inserter_input ⇒ String

Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.

Returns:

• (String)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#image_x ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#image_y ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#layer ⇒ Integer

Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#opacity ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#start_time ⇒ String

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.

Returns:

• (String)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end

#width ⇒ Integer

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.

Returns:

• (Integer)

# File 'gems/aws-sdk-mediaconvert/lib/aws-sdk-mediaconvert/types.rb', line 8394

class InsertableImage < Struct.new(
  :duration,
  :fade_in,
  :fade_out,
  :height,
  :image_inserter_input,
  :image_x,
  :image_y,
  :layer,
  :opacity,
  :start_time,
  :width)
  include Aws::Structure
end