Documentation

From your first shape to your finished sprite on iPhone, Duo, iPad, and Mac. Updated for version 1.13.

Your first model

isopxl is a small 3D pixel-art editor for iPhone, iPad, and Mac. The workflow is simple: Model → Paint → Export. Your library starts with an editable bird so you can try the tools right away.

  1. Open the editable bird from your library to try the tools, or choose New project to start your own model.
  2. In Model, choose the Face, Point, or Object button. Then choose a face, point, or entire object accordingly, and choose a transformation button, such as Move, Rotate, or Scale.
  3. Switch to Paint to color the model’s surfaces.
  4. In Export, choose Fit or Relative sizing, open Camera to choose Isometric, Top-down, or Side-view, and check the views you want. Choose Export PNG, then choose a save destination, AirDrop, or another compatible share destination.

Projects save automatically. Choose Back to projects to return to the library.

Isopxl model workspace on iPhone
iPhone · Model workspace
Isopxl model workspace on iPad
iPad · Model workspace
Isopxl model workspace on Mac
Mac · Model workspace
Isopxl model workspace on Duo
Duo · Model workspace

Know your tools

These are the same pixel icons used in the app. Match the picture to the control on your screen. The examples below are a reference, not interactive buttons.

Select / pan
Select a face or point. With Select active, drag to pan the view.
Move
Move selected geometry along X, Y, or Z.
Rotate geometry
Rotate selected geometry around an axis. Orbit gestures are listed under Move around the model.
Scale
Resize your selection uniformly or along one axis.
Extrude
Extend a selected face to add geometry.
Freeform subdivide
Drag a cut between edges or corners of a selected face.
Split selected face
Divide a face around its center.
Grid
Show or hide the modeling grid.
Snap
Turn snapping on or off for the active modeling tool.
Undo
Undo the last edit in this session.
Redo
Redo an undone edit.
Flat face editor
In Paint, select a face first, then open its flat pixel canvas.
Align to export camera
Match the painting view to the sprite camera.
Main menu
On iPhone and iPad, find shapes, project export, the axis guide, and help here. On Mac, use the File, Model, View, and Help menus.
Export
Open the share sheet to save or send the selected output.

Model: faces, edges, points, and parts

The four selection modes let you work at different levels:

  • Faces: select one surface to move, rotate, scale, extrude, or subdivide.
  • Edges: select edges to move, rotate, scale, or bevel.
  • Points: select vertices to reshape the model. Choose X, Y, or Z to move them along an axis.
  • Parts: select an entire object, then move, rotate, scale, duplicate, or delete it.

Open Add shape in the main menu on iPhone or iPad, or Model → Add Shape on Mac for a cube, wedge, cylinder, cone, UV Sphere, or Icosphere. UV Sphere is the new name for Low Poly Sphere. It uses rings of faces; Icosphere uses triangular faces. Newly added shapes are selected so you can position them.

Plan your game assets with the grid

Use the modeling grid to keep assets in proportion: a character, doorway, and tree should share a scale if they will appear together in your game. The grid is a size guide for your model; its squares do not have a fixed pixel size. The starter cube covers 2 × 2 grid squares; a cube scaled to 50% covers 1 × 1.

For a set of game assets, choose Relative (px/tile) in Export and keep the same setting across projects. One export tile spans 2 × 2 grid squares, matching the starter cube’s footprint. With the Isometric camera, the relationship is:

Relative settingOne grid squareStarter cube footprint
16 px/tile8 × 4 px16 × 8 px
32 px/tile16 × 8 px32 × 16 px
64 px/tile32 × 16 px64 × 32 px

The numbers above describe each footprint after it is projected into the isometric view at 100% export scale. A grid square is not inherently 16 × 16 pixels. These are the widths and heights of the ground diamonds, not the full sprite image. For example, at 32 px/tile, a one-square footprint is 16 pixels wide and a two-square footprint is 32 pixels wide. A taller model extends above that footprint. Top-down shows the ground square without the isometric diamond shape.

