Java BufferedImage: deterministic raster output without a window

This program targets Java 8 without preview flags. Use a full JDK for compiler-based examples.

Pixel checks are narrower than screenshots

A receipt preview can be generated on a server where no display is available. The program creates a small ARGB image and paints a solid status area. It tests exact pixels in that rectangle rather than relying on a screenshot tool or a font installed on the machine.

Text rendering has extra dependencies: font choice, metrics, antialiasing and platform rasterization can change its pixels. This program deliberately contains no text, so its acceptance check establishes geometry and color only. A production receipt renderer needs a separate layout and text test.

Release the drawing context

Graphics2D holds rendering state and must be disposed after the painting operation. The image stays usable after disposal; disposing the context does not erase its pixels. A try/finally block keeps that lifecycle clear when drawing fails.

The program writes a PNG to memory, decodes it and checks both a painted pixel and an untouched transparent pixel. It rejects a missing encoder or failed decode rather than treating an empty byte array as a successful image. The fixture encodes its own image; it does not parse an unbounded user upload.

Working program

import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import javax.imageio.ImageIO;
public class ReceiptStatusRaster {
    public static void main(String[] args) throws Exception {
        BufferedImage image = new BufferedImage(40, 20, BufferedImage.TYPE_INT_ARGB);
        Graphics2D paint = image.createGraphics();
        try { paint.setColor(new Color(20, 70, 100)); paint.fillRect(4, 3, 8, 6); }
        finally { paint.dispose(); }
        ByteArrayOutputStream bytes = new ByteArrayOutputStream();
        if (!ImageIO.write(image, "png", bytes)) throw new IllegalStateException("Missing PNG encoder");
        BufferedImage restored = ImageIO.read(new ByteArrayInputStream(bytes.toByteArray()));
        if (restored == null) throw new IllegalStateException("PNG decode failed");
        System.out.println(restored.getWidth()+"x"+restored.getHeight());
        System.out.println(restored.getRGB(4, 3) == new Color(20, 70, 100).getRGB());
        System.out.println(restored.getRGB(0, 0) == 0);
    }
}

Output

40x20
true
true

Costs and boundaries

An ARGB raster needs storage proportional to width times height, with additional encoder buffers. Validate dimensions before multiplication and allocation when dimensions come from outside the application. Compressed file size is not a reliable bound on decoded memory. This example owns only an 800-pixel image and does not establish upload safety or typography fidelity.

Common Mistakes

Dispose every created Graphics2D context.
Do not infer decoded memory size from compressed byte count.
Pixel assertions for flat geometry do not verify text layout across platforms.