How to use Squaresville

The Squaresville Pattern Generator is a tool to create patterns for quilting, cross-stitch, mosaics, or other physical objects from a digital image.

Getting started

First, select a saved image of your own to start with. You will be prompted what kind of item you would like to generate a pattern for, what measurement units you'd like to work with, how large you want your squares to be in real life, how many rows/columns of squares you want in the pattern (with the image's original dimensions in pixels as the default), maximum number of colors to use, and palette style. Changing the number of columns or rows of squares will change the other, unchanged number so the pattern stays proportionate to your image.

With this information, Squaresville will generate and display a base pattern image to work with, side-by-side with the original upload. It will also display the final dimensions of the piece based on your parameters, how many total squares are in the pattern, and open an editable color palette with all the colors present in the pattern image for fine-tuning.

Fine-tuning your Squaresville pattern

Squaresville allows a large degree of control over your pattern, and makes it simple to adjust things like square size, row/column (pixel) count, number of distinct colors in the palette, and more. For ease of use, you will be able to undo up to 10 recent actions against the palette, project dimensions, and image conversion style (dithering, diffusion, nearest color). Throughout the editing process the original image and the pattern preview are shown side by side at equal size, each scaled to fit the space your screen affords, so it's easy to compare them and see what's changing.

Adjust Number of Colors

If you want to let Squaresville automatically adjust the number of colors in your final image, change the number of colors in the palette (Either use the text control, or the associated up/down buttons). The pattern image will automatically regenerate, according to your selected conversion style. This control always shows how many colors are currently in the palette — the same count reported in the pattern stats — and it stays in step as you merge or delete colors.

Adjust Individual Palette Colors

Each individual color in the palette can be removed, changed to a different color, or merged with another color in the palette. Start by seleting the color you want to alter, by clicking on the color either in the palette, or directly in the design image: This will highlight the selected color in the palette, pulse all the squares of that color in the design image, and add that color's information to the color detail pane. The detail pane shows:

Additionally, when selecting a color, all that color's pixels in the pattern preview image will slowly pulse once.

For convenience, the current color palette can be sorted in a variety of standard color sort methods, and also by frequency of that color in the current pattern image. When a color is selected, it will remain selected through a sorting operation. While a sort is active, the palette re-applies it after every change you make to the palette — adjusting a color, deleting, or merging — so it always stays in the order you chose.

Locking a Color

To ensure that a color can't be removed or edited, select the color you want to lock, and click on that color's "Lock Color" button in the detail pane. A lock icon will appear on that color's swatches in the main palette, and in neighbor comparisons, and the "Lock Color" button will change to "Unlock Color". When a color is locked, it cannot be deleted, altered, or merged into another color.

Deleting a Color

Select the color you want to remove, and click on that color's delete button in the detail pane. The image will regenerate, reassigning that color's pixels to the nearest remaining color in the palette.

Merging Colors

Select the color you want to merge with another color in the palette. In the detail pane, make sure the style of merge you want to perform is selected, click the "Merge Color" button, and then select the color you want to merge with. You can select any of the current colors in the palette to merge with, or select one of the convenient near neighbor colors in the detail pane. Merge styles are:

Saving the Pattern Image

At any point, right-clicking and saving the pattern image will work: The indexed color image will remain saveable, making it easy to resume progress by re-uploading the pattern image.

Saving The Final Pattern

When you are happy with the result, click the large "Generate Pattern" button under the pattern preview image. You will be prompted for your desired size of row/column groups (3 or 5), and symbol type (numeric or true symbols). Squaresville will then assign one symbol to each color in the palette, and generate both the pattern and color legend in a tabbed spreadsheet.

The pattern spreadsheet will directly correspond to the pattern preview image, with each pixel row and column corresponding to a spreadsheet row / column. The rows and columns will be grouped by the selected size of row/column groups, with subtle alternating background colors to make it easier to follow in a large project.

The color legend sheet will include the color's symbol, a swatch of the color with its hex code, and the number of squares using this color in the final pattern.