Package software.amazon.awscdk.services.medialive.alpha

Class Lut

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.medialive.alpha.Lut

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)",
           date="2026-09-02T11:03:41.207Z")
@Stability(Experimental)
public abstract class Lut
extends software.amazon.jsii.JsiiObject

(experimental) The S3 location of a 3D LUT (look-up table) file used by a color-correction rule.

MediaLive reads the LUT from S3 at runtime, so the file must be in an S3 bucket — the URI must use the s3:// or s3ssl:// protocol. Unlike a FileLocation, a LUT has no credentials.

Use the static factory methods to create one from an S3 bucket (which uses the secure s3ssl:// form and auto-grants the channel role read access) or a raw S3 URL.

Example:

 Stack stack;
 IBucket bucket;
 IInput input;
 EncodeConfiguration video;
 OutputDestination destination;
 Channel.Builder.create(stack, "Channel")
         .inputs(List.of(InputAttachment.builder().input(input).build()))
         .colorCorrections(List.of(ColorCorrection.builder()
                 .inputColorSpace(ColorSpace.REC_601)
                 .outputColorSpace(ColorSpace.REC_709)
                 .lut(Lut.fromBucket(bucket, "luts/rec601-to-rec709.cube"))
                 .build()))
         .outputGroups(List.of(OutputGroupConfiguration.hls(HlsOutputGroupProps.builder()
                 .name("hls")
                 .destinations(List.of(destination))
                 .outputs(List.of(HlsOutputDefinition.builder().encodes(List.of(video)).outputName("video").build()))
                 .build())))
         .build();
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Lut()
protected	Lut(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Lut(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method	Description
static Lut	fromBucket(IBucket bucket, String key)	(experimental) Reference a LUT file in an S3 bucket.
static Lut	url(String url)	(experimental) Reference a LUT file by S3 URL.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Details

Lut

protected Lut(software.amazon.jsii.JsiiObjectRef objRef)

Lut

protected Lut(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Lut

@Stability(Experimental)
protected Lut()

Method Details

fromBucket

@Stability(Experimental)
@NotNull
public static Lut fromBucket(@NotNull
 IBucket bucket,
 @NotNull
 String key)

(experimental) Reference a LUT file in an S3 bucket.

Uses the secure s3ssl:// form and automatically grants the channel role read access.

Parameters:

bucket - The S3 bucket containing the LUT file. This parameter is required.

key - The object key within the bucket (e.g. 'luts/rec709.cube'). This parameter is required.

url

@Stability(Experimental)
@NotNull
public static Lut url(@NotNull
 String url)

(experimental) Reference a LUT file by S3 URL.

The URL must use the s3:// or s3ssl:// protocol.

Parameters:

url - The s3:// or s3ssl:// URL of the LUT file. This parameter is required.