User Guide

ToPixel User Guide

Welcome to ToPixel! This guide will help you understand each feature and how to use it.

01

1. Pixel Converter

The Pixel Converter turns your uploaded images into pixel art.

How to Use

**Step 1: Upload an Image**

  • Open the "Pixel Converter" page
  • Upload an image using any of these methods:
  • Click the "Choose File" button to select from your device
  • Drag and drop an image onto the upload area
  • Press Ctrl+V to paste an image from your clipboard
  • Supported formats: PNG, JPEG, WebP, up to 10MB

**Step 2: Crop the Image**

  • After uploading, a crop dialog appears automatically
  • Drag the crop box to move it, or drag the corner and edge handles to resize it
  • Quick actions:
  • "Full Image"select the entire image
  • "Center Square"automatically select a square from the center
  • Click "Confirm" when done, or confirm without cropping to use the full image

**Step 3: Automatic Pixelation**

  • After confirming the crop, pixelation starts automaticallyno manual action needed
  • A loading animation appears during processing
  • If a yellow banner appears at the top, the processing engine is still loadingplease wait

**Step 4: Adjust the Result**

Use the settings panel on the right to fine-tune:

  • **Settings** tab:
  • Uniform Gridcontrol whether pixel grids are uniform
  • Lock Output Long Edgeenable to set a specific long-edge pixel count (2–256px)
  • **Adjustments** tab:
  • Output Sizeslider to reduce the output size; fewer pixels means a smaller result
  • Palettechoose a color card to map image colors to the palette. Cards are grouped by brand (CoCo, DoDo, MARD, etc.) with different color counts available
  • Merge Color Limitappears after selecting a palette; control the maximum number of colors used
  • **Colors** tab:
  • See how many colors and total pixels are in the result
  • View each color's swatch, palette number, and usage count

**Step 5: Preview and Export**

  • Toggle between "pixel result" and "original image" using the top-left button on the preview
  • Toggle the pixel grid overlay with the top-right button
  • Click the preview image itself to zoom in and see details

Export options:

  • **Download PNG**click the download button at the bottom-right of the preview, crop the area, then download
  • **Export Blueprint**requires a selected palette. Generate a reference blueprint with grid, coordinates, color numbers, and usage statistics. Supports 2K/4K/8K resolution
  • **Save to Gallery**click the bookmark button at the bottom-left of the preview to save the work (requires login and paid subscription)
  • **Import to Editor**send the result to the pixel editor for further editing (requires a selected palette)

**Step 6: Redo**

  • Click "Reprocess" at the bottom to run pixelation again with updated settings
  • You can also drag a new image onto the drop zone above the result to replace the current image
02

2. AI Pixel Converter

The AI Pixel Converter first uses AI to restyle your image, then automatically converts it to pixel art.

How to Use

**Step 1: Choose a Style Template**

  • Open the "AI Pixel Converter" page
  • Three AI style templates are displayedclick to choose:
  • Chibi Cartooncute big-head style with coarser pixels
  • Detailed Cartoonmore refined anime-style artwork
  • Chibi Pixel Acute style with thick pixel outlines

**Step 2: Upload a Source Image**

  • Same upload methods as the Pixel Converter: click, drag-and-drop, or paste
  • You can crop the image in the preview area after uploading
  • Supported formats: PNG, JPEG, WebP, up to 10MB

**Step 3: Start AI Generation**

  • With your image and style selected, click "Start AI Generation"
  • Each generation costs 1 credityour available credits are shown next to the button
  • AI processing usually takes a few seconds to a minuteplease wait
  • If you don't have enough credits or access, a prompt will guide you

**Step 4: Review the AI Result**

  • After AI generation completes, pixelation runs automatically
  • You can crop the AI result and click "Re-pixelate" to reprocess using the cropped area
  • You can also download the raw AI-generated image via the download button in the AI result area

**Step 5: Adjust and Export**

