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

SVG and raster images can be embedded in project #4563

Merged
merged 2 commits into from
Dec 7, 2019
Merged
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
25 changes: 23 additions & 2 deletions source/docs/user_manual/introduction/qgis_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -118,11 +118,32 @@ General Settings
System Settings
---------------

.. _svg_paths:

**SVG paths**

Add or Remove :guilabel:`Path(s) to search for Scalable Vector Graphic (SVG)
symbols`. These SVG files are then available to symbolize features or
decorate your map composition.
symbols`. These SVG files are then available to symbolize or label the features
or decorate your map composition.

When using an SVG file in a symbol or a label, QGIS allows you to:

* load the file from the file system: the file is identified through the file path and
QGIS needs to resolve the path in order to display the corresponding image
* load the file from a remote URL: as above, the image will only be loaded on successful
retrieval of the remote resource
* embed the SVG file into the item: the file is embedded inside
the current project, style database, or print layout template.
The SVG file is then always rendered as part of the item.
This is a convenient way to create self-contained projects with custom SVG symbols
which can be easily shared amongst different users and installations of QGIS.

It is also possible to extract the embedded SVG file from a symbol or label
and save it on disk.

.. note:: The above mentioned options for loading and storing an SVG file in a project
are also applicable to raster images you may want to use for customizing
symbols, labels or decorations.

**Plugin paths**

Expand Down