tdf#105988 tdf#130024 Update Edit Points Bar help page

Created new file text/shared/02/eliminate_points.xhp so that more detailed information on "Eliminate Points" mode is on its own page. - Updated the description of the "Eliminate Points" feature to more accurately describe how the feature works. In AllLangHelp_shared.mk - Added new page text/shared/02/eliminate_points.xhp In source/text/shared/01/05270000.xhp - Added section and variable tags to allow content to be easily embedded in other pages. In source/text/shared/main0227.xhp - Added section and variable tags to allow content to be easily embedded in other pages. - Moved the link to "Converting 2D Objects to Curves, Polygons, and 3D Objects" to a new Related Topics section - Replaced "Edit Points" section with an embedded link to the description in text/shared/01/05270000 (Edit Points mode) to avoid repetition - Replaced "Edit Points" section with an embedded link to the description in text/shared/02/eliminate_points.xhp to avoid repetition. - Created a Related Topics section In text/simpress/02/10080000.xhp - Added variable tags to allow the page to be easily linked from other pages - Changed the Title and Heading 1 from "Curve" to "Curves and Polygons" to reflect current menu options. Change-Id: Ib9038f35b97b4177e11171bfdedd10c0a4149dd2 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/167939 Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org> Tested-by: Jenkins
author: Dione Maddern <dionemaddern@gmail.com> 2024-05-23 16:57:19 +0200
committer: Olivier Hallot <olivier.hallot@libreoffice.org> 2024-05-23 22:54:02 +0200
commit: 35c331d42654a28c9852187474b102db1c987e53 (patch)
tree: be948df882ba41f49564358ba73f0c415dc2bd46 /source/text
parent: 1686a72bcddf4f28d0510e02a1596baf5e6ebdc6 (diff)
4 files changed, 142 insertions, 18 deletions
diff --git a/source/text/shared/01/05270000.xhp b/source/text/shared/01/05270000.xhp
index c158001e0f..35a24d4cad 100644
--- a/source/text/shared/01/05270000.xhp
+++ b/source/text/shared/01/05270000.xhp
@@ -27,9 +27,15 @@
 </history>
 </meta>
 <body>
+<bookmark branch="index" id="bm_id911716062352822">
+<bookmark_value>polygons; edit points mode</bookmark_value>
+<bookmark_value>bezier; edit points mode</bookmark_value>
+<bookmark_value>curves; edit points mode</bookmark_value>
+<bookmark_value>edit points mode; toggle</bookmark_value>
+</bookmark>
 <bookmark branch="hid/.uno:ToggleObjectBezierMode" id="bm_id3155620" localize="false"/>
 <section id="edit_points">
-<h1 id="hd_id3155271"><link href="text/shared/01/05270000.xhp">Edit Points</link></h1>
+<h1 id="hd_id3155271"><variable id="edit_points_h1"><link href="text/shared/01/05270000.xhp">Edit Points</link></variable></h1>
 <paragraph role="paragraph" id="par_id3153391"><ahelp hid=".uno:ToggleObjectBezierMode">Lets you change the shape of the selected drawing object.</ahelp></paragraph>
 </section>
 <section id="howtoget">
