librelogo: help for gradients, log10, fixed interface

Change-Id: I0d930e83a54f7321074c5376b540a48ea9dfafd1

1 files changed, 17 insertions, 11 deletions

diff --git a/source/text/swriter/librelogo/LibreLogo.xhp b/source/text/swriter/librelogo/LibreLogo.xhp
index 1aed424c3b..3be664dc17 100644
--- a/source/text/swriter/librelogo/LibreLogo.xhp
+++ b/source/text/swriter/librelogo/LibreLogo.xhp
@@ -27,27 +27,27 @@
 <paragraph role="heading" level="1" xml-lang="en-US" id="hd_170">LibreLogo</paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_180">LibreLogo is a simple, localized, Logo-like programming environment with turtle vector graphics for teaching of computing (programming and word processing), DTP and graphic design. See <link href="http://www.numbertext.org/logo/librelogo.pdf">http://www.numbertext.org/logo/librelogo.pdf</link>.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_220">LibreLogo toolbar</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_230">The LibreLogo toolbar (View » Toolbars » Logo) contains turtle moving, program run and stop, home and clear screen and syntax highlighting/translating icons and an input bar (command line).</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_230">The LibreLogo toolbar (View » Toolbars » Logo) contains turtle moving, program start, stop, home, clear screen, program editor/syntax highlighting/translating icons and an input bar (command line).</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_240">Turtle moving icons</paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_250">They are equivalents of the Logo commands “FORWARD 10”, “BACK 10”, “LEFT 15”, “RIGHT 15”. Clicking on one of the icons will also focus the turtle shape scrolling the page to its position.</paragraph>
-<paragraph role="heading" level="2" xml-lang="en-US" id="hd_280">Program run and start</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_290">Click on the icon “run” to execute the text (or only the selected) text of the Writer document as a LibreLogo program.</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_300">Click on the icon “stop” to stop the program execution.</paragraph>
+<paragraph role="heading" level="2" xml-lang="en-US" id="hd_280">Start Logo program</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_290">Click on the icon “Start Logo program” to execute the text (or only the selected) text of the Writer document as a LibreLogo program. In an empty document an example program will be inserted and executed.</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_300">Click on the icon “Stop” to stop the program execution.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_310">Home</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_320">Click on the icon “home” to reset the position and settings of the turtle.</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_320">Click on the icon “Home” to reset the position and settings of the turtle.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_330">Clear screen</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_340">Click on the icon “clear screen” to remove the drawing objects of the document.</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_340">Click on the icon “Clear screen” to remove the drawing objects of the document.</paragraph>
+<paragraph role="heading" level="2" xml-lang="en-US" id="hd_344">Program editor/Syntax highlighting/Translating</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_345">The “magic wand” icon sets 2-page layout for program editing, expands and converts to uppercase the abbreviated, lowercase Logo commands in the Writer document. Change the language of the document (Tools » Options » Language Settings » Languages » Western) and click on this icon to translate the Logo program to the selected language.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_350">Command line</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_360">Hit Enter in the command line to execute its content. To stop the program use the icon “stop”.</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_360">Hit Enter in the command line to execute its content. To stop the program use the icon “Stop”.</paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_370">Hold down the Enter to repeat the command line, for example, on the following command sequence:</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_380"> FORWARD 200 LEFT 89<br/></paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_390">To reset the command line click triple in it or press Ctrl-A to select the previous commands, and type the new commands.</paragraph>
-<paragraph role="heading" level="2" xml-lang="en-US" id="hd_400">Syntax highlighting/Translating</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_410">It expands and upper case Logo commands in the Writer document. Change the language of the document (Tools » Options » Language Settings » Languages » Western) and click on this icon to translate the Logo program to the selected language.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_413">Graphical user interface of basic turtle settings</paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_415">Turtle shape of LibreLogo is a normal fixed size drawing object. You can positionate and rotate it on standard way, too, using the mouse and the Rotate icon of the Drawing Object Properties toolbar. Modify Line Width, Line Color and Area Color settings of the turtle shape to set PENSIZE, PENCOLOR and FILLCOLOR attributes of LibreLogo.</paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_420">Program editing</paragraph>
-<paragraph role="paragraph" xml-lang="en-US" id="par_430">LibreLogo drawings and programs use the same Writer document. The LibreLogo canvas is on the first page of the Writer document. You can insert a page break before the LibreLogo programs and set the zoom/font size for a comfortable two page layout for LibreLogo programming: left (first) page is the canvas, right (second) page is for the LibreLogo programs.</paragraph>
+<paragraph role="paragraph" xml-lang="en-US" id="par_430">LibreLogo drawings and programs use the same Writer document. The LibreLogo canvas is on the first page of the Writer document. You can insert a page break before the LibreLogo programs and set page zoom using the “magic wand” icon of the Logo toolbar, also change the font size for a comfortable 2-page layout for LibreLogo programming: left (first) page is the canvas, right (second) page is the LibreLogo program editor.</paragraph>
 <paragraph role="heading" level="1" xml-lang="en-US" id="hd_440">LibreLogo programming language</paragraph>
 <paragraph role="paragraph" xml-lang="en-US" id="par_450">LibreLogo is an easily localizable, Logo-like programming language, localized in several languages by LibreOffice native language communities. It is back-compatible with the older Logo systems in the case of the simple Logo programs used in education, eg.</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_460"> TO triangle :size<br/> REPEAT 3 [<br/>   FORWARD :size<br/>   LEFT 120<br/> ]<br/> END<br/> <br/> triangle 10 triangle 100 triangle 200<br/></paragraph>
