A function to reset and empty the scene.

from simlabpy import *
scene = Scene()
scene.reset()

A function to delete a scene node from the scene.

from simlabpy import *
scene = Scene()
sceneNode = scene.getSelectedNode()
scene.remove(sceneNode)

A function to import a supported file format to the scene.

from simlabpy import *
filePath = "D:\\Users\\SimLab\\Desktop\\geometry.fbx"
scene = Scene()
node = scene.importFile(filePath)
runtime = RunTime()
runtime.ui.alert(node.name)

A function to import a SIM or ZIM file to the scene with its environment settings.

from simlabpy import *
filePath = "D:\\Users\\SimLab\\Desktop\\geometry_with_environment.sim"
scene = Scene()
node = scene.importFileWithEnvironment(filePath)
runtime = RunTime()
runtime.ui.alert(node.name)

A function to toggle the saving mode between save and save as.

from simlabpy import *
saveAsBool = False
scene = Scene()
scene.setSavingModeToSaveAs(saveAsBool)
runtime = RunTime()
runtime.ui.alert(str(bool(saveAsBool)))

A function to open a supported file format in the scene.

from simlabpy import *
filePath = "D:\\Users\\SimLab\\Desktop\\geometry.sim"
scene = Scene()
scene.openFile(filePath)

A function for exporting the scene to a supported file format.

from simlabpy import *
filePath = "D:\\Users\\SimLab\\Desktop\\geometry.fbx"
scene = Scene()
scene.exportFile(filePath)

A function for exporting the scene to a supported file format with scene states.

from simlabpy import *
sceneStates =  []
scene = Scene()
sceneState1 = scene.getSceneStateByName("Scene1")
sceneState2 = scene.getSceneStateByName("Scene2")
sceneStates.append(sceneState1)
sceneStates.append(sceneState2)
filePath = "D:\\Users\\SimLab\\Desktop\\geometry.pdf"
scene.exportFile(filePath, sceneStates)

A function to save the scene as SIM or ZIM file format (Ver. 11.0+).

from simlabpy import *
filePath = "C:\\Users\\SimLab\\Desktop\\Box.sim"
scene = Scene()
scene.saveFile(filePath)

A function for rendering the scene to an image.

from simlabpy import *
imagePath = "D:\\Users\\SimLab\\Desktop\\render.jpg"
skipOpenFolder = False
width = 1920
height = 1080
scene = Scene()
scene.render(imagePath, width, height, skipOpenFolder)

A function for rendering an animation to a sequence of images.

from simlabpy import *
outputFolderPath = "D:\\Users\\SimLab\\Desktop\\AnimationOutput"
beginFrame = 0
endFrame = 100
scene = Scene()
scene.renderAnimation(outputFolderPath, beginFrame, endFrame)

A getter function to retrieve the rendering setting object property.

from simlabpy import *
scene = Scene()
renderSettings = scene.getRenderSettings()
spp = renderSettings.spp 
runtime = RunTime()
runtime.ui.alert(str(spp))

A getter function to retrieve the VR setting object property (Ver. 11.0+).

from simlabpy import *
scene = Scene()
vrSettings = scene.getVrSettings()
vrSettings.setEnableNightMode(True)

A function to pack the scene and its resource files into a zipped file.

from simlabpy import *
scene = Scene()
outputFilePath = "D:\\Users\\SimLab\\Desktop\\pack.zip"
baseFileFormat = "sim"
scene.packTheScene(outputFilePath, baseFileFormat)

A function to convert a sequence of images to a video file.

from simlabpy import *
inputImagesFolderPath = "D:\\Users\\SimLab\\Desktop\\images"
outputFolderPath = "D:\\Users\\SimLab\\Desktop\\output"
videoQuality = "maximum"
frameRate = 30
outputFormat = "mp4"
audioFilePath = "D:\\Users\\Simlab\\Music\\Soundtracks\\300\\300 Come And Get Them.mp3"
scene = Scene()
scene.movieMaker(outputFolderPath, inputImagesFolderPath, videoQuality, frameRate, outputFormat, audioFilePath)

A function to bake the textures of the selected scene nodes in the scene.

from simlabpy import *
smart = True
scene = Scene()
scene.selectAllNodes()
scene.bakeTexture(smart)

A function to bake textures of a list of scene nodes from the scene.

from simlabpy import *
scene = Scene()
boxNode = scene.getNodeByName("Box")
sphereNode = scene.getNodeByName("Sphere")
nodes = [] 
nodes.append(boxNode) 
nodes.append(sphereNode) 
smart = True
scene.bakeTexture(nodes, smart)

A function to bake the textures of the scene nodes in the scene that have some animation, where each scene nodes's texture gets baked individually by isolating the it in order to avoid shadows casted from any other scene node.

from simlabpy import *
scene = Scene()
boxNode = scene.getNodeByName("Box")
sphereNode = scene.getNodeByName("Sphere")
nodes = [] 
nodes.append(boxNode) 
nodes.append(sphereNode) 
smart = True
scene.bakeTextureForAnimation(nodes, smart)

A setter function that allows altering the settings of texture baking process.

from simlabpy import *
minSize = 1024
maxSize = 2048
spp = 1000
qualityLevelTop = True
optimizeBakingTime = False
maxPolygonsPerObject = 50000
scene = Scene()
scene.setTextureBakingSettings(minSize, maxSize, spp, qualityLevelTop, optimizeBakingTime, maxPolygonsPerObject)

A function to bake light and shadow maps of the selected scene nodes in the scene (Ver. 12.0+).

from simlabpy import *
smart = True
scene = Scene()
scene.selectAllNodes()
scene.bakeLight(smart)

A function to bake light and shadow maps of a list of scene nodes from the scene (Ver. 12.0+).

from simlabpy import *
scene = Scene()
boxNode = scene.getNodeByName("Box")
sphereNode = scene.getNodeByName("Sphere")
nodes = [] 
nodes.append(boxNode) 
nodes.append(sphereNode) 
smart = True
scene.bakeLight(nodes, smart)

A function that handle automatic animation creation for doors and cabinets as sequences, the functions requires a pattern file (.simlabaa).

from simlabpy import *
inputFilePath = "D:\\Users\\SimLab\\Desktop\\pattern.simlabaa"
scene = Scene()
scene.createDoorAndCabinetsAnimation(inputFilePath)

A function that retrieves a reference to a scene node that has a particuler name.

from simlabpy import *
nodeName = "Box"
scene = Scene()
boxNode = scene.getNodeByName(nodeName)

A function that retrieves a reference to the first scene node that matches the substring.

from simlabpy import *
subString = "box-"
scene = Scene()
boxSceneNode = scene.getNodeBySubString(subString)
sceneNodeName = boxSceneNode.getName()
runtime = RunTime()
runtime.ui.alert(str(sceneNodeName))

A function that retrieves a list of all scene nodes matching the substring.

