KMLExportModelSettings

Encodes geometry into the Khronos COLLADA format.

@example:
# Settings class used to control parameters for exporting models to KML
kmlExportSettings = KMLExportModelSettings()
kmlExportSettings.setOutputPath(ce.toFSPath("models/batchExportTests"))
kmlExportSettings.setBaseName("kml_batchexport")
kmlExportSettings.setCompression(False)
kmlExportSettings.setTerrainLayers(kmlExportSettings.TERRAIN_NONE)
ce.export(ce.selection()[0], kmlExportSettings)
# Turn on the compression to export a KMZ file.
kmzExportSettings = KMLExportModelSettings()
kmzExportSettings.setOutputPath(ce.toFSPath("models/batchExportTests"))
kmzExportSettings.setBaseName("kmz_batchexport")
kmzExportSettings.setCompression(True)
kmlExportSettings.setTerrainLayers(kmzExportSettings.TERRAIN_NONE)
ce.export(ce.selection()[0], kmzExportSettings)

 

Methods defined here:

getAltitudeMode

getAltitudeMode(self):

Gets AltitudeMode field. Tells applications how to read the altitude values in the KML file.

@return: Value of AltitudeMode field.  ["CLAMP_TO_GROUND", "ABSOLUTE"] [str]

getAtlasAddWrapBorder

getAtlasAddWrapBorder(self):

Gets AtlasAddWrapBorder field. Add a border of clamped pixels to protect against wrap mode bleeding.

@return: Value of AtlasAddWrapBorder field.  [True/False]

getBaseName

getBaseName(self):

Gets BaseName field. The base name for all files.

@return: Value of BaseName field.  [str]

getCOLLADAVersion

getCOLLADAVersion(self):

Gets COLLADAVersion field. Specifies the COLLADA version.

@return: Value of COLLADAVersion field.  ["COLLADA_1_4_1", "COLLADA_1_5_0"] [str]

getCollectTextures

getCollectTextures(self):

Gets CollectTextures field. Collects all used textures and copies them into the target folder. All texture references are adjusted accordingly.

@return: Value of CollectTextures field.  [True/False]

getCompression

getCompression(self):

Gets Compression field. Compress exported files.

@return: Value of Compression field.  [True/False]

getCreateShapeGroups

getCreateShapeGroups(self):

Gets CreateShapeGroups field. Create a group/transformation node per shape. Note that generated geometry is only merged inside a shape if enabled.

@return: Value of CreateShapeGroups field.  [True/False]

getCreateTextureAtlases

getCreateTextureAtlases(self):

Gets CreateTextureAtlases field. Creates texture atlases which combine a set of textures into one, thus reducing the number of textures and materials. All textures except COLORMAPs are removed.

@return: Value of CreateTextureAtlases field.  [True/False]

getExistingFiles

getExistingFiles(self):

Gets ExistingFiles field. Specifies how files should be written during the export run. The log file will be written anyways.

@return: Value of ExistingFiles field.  ["OVERWRITE", "SKIP"] [str]

getExportGeometry

getExportGeometry(self):

Gets ExportGeometry field. Choose what geometry is exported. 'Models with Shape Fallback' writes the Start Shape if the Model generation fails. 'Models' skips to the next export item if the Model generation fails. 'Shapes' always writes the Start Shape and disregards the Model generation.

@return: Value of ExportGeometry field.  ["MODEL_GEOMETRY_FALLBACK", "MODEL_GEOMETRY", "SHAPE_GEOMETRY"] [str]

getExportLog

getExportLog(self):

Returns a dictionary containing details of the export.

@return: A dictionary containing details about the finished export.

getFacesWithHoles

getFacesWithHoles(self):

Gets FacesWithHoles field. Specifies how faces with holes should be handled during the export.

@return: Value of FacesWithHoles field.  ["PASS", "TRIANGULATE_FACES_WITH_HOLES", "DISCARD_HOLES", "CONVERT_HOLES_TO_FACES"] [str]

getFileGranularity

getFileGranularity(self):

Gets FileGranularity field. Specifies the partition of the generated geometry into files.

@return: Value of FileGranularity field.  ["MEMORY_BUDGET", "START_SHAPE"] [str]

