PrintEx Documentation

Prepare UV printer artwork by placing an imported image inside a known blank template, then exporting a correctly sized raster file at print resolution.

Quick Start

  1. Open PrintEx.
  2. Click Import Image or drag an image into the window.
  3. Choose the template that matches the blank you are printing.
  4. Move and resize the image inside the template preview.
  5. Choose the output resolution.
  6. Open Settings if you need registration marks, stained-glass layers, or a reverse image.
  7. Click Export.
  8. Drop the prepared image into eufyMake Studio.

For store listing graphics, choose one of the Store Sample templates instead of a print blank template, then import or drop in a product photo.

Main Window

The toolbar contains the common workflow controls.

ControlWhat it does
Import ImageOpens a supported raster image.
GridSwitches between inches and millimeters.
TemplateSelects the blank shape and size.
OutputSelects the export DPI.
Settings buttonOpens export options.
Fill rectangle buttonFits the image to the template.
Center-in-rectangle buttonCenters the image in the template.
Rotate buttonsTurn the image 90 degrees left or right.
Store Sample object controlsShow the detected object size and shape, then fit or center the detected object.
ExportWrites the final image file.
Camera buttonSaves a PNG snapshot of the current PrintEx window.

The window title includes the app version when version.json is available in the app bundle.

Supported Image Files

PrintEx can import common raster formats:

.png, .jpg, .jpeg, .bmp, .gif, .webp, .tif, .tiff

Export Resolution

  • Standard - 600 DPI for normal output.
  • Enhanced - 1200 DPI when the printer, ink, and blank benefit from extra detail.

Settings

The Settings dialog contains optional export features.

SettingWhat it does
Registration marksAdds a 1-pixel black alignment outline outside the template border.
MarginControls the registration mark distance from the template edge. The value is always in millimeters.
Stained GlassExports an additional shadow layer named <export name>_shadow.png. The shadow layer represents the lead lines, came lines, black leading, leading strips, whatever you want to call them.
Create Ripple LayerAvailable when Stained Glass is enabled. Exports <export name>_ripple.png, the colored glass polygons without the came lines.
Ripple as Bump MapAvailable when Create Ripple Layer is enabled. Exports <export name>_map.png, a bump-map layer generated from the ripple layer.
Create Reverse ImageExports an additional horizontally flipped image named <export name>_reverse.png. This is useful for printing the other side of a stained glass image.

The normal export is always written. Optional files are saved next to the normal export.

Registration Marks

When enabled, PrintEx adds outer registration marks outside the template border. These marks are intended for positioning and alignment and are outside the printable blank area.

The Margin setting controls how far the mark is from the template edge. It is shown and saved in millimeters, regardless of whether the main grid is set to inches or millimeters. Registration marks are drawn as a single black pixel so they are visible without using unnecessary ink.

When stained-glass, ripple, bump-map, or reverse layers are enabled, registration marks are included on those generated layers at the same location and width for easy consistent placement during layout.

Stained Glass

Stained Glass creates a shadow image for workflows that need a separate black layer for the lead lines, came lines, black leading, leading strips, whatever you want to call them. Near-black pixels from the final export become fully black pixels in the shadow image, and other pixels are transparent.

Create Ripple Layer creates a companion image containing the original non-transparent pixels that are not present in the shadow layer. This keeps the ripple layer and shadow layer from duplicating the same pixels. This will be printed first as white, to lay down lightness for the stained glass.

Ripple as Bump Map creates a grayscale height-map layer from the ripple layer. It uses a soft, irregular glass-ripple texture over the visible glass areas and emphasizes the edges of the ripple polygons so the bump map can give the printed surface more glass-like definition. This will be printed as Pattern Texture, Gloss Raised, 0.35 Thickness, Smoothness of 5.

Create Reverse Image creates a horizontally flipped copy of the final export for reverse-printing workflows. This is useful for printing the other side of a stained glass image.

If all stained-glass options are enabled, PrintEx writes the normal export plus shadow, ripple, bump-map, and reverse sidecar files.

Store Graphics

The Store Sample Square and Store Sample Landscape templates create product photos for PayHip or another online store. PayHip recommends a cover image width of at least 1000 pixels, so the square store template exports at 1000 x 1000 px in Standard mode and the landscape template exports at 1600 x 1000 px in Standard mode.