from simlabpy import *
subString = "box-"
scene = Scene()
boxSceneNodes = scene.getNodesBySubString(subString)
sceneNodeName = boxSceneNodes[0].getName()
runtime = RunTime()
runtime.ui.alert(str(sceneNodeName))

A function that retrieves a reference to a scene state that has a particuler name.

from simlabpy import *
sceneStateName = "Scene1"
scene = Scene()
sceneState = scene.getSceneStateByName(sceneStateName)

A function that retrieves a reference to a material that has a particuler name.

from simlabpy import *
materialName = "Material-1"
scene = Scene()
mat = scene.getMaterialByName(materialName)
diffuseColor = mat.getDiffuseColor()
redChannel = diffuseColor.red()
runtime = RunTime()
runtime.ui.alert(str(redChannel))

A function to get all materials from the scene (Ver. 11.1+).

from simlabpy import *
scene = Scene()
sceneMaterialsList = scene.getMaterialsFromScene()
runtime = RunTime() 
for sceneMaterial in sceneMaterialsList: 
materialName = sceneMaterial.getName()
runtime.ui.alert(materialName)

A function to get a material from the given library name (Ver. 11.1+).

from simlabpy import *
libraryName = "SimLabMTL"
materialName = "Blocks Red"
scene = Scene()
boxMaterial = scene.getMaterialByName("Box-Material")
materialFromLibrary = scene.getMaterialFromLibrary(libraryName, materialName)
boxMaterial.set(materialFromLibrary)

A function that captures a new scene state for the scene.

from simlabpy import *
scene = Scene()
sceneState = scene.captureSceneState()

A function that captures a new scene state for the selected scene nodes.

from simlabpy import *
scene = Scene()
sceneState = scene.captureSceneStateFromSelection()

A setter function to set the page template for 3D PDF export.

from simlabpy import *
scene = Scene()
pdfTemplateFilePath = "C:\\Users\\SimLab\\AppData\\Roaming\\SimLab\\SimLab Composer
10\\data\\templates\\General\\Interior.stf"
scene.setPDFTemplateFileName(pdfTemplateFilePath)
output ="D:\\Users\\SimLab\\Desktop\\example.pdf"
scene.exportFile(output)

A function to generate a preview image for the scene.

from simlabpy import *
scene = Scene()
outputImagePath = "D:\\Users\\SimLab\\Desktop\\output.jpg"
outputImageWidth = 100
outputImageHeight = 120
scene.captureSceneImage(outputImagePath, outputImageWidth, outputImageHeight)

A function to create a new material in the scene.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()

A function to create a new camera in the scene.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()

A function to create a new light in the scene.

from simlabpy import *
scene = Scene()
newLight = scene.createLight()

A function to create an instance of a scene node in the scene.

from simlabpy import *
scene = Scene()
sceneNode = scene.getNodeByName("Box")
boxInstance = scene.createInstanceOf(sceneNode)

A function to create a copy of a scene node in the scene (Ver. 11.0+).

from simlabpy import *
scene = Scene()
sceneNode = scene.getNodeByName("Box")
boxCopy = scene.createCopyOf(sceneNode)

A function to create round table animation for the active camera.

from simlabpy import *
scene = Scene()
rotateClockWise = True
scene.createRoundTableCameraAnimation(rotateClockWise)

A function that computes the volume and the bounding box of the scene, then writes them in a text file (.txt).

from simlabpy import *
scene = Scene()
txtfilePath = "D:\\Users\\SimLab\\Desktop\\data.txt"
scene.exportSceneData(txtfilePath)

A function to isolate a scene node in the scene.

from simlabpy import *
scene = Scene()
sceneNode = scene.getNodeByName("Box")
scene.isolate(sceneNode)

A function to unisolate the scene.

from simlabpy import *
scene = Scene()
scene.unisolate()

A function to snap a scene node that has a particular name to Ground.

from simlabpy import *
scene = Scene()
nodeName = "Box"
scene.snapToGround(nodeName)

A function to retain scene materials with their properties from a file (.smp).

from simlabpy import *
materialPaletteFilePath = "D:\\Users\\SimLab\\Desktop\\palette.smp"
retainType = "material"
scene = Scene()
scene.retainMaterialPalette(materialPaletteFilePath, retainType)

A function to export the scene to a SimLab VR package (.vrpackage)

from simlabpy import *
outputFile = "D:\\Users\\SimLab\\Desktop\\level.vrpackage"
packageTitle = "Tower Building"
packagePublisher =  "SimLab Soft"
packageDescription = "A walkthrough experience in a tower building"
packageType = "3d"
packageImage = "D:\\Users\\SimLab\\Desktop\\thumbnail.jpg"
optimize = True
scene = Scene()
createdSuccessfully = scene.exportVrPackage(outputFile, packageTitle, packagePublisher,packageDescription, packageType, packageImage, optimize)

A function that adds a new attribute to the scene node in the scene.

from simlabpy import *
sceneNodeName = "Box"
attributeName = "height"
attributeValue = "200"
attributeCategory = ""
scene = Scene()
succeeded = scene.addAttribute(sceneNodeName, attributeName, attributeValue, attributeCategory)

A function overload to replace all scene nodes in the scene that match certain string criteria by an imported file.

from simlabpy import *
includes = "Sphere"
doesNotInclude = ""
inputFilePath = "D:\\Users\\SimLab\\Desktop\\box.fbx"
scene = Scene()
scene.replaceObject(includes, doesNotInclude, inputFilePath)

A function overload to replace a scene nodes in the scene that match certain string criteria with other nodes in the scene that match other string criteria (Ver. 11.0+).

from simlabpy import *
objectNameToReplace = "Box"
objectNameToReplaceObjectsWith = "Sphere"
deleteReplaceWithObjects = False
useOldName = False
scene = Scene()
scene.replaceObject(objectNameToReplace, objectNameToReplaceObjectsWith, deleteReplaceWithObjects, useOldName)

A function overload to replace scene node with another (Ver. 11.0+).

from simlabpy import *
objectNameToReplace = "Box"
objectNameToReplaceObjectsWith = "Sphere"
deleteReplaceWithObjects = False
useOldName = False
scene = Scene()
box = scene.getNodeByName(objectNameToReplace)
sphere = scene.getNodeByName(objectNameToReplaceObjectsWith)
scene.replaceObject(box, sphere, deleteReplaceWithObjects, useOldName)

A function to detemine whether SimLab Composer is running in the GUI mode or not.

from simlabpy import *
scene = Scene()
guiMode = scene.isGUIMode()
runtime = RunTime()
runtime.ui.alert(str(guiMode))

A function to retrieve the selected scene node in the scene.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNodeName = selectedSceneNode.getName()
runtime = RunTime()
runtime.ui.alert(selectedSceneNodeName)

A function giving the ability to apply replace rules that replace geometries, materials, visual effects, lights, water, Viewer Start, cameras, and/or VR cameras in a scene.

