Shortcuts

调整色调

torchvision.transforms.functional.adjust_hue(img: Tensor, hue_factor: float) Tensor[source]

调整图像的色调。

图像的色调通过将图像转换为HSV并循环移动色调通道(H)中的强度来调整。然后图像被转换回原始图像模式。

hue_factor 是 H 通道的偏移量,必须在 [-0.5, 0.5] 区间内。

查看 Hue 了解更多详情。

Parameters:
  • img (PIL ImageTensor) – 需要调整的图像。 如果 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 则生成原始图像。

Returns:

色调调整后的图像。

Return type:

PIL 图像或张量