y4mscaler - 云端在线

程序：

您的姓名

y4mscaler - 缩放/裁剪/翻译 YUV4MPEG2 流

概要

Y4MSCALER [选项] < Y4M流 > Y4M流

商品描述

Y4MSCALER 是一个通用的视频缩放器，它在 YUV4MPEG2 流上运行，如
由 MJPEG 工具生成和使用，例如 拉夫2yuv 和 mpeg2enc（1）。

Y4MSCALER 旨在用于管道。 因此，输入来自标准输入，输出是
标准输出。

的基本功能 Y4MSCALER 是缩放输入的指定“活动”区域
流（源）到输出流（目标）的指定活动区域。
源活动区域之外的像素将被忽略； 外面的像素
目标的活动区域填充有背景颜色。 来源可能
另外有一个磨砂应用它; 源遮罩外的像素设置为
单独指定的背景颜色。

Y4MSCALER 正确处理色度子采样，因此它也可以执行色度
子采样转换。 YUV4MPEG2 流格式支持三种 4:2:0
子采样，以及 4:1:1、4:2:2、4:4:4、带有 Alpha 通道的 4:4:4 模式，以及
单色仅亮度模式。 （请参阅“关于色度模式和子采样的说明”。）

Y4MSCALER 可以执行简单的隔行转换：从顶场优先切换到
底场优先，反之亦然（通过有损地丢弃第一个场），并创建一个
通过丢弃所有其他字段（有效地减半
垂直分辨率）。

源和目标由很多很多参数定义，但是 Y4MSCALER 有很多很多
内置启发式以自动适当地设置它们。 大多数源参数是
取自输入流标头。 剩余的源和目标参数不是
以理智的方式猜测用户指定的内容。

Y4MSCALER 包括许多常见目标流的预设参数：DVD、VCD
(VCD)、SuperVCD (SVCD)、相关的静止图像格式和 DV。

示例

要创建适合在 SVCD 中使用的流：

y4mscaler -O 预设=svcd

要从 DV 源（一个非隔行扫描格式）为 VCD 创建流
隔行格式），将输入帧向左移动 4 个像素：

y4mscaler -I ilace=仅底部 -I active=-4+0cc -O preset=vcd

获取宽屏 NTSC DV 源，并将其转换为信箱流，带有蓝色
顶部和底部的栏：

y4mscaler -O sar=ntsc -O bg=RGB:0,0,255

获取宽屏 NTSC DV 源，并将其转换为“全屏”流（即
侧面被剪掉，就像在电视上一样）：

y4mscaler -O sar=ntsc -O infer=剪辑

获取居中的、带信箱的 NTSC 源，并将其转换为宽屏 (16:9) 格式
DVD 流，去除黑条：

y4mscaler -O 预设=dvd -O sar=ntsc_wide -O 推断=剪辑

要获取 NTSC DV 流的中心 100x100 像素块，请用 20 像素包围它
蓝色边框，并将其放大为全屏 SuperVCD 流：

y4mscaler -I 活动=140x140+0+0cc -I 哑光=100x100+0+0cc -I bg=RGB:0,0,255 -O
预设=svcd

配置

前三个选项 -v、-V 和 -h 是简单直接的选项，它们采用
要么没有参数，要么只有一个数字参数。

-v [0,1,2]
设置详细级别。
0 = 仅警告和错误。
1 = 也添加信息性消息（默认）。
2 = 也添加健谈的调试消息。

-V 显示版本信息并退出。

-h 显示帮助消息（选项概要）。

-I、-O 和 -S 选项均采用以下形式的一个参数 参数=值， 这
分别为输入、输出和缩放指定参数。 这些选项可以
重复使用来指定多个参数。 参数名称和值不是
区分大小写。 “parameter=[AAA|BBB|CCC]”形式的定义意味着只有一个
可以选择列出的关键字 AAA、BBB 或 CCC。 成功的选项将覆盖
较早的。

-I 输入参数
指定源/输入流的参数。 所有“-I”参数都在
顺序，命令行上后面的参数将覆盖前面的参数。 所有的“-我”
参数在任何“-O”参数之前进行评估。

活跃=宽x高+X+呀
指定源帧的活动区域，该区域被缩放以适合活动
目标帧的区域。 默认为全帧。 （“WxH”可能是
省略，区域大小默认为源帧的大小。）W 和
H 是宽度和高度。 X 和 Y 是锚点的偏移量。 “aa”是
锚点模式（默认：TL）； 有关详细信息，请参阅“区域几何注意事项”。
示例：活动=200x180+30+24cc

