@@ -17,27 +17,60 @@ Arne's original bend code was used as base and has been modified and improved to
17
17
- GUI
18
18
- Loading/saving files.
19
19
- Adjusting joint position.
20
- - Zoom setting for easy joint adjustment.
20
+ - Zoom setting on input image for easy joint adjustment.
21
21
- Frames number output setting.
22
22
- Background color setting.
23
23
- Automatic setting of background color to magenta on save.
24
- - Saving as PNG or Indexed BMP (CC Palette)
24
+ - Saving as PNG or Indexed BMP (CC Palette).
25
+ - Saving as individual named frames.
25
26
26
27
## How To
27
28
28
29
1 . Create an input file using the provided template.
29
- 2 . Load your file in the app.
30
+ - **Warning:** The order of limb parts in the input file **is important!**
31
+ - Order should be as specified, going left to right:
32
+ Upper Arm FG, Lower Arm FG, Upper Arm BG, Lower Arm BG, Upper Leg FG, Lower Leg FG, Upper Leg BG, Lower Leg BG.
33
+ - **Double Warning:**
34
+ - Arm parts should be facing **right** for correct bending!
35
+ - Leg parts should be facing **left** for correct bending!
36
+
37
+ - See included "test-image.bmp" to understand how your input file should look like.
38
+
39
+ 2 . Load your input file using the "** Load** " button.
40
+
30
41
3 . Bent limbs will auto generate with default settings.
42
+
31
43
4 . Adjust joint positions by clicking on the upper joint marker and dragging it around.
32
- - Use **Zoom** setting to enlarge the input image for easier joint adjustment
44
+ - ~~Use **Zoom** setting to enlarge the input image for easier joint adjustment~~
45
+ - Input image will be automatically zoomed to x4 on first load.
33
46
- **Warning:** When zooming the joint markers will reset to original positions. First zoom, then adjust.
47
+
34
48
5 . Use ** Frames** setting to set number of bend frames.
35
49
- Bend angle will adjust automatically. First/Last frames will always be fully bent/unbent.
50
+
36
51
6 . Decide whether you want to save as Indexed BMP or not - if yes, tick the "** Save as Indexed Bitmap** " checkbox.
37
- 7 . Hit save
38
- - Background color will automatically be set to magenta (255,0,255) when save is clicked and will revert back to previous color when finished.
39
- 8 . Slice the saved image into frames and apply palette.
40
- - Manually touch-up the exported frames if needed.
52
+
53
+ 7 . Decide whether you want to save as individual named frames or not - if yes, tick the "** Save as Frames** " checkbox.
54
+ - Exported frame size is fixed to 24x24px.
55
+ - If enabled, a visual aid will be shown around each frame to help the user stay within bounds.
56
+ - Pixels outside bounds will be cropped.
57
+ - Exported leg frames will be automatically flipped horizontally to face right.
58
+
59
+ ** Note:** "Save as Indexed Bitmap" and "Save as Frames" do not conflict and can be used together to export indexed individual frames.
60
+
61
+ 8 . Hit save
62
+ - Background color will automatically be set to magenta (255,0,255) when save is clicked and will revert back to previous color when finished.
63
+
64
+ - **Warning:**
65
+ - File extension will be added automatically depending on selected "**Save as Indexed Bitmap**" setting so there is no need to add it manually.
66
+ Doing so will resolve in a double extension (for example: "MyFile.png.png").
67
+
68
+ - **Quadruple Warning:**
69
+
70
+ - When saving with "**Save as Frames**" enabled, only input the name of the actor these limbs belong to (for example: "Robot").
71
+ Limb names and frame numbers will be added automatically.
72
+ **Adding the limb name and frame number manually will result in horrible exported file names.**
73
+
41
74
42
75
## Current Issues
43
76
0 commit comments