getGlobalOffset

getGlobalOffset(self):

Gets GlobalOffset field. Global (= for all shapes/models) offset for exported geometry.

@return: Value of GlobalOffset field.  [sequence of float]

getHeadingCorrection

getHeadingCorrection(self):

Gets HeadingCorrection field. Correct heading, i.e. needed for Google Earth Compatibility.

@return: Value of HeadingCorrection field.  ["NONE", "HEADING180"] [str]

getIncludeMaterials

getIncludeMaterials(self):

Gets IncludeMaterials field. Exports material definitions (e.g. color, textures, ...).

@return: Value of IncludeMaterials field.  [True/False]

getLocalOffset

getLocalOffset(self):

Gets LocalOffset field. Local (= per shape or model) offset for exported geometry.

@return: Value of LocalOffset field.  ["NONE", "MODEL_CENTROID", "MODEL_CENTROID_BOTTOM", "SHAPE_CENTROID", "SHAPE_CENTROID_BOTTOM"] [str]

getMaxAtlasDim

getMaxAtlasDim(self):

Gets MaxAtlasDim field. Specifies the maximal dimension of the texture atlases in power-of-2 pixels, e.g. 11 gives a 2048x2048 Atlas.

@return: Value of MaxAtlasDim field.  [int]

getMemoryBudget

getMemoryBudget(self):

Gets MemoryBudget field. Specifies the size limit in megabytes per exported file (value 0 = unlimited). Please note: The size is measured on the unoptimized geometry, i.e. the final size may vary. The check is only performed per input shape.

@return: Value of MemoryBudget field.  [int]

getMergeNormals

getMergeNormals(self):

Gets MergeNormals field. Finds parallel normals (using the precision distance) and shares their index.

@return: Value of MergeNormals field.  [True/False]

getMergeTexcoords

getMergeTexcoords(self):

Gets MergeTexcoords field. Finds identical texture coordinates (using the precision distance) and shares their index.

@return: Value of MergeTexcoords field.  [True/False]

getMergeVertices

getMergeVertices(self):

Gets MergeVertices field. Finds co-incidental vertices (using the precision distance) and shares their index.

@return: Value of MergeVertices field.  [True/False]

getMeshGranularity

getMeshGranularity(self):

Gets MeshGranularity field. Specifies the processing of meshes.

@return: Value of MeshGranularity field.  ["AS_GENERATED", "PER_MATERIAL", "INSTANCED"] [str]

getNormalPrecision

getNormalPrecision(self):

Gets NormalPrecision field. Specifies the minimal difference between normals.

@return: Value of NormalPrecision field.  [float]

getOutputPath

getOutputPath(self):

Gets OutputPath field. Output directory for all exported files.

@return: Value of OutputPath field.  [str]

getPlacemarkLocations

getPlacemarkLocations(self):

Gets PlacemarkLocations field. Tells applications how to handle KML placemark locations.

@return: Value of PlacemarkLocations field.  ["UNPROJECT", "SLOPPY"] [str]

getReportMode

getReportMode(self):

Gets ReportMode field. Specifies how CGA reports are handled.

@return: Value of ReportMode field.  ["NONE", "PROPAGATE_TO_LEAF"] [str]

getScript

getScript(self):

Gets Script field. Python script to use for export callbacks.

@return: Value of Script field.  [str]

getShapeNameDelimiter

getShapeNameDelimiter(self):

Gets ShapeNameDelimiter field. Delimiting character for resolution of shape name clashes.

@return: Value of ShapeNameDelimiter field.  [str]

getSimplifyTerrainMeshes

getSimplifyTerrainMeshes(self):

Gets SimplifyTerrainMeshes field. Perform geometry simplification on terrains.

@return: Value of SimplifyTerrainMeshes field.  [True/False]

getTerrainLayers

getTerrainLayers(self):

Gets TerrainLayers field. Choose how terrain layers are exported.

@return: Value of TerrainLayers field.  ["TERRAIN_ALL_VISIBLE", "TERRAIN_ALL_SELECTED", "TERRAIN_ALL", "TERRAIN_NONE"] [str]

getTexcoordPrecision

getTexcoordPrecision(self):

Gets TexcoordPrecision field. Specifies the minimal distance between texels.