哑光=宽x高+X+Y
为源帧指定遮罩区域。 该区域外的所有像素
被设置为源背景颜色。 默认遮罩是全帧。 （这
“WxH”可以省略，区域大小默认为源的大小
框架。）W 和 H 是宽度和高度。 X 和 Y 是锚点的偏移量
观点。 “aa”是锚点模式（默认：TL）； 参见“区域几何注意事项”
细节。
示例：哑光=200x180+30+24cc

背景=RGB：r，g，b
背景=YCBCR:y,cb,cr
背景=RGBA：r、g、b、a
背景=YCBCRA:y,cb,cr,a
设置源背景颜色。 源遮罩区域之外的像素是
设置为这种颜色。 可以将颜色指定为 R'G'B' 或 Y'CbCr 三元组。
例如，默认颜色为黑色，指定为“bg=YCBCR:16,128,128”或
“bg=RGB:0,0,0”。 'A' 版本将设置 alpha（透明度）值
颜色。 RGBA 的 alpha 范围是 [0,255]，YCBCRA 的 alpha 范围是 [16,235]。 默认的
是完全不透明的（RGBA 为 255，YCBCRA 为 235）。

范数=[NTSC制式|朋友|SECAM]
指定源流的“规范”。 这通常是从
流头。

冰点=[没有|TOP_FIRST|底部优先|TOP_ONLY|仅底部]
指定源流使用的隔行扫描。 无、TOP_FIRST 和
BOTTOM_FIRST 对应非隔行、顶场优先、底场-
第一的。 这些值通常是从流头中推断出来的； 指定它们
将覆盖流标头。
TOP_ONLY 和 BOTTOM_ONLY 指定只有每一帧的顶场或底场
应该使用； 另一个字段被丢弃。 这些选项只能与
一个隔行输入，并导致隔行流被视为
一半高度的渐进式流。 （这在创建
来自全尺寸隔行输入流的 VCD。）这两个特殊选项可以
仅当源是纯渐进流时才使用（而不是
YUV4MPEG2“混合模式”流）。

色度=[420JPEG|420MPEG2|420PALDV|444|422|411|单|444阿尔法]
指定源流中使用的色度子采样模式。 这个参数是
从流头推断，所以这个关键字几乎不应该在
源规范。 指定这个关键字的唯一有用的原因是
用另一种覆盖一种 4:2:0。 任何其他用途将导致处理
失败。

萨尔=编号：编号
萨尔=[NTSC制式|朋友|NTSC_宽屏|PAL_宽]
指定源流的样本纵横比。 该值可以是或
数字比率（例如“10:11”）或关键字之一，对应于
分别用于 601:4 或 3:16 显示器的 CCIR-9 值。 这个参数通常是
从流头推断。

-O 输出参数
指定目标/输出流的参数。 所有“-O”参数都是
按顺序计算，命令行上的后面参数将更早地覆盖
那些。 所有“-O”参数都在任何“-I”参数之后计算。

大小=宽x高
尺寸=SRC
将输出/目标帧大小设置为宽度 W 和高度 H（以像素为单位）。 使用
关键词 型钢 指定目标帧大小应与源帧匹配
大小。

活跃=宽x高+X+呀
指定目标帧的活动区域，其中的活动区域
源帧被缩放。 默认是完整的目标帧。 （“WxH”可能是
省略，区域大小默认为目标框的大小。）W和
H 是宽度和高度。 X 和 Y 是锚点的偏移量。 “aa”是
锚点模式（默认：TL）； 有关详细信息，请参阅“区域几何注意事项”。
示例：活动=200x180+30+24cc

背景=RGB：r，g，b
背景=YCBCR:y,cb,cr
背景=RGBA：r、g、b、a
背景=YCBCRA:y,cb,cr,a
设置目标背景颜色。 目标活动区域之外的像素是
设置为这种颜色。 可以将颜色指定为 R'G'B' 或 Y'CbCr 三元组。
例如，默认颜色为黑色，指定为“bg=YCBCR:16,128,128”或
“bg=RGB:0,0,0”。 'A' 版本将设置 alpha（透明度）值
颜色。 RGBA 的 alpha 范围是 [0,255]，YCBCRA 的 alpha 范围是 [16,235]。 默认的
是完全不透明的（RGBA 为 255，YCBCRA 为 235）。

