From c5485a0a6fae8ed172a2f5340279ca6aa6c165bf Mon Sep 17 00:00:00 2001 From: Joris van der Hoeven Date: Wed, 7 Mar 2012 18:57:05 +0000 Subject: [PATCH] Extra documentation of graphical picture editor --- main/graphics/man-graphics-edit.en.tm | 54 +++++++++++++++- main/graphics/man-graphics-insert.en.tm | 82 +++++++++++++++++++++++++ main/graphics/man-graphics-style.en.tm | 76 +++++++++++++++++++++++ main/graphics/man-graphics.en.tm | 4 +- 4 files changed, 213 insertions(+), 3 deletions(-) create mode 100644 main/graphics/man-graphics-insert.en.tm diff --git a/main/graphics/man-graphics-edit.en.tm b/main/graphics/man-graphics-edit.en.tm index 3ac3619..125b334 100644 --- a/main/graphics/man-graphics-edit.en.tm +++ b/main/graphics/man-graphics-edit.en.tm @@ -3,9 +3,59 @@ <\body> - + - \; + Any of the modes which allows for the insertion of new objects (points, + lines, polygons, etc.) also allows you to directly edit existing objects. + More precisely, as soon as you go over an existing object with your mouse, + then the control points for that object will be highlighted automatically. + Several editing operations are supported: + + <\description> + When your mouse is sufficiently close to a + control point, then it will be possible to drag and drop the control + point to somewhere else using the left mouse button. + + For objects with an arbitrary number + of control points, such as broken lines, polygons, splines and closed + splines, it is possible to insert new points on existing edges. In order + to do so, move the mouse pointer on the edge where you want to insert a + new point; the two neighbouring control points should be highlighted. + Then insert a new point drag and move it around using drag and drop for + the first mouse button. + + Using the middle mouse button, it is + possible to remove control points (and eventually the object itself). + + Using the middle mouse button while + simultaneously pressing the shift key removes the entire + object which is currently highlighted. + + + While editing, it should also be noticed that attempts to + automatically the mouse pointer to control points or edges of + existing objects, as well as to intersection points of two curves and + points on the grid. This makes it possible to quickly draw complex pictures + which are exact, and not merely exact up to one or more pixels (and ugly + when magnified or printed). Around boxes with text or mathematical + formulas, there are also eight invisible control points to which + will attempt to snap the mouse pointer. This makes it easier to draw + diagrams as in figure below. + + Graphical objects are drawn in a specific which has the + effect that certain objects may be hidden by other objects. Using + and , you may move the currently highlighted object closer to or + farther away from the eye for this stacking order. In a similar vein, + certain control points may become unaccessible, because hidden by closer + control points. In that case, you may use to cycle through all + possibilities for the current cursor position. + + <\big-figure||gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-text-at-halign|center|gr-arrow-end|\|gr-auto-crop|true|>>|>>|>>|>>|>>|>>|||>>|||>>|||>>|||>>|||>>|||>>|||>>|||||>>>>> + Example of a diagram which was drawn by using snapping + to the eight control points around each box with a mathematical formula. + Notice also that we cropped the graphics to its actual size. + diff --git a/main/graphics/man-graphics-insert.en.tm b/main/graphics/man-graphics-insert.en.tm new file mode 100644 index 0000000..0fa3dea --- /dev/null +++ b/main/graphics/man-graphics-insert.en.tm @@ -0,0 +1,82 @@ + + + + +<\body> + + + After insertion of a new picture or clicking inside an existing picture, + the second mode dependent toolbar shows alist of icons which are + useful in graphics mode. In particular, the second group of icons + , , + , , + , , + , , on + this toolbar allows you to select the kind of objects that you want to + insert. currently implements the following primitive graphical + objects: + + <\description> + When selecting point mode using or + , you may insert simple points with the left mouse + button. + + When selecting line mode using + or , you may insert a new + broken line with the left mouse button: at every new click a new point is + inserted and the last point is inserted using a double click. Polygon + mode ( or ) is a variant of + line mode, with this difference that an additional segment is inserted + between the first and the last points. + + Spline mode is selected using + or . This mode is similar + to line mode, except that we now draw a smooth curve through the + specified points. Again, this mode admits a closed variant + ( or ). + + Arc mode is selected using + or . In this mode, you may insert arcs going through + three points specified through left mouse clicks. Similarly, you may use + circle mode ( or ) for drawing + circles. + + When selecting text mode + ( or ) or mathematics mode + ( or ), you may enter text (or + mathematics) at an arbitrary position in the picture, again using the + left mouse button. + + + Typical examples of these basic objects are shown in the figures below: + + <\center> + >|gr-geometry||||>>|Points.>>||gr-frame|>|gr-geometry||||||>>>|Lines.>>||gr-frame|>|gr-geometry||||||>>>|Polygons.>>>>>> + + \; + + |gr-frame|>|gr-geometry||||||>>>|Splines.>>||gr-frame|>|gr-geometry||||||>>>|Closed + splines.>>||gr-frame|>|gr-geometry||||>>>|Arcs.>>>>>> + + \; + + |gr-frame|>|gr-geometry||||>>>|Circles.>>||gr-frame|>|gr-geometry||>>>|Text.>>||gr-frame|>|gr-geometry||*\>=-1|>>>|Mathematics.>>>>>> + + + + + + + + + +<\initial> + <\collection> + + + \ No newline at end of file diff --git a/main/graphics/man-graphics-style.en.tm b/main/graphics/man-graphics-style.en.tm index c3c60fe..16943b3 100644 --- a/main/graphics/man-graphics-style.en.tm +++ b/main/graphics/man-graphics-style.en.tm @@ -5,6 +5,82 @@ <\body> + Each of the fundamental types of graphical objects also admits a certain + number of style properties which affect the rendering. The following style + properties exist: + + This property applies to any of the graphical object types + and specifies the color. + + This property applies to all graphical object types + except text and mathematics. It specifies a fill color for the object. + + <\big-figure||gr-frame|>|gr-geometry||gr-fill-color|pastel + red|gr-color|dark magenta|gr-auto-crop|true|||||>||||>>||||>>|||>>>>> + Examples of a few closed splines with different colors and fill colors. + + + This property also applies to any of the graphical + object types and specifies an opacity between 0% and 100%. The default is + 100% and lower opacities will make the object more transparent. + + |gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-fill-color|pastel + green|gr-color|dark green|gr-opacity|20%|gr-auto-crop|true||||>>|||>>|||>>|||>>|||>>|||>>>>|Examples + of the same object with increasing opacities on top of another object.> + + A few different point styles are supported for + displaying points: solid disks, round circles and squares. + + |gr-frame|>|gr-geometry||gr-fill-color|red|gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-point-style|square|gr-text-at-halign|center|gr-auto-crop|true|>|>|>|>>|>>|>>>>|The + different point styles for black color and red fill color.> + + The line width property applies to all curves (that + is, to broken lines, polygons, splines, closed splines, arcs and circles). + By default it is , the width of the fraction bar in + mathematical formulas, but any length unit can be used instead. + + <\big-figure||gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-line-width|5ln|gr-auto-crop|true|||||>|||||>>|||||>>|||||>>|>|>|>|>>>> + The same curve using different line widths. + + + Various dash styles are available for curves in + . + + <\big-figure||gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-line-width|2ln|gr-dash-style|11100|gr-dash-style-unit|20ln|gr-auto-crop|true|||||>>|||||>>|||||>>|||||>>|||||>>|||||>>>>> + The same curve using different dashing styles. + + + Various arrows at the ends of curves are supported + in . + + <\big-figure||gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-line-width|2ln|gr-arrow-begin|\||gr-arrow-end|\||gr-auto-crop|true||>>||line-width|2ln||>>||line-width|2ln||>>|\|line-width|2ln||>>||line-width|2ln||>>|\||line-width|2ln||>>|\|line-width|2ln||>>||>>||>>||line-width|2ln|arrow-begin|\\|||>>||line-width|2ln|arrow-begin|\||>>||>>|\||line-width|2ln|arrow-begin|\|\||>>||line-width|2ln|arrow-begin|\||>>|||>>|\|line-width|2ln|arrow-begin|\||>>|\|line-width|2ln|arrow-begin|\\||>>||>>>>> + The same segment using different types of arrows at the extremities. + + + For textual and mathematical boxes, its is + possible to specifiy the horizontal and vertical alignement properties, as + indicated in the figure below: + + <\big-figure||gr-frame|>|gr-geometry||gr-grid||gr-grid-old||1>|gr-edit-grid-aspect|||>|gr-edit-grid||gr-edit-grid-old||1>|gr-line-width|2ln|gr-text-at-halign|center|gr-text-at-valign|top|gr-auto-crop|true||>>|>>|>>|>>||>>||>>||>>||>>||>>||>>>>> + Illustration of horizontal and vertical alignment of text boxes. + + \; diff --git a/main/graphics/man-graphics.en.tm b/main/graphics/man-graphics.en.tm index 271b631..0f2a6c0 100644 --- a/main/graphics/man-graphics.en.tm +++ b/main/graphics/man-graphics.en.tm @@ -17,7 +17,9 @@ <\traverse> - + + +