unreal.MovieGraphAspectRatioAdaptBehavior

class unreal.MovieGraphAspectRatioAdaptBehavior

Bases: EnumBase

EMovie Graph Aspect Ratio Adapt Behavior

C++ Source:

• Plugin: MovieRenderPipeline

• Module: MovieRenderPipelineCore

• File: MovieGraphGlobalOutputSettingNode.h

AUTOMATIC: MovieGraphAspectRatioAdaptBehavior = Ellipsis

If the camera has Constrain Aspect Ratio enabled, then this should match Disabled, except the letterboxing will be cropped off. No behavior change if Constrain Aspect Ratio is not enabled.

The output resolution will be resized to respect the camera aspect ratio, matching either the specified Width, or Height. Which dimension is picked will depend on the aspect ratio (ie: a tall camera aspect ratio will preserve the height of the output, and crop the width, while a wide camera aspect ratio will preserve the width of the output and crop the height.)

Type:

1

DISABLED: MovieGraphAspectRatioAdaptBehavior = Ellipsis

Output resolution will not be modified. If the camera has Constrain Aspect Ratio enabled, then letterboxing may be shown to preserve that aspect ratio within the specified Output Resolution.

Type:

0

SCALE_TO_HEIGHT: MovieGraphAspectRatioAdaptBehavior = Ellipsis

If the camera has Constrain Aspect Ratio enabled, then the height of the output resolution will be preserved, and the width will automatically be adjusted based on the camera aspect ratio.

ie: If you have a 1.77 (16:9) Camera Aspect Ratio and target a 1.0 (1:1) output image, then the output image will have its width adjusted to preserve the 1.77 aspect ratio of the camera, without showing letterboxing. For example, a 1.77 Camera Aspect Ratio and a 1024x1024 output resolution will produce a render that is 1820x1024, which preserves the existing aspect ratio and the given height. No behavior change if Constrain Aspect Ratio is not enabled.

Type:

3

SCALE_TO_WIDTH: MovieGraphAspectRatioAdaptBehavior = Ellipsis

If the camera has Constrain Aspect Ratio enabled, then the width of the output resolution will be preserved, and the height will automatically be adjusted based on the camera aspect ratio.

ie: If you have a 1.77 (16:9) Camera Aspect Ratio and target a 1.0 (1:1) output image, then the output image will have its height adjusted to preserve the 1.77 aspect ratio of the camera, without showing letterboxing. For example, a 1.77 Camera Aspect Ratio and a 1024x1024 output resolution will produce a render that is 1024x576, which preserves the existing aspect ratio and the given width. No behavior change if Constrain Aspect Ratio is not enabled.

Type:

2