@return: Value of TexcoordPrecision field.  [float]

getTextureCoordinates

getTextureCoordinates(self):

Gets TextureCoordinates field. Choose which - if any - texture coordinate layers to export.

@return: Value of TextureCoordinates field.  ["NONE", "FIRST", "ALL"] [str]

getTriangulateMeshes

getTriangulateMeshes(self):

Gets TriangulateMeshes field. Triangulate resulting meshes (e.g. needed for Google Earth (tm) Collada import).

@return: Value of TriangulateMeshes field.  [True/False]

getVertexIndexing

getVertexIndexing(self):

Gets VertexIndexing field. Choose indexed (shared) or separated vertices between faces.

@return: Value of VertexIndexing field.  ["INDEXED", "SEPARATED"] [str]

getVertexNormals

getVertexNormals(self):

Gets VertexNormals field. Controls the export of vertex normals.

@return: Value of VertexNormals field.  ["PASS", "NONE", "SET_MISSING", "SET_ALL"] [str]

getVertexPrecision

getVertexPrecision(self):

Gets VertexPrecision field. Specifies the minimal distance between vertices.

@return: Value of VertexPrecision field.  [float]

getWriteLog

getWriteLog(self):

Gets WriteLog field. Write a log with information about this export.

@return: Value of WriteLog field.  [True/False]

load

load(self, name):

Load the named settings from the current scene file.

@param name: The name of the settings to load.  [str]
@return: result. [KMLExportModelSettings]

save

save(self, name):

Save the named settings to the current scene file.

@param name: The name of the settings to save.  [str]

setAltitudeMode

setAltitudeMode(self, enumValue):

Sets AltitudeMode field. Tells applications how to read the altitude values in the KML file.

@param enumValue: the new value ["CLAMP_TO_GROUND", "ABSOLUTE"]. [str]

setAtlasAddWrapBorder

setAtlasAddWrapBorder(self, booleanValue):

Sets AtlasAddWrapBorder field. Add a border of clamped pixels to protect against wrap mode bleeding.

@param booleanValue: the new value. [True/False]

setBaseName

setBaseName(self, stringValue):

Sets BaseName field. The base name for all files.

@param stringValue: the new value. [str]

setCOLLADAVersion

setCOLLADAVersion(self, stringValue):

Sets COLLADAVersion field. Specifies the COLLADA version.

@param stringValue: the new value ["COLLADA_1_4_1", "COLLADA_1_5_0"]. [str]

setCollectTextures

setCollectTextures(self, booleanValue):

Sets CollectTextures field. Collects all used textures and copies them into the target folder. All texture references are adjusted accordingly.

@param booleanValue: the new value. [True/False]

setCompression

setCompression(self, booleanValue):

Sets Compression field. Compress exported files.

@param booleanValue: the new value. [True/False]

setCreateShapeGroups

setCreateShapeGroups(self, booleanValue):

Sets CreateShapeGroups field. Create a group/transformation node per shape. Note that generated geometry is only merged inside a shape if enabled.

@param booleanValue: the new value. [True/False]

setCreateTextureAtlases

setCreateTextureAtlases(self, booleanValue):

Sets CreateTextureAtlases field. Creates texture atlases which combine a set of textures into one, thus reducing the number of textures and materials. All textures except COLORMAPs are removed.

@param booleanValue: the new value. [True/False]

setExistingFiles

setExistingFiles(self, stringValue):

Sets ExistingFiles field. Specifies how files should be written during the export run. The log file will be written anyways.

@param stringValue: the new value ["OVERWRITE", "SKIP"]. [str]

setExportGeometry

setExportGeometry(self, enumValue):

Sets ExportGeometry field. Choose what geometry is exported. 'Models with Shape Fallback' writes the Start Shape if the Model generation fails. 'Models' skips to the next export item if the Model generation fails. 'Shapes' always writes the Start Shape and disregards the Model generation.

@param enumValue: the new value ["MODEL_GEOMETRY_FALLBACK", "MODEL_GEOMETRY", "SHAPE_GEOMETRY"]. [str]

setFacesWithHoles

setFacesWithHoles(self, stringValue):