from simlabpy import *
filePath = "C:\\Users\\SimLab\\Desktop\\replaceRules.simlabrr"
scene = Scene()
scene.applyReplaceRules(filePath)

A function to merge identical materials in the scene.

from simlabpy import *
scene = Scene()
scene.mergeIdenticalMaterials()

A function to merge scene nodes on material.

from simlabpy import *
scene = Scene()
boxSceneNode1 = scene.getNodeByName("box1")
boxSceneNode2 = scene.getNodeByName("box2")
sceneNodes = [boxSceneNode1, boxSceneNode2]
scene.mergeNodesOnMaterial(sceneNodes)

A function to decimate mesh(es), where it combines vertices, decimate the mesh(es), and generate normals.

from simlabpy import *
scene = Scene()
boxSceneNode1 = scene.getNodeByName("box1")
boxSceneNode2 = scene.getNodeByName("box2")
sceneNodes = [boxSceneNode1, boxSceneNode2]
decimationPercentage = 80.0
scene.decimateMeshes(sceneNodes, decimationPercentage)

A function to smooth normals of geometries, where it combines vertices and generates normals.

from simlabpy import *
scene = Scene()
boxSceneNode1 = scene.getNodeByName("box1")
boxSceneNode2 = scene.getNodeByName("box2")
sceneNodes = [boxSceneNode1, boxSceneNode2]
scene.smoothNormals(sceneNodes)

A function to optimize textures of the scene, it collects maps in one directory, optionally removes duplicated maps, optionally scales maps based on a maximum size, optionally scales environment map based on a maximum size, and optionally optimizes textures based on the VR device.

from simlabpy import *
scene = Scene()
scene.optimizeTextures() # Optimize textures using the default settings, where compressMaps = True, removeDuplicatedMaps = False, maxMapWidth = 1024, maxMapHeight = 1024, maxEnvironmentWidth = 1024, maxEnvironmentHeight = 512, outputDirectory = "")

from simlabpy import *
scene = Scene()
compressMaps = True
removeDuplicatedMaps = True
maxMapWidth = maxMapHeight = 0 # Setting both of the variables to zero will disable scaling for maps.
maxEnvironmentWidth = maxEnvironmentHeight = 0 # Setting both of the variables to zero will disable scaling for environment maps.
outputDirectory = "C:\\Users\\SimLab\\AppData\\Roaming\\SimLab\SimLab Composer 10\\data\\texture\\" # The default path of the Textures directory.
scene.optimizeTextures(compressMaps, removeDuplicatedMaps, maxMapWidth, maxMapHeight, maxEnvironmentWidth, maxEnvironmentHeight, outputDirectory)

A function to optimize the scene for VR devices by merging identical materials and objects based-on identical materials. The VR optimization is applicable for the file formats: OBJ, FBX, GLTF, USDZ, and VRPackage. Note: Bear in mind that the VR optimization excludes the follow from the operation: scene states, animation/sequences, and attiributes (Ver. 12.0+).

from simlabpy import *
scene = Scene()
scene.optimizeForVR()

A function to replace material of a scene node (basic shape or 3D object) with another material.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
newMaterial = scene.createMaterial()
success = scene.replaceMaterial(selectedSceneNode, newMaterial)

A function that retrieves a list of integers containing of 4 elements representing the number of objects, vertices, polygons, and lines, respectively, for a scene node (Ver. 10.22+).

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
infoList = scene.findGeometricalInfo(selectedSceneNode)
numberOfObjects = infoList[0]  # The 1st element represents number of objects.
numberOfVertices = infoList[1] # The 2nd element represents number of vertices.
numberOfPolygons = infoList[2] # The 3rd element represents number of polygons.
numberOfLines = infoList[3]    # The 4th element represents number of lines.
runtime = RunTime()
runtime.ui.alert(str(numberOfObjects))
runtime.ui.alert(str(numberOfVertices))
runtime.ui.alert(str(numberOfPolygons))
runtime.ui.alert(str(numberOfLines))

A function to select given scene nodes in the scene (Ver. 11.1+).

from simlabpy import *
scene = Scene()
sceneNodes = scene.getNodesBySubString("Box")
scene.selectNodes(sceneNodes)

A function to select all scene nodes in the scene (Ver. 12.0+).

from simlabpy import *
scene = Scene()
scene.selectAllNodes()

A function to select then delete all scene nodes in the scene (Ver. 12.0+).

from simlabpy import *
scene = Scene()
scene.removeAllNodes()

A function to create a bounding box for the given node (Ver. 12.0+).

from simlabpy import *
scene = Scene()
sceneNode = scene.getNodeByName("Boxes")
boundingBox = scene.createBoundingBox(sceneNode)

A getter function to get the Field of View of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
fieldOfView = newCamera.getFov()
runtime = RunTime()
runtime.ui.alert(str(fieldOfView))

A getter function to get the roll of a camera in degrees (Ver. 12.2+).

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
cameraRoll = newCamera.getRoll()
runtime = RunTime()
runtime.ui.alert(str(cameraRoll))

A getter function to get the Position of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
cameraPosition = newCamera.getPosition()
cameraPositionX = cameraPosition.getX()
runtime = RunTime()
runtime.ui.alert(str(cameraPositionX))

A getter function to get the target position of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
targetPosition = newCamera.getTargetPosition()
targetPositionX = targetPosition.getX()
runtime = RunTime()
runtime.ui.alert(str(targetPositionX))

A getter function to get the up vector of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
cameraUpVector = newCamera.getUp()
cameraUpVectorX = cameraUp.getX()
runtime = RunTime()
runtime.ui.alert(str(cameraUpVectorX))

A setter function that sets a new value for the Field of View of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
fieldOfView = 60
newCamera.setFov(fieldOfView)
newFieldOfView = newCamera.getFov()
runtime = RunTime()
runtime.ui.alert(str(newFieldOfView))

A setter function that sets a new value for the roll (in degrees) of a camera (Ver. 12.2+).

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
cameraRoll = 45.0 # Unit is in degrees
newCamera.setRoll(cameraRoll)
newCameraRoll = newCamera.getRoll()
runtime = RunTime()
runtime.ui.alert(str(newCameraRoll))

A setter function that sets a new vector for the position of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
newPosition = Vector3()
newCamera.setPosition(newPosition)

A setter function that sets a new vector for the target position of a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
newTargetPosition = Vector3()
newCamera.setTargetPosition(newTargetPosition)

A setter function that sets a new up vector for a camera.

from simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
newUpVector = Vector3()
newCamera.setUp(newUpVector)

A function that retrieves the center of the bounding box of a scene node.

from simlabpy import *
scene = Scene()
sceneNode = scene.getSelectedNode()
sceneNodeBoundingBox = BoundingBox(sceneNode)
sceneNodeBoundingBoxCenter = sceneNodeBoundingBox.getCenter()
sceneNodeBoundingBoxCenterX = sceneNodeBoundingBoxCenter.getX()
runtime = RunTime()
runtime.ui.alert(str(sceneNodeBoundingBoxCenterX))

