Hi all,

I would like to wrap up work on the lines, curves, and ellipses branch.

I've renamed the branch, rebased it to the current master, and squashed all
the commits:
https://gitorious.org/~optigon/mypaint/optigon-mypaint/commits/rj/lines_curves_ellipses

The code is in pretty good shape at this point. I feel I've address most of
the feedback received about the tools. Getting this code into the master
would be beneficial to its development, especially for the interface since
I'm lacking in the Gtk department.

Things that still could be done:
- The current icons can be swapped out for new ones.
- A standard info line like the zoom overlay would allow help text to be
added to the drag functions. Perhaps a class that takes a string and
renders it on the screen in a predefined place.
- Radial Lines tool for easier perspective drawing.

I can keep working on the code but I think its at a good point in the
development for inclusion. That said, I will address any changes that the
MyPaint team feel are required.

I also put together some notes to base a MyPaint wiki manual page for Line
Modes on.

==Main Features==
- Tools for drawing straight lines, curves, and ellipses
- Straight lines can be constrained to 15 degree angles
- Two curves are allowed per straight line
- Ellipses can be rotated and constrained to circles
- Lines are drawn dynamically
- Settings for pressure emulation (entry, mid, and exit pressure)
- Settings for head and tail stroke length

==Line Modes==
There are 4 Line Modes:
1) Freehand - This is the default painting mode for MyPaint
2) Straight/Curved Line - Draws straight, constrained, and curved lines
3) Sequence of Lines - Draws a sequence of straight or curved lines
4) Ellipse - Draws circles and ellipses and rotated ellipses

Each line mode, can be toggled in 4 ways:
1) Toggled from the Toolbar via the Line Mode icon drop down panel
2) Toggled from the menus. Brush > Line Mode
3) Toggled using a hotkey bound to any of the menu commands
4) Using a modifier key. Edit > Preferences > Buttons

==Straight Lines==
Notes:
1) Keeping Shift held constrains a line to the nearest 15 degree increment
2) If Shift is held to draw Straight Lines (since this is the default
modifier key), release Shift to draw lines freely

==Curves==
- After you draw a straight line, that line can be curved
- Curves are Bezier based
Procedure:
1) Draw a straight line
2) Add a curve using the Ctrl key
  2a) If you use Shift to draw straight lines, then add curves with
Ctrl+Shift
  2b) If you are in Straight/Curved Lines mode, then add curves with Ctrl

Notes:
1) Only the last line drawn can be curved
2) You can add 2 curves per line
3) You may edit the curve indefinitely

==Ellipses==
- Ellipses are drawn outward from their center
- Using the Shift constraint lets you draw circles
- Crtl lets you rotate the ellipse
- Shift+Ctrl rotates and constrains the rotation to 15 degree increments

==Settings==
- Settings that allow you to adjust the line quality are access from the
Toolbar
- These setting let you adjust the pressure at the beginning, middle, and
end of the stroke
- By default the pressure is lighter on the ends and heavier in the center
- You can also adjust the head and tail length
- The head ratio is the amount of lead-in before the middle pressure begins
- The tail is the stroke exit ratio
- Adjusting the settings automatically updates the last line you drew

==Help==
- Hovering over the Line Mode toggles in the Toolbar panel show tooltips
summarizing how to use each tool
_______________________________________________
Mypaint-discuss mailing list
[email protected]
https://mail.gna.org/listinfo/mypaint-discuss

Reply via email to