Working with Images

Add images to your diagrams to include logos, screenshots, icons, and other visual content.

Adding Images

Drag and Drop

The easiest way to add an image:

Locate the image file in Finder
Drag it directly onto the canvas
The image appears where you drop it

To add images via the menu:

Go to File → Import...
Select your image file
Click Open

Supported Formats

Diagrammix3 supports common image formats:

PNG: Best for screenshots and images with transparency
JPEG/JPG: Good for photographs
GIF: Static or animated images
TIFF: High-quality images
HEIC: Apple's high-efficiency format
WebP: Modern web format

Resizing Images

After adding an image, you can resize it:

Select the image
Drag any corner or edge handle
Hold Shift while dragging to maintain aspect ratio

Precise Sizing

For exact dimensions:

Select the image
Open the Inspector Panel
Enter specific width and height values in the Geometry section

Aspect Ratio

Maintaining Proportions

To keep the image from being distorted:

Hold Shift while resizing with handles
Enable Lock Aspect Ratio in the Inspector

Fitting to Size

The Inspector offers fitting options:

Fill: Image fills the entire frame
Fit: Image fits within the frame without cropping
Stretch: Image stretches to match frame dimensions

Image Opacity

Make images semi-transparent to layer them with other content:

Select the image
In the Inspector Panel, find the Opacity slider
Adjust from 0% (invisible) to 100% (fully opaque)

Cropping Images

To crop an image:

Double-click the image to enter edit mode
Drag the crop handles to adjust the visible area
Click outside the image to confirm

Image as Shape Fill

You can use an image as a fill pattern for shapes:

Select a shape
In the Inspector, click the fill color
Choose Image Fill
Select your image file

Tips

Optimize file sizes: Large images can slow down your document
Use PNG for diagrams: PNG preserves crisp lines and text
Consider SVG: For logos and icons, SVG provides better quality at any size (see SVG Support)