documentation

Note: This documentation is very much work in progress and only serves as a minimal guideline. While the PixelBasher product is in development this documentation will be in flux.

Getting Started

When you first start PixelBasher you'll be greeted by an empty document. You can get started with kitbashing by clicking one of the brushes from the library menu on the right side of the application.

Getting to know the editor

Library

On the right hand side of the application you'll find the library. This window contains all of the brushes that can be used for kitbashing. You can place them in the canvas window by simply clicking them.

Canvas

The Canvas is the area on which the actual kitbashing takes place. The active area of the Canvas is shown by the border that surrounds the grid. Objects can be placed outside of the grid; however, they will be cut off when an image is exported.

Objects

When kitbashing elements are placed on the Canvas they are simply known as Objects. Objects have several properties such as: x, y, width, height, opacity, etc. They can be selected by using the mouse, dragged around and nudged by using the arrow keys.

Object Toolbar

The object toolbar appears at the bottom of the application when an object is selected. In this window you'll be able to tweak the objects colors, bring them to the foreground/background, mirror them, etc.

*The object toolbar itself is scheduled for a revamp in one of the upcoming versions.

Object Effects Panel

The object effects panel appears at the left side of the application. This window shows several effect properties which can be adjusted for each object.

*In version 1 of the application this window contains Drop Shadow and Outline. Future versions of the application might ship with other effects.

Navigation

Navigating the canvas can be done using the mouse and keyboard.

  • panning is done through dragging the middle mouse
  • zooming is done through the use of crtl+scroll

Object toolbar

The object toolbar contains several useful features.

Toolbar features

  1. move to front (hotkey W)
  2. move to back (hotkey D)
  3. parent to object
  4. mirror object
  5. brighten object
  6. darken object
  7. decrease number of colors in object
  8. increase number of colors in object

Global Settings

When the cog icon is clicked, the global settings window will be shown. In this window you can adjust various color effects which relate to the active document as a whole. Which means that if there are any object effects active, they will be processed before global effects.

Several options are available:

Global Posterize

This controls the number of colors in the entire document. This is separate from any color limiting effects on objects active on the Canvas.

Global Outline

This controls the outline of the entire document.

Contrast

This controls the document contrast. This is calculated before global posterization.

Grid

This controls the document grid size.

Exporting and saving

Using the icons on the top left corner, the user can:

  • create a new file
  • open a project
  • save a project
  • export a .png file

Hotkeys

General

  • CTRL + Mouswheel: Zoom Canvas
  • Middle Mouse: Move Canvas

While an object is selected

  • R: Rotate object 45 degrees clockwise
  • W: Move to front
  • S: Move to back
  • E: Enter parenting mode*
  • DEL: Delete selected object

*this feature is not yet fully fleshed out.

  • Scroll wheel: Change object opacity
  • Right click drag: Free rotate object