torchvision.transforms.functional.posterize(img: torch.Tensor, bits: int)torch.Tensor[source]

Posterize an image by reducing the number of bits for each color channel.

  • img (PIL Image or Tensor) – Image to have its colors posterized. If img is torch Tensor, it should be of type torch.uint8 and it is expected to be in […, 1 or 3, H, W] format, where … means it can have an arbitrary number of leading dimensions. If img is PIL Image, it is expected to be in mode “L” or “RGB”.

  • bits (int) – The number of bits to keep for each channel (0-8).


Posterized image.

Return type

PIL Image or Tensor

Examples using posterize:

Illustration of transforms

Illustration of transforms

Illustration of transforms


Access comprehensive developer documentation for PyTorch

View Docs


Get in-depth tutorials for beginners and advanced developers

View Tutorials


Find development resources and get your questions answered

View Resources