# Spritex - Retro Tools

>This is a program for creating animations in the sprite system of the small Atari computer.
The program allows working on multiple projects, where each can have many independent animations.

---
##### # Project
>A project can be created/loaded from the menu or the toolbar:
![](Assets/Image/en-US/spritex_1.png)
A new project has only two parameters: a name and the pixel height of the sprites, single or double line.
The project name can be changed later by right-clicking on it in the tab. The height cannot be changed afterwards.

---
##### # Animations
>Animations are added with the ```+``` button and removed with the ```-``` button.
![](Assets/Image/en-US/spritex_2.png)
To rename an animation, right-click on it in the animation list.

---
##### # Frame Editor
>The frame editor has a list of PM registers at the top.
-In the first column you can select which registers you are working on.
-Next is the horizontal position of the register relative to the left edge of the frame.
-Then you can select the register width mode (1, 2, 4).
-Next is a visualizer of the register's position and width. You can also control the register position through it (left mouse button and move left/right).
-The positions of active registers determine the total width of the frame.
![](Assets/Image/en-US/spritex_3.png)
Below is information about which register is used for drawing with the left mouse button. The right mouse button is permanently set to background (i.e. no register).
Next to it are up/down buttons for adjusting the frame height.
Below are fields for all registers; left-clicking a field selects that register for drawing (LMB). Double-clicking opens the color selection window.
Below are tool buttons for horizontal and vertical mirror flip.
On the right side is the frame editing grid.

---
##### # Frame List
>The upper part shows the currently selected frame and control buttons.
![](Assets/Image/en-US/spritex_4.png)
The first button on the left adds a frame, then removes a frame, followed by buttons to move the frame in the frame list.
Below is a frame thumbnail and next to it a play/stop button to run the animation.
Below that is a field for the time that can be applied to all frames at once.
Below is the list of frames in order from top to bottom.
Each frame entry contains a left-arrow button that allows inserting a copy of that frame into the currently selected one.
Then there is a thumbnail and an individual frame time.

---
##### # Color Selection
>The color selection window allows choosing a color for a pair of PM registers (0,1 or 2,3).
![](Assets/Image/en-US/spritex_5.png)
Left mouse button selects the PM0 color and right button selects PM1.

---
##### # Shared Color for PM Pair
>In the "Help -> Colors" menu there is a window showing color combinations for a pair of PM registers.
![](Assets/Image/en-US/spritex_6.png)
In the lower section there are sixteen triple color columns.
The first color column is the color selected in the upper section by hue and brightness. It represents register 0 or 2.
The second color column is the overlay color of register 0 or 2 on register 1 or 3.
The third color column shows eight brightness levels of successive color hues. It represents register 1 or 3.