Sets FacesWithHoles field. Specifies how faces with holes should be handled during the export.

@param stringValue: the new value ["PASS", "TRIANGULATE_FACES_WITH_HOLES", "DISCARD_HOLES", "CONVERT_HOLES_TO_FACES"]. [str]

setFileGranularity

setFileGranularity(self, stringValue):

Sets FileGranularity field. Specifies the partition of the generated geometry into files.

@param stringValue: the new value ["MEMORY_BUDGET", "START_SHAPE"]. [str]

setGlobalOffset

setGlobalOffset(self, floatArrayValue):

Sets GlobalOffset field. Global (= for all shapes/models) offset for exported geometry.

@param floatArrayValue: the new value. [sequence of float]

setHeadingCorrection

setHeadingCorrection(self, enumValue):

Sets HeadingCorrection field. Correct heading, i.e. needed for Google Earth Compatibility.

@param enumValue: the new value ["NONE", "HEADING180"]. [str]

setIncludeMaterials

setIncludeMaterials(self, booleanValue):

Sets IncludeMaterials field. Exports material definitions (e.g. color, textures, ...).

@param booleanValue: the new value. [True/False]

setLocalOffset

setLocalOffset(self, stringValue):

Sets LocalOffset field. Local (= per shape or model) offset for exported geometry.

@param stringValue: the new value ["NONE", "MODEL_CENTROID", "MODEL_CENTROID_BOTTOM", "SHAPE_CENTROID", "SHAPE_CENTROID_BOTTOM"]. [str]

setMaxAtlasDim

setMaxAtlasDim(self, intValue):

Sets MaxAtlasDim field. Specifies the maximal dimension of the texture atlases in power-of-2 pixels, e.g. 11 gives a 2048x2048 Atlas.

@param intValue: the new value. [int]

setMemoryBudget

setMemoryBudget(self, intValue):

Sets MemoryBudget field. Specifies the size limit in megabytes per exported file (value 0 = unlimited). Please note: The size is measured on the unoptimized geometry, i.e. the final size may vary. The check is only performed per input shape.

@param intValue: the new value. [int]

setMergeNormals

setMergeNormals(self, booleanValue):

Sets MergeNormals field. Finds parallel normals (using the precision distance) and shares their index.

@param booleanValue: the new value. [True/False]

setMergeTexcoords

setMergeTexcoords(self, booleanValue):

Sets MergeTexcoords field. Finds identical texture coordinates (using the precision distance) and shares their index.

@param booleanValue: the new value. [True/False]

setMergeVertices

setMergeVertices(self, booleanValue):

Sets MergeVertices field. Finds co-incidental vertices (using the precision distance) and shares their index.

@param booleanValue: the new value. [True/False]

setMeshGranularity

setMeshGranularity(self, stringValue):

Sets MeshGranularity field. Specifies the processing of meshes.

@param stringValue: the new value ["AS_GENERATED", "PER_MATERIAL", "INSTANCED"]. [str]

setNormalPrecision

setNormalPrecision(self, floatValue):

Sets NormalPrecision field. Specifies the minimal difference between normals.

@param floatValue: the new value. [float]

setOutputPath

setOutputPath(self, stringValue):

Sets OutputPath field. Output directory for all exported files.

@param stringValue: the new value. [str]

setPlacemarkLocations

setPlacemarkLocations(self, enumValue):

Sets PlacemarkLocations field. Tells applications how to handle KML placemark locations.

@param enumValue: the new value ["UNPROJECT", "SLOPPY"]. [str]

setReportMode

setReportMode(self, stringValue):

Sets ReportMode field. Specifies how CGA reports are handled.

@param stringValue: the new value ["NONE", "PROPAGATE_TO_LEAF"]. [str]

setScript

setScript(self, stringValue):

Sets Script field. Python script to use for export callbacks.

@param stringValue: the new value. [str]

setShapeNameDelimiter

setShapeNameDelimiter(self, stringValue):

Sets ShapeNameDelimiter field. Delimiting character for resolution of shape name clashes.

@param stringValue: the new value. [str]

setSimplifyTerrainMeshes

setSimplifyTerrainMeshes(self, booleanValue):

Sets SimplifyTerrainMeshes field. Perform geometry simplification on terrains.