@@ -152,6 +152,8 @@
 <paragraph role="logocode" xml-lang="en-US" id="par_1130"> PENSIZE 100 ; line width is 100 points<br/> PENSIZE ANY ; equivalent of PENSIZE RANDOM 10<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_1140">PENCOLOR/PENCOLOUR (pc)</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_1150"> PENCOLOR “red” ; set red pen color (by color name, see color constants)<br/> PENCOLOR [255, 255, 0] ; set yellow color (RGB list)<br/> PENCOLOR 0xffff00 ; set yellow color (hexa code)<br/> PENCOLOR 0 ; set black color (0x000000)<br/> PENCOLOR ANY ; random color<br/> PENCOLOR [5] ; set red color (by color identifier, see color constants)<br/> PENCOLOR “invisible” ; invisible pen color for shapes without visible outline<br/> PENCOLOR “~red” ; set random red color<br/></paragraph>
+<paragraph role="heading" level="3" xml-lang="en-US" id="hd_1151">PENTRANSPARENCY</paragraph>
+<paragraph role="logocode" xml-lang="en-US" id="par_1152"> PENTRANSPARENCY 80 ; set the transparency of the actual pen color to 80%<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_1153">PENCAP/LINECAP</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_1155"> PENCAP “none” ; without extra line end (default)<br/> PENCAP “round” ; rounded line end<br/> PENCAP “square” ; square line end<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_1160">PENJOINT/LINEJOINT</paragraph>
@@ -160,7 +162,9 @@
 <paragraph role="logocode" xml-lang="en-US" id="par_1190"> PENSTYLE “solid” ; solid line (default)<br/> PENSTYLE “dotted” ; dotted line<br/> PENSTYLE “dashed” ; dashed line<br/> <br/> ; custom dot–dash pattern specified by a list with the following arguments:<br/> ; – number of the neighbouring dots<br/> ; – length of a dot<br/> ; – number of the neighbouring dashes<br/> ; – length of a dash<br/> ; – distance of the dots/dashes<br/> ; – type (optional):<br/> ;   0 = dots are rectangles (default)<br/> ;   2 = dots are squares (lengths and distances are relative to the pensize)<br/> <br/> PENSTYLE [3, 1mm, 2, 4mm, 2mm, 2] ; ...––...––...––<br/></paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_1200">Fill settings</paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_1210">FILLCOLOR/FILLCOLOUR (fc)</paragraph>