Fewer pixels means simpler shapes. A small prop at a fixed Relative scale has fewer pixels to describe its silhouette: curves have larger visible steps, and thin features or tiny painted details may disappear. Start with a clear outline and larger color areas, then check the Export preview at the size you will use in your game. Choose a higher px/tile setting if the whole asset set needs more detail; changing only one asset’s setting changes its scale relative to the others.

For a standalone icon or sprite with a target size, choose Fit (max px), such as 16, 32, or 64 px. Fit resizes the model to that pixel budget, so making the entire model larger in the modeling grid does not add export detail. Increase the Fit size to give the shape more pixels. Export scale only enlarges existing pixels into crisp blocks; it does not restore fine detail.

Zooming the editor changes only your working view. With Snap enabled, four movement steps cover one grid square. Toggle Grid to show or hide the guide. See sprite export sizing for the export controls.

Move, rotate, and scale

Clicking empty space clears the selection while keeping Move, Rotate, or Scale and its axis ready for the next selection. Press F to fit the model view, or ⌘D to duplicate selected parts. These shortcuts are inactive while typing, transforming, or using the command palette.

Select something, choose a tool and axis, then drag its handle. Rotation uses a ring. Scale offers All for uniform resizing, plus X, Y, and Z for stretching. The + and − buttons also make adjustments. Rotation and scaling controls are disabled when they cannot affect the current selection.

Snap toggles snapping: movement uses quarter units, rotation uses 15° steps, and scaling uses 10% steps. Turn it off for free adjustments.

Extrude and subdivide

Select a face and use Extrude to extend it. Open Subdivide to choose Freeform, Loop Cut, or Auto. Freeform lets you drag a cut between edges or corners of a selected face; Auto divides selected faces around their centers. Painted textures stay attached as you edit.

Loop Cut

In Faces, Edges, Points, or Parts mode, choose Loop Cut from Subdivide. No selection is needed. Move the pointer over a face to preview a connected cut, then click to apply. On a touch screen, press and drag to preview, then release. Move toward another edge to change the cut direction. Snap places cuts at quarter-edge positions; turn it off for free placement.

The amber dashed preview shows the complete path, including hidden portions. Cuts follow opposite sides through four-sided faces, including sides with extra vertices along a straight edge. They can also continue across triangles and other polygons. On triangles, cuts can wrap around a pointed fan. On other polygons, the cut follows inward from the entry edge to the first boundary it reaches.

Open boundaries and existing vertices end the path. Some concave or nonplanar faces cannot produce a valid cut; a cut is offered only when the complete preview can be applied. Navigation cancels a pending touch cut. Applying a cut selects the resulting faces and preserves painted textures. Undo removes the whole cut in one step. Freeform and Auto subdivision are available in Faces mode.

Check model dimensions

In Model mode, choose Model Info… from the main menu or the Model menu on Mac. The popup shows the model’s size along the X, Y, and Z axes in grid units, plus its face and point counts.

Keep geometry simple

The face count gradually changes from ivory to amber and red as geometry grows. For ordinary four-sided faces, it reaches amber around 500 faces and red around 1,000. Other polygons can reach these colors at different counts. This is a low-poly budget guide, not a measured frame-rate warning or an editing limit. Use Undo to remove recent cuts, or Simplify to reduce selected parts.

Adjust the light

In Model mode, choose View → Show Light from the main menu or the Mac menu bar. Select the light in the viewport, then use Move and the axis controls to reposition it. Use the shadow strength slider to adjust the shadows, or choose Reset to restore the default light. The light position, shadow strength, and Show Light setting are saved with the project.

Work with whole shapes

Select Connected Part and Select Whole Model are in the main menu on iPhone or iPad, or the Model menu on Mac. Join Selected Shapes groups the selected shapes for selection; it does not perform a Boolean union or remove internal faces.

