From f6b3c1b285edf94026b7b7434d2103e9708e0909 Mon Sep 17 00:00:00 2001 From: Harrissou Sant-anna Date: Tue, 21 Jan 2025 02:22:44 +0000 Subject: [PATCH] Clarify cartographic placement for labels using DD button and mention "over point" option --- .../style_library/label_settings.rst | 22 ++++++++++--------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/docs/user_manual/style_library/label_settings.rst b/docs/user_manual/style_library/label_settings.rst index cbbee4afd87..e5d57b3fc01 100644 --- a/docs/user_manual/style_library/label_settings.rst +++ b/docs/user_manual/style_library/label_settings.rst @@ -670,7 +670,7 @@ Point labels placement modes available are: The latter option is especially useful when the symbol size isn't fixed, e.g. if it's set by a data defined size or when using different symbols in a :ref:`categorized ` renderer. - * at a :guilabel:`Maximum Distance` from the feature, which is an optional setting + * within a :guilabel:`Maximum Distance` from the feature, which is an optional setting that allows you to control how far a label can be placed from the feature it's labeling. This works alongside the :guilabel:`Distance` setting to create a range for label placement, adding flexibility to position labels more effectively, especially on busy maps, ensuring @@ -683,15 +683,12 @@ Point labels placement modes available are: (like top left or top right), even if it's a bit farther away from the feature. The label only moves to other positions if there's no room within the maximum distance at your preferred position. - * following a :guilabel:`Position priority` that can be customized or set for - an individual feature using a data defined list of prioritised positions. - This also allows only certain placements to be used, so e.g. - for coastal features you can prevent labels being placed over the land. - - By default, cartographic mode placements are prioritised in the following - order (respecting the `guidelines from Krygier and Wood (2011) + * following a :guilabel:`Position priority` which dictates placement candidates + for anchoring labels around and (centered) over the point feature, + and the order in which the positions are tested. + The default order, based on `guidelines from Krygier and Wood (2011) `_ - and other cartographic textbooks): + and other cartographic textbooks, is as follows: #. top right #. top left @@ -700,7 +697,12 @@ Point labels placement modes available are: #. middle right #. middle left #. top, slightly right - #. bottom, slightly left. + #. bottom, slightly left + + Using the |dataDefine| :sup:`Data-defined override` button, + you can provide a comma separated list of placements in order of priority. + This also allows only certain placements to be used, for certain features only, + so e.g. for coastal features you can prevent labels being placed over the land. * :guilabel:`Around Point`: labels are placed in a circle around the feature with an equal radius set in :guilabel:`Distance`.