Skip to content

Class Quick3DMapTextureData

ClassList > Quick3DMapTextureData

More...

  • #include <quick3dmaptexturedata.h>

Inherits the following classes: QQuick3DTextureData

Public Properties

Type Name
property QgsRectangle extent
Optional custom extent to render. If not set, uses mapSettings extent.
property bool forceDeferredLayersRepaint
Defers layer repaint requests while a render job is running.
property bool incrementalRendering
When the incrementalRendering property is set to true, the incremental refresh of the terrain data during rendering is allowed.
property QML_ELEMENT QgsQuickMapSettings * mapSettings
The map settings from which to get layers, extent, and output size for rendering.
property bool ready
Whether the texture data is ready to use.

Public Signals

Type Name
signal void extentChanged
Emitted when extent changes.
signal void forceDeferredLayersRepaintChanged
Emitted when forceDeferredLayersRepaint changes.
signal void incrementalRenderingChanged
Emitted when incremental rendering setting changes.
signal void mapSettingsChanged
Emitted when map settings changes.
signal void readyChanged
Emitted when texture rendering is complete and data is ready.

Public Functions

Type Name
Quick3DMapTextureData (QQuick3DObject * parent=nullptr)
Creates a new map texture data provider.
QgsRectangle extent () const
Returns the custom extent for rendering.
bool forceDeferredLayersRepaint () const
Returns whether deferred layers repaint is forced.
bool incrementalRendering () const
Returns whether incremental rendering is enabled.
bool isReady () const
Returns whether the texture data is ready to use.
QgsQuickMapSettings * mapSettings () const
Returns the map settings from which to get layers.
Q_INVOKABLE void render ()
void setExtent (const QgsRectangle & extent)
Sets a custom extent for rendering.
void setForceDeferredLayersRepaint (bool deferred)
Sets whether deferred layers repaint is forced.
void setIncrementalRendering (bool incrementalRendering)
Sets whether incremental rendering is enabled.
void setMapSettings (QgsQuickMapSettings * mapSettings)
Sets the map settings.
~Quick3DMapTextureData () override

Detailed Description

Provides in-memory texture data from rendered map layers for 3D terrain visualization.

This class inherits from QQuick3DTextureData to provide texture data directly in memory, avoiding the need for temporary files. The map is rendered using QGIS rendering engine and the result is exposed as texture data for Qt Quick 3D.

Note:

QML Type: Quick3DMapTextureData

Public Properties Documentation

property extent [1/2]

Optional custom extent to render. If not set, uses mapSettings extent.

QgsRectangle Quick3DMapTextureData::extent;

property forceDeferredLayersRepaint [1/2]

Defers layer repaint requests while a render job is running.

bool Quick3DMapTextureData::forceDeferredLayersRepaint;

property incrementalRendering [1/2]

When the incrementalRendering property is set to true, the incremental refresh of the terrain data during rendering is allowed.

bool Quick3DMapTextureData::incrementalRendering;

property mapSettings [1/2]

The map settings from which to get layers, extent, and output size for rendering.

QML_ELEMENT QgsQuickMapSettings * Quick3DMapTextureData::mapSettings;

property ready

Whether the texture data is ready to use.

bool Quick3DMapTextureData::ready;

Public Signals Documentation

signal extentChanged

Emitted when extent changes.

void Quick3DMapTextureData::extentChanged;

signal forceDeferredLayersRepaintChanged

Emitted when forceDeferredLayersRepaint changes.

void Quick3DMapTextureData::forceDeferredLayersRepaintChanged;

signal incrementalRenderingChanged

Emitted when incremental rendering setting changes.

void Quick3DMapTextureData::incrementalRenderingChanged;

signal mapSettingsChanged

Emitted when map settings changes.

void Quick3DMapTextureData::mapSettingsChanged;

signal readyChanged

Emitted when texture rendering is complete and data is ready.

void Quick3DMapTextureData::readyChanged;

Public Functions Documentation

function Quick3DMapTextureData

Creates a new map texture data provider.

explicit Quick3DMapTextureData::Quick3DMapTextureData (
    QQuick3DObject * parent=nullptr
) 

function extent [2/2]

Returns the custom extent for rendering.

QgsRectangle Quick3DMapTextureData::extent () const

function forceDeferredLayersRepaint [2/2]

Returns whether deferred layers repaint is forced.

bool Quick3DMapTextureData::forceDeferredLayersRepaint () const

function incrementalRendering [2/2]

Returns whether incremental rendering is enabled.

bool Quick3DMapTextureData::incrementalRendering () const

function isReady

Returns whether the texture data is ready to use.

bool Quick3DMapTextureData::isReady () const

function mapSettings [2/2]

Returns the map settings from which to get layers.

QgsQuickMapSettings * Quick3DMapTextureData::mapSettings () const

function render

Q_INVOKABLE void Quick3DMapTextureData::render () 

Starts the asynchronous map rendering process. The readyChanged signal is emitted when rendering completes.


function setExtent

Sets a custom extent for rendering.

void Quick3DMapTextureData::setExtent (
    const QgsRectangle & extent
) 

function setForceDeferredLayersRepaint

Sets whether deferred layers repaint is forced.

void Quick3DMapTextureData::setForceDeferredLayersRepaint (
    bool deferred
) 

function setIncrementalRendering

Sets whether incremental rendering is enabled.

void Quick3DMapTextureData::setIncrementalRendering (
    bool incrementalRendering
) 

function setMapSettings

Sets the map settings.

void Quick3DMapTextureData::setMapSettings (
    QgsQuickMapSettings * mapSettings
) 

function ~Quick3DMapTextureData

Quick3DMapTextureData::~Quick3DMapTextureData () override


The documentation for this class was generated from the following file src/core/3d/quick3dmaptexturedata.h