Select edges or points, then choose Bevel to adjust selected edges or corners. Undo and redo let you revisit changes during the current editing session. Selections are retained when undoing or redoing transforms and paint edits. Edits that change the model’s topology clear component selections.

Commands

In Model or Paint, open View → Commands… in the main menu on iPhone or iPad, or View → Command Palette… on Mac. With a keyboard, press ⌘K. Search for a command, then choose it; arrow keys and Return also navigate and apply commands. Press Escape or tap outside to close the list. Unavailable commands are dimmed.

In Model, Move to floor rests the selection on the ground. Resize… sets its longest dimension in physical paint pixels while preserving proportions; it does not set the exported PNG dimensions. Rotate X/Y/Z… accepts an exact angle. With Parts selected, Mirror X/Y/Z reflects parts in place, while Mirror Copy X/Y/Z creates reflected copies across the model origin. Align arranges two or more parts along an axis; Distribute — Equal gaps spaces three or more parts while keeping the end parts fixed.

Simplify selected parts

In Model, choose Parts and select the shapes to reduce. Open Commands, search for Simplify…, and choose a level from 1 to 4. The model previews the result before you apply it. Higher levels aim for greater reduction: about 10%, 25%, 40%, or 60% fewer surface triangles. The dialog shows the resulting face count and actual triangle reduction; face and triangle counts can change by different amounts.

Review the silhouette from different angles. Simplify can reshape surfaces, and it may stop short of the target to protect open edges, paint details, material boundaries, and valid geometry. Some already-simple or detailed painted models change little. Choose Apply to keep the preview, or Cancel to leave the model unchanged. An applied simplification is one Undo step.

In Paint, select a face before choosing Replace color… or Clear face. Replace color changes the current paint color on that face to a palette swatch or a typed RGB/RGBA hex color. Clear face restores its base color, like the eraser. Other faces stay unchanged. These edits support Undo and save automatically.

Paint: color in 3D or on a flat face

Choose Paint on model to paint directly on the model. On iPhone and iPad, draw with one finger or Apple Pencil on iPad; use two fingers to orbit and pinch to zoom. On Mac, draw with a primary-button drag; use a secondary-button drag or two-finger trackpad scroll to orbit. Painting can continue across face boundaries.

Pencil, Spray, Line, Circle, and Rectangle paint square surface pixels with the same physical size across the model, including narrow or sloping faces. A starter cube has 16 pixels along each edge. Zooming changes their size on screen; viewing a face at an angle makes its squares look foreshortened. Existing painted details are preserved.

The Draw button, marked with a small pixel corner, shows your last-used Pencil, Spray, Line, Circle, or Rectangle tool. When another tool or face selection is active, choose Draw once to resume that drawing tool. Choose Draw while it is active to open the Pencil, Spray, Line, Circle, and Rectangle menu. This works on the model and in the flat face editor.

  • Pencil: paint with the selected color.
  • Spray: hold or drag to build up scattered pixels in the selected color.
  • Line: drag from the first endpoint to the second.
  • Circle: drag from the center outward to set the radius of a circle outline.
  • Rectangle: drag between opposite corners to draw a rectangle outline.
  • Fill: fill a region on the face you touch.
  • Eraser: restore the opaque base color with a square eraser adjustable from 1–32 pixels; it does not cut holes in the model.
  • Picker: sample a color from the model.

Open the Draw menu and use − and + to set the drawing size from 1–32 pixels. Pencil and the shape tools share this size. With Spray selected, Size sets dot size independently, Width sets the circular spread from 4–32 pixels, and Speed sets 1–30 pulses per second. Release to stop spraying; Undo removes the whole stroke. On Mac, [ and ] decrease and increase the Pencil and shape brush size. A mouse or trackpad pointer previews the drawing footprint in the selected color, with a contrasting outline, over the surface before you paint.

The Eraser button has the same small pixel corner as Draw. Choose it once to select the eraser, then choose it again while selected to open the size popup. Use − and + to choose a size from 1–32 pixels, or hold either button to change it quickly. The size stays selected while editing. Adjustable erasing works on the model and in the flat face editor; Undo removes a whole stroke in one step.

