PixWrap – User Guide

Offline Product Mockup & Wrap Generator

PixWrap is an offline desktop application designed to:

  • create professional product mockups
  • generate print-ready wrap files
  • work with products such as:
    • Tumbler
    • Mug
    • Mousepad
    • T-Shirt
    • and other templates

PixWrap works fully offline.
All files are stored locally on your computer (AppData).

2️⃣ Application Layout Overview

When you open PixWrap, you will see:

🔹 Left Panel – Controls

  • Upload – upload your design
  • Products – select a product template
  • Backgrounds – choose a background
  • Adjustments – sliders controls scale, offset, opacity

🔹 Right Panel – Preview

  • Displays the live mockup preview
  • Updates instantly when you make changes

3️⃣ Upload Tab – Upload Your Design

📌 How to use:

  1. Open the Upload tab
  2. Click Upload Image
  3. Select an image file:
    • PNG
    • JPG

📌 Recommendations:

  • Square designs – ideal for tumblers
  • Horizontal designs – mugs, mousepads
  • Vertical designs – banners or tall layouts

📁 The uploaded image:

  • is used as the wrap
  • is never modified
  • stays in memory unless exported

4️⃣ Products Tab – Select a Product

📌 How it works:

  1. Open a Products tab and select product:
    • Tumbler 20oz
    • Mug
    • Mousepad
    • T-Shirt
  2. PixWrap application automatically:
    • loads the mockup image
    • loads inner & outer masks
    • prepares the wrap area

📁 Product file structure:

AppData/Local/PixWrap/products/
│
├── tumbler_20oz/
│   ├── mockup.png
│   ├── inner_mask.png
│   ├── outer_mask.png
│   ├── wrap_area.json
│   └── product.json

5️⃣ Backgrounds Tab – Choose a Background

📌 How to use:

  1. Open the Backgrounds tab
  2. Click a background thumbnail
  3. The mockup updates automatically

📌 Remove background:

  • The first option is always:
    No Background
  • Selecting it removes the applied background

📁 Background folder:

AppData/Local/PixWrap/backgrounds/<product_slug>/

6️⃣ Adjustments Tab – Sliders Tab, Scale & Position Controls

🎚️ Scale

  • Scales only the wrap image
  • Mockup and background remain unchanged

🎚️ Offset X / Offset Y

  • Moves the wrap:
    • left / right
    • up / down

🎚️ Opacity

  • Adjusts wrap transparency

🔁 Reset

  • Resets all sliders to default values

7️⃣ How Mockup Generation Works (Internal Logic)

🔄 Rendering order:

  1. Load wrap image
  2. Load background (if selected)
  3. Draw mockup base
  4. Apply wrap:
    • keep original proportions
    • apply scale and offsets
  5. Mask wrap using:
    • inner mask
    • outer mask
  6. Draw top mockup layer

This ensures realistic depth and clean edges.

8️⃣ Exporting Files

📤 Export Mockup

  • Exports exactly what you see in preview
  • Includes background
  • PNG format

📤 Export Wrap

  • Generates print-ready wrap
  • No mockup layers
  • Resolution depends on product

📌 Example:

Tumbler 20oz

  • 2790 × 2460 px
  • 300 DPI
  • Includes scale & offset adjustments

9️⃣ Template Import & Deletion

📥 Import Template

  • Menu → Templates → Import Template
  • .zip file
  • Automatically:
    • extracts template
    • validates structure
    • adds product to Products tab

🗑️ Delete Template

  • Choose product from list
  • Removes:
    • product files
    • backgrounds
    • configuration data

🔐 Demo & License System

  • Demo version product templates
    • visible “DEMO” watermark
    • export with no limitations
  • Full version product templates
    • activated via internal validation
    • license stored locally in templates

10️⃣ Creating a New Product Template

✔ Required files:

  • mockup.png
  • inner_mask.png
  • outer_mask.png
  • product.json

✔ Optional:

  • backgrounds/
  • preview.png

11️⃣ Tips for Best Results

✔ Use PNG files with transparency
✔ Avoid excessive scaling
✔ Test multiple backgrounds
✔ Export wraps separately for printing

🏁 Summary

PixWrap allows you to:

  • quickly create professional mockups
  • precisely control wrap placement
  • work fully offline
  • extend the app using templates