After pixelation, the options are the same as the Pixel Converter:

  • Select a palette, adjust output size, review color statistics
  • Download PNG, export blueprint, save to gallery, or import to editor

**History**

  • A history panel on the right (drawer panel on mobile) records all your previous AI conversion results
  • Click any history entry to restore that state and continue working
  • You can delete individual entries or clear all history
03

3. Pixel Editor

The Pixel Editor is a full-featured online pixel art editor. You can create pixel art from scratch or import results from the converters for refinement.

Creating a Canvas

  • Click "New Canvas"
  • Choose from 10 preset sizes (32×32 to 160×160), or check "Custom" to enter any size (8–256px)
  • If you have unsaved changes, you'll be asked to confirm before creating a new canvas

Drawing Tools

The editor provides 10 drawing tools with keyboard shortcuts:

ToolShortcutPurpose
PencilPDraw pixels or continuous lines; adjustable brush size (1–50px)
EraserEErase pixels to transparent; adjustable size
FillFClick an area to flood-fill all similar-colored adjacent pixels
Color PickerAltClick a pixel to set its color as the current color
Replace ColorRClick a color to replace all similar colors on the layer with the current color
Clear ColorClick a color to erase all pixels of that color from the layer
Rect SelectDrag to create a rectangular selection
Magic WandClick to auto-select similar-colored areas
Move ImageDrag to move content on the current layer
Move CanvasDrag to pan and browse the canvas

Color System

  • **Palette Selection**choose a color card to display all its colors in the palette panel
  • **Palette Panel**shows all colors of the selected card; click to use a color
  • **Used Colors**lists colors actually used on the canvas, sorted by usage. You can pick a color, delete a color, or highlight where it appears on the canvas
  • **Custom Colors**use the system color picker or enter a HEX value manually
  • **Quick Colors**20 preset colors available at the bottom

Layer Management

The layer panel displays all layers — the top layer renders on top:

  • **Add Layer**click the "+" button
  • **Switch Layer**click a layer to make it the active editing layer
  • **Show/Hide**click the eye icon to toggle visibility
  • **Lock Layer**locked layers are protected from editing
  • **Rename**click the pencil icon to edit the layer name
  • **Reorder**move layers up or down in the stack
  • **Delete**remove a layer (at least one must remain)

Symmetry Drawing

Choose a symmetry mode from the toolbar on the right:

  • Nonenormal drawing
  • Horizontalmirror along the vertical center line; one stroke draws left and right
  • Verticalmirror along the horizontal center line
  • Quadboth horizontal and vertical mirroring; one stroke draws in four positions

Selection Tools

Five selection tools are available:

  • **Rectangular**drag to create a rectangular selection
  • **Elliptical**drag to create an elliptical selection
  • **Magic Wand**click to auto-select a similar-colored region
  • **Lasso**freehand draw an irregular selection
  • **Polygon**click point by point to build a polygon selection

After making a selection you can:

  • Delete pixels inside the selection
  • Move the selection itself or the pixels within it
  • View selection info: pixel count and center color

Crop

  • **Layer Crop**crop only the active layer's content
  • **Canvas Crop**resize the entire canvas, affecting all layers
  • Drag to define the crop area and use handles to adjust

Display Controls

The status bar at the bottom provides:

  • **Grid**overlay pixel grid lines on the canvas
  • **Axis**show row/column numbers on the edges
  • **Color Numbers**display palette color numbers inside each pixel
  • **Zoom**use buttons or scroll wheel to zoom; pinch to zoom on mobile
  • **Coordinates**real-time display of cursor position on the canvas

Undo and Redo

  • History is saved automatically after each action, up to 50 undo steps
  • Undo and redo buttons are in the toolbar

Draft Saving

  • Click the "Draft" button to save your current editing state
  • The draft list shows each draft's thumbnail, name, save time, canvas size, and layer count
  • You can rename, delete, or clear all drafts
  • A red dot appears on the draft button when there are unsaved changes
  • Saving drafts requires login with a verified email