A function that retrieves the maximum X, the maximum Y, and the maximum Z of the bounding box.

from simlabpy import *
sceneNode = Scene()
sceneNode = scene.getSelectedNode()
sceneNodeBoundingBox = BoundingBox(sceneNode)
sceneNodeBoundingBoxMax = sceneNodeBoundingBox.getMax()
sceneNodeBoundingBoxMaxX = sceneNodeBoundingBoxMax.getX()
runtime = RunTime()
runtime.ui.alert(str(sceneNodeBoundingBoxMaxX))

A function that retrieves the minimum X, the minimum Y, and the minimum Z of the bounding box.

from simlabpy import *
scene = Scene()
sceneNode = scene.getSelectedNode()
sceneNodeBoundingBox = BoundingBox(sceneNode)
sceneNodeBoundingBoxMin = sceneNodeBoundingBox.getMin()
sceneNodeBoundingBoxMinX = sceneNodeBoundingBoxMin.getX()
runtime = RunTime()
runtime.ui.alert(str(sceneNodeBoundingBoxMinX))

A function to apply a scene state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
sceneState.apply()

A function to inquire if the scene state considers the material(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
materialIncluded = sceneState.isMaterialIncluded()
runtime = RunTime()
runtime.ui.alert(str(materialIncluded))

A function to inquire if the scene state considers the camera state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
cameraIncluded =  sceneState.isCameraIncluded()
runtime = RunTime()
runtime.ui.alert(str(cameraIncluded))

A function to inquire if the scene state considers the visibility(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
visibilityIncluded =  sceneState.isVisibilityIncluded()
runtime = RunTime()
runtime.ui.alert(str(visibilityIncluded))

A function to inquire if the scene state considers the light(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
lightIncluded =  sceneState.isLightIncluded()
runtime = RunTime()
runtime.ui.alert(str(lightIncluded))

A function to inquire if the scene state considers the environment state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
EnvironmentIncluded =  sceneState.isEnvironmentIncluded()
runtime = RunTime()
runtime.ui.alert(str(EnvironmentIncluded))

A function to inquire if the scene state considers the transform(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
transformIncluded = sceneState.isTransformIncluded()
runtime = RunTime()
runtime.ui.alert(str(transformIncluded))

A function to set a scene state to include the material(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeMaterialState = False
sceneState.setMaterialIncluded(includeMaterialState)

A function to set a scene state to include the camera state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeCameraState = False
sceneState.setCameraIncluded(includeCameraState)

A function to set a scene state to include the visibility state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeVisibilityState = False
sceneState.setVisibilityIncluded(includeVisibilityState)

A function to set a scene state to include the light(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeLightState = False
sceneState.setLightIncluded(includeLightState)

A function to set a scene state to include the environment state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeEnvironmentState = False
sceneState.setEnvironmentIncluded(includeEnvironmentState)

A function to set a scene state to include the transform(s) state.

from simlabpy import *
scene = Scene()
sceneState = scene.getSceneStateByName("Scene1")
includeTransformState = False
sceneState.setTransformIncluded(includeTransformState)

A function to set the active view as a camera's view.

rom simlabpy import *
scene = Scene()
newCamera = scene.createCamera()
runtime = RunTime()
runtime.setView(newCamera)

A function to set the active view to some predefined view.

rom simlabpy import *
runtime = RunTime()
topView = runtime.STANDARD_VIEW_TOP
runtime.setView(topView)

A function to make all scene content to fit in the active view.

from simlabpy import *
runtime = RunTime()
drawingAreaWidth = 200
drawingAreaHeight  = 200
zoomOutFactor  = 0
runtime.fitAll(drawingAreaWidth, drawingAreaHeight, zoomOutFactor)

A getter function to get the references object of the application (Ver. 11.0+).

from simlabpy import *
runtime = RunTime()
preferences = runtime.getPreferences()

A function that retrieves the value of a boolean preference property from the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "ShowIconsOnly"
value = prefs.getBool(preferenceName)
runtime.ui.alert(str(value))

A function that retrieves the value of a string preference property from the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "ContentDirectory"
value = prefs.getString(preferenceName)
runtime.ui.alert(str(value))

A function that retrieves the value of a float preference property from the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "RotationSpeed"
value = prefs.getFloat(preferenceName)
runtime.ui.alert(str(value))

A function that sets a new value for a boolean preference property in the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "ShowIconsOnly"
newBooleanValue = False
value = prefs.set(preferenceName, newBooleanValue)
runtime.ui.alert(str(prefs.getBool(preferenceName)))

A function that sets a new value for a string preference property in the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "ContentDirectory"
newStringValue = "E:\\Users\\SimLab\\AppData\\Roaming\\SimLab\\SimLab Composer 10\\data"
value = prefs.set(preferenceName, newStringValue)
runtime.ui.alert(prefs.getString(preferenceName))

A function that sets a new value for a float preference property in the application references of SimLab Composer.

from simlabpy import *
runtime = RunTime()
prefs = runtime.preferences
preferenceName = "ContentDirectory"
newFloatValue = "2.6"
value = prefs.set(preferenceName, newFloatValue)
runtime.ui.alert(str(prefs.getFloat(preferenceName)))

A function that shows, for the user, a dialog box that contain a checkbox to let him/her make a decision.

from simlabpy import *
message = "Do you want to import a new model?"
label = "Yes"
init = False
runtime = RunTime()
answer = runtime.ui.getBool(message, label, init)
runtime.ui.alert(str(answer))

A function that shows, for the user, a dialog box to allow the user to enter a string.

from simlabpy import *
runtime = RunTime()
message = "Enter object name:"
newObjectName = runtime.ui.getString(message)
runtime.ui.alert(newObjectName)

A function that shows, for the user, a dialog box to allow the user to select a value from a spinner.

from simlabpy import *
runtime = RunTime()
fromInt = False
message = "Please enter a new brightness value for the render settings"
label = "Brightness"
init = 3.1
brightness = runtime.ui.getValue(fromInt, message, label, init)
runtime.ui.alert(str(brightness))

A function that shows, for the user, a dialog box to allow the user to select a color from a color picker.

from simlabpy import *
runtime = RunTime()
title = "Please pick a color for the material:"
newColor = runtime.ui.getColor(title)
newColorR = newColor.red()
runtime.ui.alert(str(newColorR))

A function that shows, for the user, a dialog box to allow the user to select a scene node from the scene.

from simlabpy import *
runtime = RunTime()
lightNode = runtime.ui.getNode("Pick a light to change its properties:")
lightNodeName = lightNode.getName()
runtime.ui.alert(lightNodeName)

A function that shows, for the user, a dialog box that has a list to allow the user to select multiple scene nodes from the scene.

from simlabpy import *
runtime = RunTime()
message = "Select the nodes that you want to bake it:"
nodes = runtime.ui.getNodeArray(message)
nodeName1 = nodes[0].getName()
nodeName2 = nodes[1].getName()
runtime.ui.alert(nodeName1)
runtime.ui.alert(nodeName2)

A function to show an open dialog box to the user.

from simlabpy import *
runtime = RunTime()
title = "Please select a file to import."
fileName= runtime.ui.getOpenFileName(title)
runtime.ui.alert(fileName)

A function to show a save dialog box to the user.

from simlabpy import *
runtime = RunTime()
outputPath = runtime.ui.getSaveFileName("Exported rendered image location:", "" ,"*.jpg  *.png")
runtime.ui.alert(outputPath)

A function to check if a key is found in the command.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
found = arguments.isFound(key)
runtime.ui.alert(str(found))

A function to retrieve the value of the key as float.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
numVar = arguments.getAsNumber(key)
runtime.ui.alert(str(numVar))

A function to retrieve the value of the key as string.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
strVar = arguments.getAsString(key)
runtime.ui.alert(strVar)

A function to retrieve the value of the key as color.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
colorVar = arguments.getAsColor(key)
runtime.ui.alert(str(colorVar.red()))

A function to retrieve the value of the key as vector.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
vec = arguments.getAsVector3(key)
runtime.ui.alert(str(vec.getX()))

A function to retrieve the value of the key as float.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
numArray = arguments.getAsNumberArray(key)
runtime.ui.alert(str(numArray[0]))

A function to retrieve the value of the key as a list of string.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
stringArray = arguments.getAsStringArray(key)
runtime.ui.alert(stringArray[0])

A function to retrieve the value of the key as a list of color.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
colorArray = arguments.getAsColorArray(key)
runtime.ui.alert(str(colorArray[0].red()))

A function to retrieve the value of the key as a list of vectors.

from simlabpy import *
runtime = RunTime()
arguments = runtime.args
key = "ie"
vectorList = arguments.getAsVector3Array(key)
runtime.ui.alert(str(vectorList[0].getX()))

A function to check whether the key is found in the dictionary map or not.

from simlabpy import *
key = "Author"
value = "SimLab"
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, value)
found = dictionary.isFound(key)
runtime.ui.alert(str(found))

A function to retrieve the value of a key as float from the dictionary map.

from simlabpy import *
runtime = RunTime()
dictionary = runtime.dictionary
key = "Length"
value = 12
dictionary.set(key, value)
lengthValue = dictionary.getAsNumber(key)
newLengthValue = lengthValue + 3;
runtime.ui.alert(str(newLengthValue))

A function to retrieve the value of a key as string from the dictionary map.

from simlabpy import *
key = "Author"
value = "SimLab"
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, value)
authorValue = dictionary.getAsString(key)
runtime.ui.alert(authorValue)

A function to retrieve the value of a key as Color from the dictionary map.

from simlabpy import *
key = "Button"
value = Color()
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, value)
colorValue = dictionary.getAsColor(key)
runtime.ui.alert(str(colorValue.red()))

A function to retrieve the value of a key as vector from the dictionary map.

from simlabpy import *
key = "Forward"
value = Vector3()
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, value)
vectorValue = dictionary.getAsVector3(key)
runtime.ui.alert(str(vectorValue.getX()))

A function to retrieve the value of a key as a list of floats from the dictionary map.

from simlabpy import *
key = "Dimensions"
values = []
values.append(10)
values.append(20)
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, values)
numbersList = dictionary.getAsNumberArray(key)
runtime.ui.alert(str(numbersList[1]))

A function to retrieve the value of a key as a list of strings from the dictionary map.

from simlabpy import *
key = "Authers"
values = []
values.append("John")
values.append("Doe")
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, values)
stringsList = dictionary.getAsStringArray(key)
runtime.ui.alert(stringsList[1])