diff --git a/source/text/shared/02/eliminate_points.xhp b/source/text/shared/02/eliminate_points.xhp
new file mode 100644
index 0000000000..264526c294
--- /dev/null
+++ b/source/text/shared/02/eliminate_points.xhp
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+<!--
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+-->
+
+<meta>
+  <topic id="textshared02eliminate_pointsxhp" indexer="include" status="PUBLISH">
+    <title id="tit" >Eliminate Points</title>
+    <filename>/text/shared/02/eliminate_points.xhp</filename>
+  </topic>
+</meta>
+<body>
+
+<bookmark branch="index" id="bm_id911716062352822">
+<bookmark_value>bezier; eliminate points</bookmark_value>
+<bookmark_value>polygon; eliminate points</bookmark_value>
+<bookmark_value>curves; eliminate points</bookmark_value>
+</bookmark>
+
+<bookmark xml-lang="en-US" branch="hid/.uno:BezierEliminatePoints" id="bm_id3240924" localize="false"/>
+  
+<section id="eliminate_points_head">
+<h1 id="hd_id3156351"><variable id="eliminate_points_h1"><link href="text/shared/02/eliminate_points.xhp">Eliminate Points</link></variable></h1>
+<paragraph role="paragraph" id="par_id3149441" xml-lang="en-US">
+Enables <menuitem>Eliminate Points</menuitem> mode. If this mode is enabled, you can remove a point by dragging and dropping it onto a space directly between two points that adjoin the point you are eliminating.</paragraph>
+</section>
+
+<section id="howtoget">
+<embed href="text/shared/00/00000004.xhp#from_tabUI"/>
+<paragraph role="paragraph" id="par_id71716404636053">Choose <menuitem>Draw - Eliminate points</menuitem>.</paragraph>
+<embed href="text/shared/00/00000004.xhp#from_toolbars"/>
+<embed href="text/shared/main0227.xhp#eliminate_points_icon"/>
+</section>
+
+<paragraph role="paragraph" id="par_id7165910943528020">To remove a point, left-click on the shape you want to edit, the left-click on the point you want to remove, and drag it to a place directly between the two adjoining points until it snaps into place.</paragraph>
+
+<paragraph role="paragraph" id="par_id311716400141144">You can adjust how close the point needs to be before it snaps into place by adjusting the <link href="text/shared/optionen/01070300.xhp#bm_id3153839"><menuitem>Point reduction</menuitem></link> angle in the <menuitem>Grid</menuitem> settings dialog. The lower the angle, the closer the point needs to be before it snaps into place.</paragraph>
+
+<section id="relatedtopics">
+<embed href="text/simpress/02/10080000.xhp#curves_and_polygons_h1"/>
+<embed href="text/shared/01/05270000.xhp#edit_points_h1"/>
+<embed href="text/shared/main0227.xhp#edit_points_bar_h1"/>
+</section>
+  
+</body>
+</helpdocument>
+\ No newline at end of file
diff --git a/source/text/shared/main0227.xhp b/source/text/shared/main0227.xhp
index 63cdadfeee..e410bb18bb 100644
--- a/source/text/shared/main0227.xhp
+++ b/source/text/shared/main0227.xhp
@@ -31,19 +31,13 @@
 <bookmark_value>Edit Points bar</bookmark_value>
 </bookmark>
 <bookmark branch="hid/.uno:AvailableToolbars?Toolbar:string=bezierobjectbar" id="bm_id791690935896728" localize="false"/>
-<h1 id="hd_id3149987"><link href="text/shared/main0227.xhp">Edit Points Bar</link></h1>
+<h1 id="hd_id3149987"><variable id="edit_points_bar_h1"><link href="text/shared/main0227.xhp">Edit Points Bar</link></variable></h1>
 <paragraph role="paragraph" id="par_id3150402" xml-lang="en-US">The <emph>Edit Points </emph>Bar appears when you select a polygon object and click <emph>Edit Points</emph>.</paragraph>
-</section>
-<switch select="appl">
-<case select="IMPRESS"><embed href="text/simpress/guide/3d_create.xhp#3d_create"/>
-</case>
-<case select="DRAW"><embed href="text/simpress/guide/3d_create.xhp#3d_create"/>
-</case>
-</switch>
 <paragraph role="paragraph" id="par_id3144762" xml-lang="en-US">The functions provided allow you to edit the points of a curve or an object converted to a curve. The following icons are available:</paragraph>
-<h2 id="hd_id3153105">Edit Points</h2>
-<paragraph role="paragraph" id="par_id3159151" xml-lang="en-US">The <link href="text/shared/01/05270000.xhp"><emph>Edit Points</emph></link> icon allows you to activate or deactivate the edit mode for Bézier objects. In the edit mode, individual points of the drawing object can be selected.</paragraph>
-<table id="tbl_id3149664">
+</section>
+
+<embed href="text/shared/01/05270000.xhp#edit_points"/>
+<section id="edit_points_icon"><table id="tbl_id3149664">
 <tablerow>
 <tablecell>
 <paragraph role="paragraph" id="par_id3145366" xml-lang="en-US">
