diff --git a/doc/giv.html b/doc/giv.html index 8e2a8b7..d57801c 100644 --- a/doc/giv.html +++ b/doc/giv.html @@ -17,13 +17,13 @@

A Manual for Giv


- Version 0.9.33
+ Version 0.9.36
Dov Grobgeld
Homepage: http://giv.sourceforge.net/giv
Development: http://github.com/dov/giv
Chat room: Gitter Giv Chat room
dov.grobgeld@gmail.com
- Last modified: 2022-04-05 Tue + Last modified: 2023-02-09 Thu

1. Description

@@ -207,7 +207,40 @@

1.2. The giv files

-

1.3. Text annotations

+

1.3. Lines and Bezier Curves

+ +
+After the header of the dataset, follows its data points. + +giv follows the SVG model of drawing curves. A line is composed of a letter followed by the coordinates. By default the action is lineto, but the following are also supported: + + +
Letter + Meaning + Number parameters + Comment +
M + move to + 2 + Implicit for first point +
L + line to + 2 + Optional +
Z + line to + 2 + Close path +
C + curve to + 6 + A cubic Bezier +
+ +
+ + +

1.4. Text annotations

Text is drawn by adding the letter "T" in front of a line. The "T" may have a number 1-9 appended describing the anchoring of the text. This numbers corresponds to their position on the numerical keyboard. The default alignment is 1, i.e. lower left. To write multiline text add string "\n". @@ -253,7 +286,7 @@

1.3. Text annotations

The backslash character is used as an escape character, so to get a literal backslash two slashes must be used. "\n" is used to indicate aline break.
-

1.4. Colors

+

1.5. Colors

For all the properties that take colors as arguments the color may be given in several ways: @@ -269,7 +302,7 @@

1.4. Colors

-

1.5. Styles

+

1.6. Styles

Instead of explicitly listing all properties for a dataset, this may be done inderectly by the creation of a style. A style is created and has properties added to it through the $def_style keyword. Each use of $def_style adds one property to the style. A style is then referenced in the beginning of a dataset with the $style keyword followed by the style name. @@ -295,7 +328,7 @@

1.5. Styles

20: 200 150
-

1.6. Giv file example

+

1.7. Giv file example

Here is an extensive giv file example showing off the various features of @@ -450,6 +483,14 @@

1.6. Giv file example

Note: The example above contains just a few points. Giv very easily supports several hundred thousand points. The only limitations are the physical memory and the speed of the CPU.
+

1.8. Balloons and paths

+ +One of the features of giv is that each dataset may have a tooltip popup attached to it. These popups are knows as "balloons". This allows adding auxilliary information to the display that is revealed only when the cursor hovers above the dataset. + +In addition, a dataset may be given a hiearchical path. This path is referenced in the marks viewer, and may be used to toggle on and off datasets. If no balloon was explicitely set for a dataset, then the dataset name is used for the balloon. + +Balloons are toggled by the "b" popup. +

2. Interaction

@@ -457,76 +498,76 @@

2. Interaction

