adjust_hue¶
- torchvision.transforms.functional.adjust_hue(img: Tensor, hue_factor: float) Tensor [source]¶
调整图像的色调。
通过将图像转换为 HSV 并在色调通道 (H) 中循环移动强度来调整图像色调。然后将图像转换回原始图像模式。
hue_factor 是 H 通道中的位移量,并且必须在区间 [-0.5, 0.5] 内。
有关更多详细信息,请参阅 色调。
- 参数:
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 图像或 Tensor