Blueprint Export

Generate a reference image for physical crafting:

  • **Resolution**2K, 4K, 8K, or custom (1024–16384px)
  • **Blueprint Options**:
  • Show Gridoverlay pixel grid lines
  • Show Coordinateslabel rows and columns on the edges
  • Show Color Numbersdisplay palette color numbers in each pixel cell (requires palette)
  • Show Color Statisticsdisplay color usage counts and percentages (requires palette)
  • Mirror Exportexport a horizontally flipped version
  • **Image-Only Mode**export just the pixel art without annotations; optional white or gradient background
  • Free-tier users are limited to 2K resolution with a watermark
  • Preview output size, zoom factor, and estimated file size before exporting

Importing from Converters

  • Click "Convert" in the editor to open the workbench
  • The workbench has tabs for "Converter" and "AI Converter"
  • After converting in the workbench, choose "Import to Current Canvas" or "Import to New Canvas"
  • You can also click "Import to Editor" from the Pixel Converter or AI Pixel Converter pagesresults transfer automatically
04

4. Gallery

The Gallery lets you manage and browse all your saved pixel works.

Access Requirements

Using the Gallery requires login and a Lite or higher paid subscription.

Work Types

The Gallery contains three types:

  • **Pixel Art**works saved from the Pixel Converter
  • **AI Redraw**works saved from the AI Pixel Converter
  • **Blueprints**exported blueprint works

Browsing and Finding

  • **Search**type a keyword to search by title and description
  • **Type Filter**click "All", "Pixel Art", "AI Redraw", or "Blueprints" tabs to filter; each tab shows the count
  • **Sorting**choose "Newest First", "Oldest First", or "By Title" from the dropdown

Work Actions

  • **Preview**click a card to open the preview window with a large image and details (size, color count, palette, creation date, etc.)
  • **Download**hover over a card to reveal the download button at the top-right corner
  • **Delete**hover to reveal the delete button at the bottom-right; confirm to delete
  • **3D Preview**pixel art works support 3D preview with beaded or ironed effects; rotate and zoom to inspect

Batch Operations

  • Click "Select" next to the filter bar to enter batch selection mode
  • Select all, invert selection, batch download, or batch delete
  • The toolbar shows how many items are selected

Empty State

If your gallery is empty, quick-action buttons guide you to the Pixel Converter or AI Pixel Converter to create your first work.

05

5. Redeem Codes

Redeem codes grant free credits and Lite subscription benefits.

What You Get

Each redeem code provides:

  • **Permanent Credits**never expire (but require an active subscription to spend)
  • **Lite Subscription**a timed Lite subscription that unlocks features like Gallery

The result depends on your current account status:

  • If you're a Pro useryou receive credits only; your subscription is unchanged
  • If you're a Lite useryou receive credits and your Lite subscription is extended
  • If you have no subscriptionyou receive credits and a new Lite subscription is activated

How to Get Redeem Codes

  • Click "Get Redeem Code" in your profile page to visit the code distribution page
  • Codes are distributed through official events and channels

Method 1: Quick Redeem (No Login Needed)

Best for new users without an account:

1

Open the "Quick Redeem" page (/quick-redeem)

2

Enter the redeem code

3

Complete the image captcha (type the characters shown)

4

Submit

5

On success, the system creates an account for you and displays the generated username and passwordsave these carefully

6

Auto sign-in is attempted; once logged in, you can jump directly to any tool

7

We recommend binding a real email address in your profile as soon as possible

Method 2: Profile Redeem (Login Required)

For users who already have an account:

1

Log in and go to your profile

2

Find the "Redeem Code" section in the sidebar

3

Enter the code and click "Redeem"

4

On success, you'll see how many credits you received and your subscription end date

Notes:

  • Email verification must be completed before redeeming
  • Each code can only be used once
  • Expired or already-used codes cannot be redeemed again