On iPad, basic Apple Pencil input uses the same tap and drag controls as touch. There are no dedicated pressure, tilt, hover-preview, double-tap, or squeeze features.

Lines, circles, and rectangles preview while you drag and commit when you release. Undo removes the whole shape in one step. These tools work on the model and in the flat face editor. On the model, shapes project onto visible surfaces; in the flat editor, they stay within the face boundary.

For precise pixel work, choose Select a face, choose a face, then choose Open face pixel editor. The flat editor button becomes available after you select a face. The flat canvas shows the face at its true proportions, viewed from the outside, so left and right match the model. Paint within the outlined face, use the zoom controls, and pan with two fingers on iPhone or iPad or a two-finger trackpad scroll on Mac. The same tools and square grid work in both views.

Copy and paste face pixels

In the flat face editor, choose Rectangle selection and drag over the pixels you want. Open the Copy, Cut, Paste button’s popup and choose Copy or Cut. Choose Paste, then tap where you want the copied pixels or drag to position them and release to apply. You can select another face and paste there. Cut and Paste support Undo.

Choose + beside the color swatches to open the palette menu. Choose a built-in palette, a saved palette, or Project colors; choose Add color… to create a color or Manage palettes… to manage your saved palettes. Add or edit a color with the color square and hue slider, RGB fields, or a six-digit HEX value. Long-press a swatch to edit or remove it. Editing a built-in palette creates a personal copy.

The small sprite preview follows the export camera. Choose Align to export camera to align the paint view with it.

Isopxl paint workspace on iPhone
iPhone · Paint workspace
Isopxl paint workspace on iPad
iPad · Paint workspace
Isopxl paint workspace on Mac
Mac · Paint workspace
Isopxl paint workspace on Duo
Duo · Paint workspace

Import Lospec palettes

Visit Lospec’s palette list in your browser, choose a palette, and choose Open in app. Isopxl downloads the colors into My palettes and selects the palette for your open model.

If no model is open, the palette is saved in My palettes for you to choose later. Opening the same named palette with identical colors reuses the saved copy. Regular PNG and HEX file downloads are not imported through this integration. Downloading a palette requires an internet connection.

Export pixel-art sprites

Choose PNG in Export, then expand Sprite size and choose a mode.

  • Fit (max px): choose 16, 32, 48, 64, 128, or 256 px as the maximum artwork size. The 256 px option requires the one-time unlock. The sprite fits within that limit, and unused canvas margins are trimmed automatically without smoothing or resampling the pixels. The resulting square PNG is trimmed around the artwork; outlines and their surrounding margin can affect the final image dimensions.
  • Relative (px/tile): choose 16, 32, or 64 pixels per tile to keep characters, props, and scenery at the same scale. These values describe the projected width of a ground tile, not the PNG dimensions. One tile covers 2 × 2 modeling-grid squares, matching the starter cube’s footprint. With the Isometric camera, a 32-pixel-wide tile appears as a 32 × 16 diamond. At this setting, Top-down renders a 2 × 2 grid-square footprint as 32 × 32 pixels; Side-view uses the same 16 pixels per grid-square distance.

Image dimensions are automatic in both modes. In Relative mode, the canvas grows to contain every view, including tall models and outlines, without shrinking the model. If the sprite exceeds the 1024-pixel canvas limit, choose fewer pixels per tile.

Relative mode centers the model’s ground footprint at its lowest point. All directions share the same ground anchor and canvas. In Fit mode, the views retain the same model scale, but their trimmed image dimensions can differ. The Isometric floor grid and gold ground marker are preview guides and do not appear in exported sprites.

Camera

Open the collapsed Camera section to choose the view style for your PNG sprites.

  • Isometric: the default 30° pixel-art view.
  • Top-down: look straight down for overhead sprites.
  • Side-view: look horizontally at the model for platformers and side-scrollers.