冰点=[没有|TOP_FIRST|底部优先]
指定目标流使用的隔行扫描。 无、TOP_FIRST 和
BOTTOM_FIRST 对应非隔行、顶场优先、底场-
第一的。 默认是否匹配源流。
如果源和目标都隔行扫描，但使用不同的模式（即一种
是底部优先，另一个是顶部优先），然后 Y4MSCALER 将转换一种模式
通过删除第一个源字段到另一个。

色度=[420JPEG|420MPEG2|420PALDV|444|422|411|单|444阿尔法]
指定要在目标流中使用的色度子采样模式。 默认的
是匹配源模式。 有关更多信息，请参阅“关于色度模式和子采样的注意事项”
信息。

萨尔=编号：编号
萨尔=[型钢|NTSC制式|朋友|NTSC_宽屏|PAL_宽]
指定源流的样本纵横比。 该值可以是或
数字比率（例如“10:11”）或关键字之一，对应于
分别用于 601:4 或 3:16 显示器的 CCIR-9 值。 关键字 型钢 指定
目标 SAR 应与源匹配。

规模=N / A
比例尺=N / A
比例尺=N / A
设置缩放比例，作为分数； 例如，比例=1/2。 "scale=" 设置两者
X 和 Y 因子同时进行。 "Xscale=" 和 "Yscale=" 可用于设置它们
独立地。

推断=[PAD|CLIP|保留_X|保留_Y]
设置用于从活动区域和 SAR 推断缩放比例的模式。 这
关键字是互斥的。 默认为 PAD。

推断=[简化|精确]
设置上述启发式是否使用精确比率，或者是否允许
稍微调整活动区域以简化缩放比例。 关键词是
互斥。 默认值为简化。

align =[TL|TC|TR|CL|CC|CR|BL|BC|BR]
设置源活动区域和目标活动区域之间的对齐点。 这
关键字指定“左上”、“中上”、“右上”等指定的角
或来自源区域的点将被映射到目标中的同一点
地区; 和应用于活动区域的裁剪或填充将
保留此映射。 默认为CC，表示“center-center”，即源
和目标区域相互居中。 关键字是互斥的。
默认为 CC。 有关详细信息，请参阅“关于源和目标对齐的注意事项”。

预设=[VCD|CVD|SVCD|DVD|DVD_WIDE|DV|DV_WIDE|
SVCD_STILL_HI|SVCD_STILL_LO|VCD_STILL_HI|VCD_STILL_LO|
ATSC_720P|ATSC_1080I|ATSC_1080P]
对几种常见的输出格式使用预设的目标参数。 个人
可以通过遵循更多“-O”设置来覆盖参数。 这些关键词
是互斥的。 有关这些预设关键字的详细设置
暗示，请参阅“关于目标预设的说明”。

VCD - 352 宽 VCD，逐行

CVD - 352 宽（全高）ChinaVideoDisc

SVCD - 480 宽 SuperVCD

DVD - 720 宽 DVD

DVD_WIDE - 720 宽 DVD，变形像素

DV - 720 宽 DV（底场优先，4:1:1）

DV_WIDE - 720 宽 DV，变形像素

SVCD_STILL_HI - 高分辨率 SVCD 静止图像

SVCD_STILL_LO - 低分辨率 SVCD 静止图像

VCD_STILL_HI - 高分辨率 VCD 静止图像

VCD_STILL_LO - 低分辨率 SVCD 静止图像

ATSC_720P - ATSC 720p（逐行高清电视）

ATSC_1080I - ATSC 1080i（隔行高清电视）

ATSC_1080P - ATSC 1080p（高清电视）

-S 缩放参数
指定缩放引擎的参数。 所有“-S”参数都在
顺序，命令行上后面的参数将覆盖前面的参数。

模式=单声道
请求单色缩放。 源被视为单色及其色度
通道被忽略。 输出流的色度通道将归零为
产生灰度输出。

模式=LINESWITCH
请求换行。 有效地，每帧内的顶部和底部字段
将被交换。 这可能有助于处理混乱的畸形流
空间秩序。 此选项仅对交错流有效。

缩放器=定标器名称
使用特定的缩放引擎。 可用的引擎有：
'default' - Matto 的通用缩放器（默认）

选项=缩放选项
为所选的缩放引擎指定一个选项。 查看所有可用的
选项，请使用“选项=帮助”。

