QGIS API Documentation 4.1.0-Master (3b8ef1f72a3)
Loading...
Searching...
No Matches
qgs3dexportobject.cpp
Go to the documentation of this file.
1/***************************************************************************
2 Qgs3DExportObject.cpp
3 --------------------------------------
4 Date : June 2020
5 Copyright : (C) 2020 by Belgacem Nedjima
6 Email : gb underscore nedjima at esi dot dz
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#include "qgs3dexportobject.h"
17
18#include "qgs3d.h"
20#include "qgslogger.h"
22
23#include <QDir>
24#include <QImage>
25#include <QMatrix4x4>
26#include <QString>
27#include <QVector3D>
28#include <Qt3DCore/QAttribute>
29#include <Qt3DCore/QBuffer>
30
31using namespace Qt::StringLiterals;
32
33void Qgs3DExportObject::setupPositionCoordinates( const QVector<float> &positionsBuffer, const QMatrix4x4 &transform )
34{
35 mVertexPosition.clear();
36 for ( int i = 0; i < positionsBuffer.size(); i += 3 )
37 {
38 const QVector3D position( positionsBuffer[i], positionsBuffer[i + 1], positionsBuffer[i + 2] );
39 const QVector3D positionFinal = transform.map( position );
40 mVertexPosition << positionFinal.x() << positionFinal.y() << positionFinal.z();
41 }
42}
43
44void Qgs3DExportObject::setupTriangle( const QVector<float> &positionsBuffer, const QVector<uint> &facesIndexes, const QMatrix4x4 &transform )
45{
47 setupPositionCoordinates( positionsBuffer, transform );
48
49 // setup faces
50 mIndexes.clear();
51 for ( int i = 0; i < facesIndexes.size(); i += 3 )
52 {
53 if ( i + 2 >= facesIndexes.size() )
54 continue;
55 // skip invalid triangles
56 if ( facesIndexes[i] == facesIndexes[i + 1] || facesIndexes[i + 1] == facesIndexes[i + 2] || facesIndexes[i] == facesIndexes[i + 2] )
57 continue;
58 for ( int j = 0; j < 3; ++j )
59 mIndexes << facesIndexes[i + j];
60 }
61}
62
63void Qgs3DExportObject::setupLine( const QVector<float> &positionsBuffer )
64{
66 setupPositionCoordinates( positionsBuffer );
67
68 // setup indexes
69 mIndexes.clear();
70 for ( int i = 0; i < mVertexPosition.size(); i += 3 )
71 mIndexes << i / 3 + 1;
72}
73
74void Qgs3DExportObject::setupPoint( const QVector<float> &positionsBuffer )
75{
77 setupPositionCoordinates( positionsBuffer );
78}
79
80void Qgs3DExportObject::setupNormalCoordinates( const QVector<float> &normalsBuffer, const QMatrix4x4 &transform )
81{
82 mNormals.clear();
83
84 // Qt does not provide QMatrix3x3 * QVector3D multiplication so we use QMatrix4x4
85 QMatrix3x3 normal3x3 = transform.normalMatrix();
86 // clang-format off
87 QMatrix4x4 normal4x4( normal3x3( 0, 0 ), normal3x3( 0, 1 ), normal3x3( 0, 2 ), 0,
88 normal3x3( 1, 0 ), normal3x3( 1, 1 ), normal3x3( 1, 2 ), 0,
89 normal3x3( 2, 0 ), normal3x3( 2, 1 ), normal3x3( 2, 2 ), 0,
90 0, 0, 0, 1 );
91 // clang-format on
92
93 for ( int i = 0; i < normalsBuffer.size(); i += 3 )
94 {
95 const QVector3D normalVector( normalsBuffer[i], normalsBuffer[i + 1], normalsBuffer[i + 2] );
96 QVector3D v = normal4x4.mapVector( normalVector );
97 // round numbers very close to zero to avoid tiny numbers like 6e-8 in export
98 if ( qgsFloatNear( v.x(), 0 ) )
99 v.setX( 0 );
100 if ( qgsFloatNear( v.y(), 0 ) )
101 v.setY( 0 );
102 if ( qgsFloatNear( v.z(), 0 ) )
103 v.setZ( 0 );
104 mNormals << v.x() << v.y() << v.z();
105 }
106}
107
108void Qgs3DExportObject::setupTextureCoordinates( const QVector<float> &texturesBuffer )
109{
110 mTexturesUV.clear();
111 mTexturesUV << texturesBuffer;
112}
113
115{
116 mMaterialParameters.clear();
117 QMap<QString, QString> parameters = Qgs3D::toMaterialExportParameters( material );
118 for ( auto it = parameters.begin(); it != parameters.end(); ++it )
119 {
120 mMaterialParameters[it.key()] = it.value();
121 }
122}
123
124void Qgs3DExportObject::objectBounds( float &minX, float &minY, float &minZ, float &maxX, float &maxY, float &maxZ ) const
125{
126 if ( mType != TriangularFaces )
127 return;
128 for ( const unsigned int vertice : qAsConst( mIndexes ) )
129 {
130 const int heightIndex = static_cast<int>( vertice ) * 3 + 1;
131 minX = std::min( minX, mVertexPosition[heightIndex - 1] );
132 maxX = std::max( maxX, mVertexPosition[heightIndex - 1] );
133 minY = std::min( minY, mVertexPosition[heightIndex] );
134 maxY = std::max( maxY, mVertexPosition[heightIndex] );
135 minZ = std::min( minZ, mVertexPosition[heightIndex + 1] );
136 maxZ = std::max( maxZ, mVertexPosition[heightIndex + 1] );
137 }
138}
139
140void Qgs3DExportObject::saveTo( QTextStream &out, float scale, const QVector3D &center, int precision ) const
141{
142 // Set groups
143 // turns out grouping doest work as expected in blender
144 out << qSetRealNumberPrecision( precision );
145
146 // smoothen edges
147 if ( mSmoothEdges )
148 out << "s on\n";
149 else
150 out << "s off\n";
151
152 // Construct vertices
153 // As we can have holes in the face list and we only write vertices from these faces
154 // then the vertex list in the obj is not the whole from mVertexPosition!
155 for ( const unsigned int vertice : qAsConst( mIndexes ) )
156 {
157 const int i = static_cast<int>( vertice * 3 );
158 // for now just ignore wrong vertex positions
159 out << "v ";
160 out << ( mVertexPosition[i] - center.x() ) / scale << " ";
161 out << ( mVertexPosition[i + 1] - center.y() ) / scale << " ";
162 out << ( mVertexPosition[i + 2] - center.z() ) / scale << "\n";
163 if ( i + 3 <= mNormals.size() )
164 {
165 out << "vn " << mNormals[i] << " " << mNormals[i + 1] << " " << mNormals[i + 2] << "\n";
166 }
167 const int u_index = i / 3 * 2;
168 if ( u_index + 1 < mTexturesUV.size() )
169 {
170 // TODO: flip texture in a more appropriate way (for repeated textures)
171 out << "vt " << mTexturesUV[u_index] << " " << 1.0f - mTexturesUV[u_index + 1] << "\n";
172 }
173 }
174
175 bool hasTextures = mTexturesUV.size() == mVertexPosition.size() / 3 * 2;
176 // if the object has normals then the normals and positions buffers should be the same size
177 bool hasNormals = mNormals.size() == mVertexPosition.size();
178
179 if ( !hasNormals && !mNormals.empty() )
180 {
181 QgsDebugError( "Vertex normals count and vertex positions count are different" );
182 }
183 const int verticesCount = mIndexes.size();
184
185 // we use negative indexes as this is the way to use relative values to reference vertex positions
186 // Positive values are absolute vertex position from the beginning of the file.
187 auto getVertexIndex = [&]( unsigned int i ) -> QString {
188 const int negativeIndex = static_cast<int>( i - verticesCount );
189 if ( hasNormals && !hasTextures )
190 return u"%1//%2"_s.arg( negativeIndex ).arg( negativeIndex );
191 if ( !hasNormals && hasTextures )
192 return u"%1/%2"_s.arg( negativeIndex ).arg( negativeIndex );
193 if ( hasNormals && hasTextures )
194 return u"%1/%2/%3"_s.arg( negativeIndex ).arg( negativeIndex ).arg( negativeIndex );
195 return QString::number( negativeIndex );
196 };
197
198 if ( mType == TriangularFaces )
199 {
200 // Construct triangular faces
201 // As we have "compressed" the vertex/normal section above by using only the vertices referenced by the faces
202 // we do not need to the 'mIndexes[i]' value but only the 'i' value.
203 for ( int i = 0; i < mIndexes.size(); i += 3 )
204 {
205 out << "f " << getVertexIndex( i );
206 out << " " << getVertexIndex( i + 1 );
207 out << " " << getVertexIndex( i + 2 );
208 out << "\n";
209 }
210 }
211 else if ( mType == LineStrip )
212 {
213 out << "l";
214 for ( const unsigned int i : qAsConst( mIndexes ) )
215 out << " " << getVertexIndex( i );
216 out << "\n";
217 }
218 else if ( mType == Points )
219 {
220 out << "p";
221 for ( const unsigned int i : qAsConst( mIndexes ) )
222 out << " " << getVertexIndex( i );
223 out << "\n";
224 }
225}
226
227QString Qgs3DExportObject::saveMaterial( QTextStream &mtlOut, const QString &folderPath ) const
228{
229 QString materialName = mName + "_material";
230 if ( mMaterialParameters.size() == 0 && ( mTexturesUV.size() == 0 || mTextureImage.isNull() ) )
231 return QString();
232 mtlOut << "newmtl " << materialName << "\n";
233 if ( mTexturesUV.size() != 0 && !mTextureImage.isNull() )
234 {
235 const QString filePath = QDir( folderPath ).filePath( materialName + ".jpg" );
236 mTextureImage.save( filePath, "JPG" );
237 mtlOut << "\tmap_Kd " << materialName << ".jpg" << "\n";
238 }
239 for ( auto it = mMaterialParameters.constBegin(); it != mMaterialParameters.constEnd(); it++ )
240 {
241 mtlOut << "\t" << it.key() << " " << it.value() << "\n";
242 }
243 mtlOut << "\tillum 2\n";
244 return materialName;
245}
void setupPoint(const QVector< float > &positionsBuffer)
sets point positions coordinates
QString saveMaterial(QTextStream &mtlOut, const QString &folder) const
saves the texture of the object and material information
void setupMaterial(QgsAbstractMaterialSettings *material)
Sets the material parameters (diffuse color, shininess...) to be exported in the ....
void setupTriangle(const QVector< float > &positionsBuffer, const QVector< uint > &facesIndexes, const QMatrix4x4 &transform)
sets triangle indexes and positions coordinates
void setupNormalCoordinates(const QVector< float > &normalsBuffer, const QMatrix4x4 &transform)
Sets normal coordinates for each vertex.
void saveTo(QTextStream &out, float scale, const QVector3D &center, int precision=6) const
Saves the current object to the output stream while scaling the object and centering it to be visible...
void objectBounds(float &minX, float &minY, float &minZ, float &maxX, float &maxY, float &maxZ) const
Updates the box bounds explained with the current object bounds This expands the bounding box if the ...
void setupLine(const QVector< float > &positionsBuffer)
sets line indexes and positions coordinates
void setupTextureCoordinates(const QVector< float > &texturesBuffer)
Sets texture coordinates for each vertex.
static QMap< QString, QString > toMaterialExportParameters(const QgsAbstractMaterialSettings *settings)
Returns the parameters to be exported to .mtl file.
Definition qgs3d.cpp:150
Abstract base class for material settings.
bool qgsFloatNear(float a, float b, float epsilon=4 *FLT_EPSILON)
Compare two floats (but allow some difference).
Definition qgis.h:7088
#define QgsDebugError(str)
Definition qgslogger.h:59