A function to retrieve the value of a key as a list of colors from the dictionary map.

from simlabpy import *
key = "Contrast"
values = []
values.append(Color(0, 0, 0))
values.append(Color(1, 1, 1))
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, values)
colorsList = dictionary.getAsColorArray(key)
runtime.ui.alert(str(colorsList[1].red()))

A function to retrieve the value of a key as a list of vectors from the dictionary map.

from simlabpy import *
key = "Contrast"
values = []
values.append(Vector3())
values.append(Vector3(1, 1, 1))
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, values)
vectorsList = dictionary.getAsVector3Array(key)
runtime.ui.alert(str(vectorsList[1].getX()))

A function to set a new float value for a key in the dictionary map.

from simlabpy import *
key = "Width"
floatValue = 200.5
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, floatValue)

A function to set a new string value for a key in the dictionary map.

from simlabpy import *
key = "Author"
stringValue = "SimLab"
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, stringValue)

A function to set a new Color value for a key in the dictionary map.

from simlabpy import *
key = "Author"
colorValue = Color()
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, colorValue)

A function to set a new vector value for a key in the dictionary map.

from simlabpy import *
key = "Author"
vectorValue = Vector3()
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, vectorValue)

A function to set multiple float values for a key in the dictionary map.

from simlabpy import *
key = "Dimensions"
floatValues = []
floatValues.append(200.5)
floatValues.append(300.5)
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, floatValues)

A function to set multiple string values for a key in the dictionary map.

from simlabpy import *
key = "Authors"
stringValues = []
stringValues.append("John")
stringValues.append("Doe")
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, stringValues)

A function to set multiple color values for a key in the dictionary map.

from simlabpy import *
key = "Colors"
colorValues = []
colorValues.append(Color())
colorValues.append(Color(1, 1, 1))
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, colorValues)

A function to set multiple vector values for a key in the dictionary map.

from simlabpy import *
key = "Vectors"
vectorValues = []
vectorValues.append(Vector3())
vectorValues.append(Vector3(0.5, 0.5, 0.5))
runtime = RunTime()
dictionary = runtime.dictionary
dictionary.set(key, vectorValues)

A getter function to retrieve the brightness of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
brightness = lightNode.getBrightness()
runtime = RunTime()
runtime.ui.alert(str(brightness))

A getter function to retrieve the angle of the inner cone of the light. Return the Inner Cone Angle.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
innerConeAngle = lightNode.getInnerConeAngle()
runtime = RunTime()
runtime.ui.alert(str(innerConeAngle))

A getter function to retrieve the angle of the outer cone of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
outerConeAngle = lightNode.getOuterConeAngle()
runtime = RunTime()
runtime.ui.alert(str(outerConeAngle))

A getter function to retrieve the color of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
color = lightNode.getColor()
colorR = color.red()
runtime = RunTime()
runtime.ui.alert(str(colorR))

A getter function to retrieve the type of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
lightType = lightNode.getType()
runtime = RunTime()
runtime.ui.alert(lightType)

