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

---