Manages the data of each object of the scene (positions, normals, texture coordinates ...) since each object. More...

#include <qgs3dexportobject.h>

Public Types
enum	ObjectType { TriangularFaces , LineStrip , Points }
	The type of exported geometry. More...

Public Member Functions
	Qgs3DExportObject (const QString &name)
	Qgs3DExportObject Constructs an export object that will be filled with coordinates later.

QVector< unsigned int >	indexes () const
	Returns the vertex indexes.

QString	name () const
	Returns the object name.

QVector< float >	normals () const
	Returns the vertex normal coordinates.

void	objectBounds (float &minX, float &minY, float &minZ, float &maxX, float &maxY, float &maxZ)
	Updates the box bounds explained with the current object bounds This expands the bounding box if the current object outside the bounds of the already established bounds.

QString	saveMaterial (QTextStream &mtlOut, const QString &folder)
	saves the texture of the object and material information

void	saveTo (QTextStream &out, float scale, const QVector3D &center, int precision=6)
	Saves the current object to the output stream while scaling the object and centering it to be visible in exported scene.

void	setMaterialParameter (const QString &parameter, const QString &value)
	Sets a material parameter to be exported in the .mtl file.

void	setName (const QString &name)
	Sets the object name.

void	setSmoothEdges (bool smoothEdges)
	Sets whether triangles edges will look smooth.

void	setTextureImage (const QImage &image)
	Sets the texture image used by the object.

void	setType (ObjectType type)
	Sets the object type.

void	setupFaces (const QVector< uint > &facesIndexes)
	Sets the faces in facesIndexes to the faces in the object.

void	setupLine (const QVector< uint > &facesIndexes)
	sets line vertex indexes

void	setupMaterial (QgsAbstractMaterialSettings *material)
	Sets the material parameters (diffuse color, shininess...) from phong material.

void	setupNormalCoordinates (const QVector< float > &normalsBuffer, const QMatrix4x4 &transform)
	Sets normal coordinates for each vertex.

void	setupPositionCoordinates (const QVector< float > &positionsBuffer, const QMatrix4x4 &transform)
	Sets positions coordinates and does the translation, rotation and scaling.

void	setupTextureCoordinates (const QVector< float > &texturesBuffer)
	Sets texture coordinates for each vertex.

bool	smoothEdges () const
	Returns whether object edges will look smooth.

QImage	textureImage () const
	Returns the texture image used by the object.

QVector< float >	texturesUV () const
	Returns the vertex texture coordinates.

ObjectType	type () const
	Returns the object type.

QVector< float >	vertexPosition () const
	Returns the vertex coordinates.

Detailed Description

Manages the data of each object of the scene (positions, normals, texture coordinates ...) since each object.

Note: Not available in Python bindings

3

Since: QGIS 3.16

Definition at line 40 of file qgs3dexportobject.h.

Member Enumeration Documentation

◆ ObjectType

enum Qgs3DExportObject::ObjectType

The type of exported geometry.

Enumerator
TriangularFaces
LineStrip
Points

Definition at line 44 of file qgs3dexportobject.h.

Constructor & Destructor Documentation

◆ Qgs3DExportObject()

Qgs3DExportObject::Qgs3DExportObject ( const QString & name )

inline

Qgs3DExportObject Constructs an export object that will be filled with coordinates later.

Parameters

name	The name of the parent (Will be useful to define scene hierarchy)

Definition at line 56 of file qgs3dexportobject.h.

Member Function Documentation

◆ indexes()

QVector< unsigned int > Qgs3DExportObject::indexes ( ) const

inline

Returns the vertex indexes.

Definition at line 118 of file qgs3dexportobject.h.

◆ name()

QString Qgs3DExportObject::name ( ) const

inline

Returns the object name.

Definition at line 60 of file qgs3dexportobject.h.

◆ normals()

QVector< float > Qgs3DExportObject::normals ( ) const

inline

Returns the vertex normal coordinates.

Definition at line 112 of file qgs3dexportobject.h.

◆ objectBounds()

void Qgs3DExportObject::objectBounds	(	float &	minX,
		float &	minY,
		float &	minZ,
		float &	maxX,
		float &	maxY,
		float &	maxZ
	)

Updates the box bounds explained with the current object bounds This expands the bounding box if the current object outside the bounds of the already established bounds.

Definition at line 111 of file qgs3dexportobject.cpp.

◆ saveMaterial()

QString Qgs3DExportObject::saveMaterial	(	QTextStream &	mtlOut,
		const QString &	folder
	)

saves the texture of the object and material information

Definition at line 214 of file qgs3dexportobject.cpp.

