[3D] Add categorized renderer by ptitjano · Pull Request #64569 · qgis/QGIS

ptitjano · 2026-01-16T17:58:06Z

Description

This PR ads support for categorized renderer in QGIS 3D.
On the 3d renderering side this adds:

a new chunk loader called QgsCategorizedChunkLoader
a new 3d renderer called QgsCategorizedChunkLoader

Both implementations are similar to the existing rule based and vector renderers.

On the widget side, this adds:

a new button to preview a symbol and configure it: Qgs3DSymbolButton (a simplified version of its 2D counter part: QgsSymbolButton)
a new widget QgsCategorized3DRendererWidget to configure the renderer. It is similar to its 2D counterpart and it tries to factorize some common code (mostly the model of the tree view used to display the categories)

Some new vector symbol and material utils functions are introduced. They are used in the new widgets:

a function to generate a material (phong, gooch, etc..) from a base color
a function to compute an average color from a material (phong, gooch, etc..)
a function to generate a symbol preview as an icon
a function to copy the material settings from one vector material to an other one

Demo

qgis3d-categorized.mp4

Updates

20 january

rebased on top of Clip large features to the chunk's extent #64005
rebased on top of qgsvectorlayer3drendererwidget: Fix layer update in singlesymbol #64592
use raw pixel data in QgsPhongTexturedMaterialSettings::textureAverageColor instead of slow pixelColor
Don't use QStringList to compare strings
removed Qgs3DRendererCategory::swap
refactored and introduced QgsAbstract3DSymbol::setColorsFromBase
refactored and introduced QgsAbstract3DSymbol::averageColor
add missing dialog mode in Qgs3DSymbolButton

Funded by Stadt Frankfurt am Main

Closes #51640
Closes #53963

github-actions · 2026-01-17T01:03:09Z

🍎 MacOS Qt6 builds

Download MacOS Qt6 builds of this PR for testing.
This app is not notarized, run sudo xattr -d com.apple.quarantine /Applications/QGIS*.app to avoid the warning
(Built from commit c64789a)

🪟 Windows Qt6 builds

Download Windows Qt6 builds of this PR for testing.
(Built from commit c64789a)

src/3d/materials/qgsphongmaterialsettings.cpp

src/3d/materials/qgsphongtexturedmaterialsettings.cpp

src/3d/qgs3dmapscene.cpp

src/3d/qgscategorized3drenderer.cpp

src/3d/symbols/qgs3dsymbolutils.cpp

src/app/3d/qgs3dsymbolbutton.cpp

nyalldawson · 2026-01-19T20:20:50Z

@ptitjano above review is partial only -- i haven't checked the gui or 3d handler yet.

ptitjano · 2026-01-20T15:23:56Z

@ptitjano above review is partial only -- i haven't checked the gui or 3d handler yet.

thanks

python/PyQt6/3d/auto_generated/materials/qgsgoochmaterialsettings.sip.in

python/PyQt6/3d/auto_generated/materials/qgsmetalroughmaterialsettings.sip.in

python/PyQt6/3d/auto_generated/materials/qgsphongmaterialsettings.sip.in

python/PyQt6/3d/auto_generated/materials/qgsphongtexturedmaterialsettings.sip.in

python/PyQt6/3d/auto_generated/materials/qgssimplelinematerialsettings.sip.in

src/3d/qgscategorizedchunkloader_p.cpp

nyalldawson · 2026-03-10T04:15:43Z

src/app/3d/qgs3dsymbolbutton.cpp