@param booleanValue: the new value. [True/False]

setTerrainLayers

setTerrainLayers(self, enumValue):

Sets TerrainLayers field. Choose how terrain layers are exported.

@param enumValue: the new value ["TERRAIN_ALL_VISIBLE", "TERRAIN_ALL_SELECTED", "TERRAIN_ALL", "TERRAIN_NONE"]. [str]

setTexcoordPrecision

setTexcoordPrecision(self, floatValue):

Sets TexcoordPrecision field. Specifies the minimal distance between texels.

@param floatValue: the new value. [float]

setTextureCoordinates

setTextureCoordinates(self, stringValue):

Sets TextureCoordinates field. Choose which - if any - texture coordinate layers to export.

@param stringValue: the new value ["NONE", "FIRST", "ALL"]. [str]

setTriangulateMeshes

setTriangulateMeshes(self, booleanValue):

Sets TriangulateMeshes field. Triangulate resulting meshes (e.g. needed for Google Earth (tm) Collada import).

@param booleanValue: the new value. [True/False]

setVertexIndexing

setVertexIndexing(self, stringValue):

Sets VertexIndexing field. Choose indexed (shared) or separated vertices between faces.

@param stringValue: the new value ["INDEXED", "SEPARATED"]. [str]

setVertexNormals

setVertexNormals(self, stringValue):

Sets VertexNormals field. Controls the export of vertex normals.

@param stringValue: the new value ["PASS", "NONE", "SET_MISSING", "SET_ALL"]. [str]

setVertexPrecision

setVertexPrecision(self, floatValue):

Sets VertexPrecision field. Specifies the minimal distance between vertices.

@param floatValue: the new value. [float]

setWriteLog

setWriteLog(self, booleanValue):

Sets WriteLog field. Write a log with information about this export.

@param booleanValue: the new value. [True/False]

Constants

This class defines the following constants:

ABSOLUTE = 'ABSOLUTE'
ALL = 'ALL'
AS_GENERATED = 'AS_GENERATED'
CLAMP_TO_GROUND = 'CLAMP_TO_GROUND'
COLLADA_1_4_1 = 'COLLADA_1_4_1'
COLLADA_1_5_0 = 'COLLADA_1_5_0'
CONVERT_HOLES_TO_FACES = 'CONVERT_HOLES_TO_FACES'
DISCARD_HOLES = 'DISCARD_HOLES'
FIRST = 'FIRST'
HEADING180 = 'HEADING180'
INDEXED = 'INDEXED'
INSTANCED = 'INSTANCED'
MEMORY_BUDGET = 'MEMORY_BUDGET'
MODEL_CENTROID = 'MODEL_CENTROID'
MODEL_CENTROID_BOTTOM = 'MODEL_CENTROID_BOTTOM'
MODEL_GEOMETRY = 'MODEL_GEOMETRY'
MODEL_GEOMETRY_FALLBACK = 'MODEL_GEOMETRY_FALLBACK'
NONE = 'NONE'
OVERWRITE = 'OVERWRITE'
PASS = 'PASS'
PER_MATERIAL = 'PER_MATERIAL'
PROPAGATE_TO_LEAF = 'PROPAGATE_TO_LEAF'
SEPARATED = 'SEPARATED'
SET_ALL = 'SET_ALL'
SET_MISSING = 'SET_MISSING'
SHAPE_CENTROID = 'SHAPE_CENTROID'
SHAPE_CENTROID_BOTTOM = 'SHAPE_CENTROID_BOTTOM'
SHAPE_GEOMETRY = 'SHAPE_GEOMETRY'
SKIP = 'SKIP'
SLOPPY = 'SLOPPY'
START_SHAPE = 'START_SHAPE'
TERRAIN_ALL = 'TERRAIN_ALL'
TERRAIN_ALL_SELECTED = 'TERRAIN_ALL_SELECTED'
TERRAIN_ALL_VISIBLE = 'TERRAIN_ALL_VISIBLE'
TERRAIN_NONE = 'TERRAIN_NONE'
TRIANGULATE_FACES_WITH_HOLES = 'TRIANGULATE_FACES_WITH_HOLES'
UNPROJECT = 'UNPROJECT'