Mark Stephens Mark has been working with Java and PDF since 1999 and is a big NetBeans fan. He enjoys speaking at conferences. He has an MA in Medieval History and a passion for reading.

Understanding the PDF file Format – 3 types of Image Mask

1 min read

The PDF Mask features offer a whole set of functionality to allow complicated image drawing to happen. Rather than just sticking an image on the page (over-writing whatever was underneath), Masks allow sophisticated use of transparency so that the image can be blended into the page and colours or areas can be wholly of partly transparent.

The simplest form of Mask is an ImageMask. This is a one bit image where each pixel is either transparent (and you can see what is behind it) or painted in the current colour. It is rather like a stencil (which lets paint through the holes but stops paint appearing elsewhere).

An ImageMask is easy to create – it is a 1bit XObject image which has a value of /ImageMask set to true. They are limited to a single colour however. So you can also have a proper Mask for more control.

A Mask allows you to specify an image which can contain transparent elements. The Mask is an object attached to the XObject. You can either specify a range of colours (which will become transparent in the image) or add a separate bitmap which can define each pixel as transparent or visible (a bit like an ImageMask but offering more flexibility).

Most flexible of all, you can have a soft Mask (SMask object) attached to the image. This does not just switch transparency on or off but lets you control how much of the image shows through – allowing alsorts of transparency.

Masks are really powerful features – if you have not tried them before, they are well worth experimenting with. What do you use Masks for?

This post is part of our “Understanding the PDF File Format” series. In each article, we aim to take a specific PDF feature and explain it in simple terms. If you wish to learn more about PDF, we have 13 years worth of PDF knowledge and tips, so click here to visit our series index!

Did you know...

IDRsolutions offers a whole range of online file converters to convert PDF and Microsoft Excel, Word and Office Documents to HTML5, SVG or image formats?

It is free to use for single file conversions and also includes Developer links if you want to use our commercial software for bulk conversions. Find out more on this page

Mark Stephens Mark has been working with Java and PDF since 1999 and is a big NetBeans fan. He enjoys speaking at conferences. He has an MA in Medieval History and a passion for reading.

How to read HEIC image files in Java with…

In this article, I will explain how to read HEIC files into Java as a BufferedImage. ImageIO does not read HEIC file types so...
Mark Stephens
1 min read

How to convert WMF files to SVG in java…

This article will show you how to convert WMF files into SVG files using our JDeli Java Image library. What is WMF? WMF is...
Amy Pearson
1 min read

How to write WebP images in Java

In this article, I will walk you through how to write out images as WebP images in Java. ImageIO does not support WebP images...
Mark Stephens
1 min read

2 Replies to “Understanding the PDF file Format – 3 types of…”

  1. Dear Mr. Mark Stephens,
    Hello, I have many pdf files created from tiff files of scanned technical drawings which tiffs treat as what so-called an “Image Mask” in them when we analyze them with acrobat Preflight tool, now I want to know what an Image Mask is? How can I make a tiff treat as an Image Mask when it is converted to pdf in a simple way or with a tiny add-on or .exe software?
    Thanks and Regards,
    Omid Mansourbakht

  2. Image Masks are explained in the article. You do not really have control over what PDF features are used to create a PDF. It is down to the specific tool

Leave a Reply

Your email address will not be published. Required fields are marked *

IDRsolutions Ltd 2020. All rights reserved.