对于默认引擎，可用 缩放选项s 选择过滤器内核：

框 - 箱式过滤器

线性 - 线性插值

二次的 - 二次插值

立方体 - 三次插值，Mitchell-Netravali 样条

立方CR - 三次插值，Catmull-Rom 样条

立方B -三次插值，B样条

立方K4 - 键四阶立方

正弦：N - 带有 Lanczos 窗口的 sinc，N 个周期

要为 x 和 y 缩放方向独立选择内核，请使用两个内核
名称以逗号分隔，例如 选项=框，二次.

正弦：N 将提供最佳质量的结果（最少混叠），但速度最慢。
质量随着 N 值的增大而提高，处理时间也是如此。 立方体 is
在图形世界中通常被认为是三阶三次样条
平滑和混叠之间的最佳权衡。 框 产生最差的质量
结果（大多数混叠），但速度最快。 默认内核是 立方K4，这
具有更平坦的通带和更锐利的截止频率 立方体. （它需要相同的
计算能力为 罪过：4，但产生较少的振铃伪影。）

附注 ON TARGET PRESETS

下表详细说明了各种目标“预设=”提供的设置
关键词。 当给出两个值时，主要用于 NTSC 流； 中的值
{braces} 用于 PAL 流。 如果未指定隔行值，则从
源，否则需要指定的目标隔行扫描。

预设帧尺寸隔行 SAR 子采样
-------------------------------------------------- ---------------------
VCD 352x240{288} none 10:11{59:54} 4:2:0-JPEG
CVD 352x480{576} --- 20:11{59:27} 4:2:0-MPEG2
SVCD 480x480{576} --- 15:11{59:36} 4:2:0-MPEG2
DVD 720x480{576} --- 10:11{59:54} 4:2:0-MPEG2
DVD_WIDE 720x480{576} --- 40:33{118:81} 4:2:0-MPEG2
DV 720x480{576} bottom-first 10:11{59:54} 4:1:1
DV_WIDE 720x480{576} bottom-first 40:33{118:81} 4:1:1
SVCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-MPEG2
SVCD_STILL_LO 480x480{576} none 15:11{59:36} 4:2:0-MPEG2
VCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-JPEG
VCD_STILL_LO 352x240{288} none 10:11{59:54} 4:2:0-JPEG
ATSC_720p 1280x720 none 1:1 4:2:0-MPEG2
ATSC_1080i 1920x1080 (required) 1:1 4:2:0-MPEG2
ATSC_1080p 1920x1080 none 1:1 4:2:0-MPEG2

附注 ON 地区 几何

使用“WxH+X+Yaa”形式的几何字符串指定活动区域和遮罩区域。
“WxH”部分指定区域的大小，以像素为单位的宽度和高度。 （在
某些情况下，“WxH”可能会被省略，区域大小默认为全帧
大小。）“+X+Y”指定区域的位置，作为相对于
由“aa”指定的锚点。

“aa”代码可以是以下之一 TL, TC, TR, CL, CC, CR, BL, BC或 BR. 这些代表“顶级-
left", "top-center", ..., "bottom-center", "bottom-right"。这些代码不是大小写-
敏感。

“+X+Y”指定区域锚点与帧锚点的偏移量
观点。 例如，“+20+30TL”表示区域的左上角将是
从框架的左上角向右偏移 20 像素，向下偏移 30 像素。

偏移值也可以为负。 例如，“-4+0CC”表示中心
（垂直和水平）区域的中心向左偏移 4 个像素
框架。

几何字符串的默认锚点是 TL，即左上角。

附注 ON 源 AND TARGET 对准

通常，源活动区域和目标活动区域不完全匹配。 这发生在，
使用给定或计算的缩放比例，源区域缩放到不同的大小
或形状比目标区域。 在这种情况下，源区域和目标区域是相互的
剪裁，以便只有适合的源部分才会被缩放到目标中。

在进行任何裁剪或填充之前，源区域和目标区域会对齐，以便
通过“align=aa”参数指定的点重合。 “aa”代码指定一个锚点
点如上所述。

例如，“align=BC”指定源区域的底部中心应该得到
映射到目标区域的底部中心。 换句话说，源区将
水平居中，垂直对齐目标区域的底部之前
剪裁：

