Request for documentation
From pull request qgis/QGIS#64525
Author: @nyalldawson
QGIS version: 4.0
Placement modes for curved label placement
PR Description:
Implements https://github.com/qgis/QGIS-Enhancement-Proposals/blob/master/qep-404-curved-placement-modes.md
Introduces additional placement "modes" for use with curved labels, allowing for much more fine-grained control over how text is positioned for curved labels.
These additional modes are exposed as options which are visible and enabled whenever a line geometry type layer is set to curved label placement.
A data defined override is available for the new curved placement modes, allowing mixed use of different modes for features within a single layer.
The new modes are:
Default
Existing behavior, no change. Glyphs are placed at regular character and word spacing along the curved line geometry.
Place characters at vertices
When this mode is selected, each individual character from the label text is placed such that their left-baseline position is located at a corresponding vertex from the curved line geometry. I.e. the first character will be placed at the start of the line, the second at the second vertex, the third at the third vertex, etc.
If the curved line geometry does not contain sufficient vertices for the characters present in the label text then the excess characters are ignored and will not be rendered.
If the label’s “distance” setting is non-zero, then the character will be vertically offset from the vertex position by this distance.
Characters are rotated to follow the line angle at the vertex.
Stretch character spacing to fit line
When selected, this mode increases (or decreases) the character spacing used for each label in order to fit the entire text over the actual length of the curved line geometry.
Stretch word spacing to fit line
When selected, this mode increases (or decreases) the word spacing used for each label in order to fit the entire text over the actual length of the curved line geometry.
Sponsored by LINZ
Commits tagged with [need-docs] or [FEATURE]
Request for documentation
From pull request qgis/QGIS#64525
Author: @nyalldawson
QGIS version: 4.0
Placement modes for curved label placement
PR Description:
Implements https://github.com/qgis/QGIS-Enhancement-Proposals/blob/master/qep-404-curved-placement-modes.md
Introduces additional placement "modes" for use with curved labels, allowing for much more fine-grained control over how text is positioned for curved labels.
These additional modes are exposed as options which are visible and enabled whenever a line geometry type layer is set to curved label placement.
A data defined override is available for the new curved placement modes, allowing mixed use of different modes for features within a single layer.
The new modes are:
Default
Existing behavior, no change. Glyphs are placed at regular character and word spacing along the curved line geometry.
Place characters at vertices
When this mode is selected, each individual character from the label text is placed such that their left-baseline position is located at a corresponding vertex from the curved line geometry. I.e. the first character will be placed at the start of the line, the second at the second vertex, the third at the third vertex, etc.
If the curved line geometry does not contain sufficient vertices for the characters present in the label text then the excess characters are ignored and will not be rendered.
If the label’s “distance” setting is non-zero, then the character will be vertically offset from the vertex position by this distance.
Characters are rotated to follow the line angle at the vertex.
Stretch character spacing to fit line
When selected, this mode increases (or decreases) the character spacing used for each label in order to fit the entire text over the actual length of the curved line geometry.
Stretch word spacing to fit line
When selected, this mode increases (or decreases) the word spacing used for each label in order to fit the entire text over the actual length of the curved line geometry.
Sponsored by LINZ
Commits tagged with [need-docs] or [FEATURE]