QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
|
Generates and renders elevation profile plots. More...
#include <qgsprofilerenderer.h>
Signals | |
void | generationFinished () |
Emitted when the profile generation is finished (or canceled). | |
Public Member Functions | |
QgsProfilePlotRenderer (const QList< QgsAbstractProfileSource * > &sources, const QgsProfileRequest &request) | |
Constructor for QgsProfilePlotRenderer, using the provided list of profile sources to generate the results. | |
QgsProfilePlotRenderer (std::vector< std::unique_ptr< QgsAbstractProfileGenerator > > generators, const QgsProfileRequest &request) | |
Constructor for QgsProfilePlotRenderer, using the provided list of profile generators to generate the results. | |
~QgsProfilePlotRenderer () override | |
QVector< QgsAbstractProfileResults::Feature > | asFeatures (Qgis::ProfileExportType type, QgsFeedback *feedback=nullptr) |
Exports the profile results as a set of features. | |
void | cancelGeneration () |
Stop the generation job - does not return until the job has terminated. | |
void | cancelGenerationWithoutBlocking () |
Triggers cancellation of the generation job without blocking. | |
void | generateSynchronously () |
Generate the profile results synchronously in this thread. | |
QVector< QgsProfileIdentifyResults > | identify (const QgsDoubleRange &distanceRange, const QgsDoubleRange &elevationRange, const QgsProfileIdentifyContext &context) |
Identify results visible within the specified ranges. | |
QVector< QgsProfileIdentifyResults > | identify (const QgsProfilePoint &point, const QgsProfileIdentifyContext &context) |
Identify results visible at the specified profile point. | |
void | invalidateAllRefinableSources () |
Invalidates previous results from all refinable sources. | |
bool | invalidateResults (QgsAbstractProfileSource *source) |
Invalidates the profile results from the source with matching ID. | |
bool | isActive () const |
Returns true if the generation job is currently running in background. | |
void | regenerateInvalidatedResults () |
Starts a background regeneration of any invalidated results and immediately returns. | |
void | render (QgsRenderContext &context, double width, double height, double distanceMin, double distanceMax, double zMin, double zMax, const QString &sourceId=QString()) |
Renders a portion of the profile using the specified render context. | |
QImage | renderToImage (int width, int height, double distanceMin, double distanceMax, double zMin, double zMax, const QString &sourceId=QString(), double devicePixelRatio=1.0) |
Renders a portion of the profile to an image with the given width and height. | |
void | replaceSource (QgsAbstractProfileSource *source) |
Replaces the existing source with matching ID. | |
void | setContext (const QgsProfileGenerationContext &context) |
Sets the context in which the profile generation will occur. | |
QgsProfileSnapResult | snapPoint (const QgsProfilePoint &point, const QgsProfileSnapContext &context) |
Snap a point to the results. | |
QStringList | sourceIds () const |
Returns the ordered list of source IDs for the sources used by the renderer. | |
void | startGeneration () |
Start the generation job and immediately return. | |
void | waitForFinished () |
Block until the current job has finished. | |
QgsDoubleRange | zRange () const |
Returns the limits of the retrieved elevation values. | |
Generates and renders elevation profile plots.
This class has two roles:
Step 1, involving the generation of the elevation profiles only needs to occur once. This is done via a call to startGeneration(), which commences generation of the profiles from each source in a separate background thread. When the generation is completed for all sources the generationFinished() signal is emitted.
After the profile is generated, it can be rendered. The rendering step may be undertaken multiple times (e.g. to render to different image sizes or data ranges) without having to re-generate the raw profile data.
Definition at line 58 of file qgsprofilerenderer.h.
QgsProfilePlotRenderer::QgsProfilePlotRenderer | ( | const QList< QgsAbstractProfileSource * > & | sources, |
const QgsProfileRequest & | request | ||
) |
Constructor for QgsProfilePlotRenderer, using the provided list of profile sources to generate the results.
Definition at line 26 of file qgsprofilerenderer.cpp.
QgsProfilePlotRenderer::QgsProfilePlotRenderer | ( | std::vector< std::unique_ptr< QgsAbstractProfileGenerator > > | generators, |
const QgsProfileRequest & | request | ||
) |
Constructor for QgsProfilePlotRenderer, using the provided list of profile generators to generate the results.
Definition at line 40 of file qgsprofilerenderer.cpp.
|
override |
Definition at line 46 of file qgsprofilerenderer.cpp.
QVector< QgsAbstractProfileResults::Feature > QgsProfilePlotRenderer::asFeatures | ( | Qgis::ProfileExportType | type, |
QgsFeedback * | feedback = nullptr |
||
) |
Exports the profile results as a set of features.
Definition at line 429 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::cancelGeneration | ( | ) |
Stop the generation job - does not return until the job has terminated.
Does nothing if the generation is not active.
Definition at line 114 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::cancelGenerationWithoutBlocking | ( | ) |
Triggers cancellation of the generation job without blocking.
The generation job will continue to operate until it is able to cancel, at which stage the generationFinished() signal will be emitted. Does nothing if the generation is not active.
Definition at line 137 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::generateSynchronously | ( | ) |
Generate the profile results synchronously in this thread.
The function does not return until the generation is complete.
This is an alternative to ordinary API (using startGeneration() + waiting for generationFinished() signal). Users are discouraged to use this method unless they have a strong reason for doing it. The synchronous generation blocks the main thread, making the application unresponsive. Also, it is not possible to cancel generation while it is in progress.
Definition at line 89 of file qgsprofilerenderer.cpp.
|
signal |
Emitted when the profile generation is finished (or canceled).
QVector< QgsProfileIdentifyResults > QgsProfilePlotRenderer::identify | ( | const QgsDoubleRange & | distanceRange, |
const QgsDoubleRange & | elevationRange, | ||
const QgsProfileIdentifyContext & | context | ||
) |
Identify results visible within the specified ranges.
Definition at line 410 of file qgsprofilerenderer.cpp.
QVector< QgsProfileIdentifyResults > QgsProfilePlotRenderer::identify | ( | const QgsProfilePoint & | point, |
const QgsProfileIdentifyContext & | context | ||
) |
Identify results visible at the specified profile point.
Definition at line 391 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::invalidateAllRefinableSources | ( | ) |
Invalidates previous results from all refinable sources.
Definition at line 199 of file qgsprofilerenderer.cpp.
bool QgsProfilePlotRenderer::invalidateResults | ( | QgsAbstractProfileSource * | source | ) |
Invalidates the profile results from the source with matching ID.
The matching stored source will be deleted and replaced with source.
Returns true
if results were previously stored for the matching source and have been invalidated.
Definition at line 225 of file qgsprofilerenderer.cpp.
bool QgsProfilePlotRenderer::isActive | ( | ) | const |
Returns true
if the generation job is currently running in background.
Definition at line 165 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::regenerateInvalidatedResults | ( | ) |
Starts a background regeneration of any invalidated results and immediately returns.
Does nothing if the generation is already in progress.
Definition at line 272 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::render | ( | QgsRenderContext & | context, |
double | width, | ||
double | height, | ||
double | distanceMin, | ||
double | distanceMax, | ||
double | zMin, | ||
double | zMax, | ||
const QString & | sourceId = QString() |
||
) |
Renders a portion of the profile using the specified render context.
If sourceId is empty then all sources will be rendered, otherwise only the matching source will be rendered.
Definition at line 323 of file qgsprofilerenderer.cpp.
QImage QgsProfilePlotRenderer::renderToImage | ( | int | width, |
int | height, | ||
double | distanceMin, | ||
double | distanceMax, | ||
double | zMin, | ||
double | zMax, | ||
const QString & | sourceId = QString() , |
||
double | devicePixelRatio = 1.0 |
||
) |
Renders a portion of the profile to an image with the given width and height.
If sourceId is empty then all sources will be rendered, otherwise only the matching source will be rendered.
Definition at line 301 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::replaceSource | ( | QgsAbstractProfileSource * | source | ) |
Replaces the existing source with matching ID.
The matching stored source will be deleted and replaced with source.
Definition at line 220 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::setContext | ( | const QgsProfileGenerationContext & | context | ) |
Sets the context in which the profile generation will occur.
Depending on the sources present, this may trigger automatically a regeneration of results.
Definition at line 170 of file qgsprofilerenderer.cpp.
QgsProfileSnapResult QgsProfilePlotRenderer::snapPoint | ( | const QgsProfilePoint & | point, |
const QgsProfileSnapContext & | context | ||
) |
Snap a point to the results.
Definition at line 359 of file qgsprofilerenderer.cpp.
QStringList QgsProfilePlotRenderer::sourceIds | ( | ) | const |
Returns the ordered list of source IDs for the sources used by the renderer.
Definition at line 54 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::startGeneration | ( | ) |
Start the generation job and immediately return.
Does nothing if the generation is already in progress.
Definition at line 65 of file qgsprofilerenderer.cpp.
void QgsProfilePlotRenderer::waitForFinished | ( | ) |
Block until the current job has finished.
Definition at line 154 of file qgsprofilerenderer.cpp.
QgsDoubleRange QgsProfilePlotRenderer::zRange | ( | ) | const |
Returns the limits of the retrieved elevation values.
Definition at line 285 of file qgsprofilerenderer.cpp.