A getter function to retrieve the path of the used IES file of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "ies"
lightNode.setType(newLightType)
iesFilePath = "C:\\Users\\SimLab\\AppData\\Roaming\\SimLab\\SimLab Composer 10\\data\\IES lights\\FCACFB81-8D57-4FF2-AE7A-CF14A1AB9C67.ies"
lightNode.setIESFileName(iesFilePath) 
iesFilePath = lightNode.getIESFileName()
runtime = RunTime()
runtime.ui.alert(iesFilePath)

A getter function to determine whether a light source object in your scene will cast a shadow or not (Ver. 12.2+).

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "spot"
lightNode.setType(newLightType)
bCastShadow = lightNode.getCastShadow() 
runtime = RunTime()
runtime.ui.alert(str(bool(bCastShadow)))

A getter function to get the blend value of a spot light source object (Ver. 12.2+).

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "spot"
lightNode.setType(newLightType)
lightBlend = lightNode.getBlend()
runtime = RunTime()
runtime.ui.alert(str(lightBlend))

A setter function to set a new value for the brightness of the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newBrightness = 100
lightNode.setBrightness(newBrightness)
brightness = lightNode.getBrightness()
runtime = RunTime()
runtime.ui.alert(str(brightness))

A setter function to set the the inner cone angle for the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
lightType = "spot"
lightNode.setType(lightType)
newInnerConeAngle = 100
lightNode.setInnerConeAngle(newInnerConeAngle)
innerConeAngle = lightNode.getInnerConeAngle()
runtime = RunTime()
runtime.ui.alert(str(innerConeAngle))

A setter function to set the the outer cone angle for the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
lightType = "spot"
lightNode.setType(lightType)
newOuterConeAngle = 100
lightNode.setOuterConeAngle(newOuterConeAngle)
outerConeAngle = lightNode.getOuterConeAngle()
runtime = RunTime()
runtime.ui.alert(str(outerConeAngle))

A setter function to set a color for the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newColor = Color(0, 1, 0)
lightNode.setColor(newColor)
color = lightNode.getColor()
colorR = color.red()
runtime = RunTime()
runtime.ui.alert(str(colorR))

A setter function to set a light type for the light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "spot"
lightNode.setType(newLightType)
lightType = lightNode.getType()
runtime = RunTime()
runtime.ui.alert(lightType)

A setter function to set the path of the IES file for the IES light.

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "ies"
lightNode.setType(newLightType)
iesFilePath = "C:\\Users\\SimLab\\AppData\\Roaming\\SimLab\\SimLab Composer 10\\data\\IES lights\\FCACFB81-8D57-4FF2-AE7A-CF14A1AB9C67.ies"
lightNode.setIESFileName(iesFilePath)

A setter function allows you to specify whether a light object in your scene will cast a shadow or not (Ver. 12.2+).

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "spot"
lightNode.setType(newLightType)
bNewCastShadowStatus = False
lightNode.setCastShadow(bNewCastShadowStatus)
runtime = RunTime()
runtime.ui.alert(str(lightNode.getCastShadow()))

A setter function to set a new blend value for a spot light source object (Ver. 12.2+).

from simlabpy import *
scene = Scene()
lightNode = scene.createLight()
newLightType = "spot"
lightNode.setType(newLightType)
newLightBlend = 0.62
lightNode.setBlend(newLightBlend)
runtime = RunTime()
runtime.ui.alert(str(lightNode.getBlend()))

A getter function to get the value of the red channel of the color.

from simlabpy import *
newColor = Color(.5, .5, .5)
runtime = RunTime()
runtime.ui.alert(str(newColor.red()))

A getter function to get the value of the green channel of the color.

from simlabpy import *
newColor = Color(.5, .5, .5)
runtime = RunTime()
runtime.ui.alert(str(newColor.green()))

A getter function to get the value of the blue channel of the color.

from simlabpy import *
newColor = Color(.5, .5, .5)
runtime = RunTime()
runtime.ui.alert(str(newColor.blue()))

A setter function to set a new value for the red channel of the color.

from simlabpy import *
newColor = Color()
runtime = RunTime()
newR = 0.4
newColor.setRed(newR)

A setter function to set a new value for the green channel of the color.

from simlabpy import *
newColor = Color()
runtime = RunTime()
newG = 0.4
newColor.setGreen(newG)

A setter function to set a new value for the blue channel of the color.

from simlabpy import *
newColor = Color()
runtime = RunTime()
newB = 0.4
newColor.setBlue(newB)

A getter function that returns the name of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
materialName = newMaterial.getName()
runtime = RunTime()
runtime.ui.alert(materialName)

A getter function that returns the diffuse color of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
diffuseColor = newMaterial.getDiffuseColor()
diffuseColorR = diffuseColor.red()
runtime = RunTime()
runtime.ui.alert(str(diffuseColorR))

A getter function that returns the ambient color of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
ambientColor = newMaterial.getAmbientColor()
ambientColorR = ambientColor.red()
runtime = RunTime()
runtime.ui.alert(str(ambientColorR))

A getter function that returns the emissive color of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
emissiveColor = newMaterial.getEmissiveColor()
emissiveColorR = emissiveColor.red()
runtime = RunTime()
runtime.ui.alert(str(emissiveColorR))

A getter function that returns the specular color of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
specularColor = newMaterial.getSpecularColor()
specularColorR = specularColor.red()
runtime = RunTime()
runtime.ui.alert(str(specularColorR))

A getter function that returns Eta value of the material if it is plastic, shiny metal, or thin dielectric.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newMaterial.setMaterialType("plastic");
eta = newMaterial.getEta()
runtime = RunTime()
runtime.ui.alert(str(eta))

A getter function that returns the diffuse texture of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
diffuseTexture = newMaterial.getDiffuseTexture()
diffuseScaleU = diffuseTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(diffuseScaleU))

A getter function that returns the bump texture of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
bumpTexture = newMaterial.getBumpTexture()
bumpScaleU = bumpTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(bumpScaleU))

A getter function that returns the opacity texture of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
opacityTexture = newMaterial.getOpacityTexture()
opacityScaleU = opacityTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(opacityScaleU))

A getter function that returns the reflection texture of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
reflectionTexture = newMaterial.getReflectionTexture()
reflectionScaleU = reflectionTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(reflectionScaleU))

A getter function that returns the normal texture of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
normalTexture = newMaterial.getNormalTexture()
normalScaleU = normalTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(normalScaleU))

A getter function that returns the roughness texture of the material.

from simlabpy import *
scene = Scene()
material = scene.getMaterialByName("Material-1")
newTexture = Texture()
textureMapPath = "D:\\Users\\SimLab\\Desktop\\roughnessMap.png"
newTexture.setPath(textureMapPath)
material.setRoughnessTexture(newTexture)
roughnessTexture = material.getRoughnessTexture()
runtime = RunTime()
runtime.ui.alert(str(roughnessTexture.getPath()))

A getter function that returns the type of the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
materialType = newMaterial.getMaterialType()
runtime = RunTime()
runtime.ui.alert(materialType)