@@ -54,10 +48,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierMove" id="bm_id4528551" localize="false"/>
+
+<section id="move_points">
 <h2 id="hd_id3146976">Move Points</h2>
 <paragraph role="paragraph" id="par_id3147435" xml-lang="en-US"><ahelp hid=".uno:BezierMove">Activates a mode in which you can move points.</ahelp> The mouse pointer displays a small empty square when resting on a point. Drag that point to another location. The curve on both sides of the point follows the movement; the section of the curve between the next points changes shape.</paragraph>
 <paragraph role="paragraph" id="par_id3149481" xml-lang="en-US">Point at the curve between two points or within a closed curve and drag the mouse to shift the entire curve without distorting the form.</paragraph>
+</section>
+
+<section id="move_points_icon">
 <table id="tbl_id3152940">
 <tablerow>
 <tablecell>
@@ -69,10 +70,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierInsert" id="bm_id3061552" localize="false"/>
+
+<section id="insert_points">
 <h2 id="hd_id3150115">Insert Points</h2>
 <paragraph role="paragraph" id="par_id3160478" xml-lang="en-US"><ahelp hid=".uno:BezierInsert">Activates the insert mode. This mode allows you to insert points.</ahelp> You can also move points, just as in the move mode. If, however, you click at the curve between two points and move the mouse a little while holding down the mouse button you insert a new point. The point is a smooth point, and the lines to the control points are parallel and remain so when moved.</paragraph>
 <paragraph role="paragraph" id="par_id3157846" xml-lang="en-US">If you wish to create a corner point you must first insert either a smooth or a symmetrical point which is then converted to a corner point by using <emph>Corner Point</emph>.</paragraph>
+</section>
+
+<section id="insert_points_icon">
 <table id="tbl_id3156180">
 <tablerow>
 <tablecell>
@@ -84,10 +92,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierDelete" id="bm_id7852235" localize="false"/>
+
+<section id="delete_points">
 <h2 id="hd_id3149020">Delete Points</h2>
 <paragraph role="paragraph" id="par_id3148917" xml-lang="en-US"><ahelp hid=".uno:BezierDelete">Use the <emph>Delete Points</emph> icon to delete one or several selected points. If you wish to select several points click the appropriate points while holding down the Shift key.</ahelp></paragraph>
 <paragraph role="paragraph" id="par_id3153766" xml-lang="en-US">First select the points to be deleted, and then click this icon, or press Del.</paragraph>
+</section>
+
+<section id="delete_points_icon">
 <table id="tbl_id3159266">
 <tablerow>
 <tablecell>
@@ -99,9 +114,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierCutLine" id="bm_id1077279" localize="false"/>
+
+<section id="split_curve">
 <h2 id="hd_id3147361">Split Curve</h2>
 <paragraph role="paragraph" id="par_id3151248" xml-lang="en-US"><ahelp hid=".uno:BezierCutLine">The<emph> Split Curve </emph>icon splits a curve. Select the point or points where you want to split the curve, then click the icon</ahelp>.</paragraph>
+</section>
+
+<section id="split_curve_icon">
 <table id="tbl_id3145766">
 <tablerow>
 <tablecell>
@@ -113,10 +135,17 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierConvert" id="bm_id2868052" localize="false"/>
+
+<section id="convert_to_curve">
 <h2 id="hd_id3150345">Convert To Curve</h2>
 <paragraph role="paragraph" id="par_id3148420" xml-lang="en-US"><ahelp hid=".uno:BezierConvert">Converts a curve into a straight line or converts a straight line into a curve.</ahelp> If you select a single point, the curve before the point will be converted. If two points are selected, the curve between both points will be converted. If you select more than two points, each time you click this icon, a different portion of the curve will be converted. If necessary, round points are converted into corner points and corner points are converted into round points.</paragraph>
 <paragraph role="paragraph" id="par_id3150304" xml-lang="en-US">If a certain section of the curve is straight, the end points of the line have a maximum of one control point each. They cannot be modified to round points unless the straight line is converted back to a curve.</paragraph>