The selected camera applies to the preview and every checked export view. It saves automatically with each project and is restored when you reopen or import its editable project file. Older projects without a saved camera use Isometric. Camera selection changes the rendered PNGs without changing the model’s geometry or paint.

A front-facing sprite using the Side-view camera. Isopxl on iPhone.
iPhone · A front-facing sprite using the Side-view camera.
A front-facing sprite using the Side-view camera. Isopxl on iPad.
iPad · A front-facing sprite using the Side-view camera.
A front-facing sprite using the Side-view camera. Isopxl on Mac.
Mac · A front-facing sprite using the Side-view camera.
Isometric sprite preview and export views. Isopxl on Duo.
Duo · Isometric sprite preview and export views.

Appearance and directions

Open Appearance to choose your sprite’s finish. Flat keeps painted colors unshaded. Shaded adds light and dark tones that bring out the shape. With Shaded selected, enable Dithering to blend those tones with a patterned pixel texture. Dithering is unavailable in Flat mode. Choose 1-bit for a two-color finish with directional shading. Edit its Dark and Light swatches to choose the pair; the defaults are dark green and cream. Dithering, its pattern choices, and Outline remain available. Turning dithering off uses solid tones. Gradient and Palette Shading are disabled while 1-bit is selected, and their preferences are retained when you switch back. Enable Outline for a crisp border around the sprite. These effects appear in the PNG preview and exports; they preserve your model and painted colors. Choose a dithering pattern under Pattern; additional patterns require the one-time unlock. Gradient, also included in the unlock, adds color-aware lighting with adjustable strength, 3, 5, or 7 shades, and editable Shadow and Light tints. Palette Shading takes precedence over Gradient while enabled.

Shading, dithering, and outlines in the PNG preview. Isopxl on iPhone.
iPhone · Shading, dithering, and outlines in the PNG preview.
Shading, dithering, and outlines in the PNG preview. Isopxl on iPad.
iPad · Shading, dithering, and outlines in the PNG preview.
Shading, dithering, and outlines in the PNG preview. Isopxl on Mac.
Mac · Shading, dithering, and outlines in the PNG preview.
Shading, dithering, and outlines in the PNG preview. Isopxl on Duo.
Duo · Shading, dithering, and outlines in the PNG preview.

Open More export settings to choose 4, 8, or 16 directions around the model. The default is four; 16 directions requires the one-time unlock. Choose a thumbnail to preview its angle, then use the separate checkbox to include or exclude that view. Select all includes every direction in the current set; Deselect all clears the selection. Select at least one view to export. The direction count and checked views save automatically with each project. By default, Export PNG sends a separate transparent PNG for each checked view to the share sheet. Enable Export as spritesheet to combine the checked views into one PNG instead.

Palette shading

Expand Palette Shading, choose Enable, then open Ramps…. Each paint color used by the model has an Original swatch and a Shadow, Base, and Light ramp. Base stays fixed; choose Shadow or Light to edit its color. Choose Remove in the color editor to leave a shade empty; an empty shade uses the base color. Choose the empty slot to restore a shade. Removing both shades keeps that color flat.

Auto regenerates suggested ramps for the current colors; Done closes the popup. Palette shading supplies lighting even with Flat selected. With Shaded selected, dithering can blend the ramp colors. Changes update PNG previews and save with the project. Original paint and OBJ textures stay unchanged.

Export a spritesheet

In More export settings, enable Export as spritesheet, check the directions you want, then choose Export PNG. The result is one transparent PNG with the selected views ordered left to right, then top to bottom. Each frame has the same square cell size, scale, and model pivot. Rotation is framed around the center of the model’s 3D bounding box, rather than recentering each view’s visible outline. Fit uses one shared fit across the full direction set, so checking fewer views does not resize the remaining frames. Transparent margins can differ between frames as an irregular shape turns. This keeps the rotation consistent, though an asymmetric silhouette can still appear uneven around that pivot. Individual PNG exports retain their separate fitting and cropping. There are no extra blank frames.