A setter function that sets a new name for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newMaterialName = "Wall"
newMaterial.setName(newMaterialName)
runtime = RunTime()
runtime.ui.alert(newMaterial.getName())

A function that applies a new diffuse color for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newdiffuseColor = Color(.5, .5, .5)
newMaterial.setDiffuseColor(newdiffuseColor)
diffuseColor = newMaterial.getDiffuseColor()
diffuseColorR = diffuseColor.red()
runtime = RunTime()
runtime.ui.alert(str(diffuseColorR))

A function that applies a new ambient color for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newAmbientColor = Color(.5, .5, .5)
newMaterial.setAmbientColor(newAmbientColor)
ambientColor = newMaterial.getAmbientColor()
ambientColorR = ambientColor.red()
runtime = RunTime()
runtime.ui.alert(str(ambientColorR))

A function that applies a new emissive color for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newEmissiveColor = Color(.5, .5, .5)
newMaterial.setEmissiveColor(newEmissiveColor)
emissiveColor = newMaterial.getEmissiveColor()
emissiveColorR = emissiveColor.red()
runtime = RunTime()
runtime.ui.alert(str(emissiveColorR))

A function that applies a new specular color for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newSpecularColor = Color(.5, .5, .5)
newMaterial.setSpecularColor(newSpecularColor)
specularColor = newMaterial.getSpecularColor()
specularColorR = specularColor.red()
runtime = RunTime()
runtime.ui.alert(str(specularColorR))

A function that applies a new Eta value for the material if its type is plastic, shiny metal, or thin dielectric.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newMaterial.setMaterialType("plastic");
newEta = 1.5
newMaterial.setEta(newEta)
runtime = RunTime()
runtime.ui.alert(str(newMaterial.getEta()))

A function that applies a new diffuse texture for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newDiffuseTexture = Texture()
newDiffuseTexture.setPath("D:\\Users\\SimLab\\Desktop\\diffuseTexture.jpg")
newMaterial.setDiffuseTexture(newDiffuseTexture)

A function that applies a new bump texture for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newBumpTexture = Texture()
newBumpTexture.setPath("D:\\Users\\SimLab\\Desktop\\bumpTexture.jpg")
newMaterial.setBumpTexture(newBumpTexture)

A function that applies a new opacity texture for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newOpacityTexture = Texture()
newBumpTexture.setPath("D:\\Users\\SimLab\\Desktop\\opacityTexture.jpg")
newMaterial.setOpacityTexture(newOpacityTexture)

A function that applies a new reflection texture for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newReflectionTexture = Texture()
newReflectionTexture.setPath("D:\\Users\\SimLab\\Desktop\\reflectionTexture.jpg")
newMaterial.setReflectionTexture(newReflectionTexture)

A function that applies a new normal texture for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newNormalTexture = Texture()
newNormalTexture.setPath("D:\\Users\\SimLab\\Desktop\\normalTexture.jpg")
newMaterial.setNormalTexture(newNormalTexture)

A function that applies a new roughness texture for the material.

from simlabpy import *
scene = Scene()
material = scene.getMaterialByName("Material-1")
newTexture = Texture()
textureMapPath = "D:\\Users\\SimLab\\Desktop\\roughnessMap.png"
newTexture.setPath(textureMapPath)
material.setRoughnessTexture(newTexture)
roughnessTexture = material.getRoughnessTexture()
runtime = RunTime()
runtime.ui.alert(str(roughnessTexture.getPath()))

A function that sets a new type for the material.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newMaterial.setMaterialType("plastic");

A function that assigns a material to another.

from simlabpy import *
scene = Scene()
newMaterial = scene.createMaterial()
newNormalTexture = Texture()
newNormalTexture.setPath("D:\\Users\\SimLab\\Desktop\\normalTexture.jpg")
newMaterial.setNormalTexture(newNormalTexture)
material = scene.createMaterial()
material.set(newMaterial)

A functions to set the elements of the matrix.

from simlabpy import *
matrix = Matrix4x4()
matrix.set(1, 0, 0, 2, 0, 1, 0, 2, 0, 0, 1, 2, 0, 0, 0, 1)

A function that returns the inverse of the matrix.

from simlabpy import *
newMatrix = Matrix4x4()
inverseMatrix = newMatrix.getInverse()
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(inverseMatrix)

A function to scale the matrix and return the result in a new matrix.

from simlabpy import *
newMatrix = Matrix4x4()
scaleX = 10
scaleY = 10
scaleZ = 10
scaleMatrix = newMatrix.scale(scaleX, scaleY, scaleZ)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(scaleMatrix)

A function for performing in-place scaling for the matrix with X, Y, and Z values.

from simlabpy import *
newMatrix = Matrix4x4()
scaleX = 10
scaleY = 10
scaleZ = 10
newMatrix.scaleInPlace(scaleX, scaleY, scaleZ)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A function to multiple the matrix with another and return the result in a new matrix.

from simlabpy import *
multiplyMatrix = Matrix4x4()
multipliedMatrix = newMatrix.multiply(multiplyMatrix)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(multipliedMatrix)

A function for performing in-place multiplication for the current matrix with the specified matrix, where the resulting matrix will be stored in the current matrix.

from simlabpy import *
newMatrix = Matrix4x4()
newMatrix.set(1, 0, 0, 2, 0, 1, 0, 2, 0, 0, 1, 2, 0, 0, 0, 1)
multiplyMatrix = Matrix4x4()
newMatrix.multiplyInPlace(multiplyMatrix)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A function that transforms the input vector as a point, and return the result in a new vector.

from simlabpy import *
newMatrix = Matrix4x4()
inputVector =  Vector3() 
resultVector = newMatrix.transformPosition(inputVector)

A function to translate the matrix by a vector.

from simlabpy import *
newMatrix = Matrix4x4()
inputVector = Vector3() 
newMatrix.translate(inputVector)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A function for performing in-place translation for the matrix by a vector.

from simlabpy import *
newMatrix = Matrix4x4()
inputVector =  Vector3() 
newMatrix.translateInPlace(inputVector)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A function to compute the result matrix of rotating the matrix by the rotation.

from simlabpy import *
newMatrix = Matrix4x4()
inputFromVector =  Vector3() 
inputToVector =  Vector3() 
resultMatrix = newMatrix.rotate(inputFromVector, inputToVector)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(resultMatrix)

A function to rotate the matrix by the rotation between two vectors.

from simlabpy import *
newMatrix = Matrix4x4()
inputVector1 =  Vector3() 
inputVector2 =  Vector3() 
newMatrix.rotateInPlace(inputVector1, inputVector2)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A function to rotate the matrix around the provided vector and by the provided angle.

from simlabpy import *
newMatrix = Matrix4x4()
aroundVector =  Vector3() 
angle = 1.5
newMatrix.rotateAboutVectorInPlace(angle, aroundVector)
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setTransform(newMatrix)

A getter function to get the name of the scene node.

