Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Backport release_3.40] Misc updates on Layout items #9475

Merged
merged 4 commits into from
Dec 13, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -280,6 +280,11 @@ QGIS allows advanced rendering for layout items just like vector and raster laye
* |checkbox| :guilabel:`Exclude item from exports`: Combined with data-defined expressions,
you can decide to make an item invisible in some exports.
After activating this checkbox, the item will not be included in export to PDF, print etc..
* :guilabel:`Geospatial PDF group`: When set, a matching layer tree group will be created
in the exported Geospatial PDF and the item will only be visible when this group is checked.
This allows content to be selectively displayed as a group by viewers of the Geospatial PDF.
E.g., it can allow extra layout content such as descriptive labels or legends to only be shown
when layers from the group are visible, making the file export much more flexible.

Variables
.........
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -119,9 +119,16 @@ Appearance

* :guilabel:`Left`, :guilabel:`Center`, :guilabel:`Right` or
:guilabel:`Justify` for :guilabel:`Horizontal alignment`
* and :guilabel:`Top`, :guilabel:`Middle`, :guilabel:`Bottom` for
* and :guilabel:`Top`, :guilabel:`Vertical Center`, :guilabel:`Bottom` for
:guilabel:`Vertical alignment`.

.. _figure_layout_label_appearance:

.. figure:: img/label_appearance.png
:align: center

Label Item Appearance Properties

.. _layout_label_expressions:

Exploring expressions in a label item
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,11 @@ provides the functionalities to set the units of display and some text formattin
QGIS locale, or when you would like to vary the style from the locale
defaults (e.g. adding thousands separators when the locale default is to hide
them).
* Select the :guilabel:`Method` for scale bar calculation: Depending on the map CRS and extent,
the distance reported in the scale bar may not be the same measured over the map.
This option lets you specify the method you would like to use:
:guilabel:`Average Top, Middle and Bottom Scales`, :guilabel:`Calculate along Top of Map`,
:guilabel:`Calculate along Middle of Map` or :guilabel:`Calculate along Bottom of Map`.

Segments
--------
Expand Down Expand Up @@ -119,27 +124,26 @@ subdivisions (see :numref:`figure_layout_scalebar_segments`):
* :guilabel:`Subdivision height` is used to define the height of the subdivision
segment.

Display
--------
Appearance
----------

The :guilabel:`Display` group of the scale bar :guilabel:`Item Properties`
The :guilabel:`Appearance` group of the scale bar :guilabel:`Item Properties`
panel provides the following functionalities:

.. _figure_layout_scalebar_display:
.. _figure_layout_scalebar_appearance:

.. figure:: img/scalebar_display.png
.. figure:: img/scalebar_appearance.png
:align: center

Scale Bar Display group
Scale Bar Appearance group

You can define how the scale bar will be displayed in its frame.

* :guilabel:`Box margin` : space between text and frame borders
* :guilabel:`Label margin` : space between text and scale bar drawing
* :guilabel:`Vertical label placement`: it can be above or below the scale bar
segment
* :guilabel:`Horizontal label placement`: which would be centered at the scale
bar segment's edge or center
* :guilabel:`Distance label placement` defines the position of the text relative to the scale bar segments:
:guilabel:`Above Segment Edges`, :guilabel:`Above Segment Centers`,
:guilabel:`Below Segment Edges` or :guilabel:`Below Segment Centers`
* :guilabel:`Primary fill` and :guilabel:`Secondary fill` of the scale bar
drawing using :ref:`fill symbols properties <vector_fill_symbols>`
(color, opacity, patterns, effects...) --- for *Single Box*, *Double Box*
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions docs/user_manual/print_composer/create_output.rst
Original file line number Diff line number Diff line change
Expand Up @@ -284,6 +284,9 @@ To export a layout as PDF:
* :guilabel:`Include vector feature information` (choose the layers and
group them into logical PDF groups).

.. When expanding on the Geospatial PDF description,
mention also the "Geospatial PDF group" property of layout items?

.. note:: Exporting a print layout to formats that supports georeferencing
(e.g. ``PDF`` and ``TIFF``) creates a georeferenced output by default.

Expand Down
11 changes: 8 additions & 3 deletions docs/user_manual/print_composer/overview_composer.rst
Original file line number Diff line number Diff line change
Expand Up @@ -244,13 +244,14 @@ with some convenient information.
:menuselection:`Layouts -->`
:guilabel:`Layout Properties...` :ref:`layout_panel`
:guilabel:`Rename Layout...`
:guilabel:`Page Properties...` :ref:`page_properties`
|newPage| :guilabel:`Add Pages...` :guilabel:`Layout` :ref:`page_properties`
|fileOpen| :guilabel:`Add Items from Template` :guilabel:`Layout` :ref:`create_layout_item`
|fileSaveAs| :guilabel:`Save as Template...` :guilabel:`Layout` :ref:`layout_manager`
|saveMapAsImage| :guilabel:`Export as Image...` :guilabel:`Layout` :ref:`export_layout_image`
|saveAsSVG| :guilabel:`Export as SVG...` :guilabel:`Layout` :ref:`export_layout_svg`
|saveAsPDF| :guilabel:`Export as PDF...` :guilabel:`Layout` :ref:`export_layout_pdf`
:guilabel:`Page Setup...` :kbd:`Ctrl+Shift+P`
:guilabel:`Printer Page Setup...` :kbd:`Ctrl+Shift+P`
|filePrint| :guilabel:`Print...` :kbd:`Ctrl+P` :guilabel:`Layout` :ref:`create-output`
:guilabel:`Close` :kbd:`Ctrl+Q`
================================================= ========================== ========================== =====================================
Expand Down Expand Up @@ -646,8 +647,12 @@ Updating page properties
........................

Any page can be later customized through the Page :guilabel:`Item Properties` panel.
To access a page's properties, left-click on an empty section of the page
or right-click on a page and select :guilabel:`Page Properties...`.
To access a page's properties, either:

* Left-click on an empty section of the page
* Right-click on a page and select :guilabel:`Page Properties...`.
* Go to :menuselection:`Layout --> Page properties...` while hovering over the page

The :guilabel:`Item Properties` panel opens with settings such as:

* for layouts with several pages, it displays the active page number
Expand Down
Loading