setMaterial operation

Syntax

setMaterial(material)

Parameters

Description

Sets the material attributes of the current shape's material according to material. This operation allows for setting of multiple (all) material attributes in one operation.
The result will be the same as using set() to set each material attribute individually.

Related

Example 1

setMaterial-example

myMaterial = [ "color.r",    "1.0", 
               "color.g",    "0.0", 
               "color.b",    "0.0", 
               "opacitymap", "builtin:default" ]

Lot --> primitiveCube() 
        scaleUV(0,0.25,0.25)
        setMaterial(myMaterial)
        
Using setMaterial() to set a number of material attributes in one operation.

Example 2: loading a .cgamat file

setMaterial-example

Lot --> primitiveSphere()
        setMaterial(readMaterial("materials/Metal2/Metal2.cgamat"))
        
Using setMaterial() and readMaterial() to load a .cgamat material description (including textures) from disk.

CityEngine's CGA Material Encoder allows for writing cgamat files via model export.

Example 3: using a CSV file to define a material

setMaterial-example
RefExampleCSV-->
	primitiveCube()
	setMaterial(readStringTable("exampleMaterial.csv"))    
    

exampleMaterial.csv: color.r,1 color.g,0.5 color.b,0 colormap,builtin:default
Material descriptions in CSV files can be used via readStringTable().

Copyright ©2008-2023 Esri R&D Center Zurich. All rights reserved.