The filename includes the scaled cell dimensions, such as Oak Tree-table-64-64.png, for Playdate image-table loading. Export scale enlarges pixels exactly, and the complete sheet must fit within 4096 pixels per side. Reduce the scale, sprite size, or selected directions if needed. This output option is off by default and is not saved with the project.

Export scale and saved preferences

In More export settings, choose Export scale: 100%, 200%, 400%, 800%, or 1600%. The default is 100%. Larger scales enlarge each sprite pixel into an exact square block, keeping edges crisp. They increase the PNG dimensions without adding sprite detail or changing the preview zoom. Output is limited to 4096 pixels per side; choose a smaller scale if your sprite exceeds that limit.

Camera, appearance, palette shading and its ramps, sprite size, direction count, checked views, and PNG export scale save automatically with each project and are restored when you reopen or import its editable project file. The app also remembers whether Sprite Size, Camera, Appearance, Palette Shading, and More export settings are expanded. Older projects without these preferences start with four directions, view 1 checked, 100% export scale, and those sections collapsed.

PNG filenames use your project name, the rendered image size, and the view number, such as Oak Tree-64px-view1.png. Rename the project in the library to change the name used for future exports.

The zoom controls change only the preview, not your saved image. Choose Export PNG to open the share sheet with separate transparent PNGs for the checked views, or a single PNG when Export as spritesheet is enabled. On iPhone and iPad, choose Save to Files, AirDrop, Messages, or another compatible app. On Mac, choose an available save or share destination. The available destinations depend on the apps installed and how many files they support.

Export a textured 3D model

OBJ export is included in the one-time unlock. Choose OBJ, then choose Export OBJ to open the share sheet. Choose an available save or share destination. On iPhone and iPad, this includes Save to Files and AirDrop.

The share sheet receives three files: model.obj, model.mtl, and texture.png. No ZIP is created. Save or send all three together and keep them in the same folder when importing into Blender or another compatible 3D tool.

Set texture interpolation to Closest in Blender or Point in Unity for crisp pixel textures. PNG camera selection, sprite size, tile scale, sprite shading, and outlines do not change the OBJ export.

Save, share, and back up projects

Choose a project’s name in the library to rename it. Use Select to duplicate, share, or delete projects. Project stacks group related work into one level of organization.

Export editable project in the editor menu (File on Mac) saves an .isopxl file with the geometry, textures, palette, and export settings, including the selected PNG camera. The library’s Share action also creates editable project files. Use Import to open an .isopxl file or a compatible older .json file as a new project. You can also open an .isopxl file from Files or Finder to import it into Isopxl. If a stack is open, the imported project is added to that stack.

Projects are stored locally in the app. Transfer an exported .isopxl file with AirDrop, Files, Finder, or another service, then use Import on the receiving device. Exported projects are compatible across iPhone, iPad, and Mac. Project libraries do not sync automatically. Keep exported copies of important work in a location you control. Deleted projects are hidden from the library and may remain in local app storage for recovery; there is no in-app Trash screen.

Free exports and the one-time unlock

All modeling and painting tools are available for free. You get three completed PNG export batches. A completed export counts as one batch, whether you export one view or multiple views from a set of 4, 8, or 16 directions. Cancelling the share sheet or a reported export failure does not use an export, and editable project backups do not count.

The one-time purchase unlocks unlimited PNG exports, OBJ export, 256 px Fit sizing, 16 directions, additional dithering patterns, and Gradient. Open Purchase Isopxl… in the main menu on iPhone or iPad, or the Isopxl application menu on Mac, to see the current App Store price.

After all three free PNG export batches have been used, a dismissible purchase reminder can appear when you open the app, at most once per day. Choose the close button to return to your projects. The purchase popup shows the current App Store price and the features included in the one-time unlock.

Already purchased? Choose Restore Purchases in the purchase sheet while signed into the Apple Account used to buy the unlock. An internet connection may be required.