+</section>
+
+<section id="convert_to_curve_icon">
 <table id="tbl_id3147132">
 <tablerow>
 <tablecell>
@@ -128,9 +157,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierEdge" id="bm_id1940216" localize="false"/>
+
+<section id="corner_point">
 <h2 id="hd_id3153199">Corner Point</h2>
 <paragraph role="paragraph" id="par_id3148460" xml-lang="en-US"><ahelp hid=".uno:BezierEdge">Converts the selected point or points into corner points.</ahelp> Corner points have two movable control points, which are independent from each other. A curved line, therefore, does not go straight through a corner point, but forms a corner.</paragraph>
+</section>
+
+<section id="convert_to_curve_icon">
 <table id="tbl_id3150982">
 <tablerow>
 <tablecell>
@@ -142,9 +178,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierSmooth" id="bm_id4189903" localize="false"/>
+
+<section id="smooth_transition">
 <h2 id="hd_id3166436">Smooth Transition</h2>
 <paragraph role="paragraph" id="par_id3155510" xml-lang="en-US"><ahelp hid=".uno:BezierSmooth">Converts a corner point or symmetrical point into a smooth point.</ahelp> Both control points of the corner point are aligned in parallel, and can only be moved simultaneously. The control points may differentiate in length, allowing you to vary the degree of curvature.</paragraph>
+</section>
+
+<section id="smooth_transition_icon">
 <table id="tbl_id3154371">
 <tablerow>
 <tablecell>
@@ -156,9 +199,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierSymmetric" id="bm_id184203" localize="false"/>
+
+<section id="symmetric_transiton">
 <h2 id="hd_id3159622">Symmetric Transition</h2>
 <paragraph role="paragraph" id="par_id3155812" xml-lang="en-US"><ahelp hid=".uno:BezierSymmetric">This icon converts a corner point or a smooth point into a symmetrical point.</ahelp> Both control points of the corner point are aligned in parallel and have the same length. They can only be moved simultaneously and the degree of curvature is the same in both directions.</paragraph>
+</section>
+
+<section id="symmetric_transiton_icon">
 <table id="tbl_id3148599">
 <tablerow>
 <tablecell>
@@ -170,9 +220,16 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
 <bookmark xml-lang="en-US" branch="hid/.uno:BezierClose" id="bm_id4041301" localize="false"/>
+
+<section id="close_bezier">
 <h2 id="hd_id3146786">Close Bézier</h2>
 <paragraph role="paragraph" id="par_id3156032" xml-lang="en-US"><ahelp hid=".uno:BezierClose">Closes a line or a curve.</ahelp> A line is closed by connecting the last point with the first point, indicated by an enlarged square.</paragraph>
+</section>
+
+<section id="close_bezier_icon">
 <table id="tbl_id3144508">
 <tablerow>
 <tablecell>
@@ -184,9 +241,11 @@
 </tablecell>
 </tablerow>
 </table>
-<bookmark xml-lang="en-US" branch="hid/.uno:BezierEliminatePoints" id="bm_id3240924" localize="false"/>
-<h2 id="hd_id3156351">Eliminate Points</h2>
-<paragraph role="paragraph" id="par_id3149441" xml-lang="en-US"><ahelp hid=".uno:BezierEliminatePoints">Marks the current point or the selected points for deletion.</ahelp> This happens in the event that the point is located on a straight line. If you convert a curve or a polygon with the <emph>Convert to Curve </emph>icon into a straight line or you change a curve with the mouse so that a point lies on the straight line, it is removed. The angle from which the point reduction is to take place <switchinline select="appl"><caseinline select="DRAW">can be set by choosing <link href="text/shared/optionen/01070300.xhp"><emph>%PRODUCTNAME Draw - Grid</emph></link> in the Options dialog box</caseinline><caseinline select="IMPRESS">can be set by choosing <link href="text/shared/optionen/01070300.xhp"><emph>%PRODUCTNAME Impress - Grid</emph></link> in the Options dialog box</caseinline><defaultinline>is 15° by default.</defaultinline></switchinline></paragraph>
+</section>
+
+<embed href="text/shared/02/eliminate_points.xhp#eliminate_points_head"/>
+
+<section id="eliminate_points_icon">
 <table id="tbl_id3150892">
 <tablerow>
 <tablecell>