- - - - - - - - 来源
|abcdefghijklmn|
---|opqrstuvwxyz01|--- 目标 ----------------
| |234567890ABCDE| | |234567890ABCDE|
| |FGHIJKLMNOPQRS| | |FGHIJKLMNOPQRS|
| |TUVWXYZabcdefg| | |TUVWXYZabcdefg|
---------------------------------- ----------------
相互剪裁前

如果改为“align=TR”居中，则源将被剪裁在不同的位置，并且
缩放到目标帧的不同区域：

---------------------------------- ----------------
| |abcdefghijklmn| |abcdefghijklmn|
| |opqrstuvwxyz01| |opqrstuvwxyz01|
| |234567890ABCDE| |234567890ABCDE|
------|FGHIJKLMNOPQRS| ------------------
目标 |TUVWXYZabcdefg| 来源
----------------
相互剪裁前

默认对齐方式为“CC”，即源和目标相互居中。

附注 ON 规模 因子 推理

如果未明确提供 X 和 Y 缩放因子， Y4MSCALER 将推断
源和目标活动区域和样本纵横比 (SAR) 的因素。

如果活动区域在形状上不兼容（给定 SAR），则源和
目标区域将根据四种策略之一进行裁剪或填充。 政策是
使用“infer=”参数和关键字之一选择 PAD, CLIP, 保留_X或
保留_Y. （默认为 PAD.)

PAD
选择将填充源的缩放因子，但确保所有源
图像内容最终出现在目标中。

CLIP
选择将剪切源但将填充目标的缩放因子
区域尽可能。

保留_X
选择保留尽可能多的水平源内容的缩放因子
可能。

保留_Y
选择保留尽可能多的垂直源内容的缩放因子
可能。

该政策还受到其他两个关键字选择的影响， 简化或 精确.
（默认为 简化.)

精确
计算精确的比例因子。

简化
调整活动区域和缩放因子（在 10% 左右），以简化
比例尽可能。 （例如，稍微裁剪或填充以达到比例
2/1 而不是 45/22。）

附注 ON 色度 模式 AND 二次抽样

Y4MSCALER 可以将流从一种色度子采样模式转换为另一种。 这样的
转换总是有损操作，即使整个帧正在经历 1/1
缩放。

Y4MSCALER 将从输入流标头中的标签推断源的子采样模式。
目标预设（“preset=XXX”）将尝试设置目标二次采样模式
适当地。 否则，默认情况下目标子采样模式将匹配源。
可以通过使用
“色度=”参数。

Y4MSCALER 能够读取和写入 4:4:4、4:2:2、4:1:1 和 4:2:0 中的流
（所有三个品种）子采样模式。 然而，前三个是一个相对较新的
除了 YUV4MPEG2 标准之外，许多 MJPEGtools 将无法处理它们
正确，如果有的话。 smil2yuv 和 raw2yuv 可以从 NTSC DV 生成原生 4:1:1 流
视频，然后可以通过以下方式将其转换为 4:2:0 Y4MSCALER 在进一步处理之前
其他工具。

如果源有 alpha 通道（即 444ALPHA 模式）而目标没有，则 alpha
频道将被简单地丢弃。 另一方面，如果目标有一个 alpha 通道
但源没有，将使用的 alpha 值创建一个恒定的 alpha 通道
目标的背景颜色（由“-O bg=”设置）。 默认是完全不透明的。

类似地，如果目标有色度通道而源没有（即只有亮度的
MONO 流），则输出中的色度通道将根据
背景颜色。

附注 ON 异常 交错 混合物

YUV4MPEG2 格式允许“混合模式隔行”流，其中可能包含
逐行和隔行帧的混合。 每个帧都被标记为时间
隔行或逐行，以及垂直二次采样的帧（4:2:0 格式）更进一步
标记为空间交错与否。 不幸的是，这允许
异常的 帧，碰巧在时间上交错（以不同的方式采样的场）
次）但在空间上是渐进的（在整个帧中执行子采样），或者反之
反之。 对这种异常帧唯一合理的做法是垂直——
对色度进行上采样，基本上使问题尽快消失。

Y4MSCALER 如果目标输出格式是非垂直的，则只会处理此类帧-
子采样（例如 4:4:4、4:2:2 等）并且不需要其他垂直处理。
否则 Y4MSCALER 遇到异常时将在中游处理
框架。 如果有任何可能遇到此类错误， Y4MSCALER 将打印一个
处理开始时发出警告。

退出 状态

0 程序执行成功。

1 用法、语法或操作错误。

使用 onworks.net 服务在线使用 y4mscaler