Skip to content

Documentation for blank segment map tool#10709

Open
hefniraera wants to merge 2 commits intoqgis:masterfrom
hefniraera:blank-segments
Open

Documentation for blank segment map tool#10709
hefniraera wants to merge 2 commits intoqgis:masterfrom
hefniraera:blank-segments

Conversation

@hefniraera
Copy link
Copy Markdown
Collaborator

Fixes #10569

Goal:

Ticket(s): #

  • Backport to LTR documentation is requested

Copy link
Copy Markdown
Collaborator

@DelazJ DelazJ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "Common parameters" section is dedicated to generic options spread across every symbol types. Particular options, even shared by a few symbol types, are explained (referenced) in (one of) their corresponding symbol section. This new option should then belong to the marker line section and referenced in hash line (already done).
Moreover, I think we should explain why people would need to use that tool (the QEP kind of does that), and how it does actually work, step by step. This is not a common way to adjust symbols and IMHO deserves more explanation.

Note that this tool affects symbol rendering only and does not modify
the underlying feature geometry.

To create blank segments:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not all the following bullet points are about segments creation.


To create blank segments:

* Click near the line to define the start of a blank segment, and click
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Before you click, I think you need to select/configure the data-defined field to store the distances, then select the (eye) tool. I think these steps should be mentioned.
  • Why "click near the line"? Don't you need to click on the line, at the exact position where the blank segment should start? Anyway, I clicked near, I clicked on the line (zoomed as much as possible), raised the search radius..., on my Windows machine, I couldn't get anything visible in the map canvas. Have you successfully created blank segments?
  • And one last (weird) point, interaction with the map canvas is afaict only possible from the Layer Styling panel. The modal "Layer properties" dialog doesn't allow blank segments creation.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for testing this and for the detailed feedback. I'm currently unable to reproduce the blank segments creation either, even on the latest master. The draft was initially based on the screencast, but I agree that the steps need to be verified more thoroughly. I'll investigate this.

Comment on lines +442 to +444
* Drag the start or end of an existing blank segment along the line to
resize it.
* Drag the entire blank segment to move it along the line.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Worth mentioning that these actions (and probably the next one) are possible when the eye tool is active.

@DelazJ DelazJ added the 4.0 QGIS 4.0 new features label Feb 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

4.0 QGIS 4.0 new features

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add map tool to edit blank segments (Request in QGIS)

2 participants