video_resize_aspect_ratio_mapper

Resizes videos to fit within a specified aspect ratio range. This operator adjusts the dimensions of videos to ensure their aspect ratios fall within a defined range. It can either increase or decrease the video dimensions based on the specified strategy. The aspect ratio is calculated as width divided by height. If a video’s aspect ratio is outside the given range, it will be resized to match the closest boundary (either the minimum or maximum ratio). The min_ratio and max_ratio should be provided as strings in the format “9:21” or “9/21”. The resizing process uses the ffmpeg library to handle the actual video scaling. Videos that do not need resizing are left unchanged. The operator supports saving the modified videos to a specified directory or the same directory as the input files.

调整视频尺寸以适应指定的宽高比范围。此算子调整视频的尺寸，以确保其宽高比在定义的范围内。根据指定的策略，它可以增加或减少视频的尺寸。宽高比计算为宽度除以高度。如果视频的宽高比超出给定范围，它将被调整到最接近的边界（最小或最大比率）。min_ratio 和 max_ratio 应以 “9:21” 或 “9/21” 格式的字符串提供。调整过程使用 ffmpeg 库来处理实际的视频缩放。不需要调整尺寸的视频保持不变。该算子支持将修改后的视频保存到指定目录或与输入文件相同的目录。

Type 算子类型: mapper

Tags 标签: cpu, video

🔧 Parameter Configuration 参数配置

name 参数名

type 类型

default 默认值

desc 说明

min_ratio

<class ‘str’>

'9/21'

The minimum aspect ratio to enforce videos with

max_ratio

<class ‘str’>

'21/9'

The maximum aspect ratio to enforce videos with

strategy

<class ‘str’>

'increase'

The resizing strategy to apply when adjusting the

save_dir

<class ‘str’>

None

The directory where generated video files will be stored.

args

''

extra args

kwargs

''

extra args

📊 Effect demonstration 效果演示

test_default_params

VideoResizeAspectRatioMapper()

📥 input data 输入数据

Sample 1: 1 video
video1.mp4:
Sample 2: 1 video
video2.mp4:
Sample 3: 1 video
video3.mp4:

📤 output data 输出数据

Sample 1: list
[[(640, 360)], [(480, 640)], [(362, 640)]]

✨ explanation 解释

This example demonstrates the default behavior of the operator, where no specific aspect ratio range is set. As a result, all videos remain unchanged because there are no constraints to modify their dimensions. The output data shows the (width, height) of each video, which is the same as the input data. For clarity, we show the (width, height) of each video in the raw output; the actual raw output from the operator is the original videos without any changes. 这个示例展示了算子的默认行为，即没有设置特定的宽高比范围。因此，所有视频保持不变，因为没有任何约束来修改它们的尺寸。输出数据显示了每个视频的（宽度，高度），这与输入数据相同。为了清晰起见，我们在原始输出中显示了每个视频的（宽度，高度）；算子的实际原始输出是没有做任何修改的原始视频。

test_min_ratio_increase

VideoResizeAspectRatioMapper(min_ratio='3/4', strategy='increase')

📥 input data 输入数据

Sample 1: 1 video
video1.mp4:
Sample 2: 1 video
video2.mp4:
Sample 3: 1 video
video3.mp4:

📤 output data 输出数据

Sample 1: list
[[(640, 360)], [(480, 640)], [(480, 640)]]

✨ explanation 解释

This example sets a minimum aspect ratio of 3/4 and uses the ‘increase’ strategy. If a video’s aspect ratio is below 3/4, it will be resized to match this minimum ratio. In this case, only the third video (with an initial aspect ratio of 181:320) is resized to 480x640 to meet the minimum ratio requirement. The other two videos remain unchanged. The output data shows the (width, height) of each video after processing. For clarity, we show the (width, height) of each video in the raw output; the actual raw output from the operator is the resized videos. 这个示例设置了最小宽高比为3/4，并使用了“增加”策略。如果一个视频的宽高比低于3/4，它将被调整以匹配这个最小比例。在这种情况下，只有第三个视频（初始宽高比为181:320）被调整为480x640以满足最小比例要求。其他两个视频保持不变。输出数据显示了处理后的每个视频的（宽度，高度）。为了清晰起见，我们在原始输出中显示了每个视频的（宽度，高度）；算子的实际原始输出是调整后的视频。