@@ -198,5 +257,12 @@
 </tablecell>
 </tablerow>
 </table>
+</section>
+
+<section id="relatedtopics">
+<embed href="text/simpress/guide/3d_create.xhp#3d_create"/>
+<embed href="text/simpress/02/10080000.xhp#curves_and_polygons_h1"/>
+<embed href="text/sdraw/main0200.xhp#main0200"/>
+</section>
 </body>
 </helpdocument>
diff --git a/source/text/simpress/02/10080000.xhp b/source/text/simpress/02/10080000.xhp
index a83fc39e9f..16d1b45b0c 100644
--- a/source/text/simpress/02/10080000.xhp
+++ b/source/text/simpress/02/10080000.xhp
@@ -22,7 +22,7 @@
 <helpdocument version="1.0">
 <meta>
 <topic id="textsimpress0210080000xml" indexer="include" status="PUBLISH">
-<title id="tit" xml-lang="en-US">Curve</title>
+<title id="tit" xml-lang="en-US">Curves and Polygons</title>
 <filename>/text/simpress/02/10080000.xhp</filename>
 </topic>
 <history>
@@ -40,8 +40,8 @@
 <paragraph role="paragraph" id="par_id3149050" xml-lang="en-US" localize="false"/>
 <section id="curve">
 <bookmark xml-lang="en-US" branch="hid/.uno:LineToolbox" id="bm_id3145114" localize="false"/>
-<h1 id="hd_id3149875"><link href="text/simpress/02/10080000.xhp">Curve</link></h1>
-<paragraph role="paragraph" id="par_id3147301" xml-lang="en-US"><ahelp hid=".uno:LineToolbox">The Curve icon on the Drawing bar opens the <emph>Lines</emph> toolbar, where you can add lines and shapes to the current slide.</ahelp></paragraph>
+<h1 id="hd_id3149875"><variable id="curves_and_polygons_h1"><link href="text/simpress/02/10080000.xhp">Curves and Polygons</link></variable></h1>
+<paragraph role="paragraph" id="par_id3147301" xml-lang="en-US"><ahelp hid=".uno:LineToolbox">The <menuitem>Curves and Polygons</menuitem> icon on the Drawing bar opens the <emph>Lines</emph> toolbar, where you can add lines and shapes to the current slide.</ahelp></paragraph>
 </section>
 <paragraph role="paragraph" id="par_id3157873" xml-lang="en-US">If you hold the Shift key down, the movement of the mouse is limited to multiples of 45 degrees. If you hold down the <switchinline select="sys"><caseinline select="MAC">Options</caseinline><defaultinline>Alt</defaultinline></switchinline> key, the new point will not be connected to the last point. This allows you to create objects that consist of curves that are not connected together. If you draw a smaller object while holding down the <switchinline select="sys"><caseinline select="MAC">Option</caseinline><defaultinline>Alt</defaultinline></switchinline> key into a larger object that you have not closed yet, the smaller object is subtracted from the larger one, thus appearing as a hole in the larger one.</paragraph>
 <paragraph role="paragraph" id="par_id3153083" xml-lang="en-US">Closed shapes automatically receive the fill that is displayed in the <emph>Area Style/Filling</emph> box on <emph>Line and Filling</emph> bar. </paragraph>
author	Dione Maddern <dionemaddern@gmail.com>	2024-05-23 16:57:19 +0200
committer	Olivier Hallot <olivier.hallot@libreoffice.org>	2024-05-23 22:54:02 +0200
commit	35c331d42654a28c9852187474b102db1c987e53 (patch)
tree	be948df882ba41f49564358ba73f0c415dc2bd46 /source/text
parent	1686a72bcddf4f28d0510e02a1596baf5e6ebdc6 (diff)