adjust_hue¶
- torchvision.transforms.functional.adjust_hue(img: Tensor, hue_factor: float) Tensor [源代码]¶
调整图像的色相。
通过将图像转换为 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 图像或张量