video_resize_resolution_mapper¶
Resizes video resolution based on specified width and height constraints.
This operator resizes videos to fit within the provided minimum and maximum width and height limits. It can optionally maintain the original aspect ratio by adjusting the dimensions accordingly. The resized videos are saved in the specified directory or the same directory as the input if no save directory is provided. The key metric for resizing is the video's width and height, which are adjusted to meet the constraints while maintaining the aspect ratio if configured. The force_divisible_by parameter ensures that the output dimensions are divisible by a specified integer, which must be a positive even number when used with aspect ratio adjustments.
根据指定的宽度和高度约束调整视频分辨率。
此算子调整视频尺寸以适应提供的最小和最大宽度和高度限制。它可以选择性地通过相应调整尺寸来保持原始宽高比。调整后的视频保存在指定目录中，如果没有提供保存目录，则保存在与输入文件相同的目录中。调整的关键指标是视频的宽度和高度，它们会根据约束进行调整，并在配置时保持宽高比。force_divisible_by 参数确保输出尺寸可以被指定的整数整除，当与宽高比调整一起使用时，该整数必须是正偶数。
Type 算子类型: mapper
Tags 标签: cpu, video
🔧 Parameter Configuration 参数配置¶
name 参数名 |
type 类型 |
default 默认值 |
desc 说明 |
|---|---|---|---|
|
<class 'int'> |
|
Videos with width less than 'min_width' will be mapped to videos with equal or bigger width. |
|
<class 'int'> |
|
Videos with width more than 'max_width' will be mapped to videos with equal of smaller width. |
|
<class 'int'> |
|
Videos with height less than 'min_height' will be mapped to videos with equal or bigger height. |
|
<class 'int'> |
|
Videos with height more than 'max_height' will be mapped to videos with equal or smaller height. |
|
<class 'str'> |
|
Enable decreasing or increasing output video width or height if necessary to keep the original aspect ratio, including ['disable', 'decrease', 'increase']. |
|
typing.Annotated[int, Gt(gt=0)] |
|
Ensures that both the output dimensions, width and height, are divisible by the given integer when used together with force_original_aspect_ratio, must be a positive even number. |
|
<class 'str'> |
|
The directory where generated video files will be stored. If not specified, outputs will be saved in the same directory as their corresponding input files. This path can alternatively be defined by setting the |
|
|
extra args |
|
|
|
extra args |
📊 Effect demonstration 效果演示¶
test_default_mapper¶
VideoResizeResolutionMapper()
📥 input data 输入数据¶
📤 output data 输出数据¶
[[(640, 360)], [(480, 640)], [(362, 640)]]
✨ explanation 解释¶
This example shows the operator's behavior when no specific width or height constraints are set. The original videos are not resized, and their dimensions remain the same. The output data here is a list of (width, height) tuples for each video, which is derived from the processed videos to help understand the result. 此示例展示了当未设置特定的宽度或高度约束时，算子的行为。原始视频不会被调整大小，其尺寸保持不变。这里的输出数据是每个视频的（宽度，高度）元组列表，这是从处理后的视频中提取出来的，以帮助理解结果。
test_keep_aspect_ratio_decrease_mapper¶
VideoResizeResolutionMapper(min_width=400, max_width=480, min_height=480, max_height=480, force_original_aspect_ratio='decrease')
📥 input data 输入数据¶
📤 output data 输出数据¶
[[(480, 270)]]
✨ explanation 解释¶
In this case, the operator resizes the videos while maintaining the original aspect ratio and ensuring that both the width and height fall within the specified limits. If the original dimensions exceed the maximum, the video is scaled down. The output data here is a list of (width, height) tuples for each video, which is derived from the processed videos to help understand the result. 在这种情况下，算子在保持原始纵横比的同时调整视频大小，并确保宽度和高度都在指定范围内。如果原始尺寸超过最大值，则视频会被缩小。这里的输出数据是每个视频的（宽度，高度）元组列表，这是从处理后的视频中提取出来的，以帮助理解结果。