◆ saveTo()

void Qgs3DExportObject::saveTo	(	QTextStream &	out,
		float	scale,
		const QVector3D &	center,
		int	precision = `6`
	)

Saves the current object to the output stream while scaling the object and centering it to be visible in exported scene.

Definition at line 127 of file qgs3dexportobject.cpp.

◆ setMaterialParameter()

void Qgs3DExportObject::setMaterialParameter	(	const QString &	parameter,
		const QString &	value
	)

inline

Sets a material parameter to be exported in the .mtl file.

Definition at line 101 of file qgs3dexportobject.h.

◆ setName()

void Qgs3DExportObject::setName ( const QString & name )

inline

Sets the object name.

Definition at line 62 of file qgs3dexportobject.h.

◆ setSmoothEdges()

void Qgs3DExportObject::setSmoothEdges ( bool smoothEdges )

inline

Sets whether triangles edges will look smooth.

Definition at line 72 of file qgs3dexportobject.h.

◆ setTextureImage()

void Qgs3DExportObject::setTextureImage ( const QImage & image )

inline

Sets the texture image used by the object.

Definition at line 89 of file qgs3dexportobject.h.

◆ setType()

void Qgs3DExportObject::setType ( ObjectType type )

inline

Sets the object type.

Definition at line 67 of file qgs3dexportobject.h.

◆ setupFaces()

void Qgs3DExportObject::setupFaces ( const QVector< uint > & facesIndexes )

Sets the faces in facesIndexes to the faces in the object.

Definition at line 64 of file qgs3dexportobject.cpp.

◆ setupLine()

void Qgs3DExportObject::setupLine ( const QVector< uint > & facesIndexes )

sets line vertex indexes

Definition at line 69 of file qgs3dexportobject.cpp.

◆ setupMaterial()

void Qgs3DExportObject::setupMaterial ( QgsAbstractMaterialSettings * material )

Sets the material parameters (diffuse color, shininess...) from phong material.

Definition at line 102 of file qgs3dexportobject.cpp.

◆ setupNormalCoordinates()

void Qgs3DExportObject::setupNormalCoordinates	(	const QVector< float > &	normalsBuffer,
		const QMatrix4x4 &	transform
	)

Sets normal coordinates for each vertex.

Definition at line 76 of file qgs3dexportobject.cpp.

◆ setupPositionCoordinates()

void Qgs3DExportObject::setupPositionCoordinates	(	const QVector< float > &	positionsBuffer,
		const QMatrix4x4 &	transform
	)

Sets positions coordinates and does the translation, rotation and scaling.

Definition at line 54 of file qgs3dexportobject.cpp.

◆ setupTextureCoordinates()

void Qgs3DExportObject::setupTextureCoordinates ( const QVector< float > & texturesBuffer )

Sets texture coordinates for each vertex.

Definition at line 97 of file qgs3dexportobject.cpp.

◆ smoothEdges()

bool Qgs3DExportObject::smoothEdges ( ) const

inline

Returns whether object edges will look smooth.

Definition at line 70 of file qgs3dexportobject.h.

◆ textureImage()

QImage Qgs3DExportObject::textureImage ( ) const

inline

Returns the texture image used by the object.

Definition at line 91 of file qgs3dexportobject.h.

◆ texturesUV()

QVector< float > Qgs3DExportObject::texturesUV ( ) const

inline

Returns the vertex texture coordinates.

Definition at line 115 of file qgs3dexportobject.h.

◆ type()

ObjectType Qgs3DExportObject::type ( ) const

inline

Returns the object type.

Definition at line 65 of file qgs3dexportobject.h.

◆ vertexPosition()

QVector< float > Qgs3DExportObject::vertexPosition ( ) const

inline

Returns the vertex coordinates.

Definition at line 109 of file qgs3dexportobject.h.

The documentation for this class was generated from the following files:

/build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/3d/qgs3dexportobject.h
/build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/3d/qgs3dexportobject.cpp

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ ObjectType

Constructor & Destructor Documentation

◆ Qgs3DExportObject()

Member Function Documentation

◆ indexes()

◆ name()

◆ normals()

◆ objectBounds()

◆ saveMaterial()

◆ saveTo()

◆ setMaterialParameter()

◆ setName()

◆ setSmoothEdges()

◆ setTextureImage()

◆ setType()

◆ setupFaces()

◆ setupLine()

◆ setupMaterial()

◆ setupNormalCoordinates()

◆ setupPositionCoordinates()

◆ setupTextureCoordinates()

◆ smoothEdges()

◆ textureImage()

◆ texturesUV()

◆ type()

◆ vertexPosition()