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 Image 或 Tensor