-<paragraph role="logocode" xml-lang="en-US" id="par_1220"> FILLCOLOR “blue” ; fill with blue color, see also PENCOLOR<br/> FILLCOLOR “invisible” CIRCLE 10 ; unfilled circle<br/></paragraph>
+<paragraph role="logocode" xml-lang="en-US" id="par_1220"> FILLCOLOR “blue” ; fill with blue color, see also PENCOLOR<br/> FILLCOLOR “invisible” CIRCLE 10 ; unfilled circle<br/> FILLCOLOR [“blue”, “red”] ; gradient between red and blue<br/> FILLCOLOR [[255, 255, 255], [255, 128, 0]] ; between white and orange<br/> FILLCOLOR [“blue”, “red”, 1, 0, 0] ; set axial gradient (with the required rotation and border settings), possible values: 0-5 = linear, axial, radial, elliptical, square and rectangle gradients<br/> FILLCOLOR [“red”, “blue”, 0, 90, 20] ; linear with 20% border, rotated with 90 degrees from the actual heading of the turtle<br/> FILLCOLOR [“red”, 'blue”, 0, 90, 20, 0, 0, 200, 50] ; from 200% to 50% intensity<br/> FILLCOLOR [ANY, ANY, 2, 0, 0, 50, 50] ; radial gradient with random colors and 50-50% horizontal and vertical positions of the center<br/></paragraph>
+<paragraph role="heading" level="3" xml-lang="en-US" id="hd_1225">FILLTRANSPARENCY</paragraph>
+<paragraph role="logocode" xml-lang="en-US" id="par_1226"> FILLTRANSPARENCY 80 ; set the transparency of the actual fill color to 80%<br/> FILLTRANSPARENCY [80] ; set linear transparency gradient from 80% to 0%<br/> FILLTRANSPARENCY [80, 20] ; set linear transparency gradient from 80% to 20%<br/> FILLTRANSPARENCY [80, 20, 1, 90] ; set axial transparency gradient rotated with 90 degrees from the actual heading of the turtle<br/> FILLTRANSPARENCY [80, 20, 2, 0, 20, 50, 50] ; set radial transparency gradient from outer 80% to inner 20% transparency with 20% border and with 50-50% horizontal and vertical positions of the center<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_1230">FILLSTYLE</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_1240"> FILLSTYLE 0 ; fill without hatches (default)<br/> FILLSTYLE 1 ; black single hatches (horizontal)<br/> FILLSTYLE 2 ; black single hatches (45 degrees)<br/> FILLSTYLE 3 ; black single hatches (-45 degrees)<br/> FILLSTYLE 4 ; black single hatches (vertical)<br/> FILLSTYLE 5 ; red crossed hatches (45 degrees)<br/> FILLSTYLE 6 ; red crossed hatches (0 degrees)<br/> FILLSTYLE 7 ; blue crossed hatches (45 degrees)<br/> FILLSTYLE 8 ; blue crossed hatches (0 degrees)<br/> FILLSTYLE 9 ; blue triple crossed<br/> FILLSTYLE 10 ; black wide single hatches (45 degrees)<br/> <br/> ; custom hatches specified by a list with the following arguments:<br/> ; – style (1 = single, 2 = double, 3 = triple hatching)<br/> ; – color<br/> ; – distance<br/> ; – degree<br/> <br/> FILLSTYLE [2, “green”, 3pt, 15°] ; green crossed hatches (15 degrees)<br/></paragraph>
 <paragraph role="heading" level="2" xml-lang="en-US" id="hd_1250">Drawing objects</paragraph>
@@ -293,6 +297,8 @@
 <paragraph role="logocode" xml-lang="en-US" id="par_2370"> PRINT SIN 90 * PI/180 ; print 1.0 (sinus of 90° in radians)<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_2380">COS</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_2390"> PRINT COS 0 * PI/180 ; print 1.0 (cosinus of 0° in radians)<br/></paragraph>
+<paragraph role="heading" level="3" xml-lang="en-US" id="hd_2395">LOG10</paragraph>
+<paragraph role="logocode" xml-lang="en-US" id="par_2396"> PRINT LOG10 100 ; print 2.0 (common logarithm of 100)<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_2400">ROUND</paragraph>
 <paragraph role="logocode" xml-lang="en-US" id="par_2410"> PRINT ROUND 3.8 ; print 4 (rounding 3.8)<br/> PRINT ROUND RANDOM 100 ; random integer number (0 &lt;= x &lt;= 100)<br/></paragraph>
 <paragraph role="heading" level="3" xml-lang="en-US" id="hd_2420">ABS</paragraph>