from simlabpy import *
newSceneNode = Node()
nodeName = newSceneNode.getName()
runtime = RunTime()
runtime.ui.alert(nodeName)

A setter function to set a new name of the scene node.

from simlabpy import *
newSceneNode = Node()
newName = "Box"
newSceneNode.setName(newName)
nodeName = newSceneNode.getName()
runtime = RunTime()
runtime.ui.alert(nodeName)

A getter function to get the visibility of the scene node.

from simlabpy import *
newSceneNode = Node()
visibility = newSceneNode.getVisibility()
runtime = RunTime()
runtime.ui.alert(str(visibility))

A setter function to set the visibility of the scene node.

from simlabpy import *
newSceneNode = Node()
newVisibility = False
newSceneNode.setVisibility(newVisibility)
visibility = newSceneNode.getVisible()
runtime = RunTime()
runtime.ui.alert(str(visibility))

A getter function to get the transform of the scene node.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
nodeTransform = selectedSceneNode.getTransform()

A function to compute the world transformation matrix of an object (Ver. 12.2+).

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
bIncludeLocalTransform = True
nodeWorldTransform = selectedSceneNode.getWorldTransform(bIncludeLocalTransform)

A setter function to set a new transform for the scene node.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
newMatrix = Matrix4x4()
selectedSceneNode.setTransform(newMatrix)
nodeTransform = selectedSceneNode.getTransform()

A getter function to get the parent of the scene node.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
parentNode = selectedSceneNode.getParent()
parentName = parentNode.getName()
runtime = RunTime()
runtime.ui.alert(str(parentName))

A setter function to set a new parent scene node for the scene node.

from simlabpy import *
scene = Scene()
sphereNode = scene.getNodeByName("Sphere")
selectedSceneNode = scene.getSelectedNode()
selectedSceneNode.setParent(sphereNode)
newParentNode = selectedSceneNode.getParent()
newParentName = newParentNode.getName()
runtime = RunTime()
runtime.ui.alert(str(newParentName))

A function to compute the bounding box of the scene node.

from simlabpy import *
scene = Scene()
selectedSceneNode = scene.getSelectedNode()
boundingBox = selectedSceneNode.computeBoundingBox()
boundingBoxCenter = boundingBox.getCenter()
boundingBoxCenterX = boundingBoxCenter.getX()
runtime = RunTime()
runtime.ui.alert(str(boundingBoxCenterX))

A function that adds a new attribute to the scene node in the scene (Ver. 10.21+).

from simlabpy import *
nodesArray = RunTime().ui.getNodeArray("Select nodes from the scene:")
attributeName = "Name"
attributeCategory = ""
attributeSortingKey = ""
for node in nodesArray:
attributeValue = node.getName()
succeeded = node.addAttribute(attributeName, attributeValue, attributeCategory, attributeSortingKey)

A function that retrieves the attribute value from the scene node by it's name and category (Ver. 11.0+).

from simlabpy import *
scene = Scene()
node = scene.getNodeByName("Box")
attributeName = "Name"
attributeCategory = ""
attributeValue = node.readAttribute(attributeName, attributeCategory)

A function to remove a scene node attribute by it's name. (Ver. 11.0+).

from simlabpy import *
scene = Scene()
node = scene.getNodeByName("Box")
attributeName = "Name"
node.removeAttribute(attributeName)

A function to update a scene node attribute value for the given attribute name. (Ver. 11.0+).

from simlabpy import *
scene = Scene()
node = scene.getNodeByName("Box")
attributeName = "Name"
newAttributeValue = "New Value"
node.updateAttributeValue(attributeName, newAttributeValue)

A function that retrieves the scene node children. (Ver. 11.0+).

from simlabpy import *
scene = Scene()
node = scene.getNodeByName("Box")
nodeChildren = node.getChildren()

A function that rotate the scene node by the given degree. (Ver. 11.1+).

from simlabpy import *
scene = Scene()
node = scene.getNodeByName("Box")
node.rotateByDegree(45,45,45)

A function to refresh the user interface of render settings (Ver. 11.0+).

from simlabpy import *
scene = Scene()
renderSettings = scene.getRenderSettings()
renderSettings.updateGUI()

A function to stop updating the user interface of render settings with new information. The function should be followed by resumeUpdate() function (Ver. 11.0+).

from simlabpy import *
scene = Scene()
renderSettings = scene.getRenderSettings()
renderSettings.stopUpdate()

A function to resume updating the user interface of render settings with new information. The function should be called after stopUpdate() function. It should be called in scripts before the last call of the Set function to enable the user interface of render settings to be updated (Ver. 11.0+).

from simlabpy import *
scene = Scene()
renderSettings = scene.getRenderSettings()
renderSettings.resumeUpdate()

A setter function to set new values for the different properties of render settings (Ver. 11.0+).

from simlabpy import *
scene = Scene()
renderSettings = scene.getRenderSettings()
color = Color(0.57,0.57,0.57)
renderSettings.set("colorBackground", color) # The type of 2nd argument is color.
renderSettings.set("backgroundType", 3) # The type of 2nd argument is int.
renderSettings.set("enableGroundReflection", False) # The type of 2nd argument is bool.
renderSettings.set("groundShadowStrength", 0.8) # The type of 2nd argument is float.
renderSettings.set("envPath", "C:\\Users\\SimLab\\AppData\\Roaming\\SimLab\\SimLab Composer 10\\data\\hdrs\\5516F55C-FE6C-41EB-8465-A19A1C9E482E.exr") # The type of 2nd argument is string.

A getter function to get the scale U value of the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
scaleU = newTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(scaleU))

A getter function to get the scale V value of the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
scaleV = newTexture.getScaleV()
runtime = RunTime()
runtime.ui.alert(str(scaleV))

A getter function to get the offset U value of the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
offsetU = newTexture.getOffsetU()
runtime = RunTime()
runtime.ui.alert(str(offsetU))

A getter function to get the offset V value of the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
offsetV = newTexture.getOffsetV()
runtime = RunTime()
runtime.ui.alert(str(offsetV))

A getter function to get the path of the used texture map of the texture.

from simlabpy import *
newTexture = Texture()
newTextureMapPath = "D:\\Users\\SimLab\\Desktop\\diffuse.png"
newTexture.setPath(newTextureMapPath)
textueMapPath = newTexture.getPath()
runtime = RunTime()
runtime.ui.alert(textueMapPath)

A setter function to set the scale U value for the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
newScaleU = 2
newTexture.setScaleU(newScaleU)
scaleU = newTexture.getScaleU()
runtime = RunTime()
runtime.ui.alert(str(scaleU))

A setter function to set the scale V value for the texture UV coordinates in a material.

from simlabpy import *
newTexture = Texture()
newScaleV = 2
newTexture.setScaleV(newScaleV)
scaleV = newTexture.getScaleV()
runtime = RunTime()
runtime.ui.alert(str(scaleV))

A setter function to set the offset U value for the texture UV coordinates in a material.