+void Qgs3DSymbolButton::showSettingsDialog()
+{
+  QgsPanelWidget *panel = QgsPanelWidget::findParentPanel( this );
+  QgsSingleSymbol3DRendererWidget *widget = new QgsSingleSymbol3DRendererWidget( mLayer, this );


why QgsSingleSymbol3DRendererWidget? QgsSymbol3DWidget would be more appropriate.

Because we need a widget which inherits from QgsPanelWidget. Maybe, the existing QgsSymbol3DWidget could be adapted to inherit from QgsPanelWidget?

More precisely, I don't understand the difference between QgsSingleSymbol3DRendererWidget and QgsSymbol3DWidget

nyalldawson · 2026-03-10T04:18:20Z

src/app/3d/qgscategorized3drendererwidget.cpp

+  : QgsTemplatedCategorizedRendererModel<QgsCategorized3DRenderer>( parent, screen )
+{}
+
+Qt::ItemFlags QgsCategorized3DRendererModel::flags( const QModelIndex &index ) const


there's SO much duplicate code here. is there no way to reduce this via the template QgsTemplatedCategorizedRendererModel? (and similarly with the widget)

I don't mind reducing reducing the duplicate code, quite the opposite. But I was under the impression that this was not the way to do it. Currently, almost no widget code is shared between 2D and 3D. Take for example the rulebasedrenderer. All the code is duplicated.

src/app/3d/qgsvectorlayer3drendererwidget.cpp

nyalldawson · 2026-03-10T04:22:08Z

src/gui/symbology/qgstemplatedcategorizedrendererwidget_p.h

+
+    virtual void sort( int column, Qt::SortOrder order = Qt::AscendingOrder ) override = 0;
+
+    int rowCount( const QModelIndex &parent = QModelIndex() ) const override


you can speed up compilation by moving these to the .cpp file, and then doing something like: https://github.com/qgis/QGIS/blob/master/src/core/project/qgsprojectstoredobjectmanager.cpp#L121

I don't think this can be done because in that cause, one would need to include qgscategorized3drenderer.h in the cpp file. However, one cannot access 3d directory from the gui one. Or am I missing something?

`QgsCategorized3DRenderer::createEntity` is not implemented at the moment. This will be done with QgsCategorizedChunkLoader` in the next commit.

This function calculates a weighted average of the ambient, diffuse, and specular color components to produce a single representative color.

…e color This function calculates a weighted average of the ambient, diffuse, and specular color components to produce a single representative color.

This function calculates a weighted average of the cool, warm, diffuse and specular color components to produce a single representative color.

For phong and gooch, this uses the average logic introduced in the previous commits. For materials with only one color, this returns the base color.

This adds a utility function to get the average color of a 3d symbol.

This adds a new function to generate a preview icon of a vector 3d symbol based on its type (line, point or polygon) and its average color.

This function decomposes a base color into phong material components (ambient, diffuse, specular, shininess).

…e color This function decomposes a base color into phong material components (ambient, specular, shininess).

This function decomposes a base color into gooch components (cool, diffuse, specular, warm, alpha and beta).

…olor For phong and gooch, this uses the base color logic introduced in the previous commits. For materials with only one color, this sets its color.

This methods sets the base color of the material settings associated with a 3D vector symbol.

This function copies the material properties of a vector 3D symbol from one symbol to another.

…olorRamp

And add them in `QgsTemplatedCategorizedRendererModel`.

This will be needed by `Qgs3DSymbolButton` in the next commit.

This widget is used to configure a 3d categorized renderer. Closes: qgis#53963

This prevents fetching features that won't be rendered.

ptitjano self-assigned this Jan 16, 2026

ptitjano added Feature 3D Relates to QGIS' 3D engine or rendering labels Jan 16, 2026

github-actions bot added this to the 4.0.0 milestone Jan 16, 2026

ptitjano force-pushed the symbology-3d-category branch 9 times, most recently from 4d64c84 to 849cc79 Compare January 16, 2026 23:14

ptitjano force-pushed the symbology-3d-category branch 4 times, most recently from 61bf941 to f796430 Compare January 19, 2026 01:00

nyalldawson reviewed Jan 19, 2026

View reviewed changes

ptitjano force-pushed the symbology-3d-category branch 2 times, most recently from d37f249 to 690ab06 Compare January 20, 2026 15:10

ptitjano force-pushed the symbology-3d-category branch from 690ab06 to f78fa15 Compare January 21, 2026 08:30

nyalldawson added the Freeze Exempt Feature Freeze exemption granted label Jan 27, 2026

ptitjano force-pushed the symbology-3d-category branch from f78fa15 to dd6687e Compare February 4, 2026 13:16

github-actions bot added the GUI/UX Related to QGIS application GUI or User Experience label Feb 4, 2026

ptitjano force-pushed the symbology-3d-category branch 3 times, most recently from 410a159 to 7219bba Compare February 4, 2026 13:24

nyalldawson reviewed Mar 10, 2026

View reviewed changes

ptitjano added 21 commits March 11, 2026 17:21

3d/symbols: Use const QgsVectorLayer in createFeatureHandler

e3d8fbb

3d: Initial QgsCategorized3DRenderer implementation

4ff2124

`QgsCategorized3DRenderer::createEntity` is not implemented at the moment. This will be done with QgsCategorizedChunkLoader` in the next commit.

3d: Add qgscategorizedchunkloader

8a40f7c

qgs3dmapscene: Add support for QgsCategorized3DRenderer

d8a1728

tests: Add a "type" field to building testdata

6bdecec

testqgs3drendering: Add a categorized unit test

3d692d1

qgscategorized3drenderer: Add methods to handle categories

f0085de

qgsphongmaterialsettings: Add a function to compute an average color

ab814f0

This function calculates a weighted average of the ambient, diffuse, and specular color components to produce a single representative color.

qgsphongtexturedmaterialsettings: Add a function to compute an averag…

b137b8b

…e color This function calculates a weighted average of the ambient, diffuse, and specular color components to produce a single representative color.

qgsgoochmaterialsettings: Add a function to compute an average color

aabe8b0

This function calculates a weighted average of the cool, warm, diffuse and specular color components to produce a single representative color.

qgsabstractmaterialsettings: Add method to retrieve average color

ddb6ac1

For phong and gooch, this uses the average logic introduced in the previous commits. For materials with only one color, this returns the base color.

qgsabstract3dsymbol: Add materialsettings method

4b5f092

3d: Introduce qgs3dsymbolutils::vectorSymbolAverageColor

02db1ec

This adds a utility function to get the average color of a 3d symbol.

qgs3dsymbolutils: Add vectorSymbolPreviewIcon method

092468a

This adds a new function to generate a preview icon of a vector 3d symbol based on its type (line, point or polygon) and its average color.

qgsphongmaterialsettings: Add method to set colors from a base color

afd707c

This function decomposes a base color into phong material components (ambient, diffuse, specular, shininess).

qgsphongtexturedmaterialsettings: Add method to set colors from a bas…

1b877a6

…e color This function decomposes a base color into phong material components (ambient, specular, shininess).

qgsgoochmaterialsettings: Add method to set colors from a base color

3c2f83e

This function decomposes a base color into gooch components (cool, diffuse, specular, warm, alpha and beta).

qgsabstractmaterialsettings: Add method to set components from base c…

4a97d6c

…olor For phong and gooch, this uses the base color logic introduced in the previous commits. For materials with only one color, this sets its color.

qgs3dsymbolutils: Add setVectorSymbolBaseColor method

b551062

This methods sets the base color of the material settings associated with a 3D vector symbol.

qgs3dsymbolutils: Add copyVectorSymbolMaterial method

c2ca233

This function copies the material properties of a vector 3D symbol from one symbol to another.

qgscategorized3drenderer: Add methods to handle a base symbol and a c…

81dc077

…olorRamp

ptitjano force-pushed the symbology-3d-category branch 2 times, most recently from 984dde1 to 2dcf2b1 Compare March 11, 2026 16:56

ptitjano added 5 commits March 13, 2026 09:19

qgscategorizedsymbolrenderer: factor out common model part

580342b

And add them in `QgsTemplatedCategorizedRendererModel`.

qgssinglesymbol3drendererwidget: Inherit from qgspanelwidget

ed161f8

This will be needed by `Qgs3DSymbolButton` in the next commit.

3d: Introduce qgs3dsymbolbutton

794c604

3d: Introduce qgscategorized3drendererwidget

e0b7bd5

This widget is used to configure a 3d categorized renderer. Closes: qgis#53963

qgscategorizedchunkloader: Add support for filter expression in request

c64789a

This prevents fetching features that won't be rendered.

ptitjano force-pushed the symbology-3d-category branch from 2dcf2b1 to c64789a Compare March 13, 2026 14:58


		virtual void sort( int column, Qt::SortOrder order = Qt::AscendingOrder ) override = 0;

		int rowCount( const QModelIndex &parent = QModelIndex() ) const override

Uh oh!

Conversation

ptitjano commented Jan 16, 2026 • edited by uclaros Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Demo

Updates

20 january

Uh oh!

github-actions bot commented Jan 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🍎 MacOS Qt6 builds

🪟 Windows Qt6 builds

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nyalldawson commented Jan 19, 2026

Uh oh!

ptitjano commented Jan 20, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nyalldawson Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

ptitjano Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ptitjano Mar 11, 2026

Choose a reason for hiding this comment

Uh oh!

nyalldawson Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

ptitjano Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

nyalldawson Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

ptitjano Mar 11, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ptitjano commented Jan 16, 2026 •

edited by uclaros

Loading

github-actions bot commented Jan 17, 2026 •

edited

Loading

ptitjano Mar 11, 2026 •

edited

Loading

ptitjano Mar 11, 2026 •

edited

Loading