When a Store Sample template is selected, PrintEx detects the product in the imported photo and shows it with an orange rectangle. The left tool strip shows the detected object size at the selected output resolution and the detected shape name: circle, square, hexagon, or polygon.

  1. Select Store Sample Square - 1000 x 1000 px or Store Sample Landscape - 1600 x 1000 px.
  2. Import or drop in the product photo.
  3. Wait for the loading indicator in the left tool strip to finish.
  4. Check the orange detection rectangle. Drag its handles if the detected product edge needs correction.
  5. Use object Fit to resize the detected product to a consistent store-sample size.
  6. Use object Center to center the detected product on the template.
  7. Export the finished store graphic.

The regular image controls still work in Store Sample templates. Use the fill-rectangle button to fill the whole template with the image, the center-in-rectangle button to center the whole image, and the rotate buttons to turn the image 90 degrees.

Templates

Each template is described by a JSON file and usually has a matching PNG thumbnail or mask. Dimensions can be defined in inches or millimeters.

Coin - 40 mm

Coin - 40 mm template thumbnail
ShapeEllipse
Size40.0 x 40.0 mm
Printable inset1.5 mm
Amazon blankBlank Challenge Coin

Use this template for small round 40 mm coin-style blanks. The printable inset keeps artwork away from the outer edge.

Hexagon Coaster

Hexagon coaster template thumbnail
ShapeHexagon
Size111.0 x 98.0 mm
Printable inset7.0 mm
Amazon blankHexagonal Black Stone Coaster

Use this template for hexagon coaster blanks. The inset leaves a substantial margin from the cut edge.

License Plate - 302 x 152 mm

License plate template thumbnail
ShapeRounded rectangle
Size302.0 x 152.0 mm
Corner radius7.0 mm
SlotsFour mounting slots
Amazon blankBlack License Plate Blank

Use this template for standard license plate blanks with four mounting slots. Keep important artwork away from the slot areas.

Round Coaster - 4 in

Round coaster template thumbnail
Template filetemplates/round_coaster.json
Image filetemplates/round_coaster.png
ShapeEllipse
Size4.0 x 4.0 in
Amazon blankBlank Round 4 in Ceramic Coaster

Use this template for 4 inch round coaster blanks.

Round - 5 in

Round 5 in template thumbnail
Template filetemplates/round_5in.json
Image filetemplates/round_5in.png
ShapeEllipse
Size5.0 x 5.0 in
Printable inset0.0 in

Use this template for 5 inch round blanks with no built-in printable margin.

Square Coaster - 4 in

Square coaster template thumbnail
ShapeRectangle
Size4.0 x 4.0 in
Amazon blankBlank Square 4 in Ceramic Coaster

Use this template for 4 inch square coaster blanks.

Store Sample Square - 1000 x 1000 px

Store sample square template thumbnail
ShapeRectangle
Standard export size1000 x 1000 px
Enhanced export size2000 x 2000 px

Use this template for square product sample graphics on PayHip or another store. Uses object detection to ensure consistent object placement across items in your store.

Store Sample Landscape - 1600 x 1000 px

Store sample landscape template thumbnail
ShapeRectangle
Standard export size1600 x 1000 px
Enhanced export size3200 x 2000 px

Use this template for landscape product sample graphics on PayHip or another store. Uses object detection to ensure consistent object placement across items in your store.

Template JSON Reference

FieldPurpose
nameDisplay name in the template selector.
width_in, height_inTemplate dimensions in inches.
width_mm, height_mmTemplate dimensions in millimeters.
shapeellipse, hexagon, or rect.
imageOptional PNG image or mask filename.
corner_radius_in, corner_radius_mmRounded rectangle corner radius.
printable_inset_in, printable_inset_mmInset from the outer template edge.
holesCircular cutouts or mounting holes.
slotsRectangular or rounded mounting slots.

Slot by center point

{
  "x_mm": 67.0,
  "y_mm": 16.5,
  "width_mm": 30.0,
  "height_mm": 7.0
}

Slot by top-left edge offsets

{
  "left_mm": 52.0,
  "top_mm": 13.0,
  "width_mm": 30.0,
  "height_mm": 7.0
}

Troubleshooting

The image is the wrong size

Confirm the selected template matches the physical blank. Export size is based on the template dimensions and selected DPI.

The template thumbnail or mask is missing

Confirm the template JSON image field points to an existing PNG in templates/.

Download PrintEx