Jimcpp 2.1.0
Jimcpp is a high-performance c++ graphics engine.
Loading...
Searching...
No Matches
IColladaMeshWriter.hpp
1// Copyright (C) 2002-2012 Nikolaus Gebhardt
2// This file is part of the "Irrlicht Engine".
3// For conditions of distribution and use, see copyright notice in jimcpp/jimcpp.hpp
4
5#ifndef JPP_I_COLLADA_MESH_WRITER_HPP_INCLUDED
6#define JPP_I_COLLADA_MESH_WRITER_HPP_INCLUDED
7
8#include <jimcpp/core/engine/IMeshWriter.hpp>
9#include <jimcpp/core/engine/ISceneNode.hpp>
10#include <jimcpp/core/engine/IAnimatedMesh.hpp>
11#include <jimcpp/core/engine/SMaterial.hpp>
12
13namespace jpp
14{
15namespace io
16{
17 class IWriteFile;
18} // end namespace io
19
20namespace scene
21{
24 {
32 // constantly shaded surface that is independent of lighting.
33 ECTF_CONSTANT
34 };
35
45
48 {
49 ECCS_DIFFUSE,
50 ECCS_AMBIENT,
51 ECCS_EMISSIVE,
52 ECCS_SPECULAR,
53 ECCS_TRANSPARENT,
54 ECCS_REFLECTIVE
55 };
56
78
90
93 {
94 public:
96
98 virtual E_COLLADA_TECHNIQUE_FX getTechniqueFx(const video::SMaterial& material) const = 0;
99
101
104 virtual s32 getTextureIdx(const video::SMaterial & material, E_COLLADA_COLOR_SAMPLER cs) const = 0;
105
107
112
114
116
118
120
122
124 virtual f32 getTransparency(const video::SMaterial& material) const = 0;
125
127
129 virtual f32 getReflectivity(const video::SMaterial& material) const = 0;
130
132
134 virtual f32 getIndexOfRefraction(const video::SMaterial& material) const = 0;
135
138 virtual bool isExportable(const jpp::scene::ISceneNode * node) const = 0;
139
142 // TODO: Function is not const because there is no const getMesh() function for several Jimcpp nodes.
144
146
150 virtual bool useNodeMaterial(const scene::ISceneNode* node) const = 0;
151
152 };
153
155
160 {
161 public:
162
163 virtual ~IColladaMeshWriterNames () {}
164
166
175 virtual jpp::core::stringc nameForMesh(const scene::IMesh* mesh, int instance) = 0;
176
178
185
187
197 virtual jpp::core::stringc nameForMaterial(const video::SMaterial & material, int materialId, const scene::IMesh* mesh, const scene::ISceneNode* node) = 0;
198 };
199
200
203 {
204 public:
205
207 : Properties(0), DefaultProperties(0), NameGenerator(0), DefaultNameGenerator(0)
208 , WriteTextures(true), WriteDefaultScene(true), ExportSMaterialOnce(true)
209 , AmbientLight(0.f, 0.f, 0.f, 1.f)
210 , UnitMeter(1.f), UnitName("meter")
211 , GeometryWriting(ECGI_PER_MESH)
212 {
213 ParamNamesUV[0] = "U";
214 ParamNamesUV[1] = "V";
215 }
216
219 {
220 if ( Properties )
221 Properties->drop();
222 if ( DefaultProperties )
223 DefaultProperties->drop();
224 if ( NameGenerator )
225 NameGenerator->drop();
226 if ( DefaultNameGenerator )
227 DefaultNameGenerator->drop();
228 }
229
231 //\param writeRoot: 0 = no, 1=yes unless root is scenemanager, 2=yes
232 virtual bool writeScene(io::IWriteFile* file, scene::ISceneNode* root, int writeRoot=1) = 0;
233
234
236 virtual void setWriteTextures(bool write)
237 {
238 WriteTextures = write;
239 }
240
242 virtual bool getWriteTextures() const
243 {
244 return WriteTextures;
245 }
246
248
252 virtual void setWriteDefaultScene(bool write)
253 {
254 WriteDefaultScene = write;
255 }
256
258 virtual bool getWriteDefaultScene() const
259 {
260 return WriteDefaultScene;
261 }
262
264 virtual void setAmbientLight(const video::SColorf &ambientColor)
265 {
266 AmbientLight = ambientColor;
267 }
268
271 {
272 return AmbientLight;
273 }
274
276
279 virtual void setUnit(jpp::f32 meter, const jpp::core::stringc& name)
280 {
281 UnitMeter = meter;
282 UnitName = name;
283 }
284
286 virtual jpp::f32 getUnitMeter() const
287 {
288 return UnitMeter;
289 }
290
293 {
294 return UnitName;
295 }
296
298
306 {
307 GeometryWriting = writeStyle;
308 }
309
312 {
313 return GeometryWriting;
314 }
315
317
324 virtual void setExportSMaterialsOnlyOnce(bool exportOnce)
325 {
326 ExportSMaterialOnce = exportOnce;
327 }
328
329 virtual bool getExportSMaterialsOnlyOnce() const
330 {
331 return ExportSMaterialOnce;
332 }
333
335
338 {
339 if ( p == Properties )
340 return;
341 if ( p )
342 p->grab();
343 if ( Properties )
344 Properties->drop();
345 Properties = p;
346 }
347
350 {
351 return Properties;
352 }
353
355
357 {
358 return DefaultProperties;
359 }
360
362 virtual void setNameGenerator(IColladaMeshWriterNames * nameGenerator)
363 {
364 if ( nameGenerator == NameGenerator )
365 return;
366 if ( nameGenerator )
367 nameGenerator->grab();
368 if ( NameGenerator )
369 NameGenerator->drop();
370 NameGenerator = nameGenerator;
371 }
372
375 {
376 return NameGenerator;
377 }
378
380
382 {
383 return DefaultNameGenerator;
384 }
385
387
388 virtual jpp::core::stringc toNCName(const jpp::core::stringc& oldString, const jpp::core::stringc& prefix=jpp::core::stringc("_NC_")) const = 0;
389
391
393 // TODO: Function is not const because there is no const getMesh() function for several Jimcpp nodes.
395
397
404 {
405 ParamNamesUV[0] = u;
406 ParamNamesUV[1] = v;
407 }
408
409
410 protected:
411 // NOTE: You usually should also call setProperties with the same parameter when using setDefaultProperties
412 virtual void setDefaultProperties(IColladaMeshWriterProperties * p)
413 {
414 if ( p == DefaultProperties )
415 return;
416 if ( p )
417 p->grab();
418 if ( DefaultProperties )
419 DefaultProperties->drop();
420 DefaultProperties = p;
421 }
422
423 // NOTE: You usually should also call setNameGenerator with the same parameter when using setDefaultProperties
424 virtual void setDefaultNameGenerator(IColladaMeshWriterNames * p)
425 {
426 if ( p == DefaultNameGenerator )
427 return;
428 if ( p )
429 p->grab();
430 if ( DefaultNameGenerator )
431 DefaultNameGenerator->drop();
432 DefaultNameGenerator = p;
433 }
434
435 protected:
436 jpp::core::stringc ParamNamesUV[2];
437
438 private:
439 IColladaMeshWriterProperties * Properties;
440 IColladaMeshWriterProperties * DefaultProperties;
441 IColladaMeshWriterNames * NameGenerator;
442 IColladaMeshWriterNames * DefaultNameGenerator;
443 bool WriteTextures;
444 bool WriteDefaultScene;
445 bool ExportSMaterialOnce;
446 video::SColorf AmbientLight;
447 jpp::f32 UnitMeter;
448 jpp::core::stringc UnitName;
449 E_COLLADA_GEOMETRY_WRITING GeometryWriting;
450 };
451
452
453} // end namespace
454} // end namespace
455
456#endif
Base class of most objects of the Jimcpp Engine.
Definition IReferenceCounted.hpp:46
void grab() const
Grabs the object. Increments the reference counter by one.
Definition IReferenceCounted.hpp:96
bool drop() const
Drops the object. Decrements the reference counter by one.
Definition IReferenceCounted.hpp:126
Axis aligned bounding box in 3d dimensional space.
Definition aabbox3d.hpp:22
Interface providing write access to a file.
Definition IWriteFile.hpp:18
Callback interface to use custom names on collada writing.
Definition IColladaMeshWriter.hpp:160
virtual jpp::core::stringc nameForMaterial(const video::SMaterial &material, int materialId, const scene::IMesh *mesh, const scene::ISceneNode *node)=0
Return a name for the material.
virtual jpp::core::stringc nameForMesh(const scene::IMesh *mesh, int instance)=0
Return a unique name for the given mesh.
virtual jpp::core::stringc nameForNode(const scene::ISceneNode *node)=0
Return a unique name for the given node.
Callback interface for properties which can be used to influence collada writing.
Definition IColladaMeshWriter.hpp:93
virtual video::SColor getCustomColor(const video::SMaterial &material, E_COLLADA_COLOR_SAMPLER cs) const =0
Return custom colors for certain color types requested by collada.
virtual bool isExportable(const jpp::scene::ISceneNode *node) const =0
virtual f32 getReflectivity(const video::SMaterial &material) const =0
Reflectivity value for that material.
virtual bool useNodeMaterial(const scene::ISceneNode *node) const =0
Return if the node has it's own material overwriting the mesh-materials.
virtual E_COLLADA_JPP_COLOR getColorMapping(const video::SMaterial &material, E_COLLADA_COLOR_SAMPLER cs) const =0
Return which color from Jimcpp should be used for the color requested by collada.
virtual IMesh * getMesh(jpp::scene::ISceneNode *node)=0
virtual f32 getIndexOfRefraction(const video::SMaterial &material) const =0
Return index of refraction for that material.
virtual E_COLLADA_TRANSPARENT_FX getTransparentFx(const video::SMaterial &material) const =0
Return the transparence color interpretation.
virtual f32 getTransparency(const video::SMaterial &material) const =0
Transparency value for that material.
virtual E_COLLADA_TECHNIQUE_FX getTechniqueFx(const video::SMaterial &material) const =0
Which lighting model should be used in the technique (FX) section when exporting effects (materials)
virtual s32 getTextureIdx(const video::SMaterial &material, E_COLLADA_COLOR_SAMPLER cs) const =0
Which texture index should be used when writing the texture of the given sampler color.
Interface for writing meshes.
Definition IColladaMeshWriter.hpp:203
IColladaMeshWriterProperties * getDefaultProperties() const
Return the original default properties of the writer.
Definition IColladaMeshWriter.hpp:356
virtual E_COLLADA_GEOMETRY_WRITING getGeometryWriting() const
Get the current style of geometry writing.
Definition IColladaMeshWriter.hpp:311
virtual IColladaMeshWriterProperties * getProperties() const
Get properties which are currently used.
Definition IColladaMeshWriter.hpp:349
virtual jpp::core::stringc toNCName(const jpp::core::stringc &oldString, const jpp::core::stringc &prefix=jpp::core::stringc("_NC_")) const =0
Restrict the characters of oldString a set of allowed characters in xs:NCName and add the prefix.
virtual video::SColorf getAmbientLight() const
Return ambient light of the scene which is written.
Definition IColladaMeshWriter.hpp:270
virtual void setExportSMaterialsOnlyOnce(bool exportOnce)
Make certain there is only one collada material generated per Jimcpp material.
Definition IColladaMeshWriter.hpp:324
virtual void setAmbientLight(const video::SColorf &ambientColor)
Sets ambient color of the scene to write.
Definition IColladaMeshWriter.hpp:264
virtual bool getWriteTextures() const
Get if texture information should be written.
Definition IColladaMeshWriter.hpp:242
virtual void setProperties(IColladaMeshWriterProperties *p)
Set properties to use by the meshwriter instead of it's default properties.
Definition IColladaMeshWriter.hpp:337
virtual void setGeometryWriting(E_COLLADA_GEOMETRY_WRITING writeStyle)
Control when and how often a mesh is written.
Definition IColladaMeshWriter.hpp:305
virtual jpp::f32 getUnitMeter() const
Return real world meters to use per unit for all elements and objects.
Definition IColladaMeshWriter.hpp:286
virtual void setUnit(jpp::f32 meter, const jpp::core::stringc &name)
Set the unit distances for all elements and objects.
Definition IColladaMeshWriter.hpp:279
void SetParamNamesUV(const core::stringc &u, const core::stringc &v)
Change param name used for UV's.
Definition IColladaMeshWriter.hpp:403
virtual ~IColladaMeshWriter()
Destructor.
Definition IColladaMeshWriter.hpp:218
virtual jpp::core::stringc getUnitName() const
Return name to use for distance units. Like p.E. "meter".
Definition IColladaMeshWriter.hpp:292
virtual void setWriteDefaultScene(bool write)
Set if a default scene should be written when writing meshes.
Definition IColladaMeshWriter.hpp:252
virtual bool getWriteDefaultScene() const
Get if a default scene should be written.
Definition IColladaMeshWriter.hpp:258
virtual void setWriteTextures(bool write)
Set if texture information should be written.
Definition IColladaMeshWriter.hpp:236
IColladaMeshWriterNames * getDefaultNameGenerator() const
Return the original default name generator of the writer.
Definition IColladaMeshWriter.hpp:381
virtual void setNameGenerator(IColladaMeshWriterNames *nameGenerator)
Install a generator to create custom names on export.
Definition IColladaMeshWriter.hpp:362
virtual bool writeScene(io::IWriteFile *file, scene::ISceneNode *root, int writeRoot=1)=0
writes a scene starting with the given node
virtual const jpp::core::stringc * findGeometryNameForNode(ISceneNode *node)=0
After export you can find out which name had been used for writing the geometry for this node.
virtual IColladaMeshWriterNames * getNameGenerator() const
Get currently used name generator.
Definition IColladaMeshWriter.hpp:374
Interface for writing meshes.
Definition IMeshWriter.hpp:24
Class which holds the geometry of an object.
Definition IMesh.hpp:72
Scene node interface.
Definition ISceneNode.hpp:43
Class representing a 32 bit ARGB color.
Definition SColor.hpp:317
Class representing a color with four floats.
Definition SColor.hpp:574
Class for holding parameters for a material renderer.
Definition SMaterial.hpp:304
E_COLLADA_COLOR_SAMPLER
Color names collada uses in it's color samplers.
Definition IColladaMeshWriter.hpp:48
E_COLLADA_GEOMETRY_WRITING
Control when geometry elements are created.
Definition IColladaMeshWriter.hpp:81
@ ECGI_PER_MESH_AND_MATERIAL
Definition IColladaMeshWriter.hpp:88
@ ECGI_PER_MESH
Default - write each mesh exactly once to collada. Optimal but will not work with many tools.
Definition IColladaMeshWriter.hpp:83
E_COLLADA_TRANSPARENT_FX
How to interpret the opacity in collada.
Definition IColladaMeshWriter.hpp:38
@ ECOF_A_ONE
default - only alpha channel of color or texture is used.
Definition IColladaMeshWriter.hpp:40
@ ECOF_RGB_ZERO
Alpha values for each RGB channel of color or texture are used.
Definition IColladaMeshWriter.hpp:43
E_COLLADA_JPP_COLOR
Jimcpp colors which can be mapped to E_COLLADA_COLOR_SAMPLER values.
Definition IColladaMeshWriter.hpp:59
@ ECIC_SPECULAR
Use SMaterial::SpecularColor.
Definition IColladaMeshWriter.hpp:76
@ ECIC_CUSTOM
Check IColladaMeshWriterProperties for custom color.
Definition IColladaMeshWriter.hpp:64
@ ECIC_EMISSIVE
Use SMaterial::EmissiveColor.
Definition IColladaMeshWriter.hpp:73
@ ECIC_NONE
Don't write this element at all.
Definition IColladaMeshWriter.hpp:61
@ ECIC_DIFFUSE
Use SMaterial::DiffuseColor.
Definition IColladaMeshWriter.hpp:67
@ ECIC_AMBIENT
Use SMaterial::AmbientColor.
Definition IColladaMeshWriter.hpp:70
E_COLLADA_TECHNIQUE_FX
Lighting models - more or less the way Collada categorizes materials.
Definition IColladaMeshWriter.hpp:24
@ ECTF_BLINN
Definition IColladaMeshWriter.hpp:27
@ ECTF_LAMBERT
diffuse shaded surface that is independent of lighting.
Definition IColladaMeshWriter.hpp:31
@ ECTF_PHONG
Phong shading, default in many external renderers.
Definition IColladaMeshWriter.hpp:29
As of Jimcpp 1.6, position2d is a synonym for vector2d.
Definition vector3d.hpp:11
signed int s32
32 bit signed variable.
Definition irrTypes.hpp:72
float f32
32 bit floating point variable.
Definition irrTypes.hpp:110

Jimcpp    @cppfx.xyz

K