Zooming and panning

[TurboGraphxBeige]

Added more complete documentation about zooming and panning.

[DelazJ]

Hi @TurboGraphxBeige
Thanks for providing the docs' update. Much appreciated. I did not really go through the description as I have some "concerns" with the legibility of the new structure. Would like to get your feedback on my suggestion below. Thanks

[DelazJ]

Better, thanks @TurboGraphxBeige
I miss the "zoom to native resolution" tool.
There's also a need to add link references in https://docs.qgis.org/testing/en/docs/user_manual/introduction/qgis_gui.html#layer, and align occurrences of "zoom to layer(s)" in the whole docs (this can be done in a follow-up PR, to keep backport easier, if I understand @SrNetoChan plans)

[DelazJ]

Suggested change

	- :menuselection:`View --> Pan Map`
	- :menuselection:`Pan Map`

Since the header already mentions it, it looks overkill to repeat at each row. Same for the Layers column.
I'm halved whether we should show the icon in this column too, to visually match what people should look for in the GUI (or a first icon column?).

[TurboGraphxBeige]

It could be nice to show the icons in the View Menu column. I would show them smaller than in the Map Navigation Toolbar column (already the case in the View menu). Is there a way to override the image size or I need to re-declare a smaller image for each icons?

.. |panSmall| image:: /static/common/mActionPan.png
:width: 1em

[DelazJ]

Afaik, you'd need to declare the new references, either:

• in the substitution.rst file and add it in the substitutions list at the end of this file
• or above the substitution list, to limit their scope to this file

But I wonder if this size distinction is really necessary: up to now icons were assigned (almost) the same size, regardless they are on a toolbar or in a menu. Adding a smaller icon for menus (and applying everywhere for coherence and consistency), I'm not sure of how the doc would render but ultimately, I'm afraid it'd add burden on writers (duplicate list of icons and remember which one to use).
I suggested the separate columns for menu and toolbar because I thought some actions were exclusive to menu vs toolbar(*) and had different label or usage. but it's not the case, so probably no need to repeat labels over the columns. What about something like https://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/attribute_table.html#introducing-the-attribute-table-interface (sorry to suggest another formatting. Just trying to find the best easy-to-understand-and-maintain scenario)

* Btw, the top message of qgis/QGIS#40649 should be updated to reflect the actual behavior before it's harvested in 3.18 changelog

[TurboGraphxBeige]

Let me know what you think of the new table structure in the recent commit. I think we're getting there. I also added the "Zoom to Native Resolution" tool. However, I would appreciate a suggestion for the "Usage" column. Honestly, I have never used it and have no idea what it really does.

[DelazJ]

Yes LGTM. Let's get feedback for the usage and merge. Thanks @TurboGraphxBeige

[jakimowb]

"Zoom to Native Resolution" means to zoom to that zoom level, where each pixel of the active raster layer covers one screen pixel. This way no raster pixel get's "hidden", as it is the case in lower map scales.

[saberraz]

AFAIK: it is only for raster layers and matches 1 pixel of raster to 1 pixel of screen.

[DelazJ]

Thanks guys. @TurboGraphxBeige, your choice 😄

[TurboGraphxBeige]

I think that's it. Feel free to rephrase it if needed.

[TurboGraphxBeige]

I'll wait for this PR to be merged then I'll make another PR for the 3.18 related stuff (and fix #6406):

• link references in https://docs.qgis.org/testing/en/docs/user_manual/introduction/qgis_gui.html#layer
• New behavior of Zoom to Layer(s), Zoom to Selection, Pan Map to Selection (Zoom to multiple selected layer(s) in layer tree QGIS#40460 and Zoom and pan to selection from multiple layers QGIS#40857)

[DelazJ]

Asked on the dev list