Export images and sprite-sheets

Pikselo can export documents to a PNG image file. When more than a single document is exported to the same image file, this is called a sprite-sheet.

Sprite-sheets are very useful to use the images and animations within applications that don't understand or in which is not feasible to use the file format used by Pikselo. Examples of such applications are games, where sprite-sheets are very common and most game libraries support them. To make easier using sprite-sheets, Pikselo can also write a map file with the size and the position over the PNG image of each of the individual exported documents. Thus, it is not necessary for all the documents to have the same size.

To export one or more documents to a single PNG image or sprite-sheet:

  1. Make sure that all the documents--images and/or animations--that you want to export are open in Pikselo's main window.

  2. From the main window, choose File ▸ Export… to open the Export dialog.

  3. Enter the path to image file to export the documents to in the first text entry labeled Image. Optionally, use the Browse button on the right to select the directory and the name of the image file.

  4. If you want Pikselo to write the coordinates map file in addition to the image file, enter the path to the map file in the text entry labeled Map file. Optionally, use the Browse button on the right to select the directory and the name of the map file. If you don't want a map file, leave this text entry empty.

  5. Select the documents that you want to export by selecting the check box next to each of the document that needs to be exported from the list. You can select as many documents as you want, but there must be at least one document selected to create the image.

  6. Enter the desired maximum width and height that the exported image can have. Pikselo will try to create an image as small as possible to fit all the documents inside the image file, but will never try to create an images bigger than the specified size here.

  7. Select the background color to fill the transparent areas of the exported image with.

  8. Select the check box labeled Force power-of-two image size to tell Pikselo that the exported image must have a width and a height that must be a power of two but never bigger than the specified maximum size. This is usually required in 3D applications.

  9. Select the check box labeled Force squared image to tell Pikselo that the exported image must be squared (i.e., the image's width and height are equal.) Pikselo won't create the image if the resulting width or height is bigger than their maximum.

  10. Click the OK button.