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