adjust_hue¶
- torchvision.transforms.functional.adjust_hue(img: Tensor, hue_factor: float) Tensor [source]¶
调整图像的色相。
通过将图像转换为 HSV 并对色相通道(H)中的强度进行循环移位来调整图像的色相。然后将图像转换回原始图像模式。
hue_factor 是 H 通道中的移位量,必须在 [-0.5, 0.5] 区间内。
更多详细信息请参见 Hue。
- 参数:
img (PIL Image 或 Tensor) – 要调整的图像。如果 img 是 torch Tensor,则期望其格式为 […, 1 或 3, H, W],其中 … 表示它可以有任意数量的前导维度。如果 img 是 PIL Image 模式“1”、“I”、“F”以及带透明度的模式(alpha 通道),则不支持。注意:输入图像的像素值在转换为 HSV 空间之前必须是非负的;因此,如果您将图像归一化到包含负值的区间,或在使用此函数之前使用生成负值的插值,则此函数将无法工作。
hue_factor (float) – 色相通道的移位量。应在 [-0.5, 0.5] 之间。0.5 和 -0.5 分别表示在 HSV 空间中正向和负向的色相通道完全反转。0 表示不移位。因此,-0.5 和 0.5 都将产生具有互补颜色的图像,而 0 表示原始图像。
- 返回:
色相调整后的图像。
- 返回类型:
PIL 图像或张量