Option Description -1 - Sets one image pixel equal to one screen pixel. -a - Toggle anti aliasing -b - Toggle the balloon popup. -c - Reduce contrast. Useful for viewing overlay on binary images. -i - Show information window -f - Fill data to window -g - Toggle the pixel grid. (Only shown at high zoom ratios). -h - Horizontal flip -m - Toggle overlay. -o - Popup dataset browser. -q - Quit -s - Shrink wrap -v - Vertical flip -Shift-V - Toggle vertical zoom locking. -Control+c - Copy contents of balloon text to clip board -Control+d - Copy contents of the last measurement to the clipboard. -Control+x - Copy XY coordinate to the to clip board -Esc - Abort remote command pick points -=
Ctrl-B1 - Zoom in by a factor of 2 --
Ctrl-B3 - Zoom out by a factor of 2 -Scroll wheel up - Zoom in by a factor of 1.4 -Scroll wheel down - Zoom out by a factor of 1.4 -Shift+Scroll wheel up - Zoom in by a factor of 1.1 -Shift+Scroll wheel down - Zoom out by a factor of 1.1 -Control+Scroll wheel up - Zoom in by a factor of 2 -Control+Scroll wheel down - Zoom out by a factor of 2 -Alt + Scroll wheel up - Zoom in of quiver vectors by a factor of 1.2 -Alt + Scroll wheel down - Zoom out of quiver vectors by a factor of 1.2 -B3 - Popup options menu. +1 + Sets one image pixel equal to one screen pixel. +a + Toggle anti aliasing +b + Toggle the balloon popup. +c + Reduce contrast. Useful for viewing overlay on binary images. +i + Show information window +f + Fill data to window +g + Toggle the pixel grid. (Only shown at high zoom ratios). +h + Horizontal flip +m + Toggle overlay. +o + Popup dataset browser. +q + Quit +s + Shrink wrap +v + Vertical flip +Shift-V + Toggle vertical zoom locking. +Control+c + Copy contents of balloon text to clip board +Control+d + Copy contents of the last measurement to the clipboard. +Control+x + Copy XY coordinate to the to clip board +Esc + Abort remote command pick points +=
Ctrl-B1 + Zoom in by a factor of 2 +-
Ctrl-B3 + Zoom out by a factor of 2 +Scroll wheel up + Zoom in by a factor of 1.4 +Scroll wheel down + Zoom out by a factor of 1.4 +Shift+Scroll wheel up + Zoom in by a factor of 1.1 +Shift+Scroll wheel down + Zoom out by a factor of 1.1 +Control+Scroll wheel up + Zoom in by a factor of 2 +Control+Scroll wheel down + Zoom out by a factor of 2 +Alt + Scroll wheel up + Zoom in of quiver vectors by a factor of 1.2 +Alt + Scroll wheel down + Zoom out of quiver vectors by a factor of 1.2 +B3 + Popup options menu. -Left/Space - Show next image in directory. -Right/BackSpace - Show previous image in directory. -Shift-Down - Choose next image when several $image references are given or next image for multi depth images. -Shift-Up - Choose previous $image image +Left/Space + Show next image in directory. +Right/BackSpace + Show previous image in directory. +Shift-Down + Choose next image when several $image references are given or next image for multi depth images. +Shift-Up + Choose previous $image image
@@ -560,10 +601,14 @@

3. Gallery

- + Pseudo color + A gray level image with transparent overlay + + + - Example use of svgmarks where the markers are read from an external svg file. + Example use of svgmarks
where the markers are read from an
external svg file. diff --git a/doc/giv.phtml b/doc/giv.phtml index bde2c67..0ac00f0 100644 --- a/doc/giv.phtml +++ b/doc/giv.phtml @@ -93,13 +93,13 @@ sub code_snippet { # usage: code_snippet($filename, title)


- Version 0.9.33
+ Version 0.9.36
Dov Grobgeld
Homepage: http://giv.sourceforge.net/giv
Development: http://github.com/dov/giv
Chat room: Gitter Giv Chat room
dov.grobgeld@gmail.com
- Last modified: 2022-04-05 Tue + Last modified: 2023-02-09 Thu

<: section("Description") :> @@ -289,6 +289,38 @@ sub code_snippet { # usage: code_snippet($filename, title) +<: subsection("Lines and Bezier Curves") :> +
+After the header of the dataset, follows its data points. + +giv follows the SVG model of drawing curves. A line is composed of a letter followed by the coordinates. By default the action is lineto, but the following are also supported: + + + <: TR() :>
Letter + Meaning + Number parameters + Comment + <:TR():><: td() :>M + <: td() :>move to + <: td() :>2 + <: td() :>Implicit for first point + <:TR():><: td() :>L + <: td() :>line to + <: td() :>2 + <: td() :>Optional + <:TR():><: td() :>Z + <: td() :>line to + <: td() :>2 + <: td() :>Close path + <:TR():><: td() :>C + <: td() :>curve to + <: td() :>6 + <: td() :>A cubic Bezier +
+ +
+ + <: subsection("Text annotations") :>
Text is drawn by adding the letter "T" in front of a line. The "T" may have a number 1-9 appended describing the anchoring of the text. This numbers corresponds to their position on the numerical keyboard. The default alignment is 1, i.e. lower left. To write multiline text add string "\n". @@ -351,6 +383,13 @@ giv. The result is shown in the screenshow below. Note: The example above contains just a few points. Giv very easily supports several hundred thousand points. The only limitations are the physical memory and the speed of the CPU.
+<: subsection("Balloons and paths") :> +One of the features of giv is that each dataset may have a tooltip popup attached to it. These popups are knows as "balloons". This allows adding auxilliary information to the display that is revealed only when the cursor hovers above the dataset. + +In addition, a dataset may be given a hiearchical path. This path is referenced in the marks viewer, and may be used to toggle on and off datasets. If no balloon was explicitely set for a dataset, then the dataset name is used for the balloon. + +Balloons are toggled by the "b" popup. + <: section("Interaction") :>
@@ -459,10 +498,14 @@ giv. The result is shown in the screenshow below. - + + -
+
Pseudo color + A gray level image with transparent overlay +
Example use of svgmarks where the markers are read from an external svg file. + Example use of svgmarks
where the markers are read from an
external svg file.