QGIS API Documentation  3.4.15-Madeira (e83d02e274)
Public Member Functions | Public Attributes | List of all members
QgsLayoutExporter::ImageExportSettings Struct Reference

Contains settings relating to exporting layouts to raster images. More...

#include <qgslayoutexporter.h>

Public Member Functions

 ImageExportSettings ()
 Constructor for ImageExportSettings. More...
 

Public Attributes

QgsMargins cropMargins
 Crop to content margins, in pixels. More...
 
bool cropToContents = false
 Set to true if image should be cropped so only parts of the layout containing items are exported. More...
 
double dpi = -1
 Resolution to export layout at. If dpi <= 0 the default layout dpi will be used. More...
 
bool exportMetadata = true
 Indicates whether image export should include metadata generated from the layout's project's metadata. More...
 
QgsLayoutRenderContext::Flags flags = nullptr
 Layout context flags, which control how the export will be created. More...
 
bool generateWorldFile = false
 Set to true to generate an external world file alongside exported images. More...
 
QSize imageSize
 Manual size in pixels for output image. More...
 
QList< int > pages
 List of specific pages to export, or an empty list to export all pages. More...
 

Detailed Description

Contains settings relating to exporting layouts to raster images.

Definition at line 144 of file qgslayoutexporter.h.

Constructor & Destructor Documentation

QgsLayoutExporter::ImageExportSettings::ImageExportSettings ( )
inline

Constructor for ImageExportSettings.

Definition at line 147 of file qgslayoutexporter.h.

Member Data Documentation

QgsMargins QgsLayoutExporter::ImageExportSettings::cropMargins

Crop to content margins, in pixels.

These margins will be added to the bounds of the exported layout if cropToContents is true.

Definition at line 178 of file qgslayoutexporter.h.

bool QgsLayoutExporter::ImageExportSettings::cropToContents = false

Set to true if image should be cropped so only parts of the layout containing items are exported.

Definition at line 172 of file qgslayoutexporter.h.

double QgsLayoutExporter::ImageExportSettings::dpi = -1

Resolution to export layout at. If dpi <= 0 the default layout dpi will be used.

Definition at line 152 of file qgslayoutexporter.h.

bool QgsLayoutExporter::ImageExportSettings::exportMetadata = true

Indicates whether image export should include metadata generated from the layout's project's metadata.

Since
QGIS 3.2

Definition at line 201 of file qgslayoutexporter.h.

QgsLayoutRenderContext::Flags QgsLayoutExporter::ImageExportSettings::flags = nullptr

Layout context flags, which control how the export will be created.

Definition at line 207 of file qgslayoutexporter.h.

bool QgsLayoutExporter::ImageExportSettings::generateWorldFile = false

Set to true to generate an external world file alongside exported images.

Definition at line 193 of file qgslayoutexporter.h.

QSize QgsLayoutExporter::ImageExportSettings::imageSize

Manual size in pixels for output image.

If imageSize is not set then it will be automatically calculated based on the output dpi and layout size.

If cropToContents is true then imageSize has no effect.

Be careful when specifying manual sizes if pages in the layout have differing sizes! It's likely not going to give a reasonable output in this case, and the automatic dpi-based image size should be used instead.

Definition at line 166 of file qgslayoutexporter.h.

QList< int > QgsLayoutExporter::ImageExportSettings::pages

List of specific pages to export, or an empty list to export all pages.

Page numbers are 0 index based, so the first page in the layout corresponds to page 0.

Definition at line 187 of file qgslayoutexporter.h.


The documentation for this struct was generated from the following file: