Scene is a container that stores models and their associated colors.

scene = Scene()
scene.add(model, color)

scene.add returns an interactiveobject with which you can change the state of the displayed object (see interactiveobject)

zencad.default_scene - scene object used by display-related operations, unless otherwise specified.


A tool for adding geometry to a scene.

zencad.display(shape, color=zencad.default_color, scene=zencad.default_scene)
zencad.display(unit, color=zencad.default_color, scene=zencad.default_scene, deep=True)
zencad.display(lst, color=zencad.default_color, scene=zencad.default_scene)

zencad.disp(model) # alternate

Depending on the type of the parameter, display can behave as follows: For shape - adds to the scene, returns interactiveobject For assemble.unit - calls the bindto_scene procedure, returns None For list / tuple, it calls display iteratively on the list items, returns a list of results.


A special variant of the display function used to debug the constructed geometry.

zencad.highlight(model, color=zencad.color(0.5, 0, 0, 0.5))
zencad.hl(model) # alternate naming

Unlike display, the function returns the object passed to it. Usage example (highlight the subtracted form):

c = a - hl(b.up(100500))


An object containing color information in rgba format. The range of parameter values is [0,1].


ZenCad defines a standard set of colors:

zencad.color.white =     zencad.color(1,1,1)
zencad.color.black =     zencad.color(0,0,0)
zencad.color.red =       zencad.color(1,0,0)
zencad.color.green =     zencad.color(0,1,0)
zencad.color.blue =      zencad.color(0,0,1)
zencad.color.yellow =    zencad.color(1,1,0)
zencad.color.magenta =   zencad.color(0,1,1)
zencad.color.cian =      zencad.color(1,0,1)
zencad.color.mech =      zencad.color(0.6, 0.6, 0.8)
zencad.color.transmech = zencad.color(0.6, 0.6, 0.8, 0.8)


animate=None, preanimate=None, close_handle=None)

The show function initiates the display of the renderer program. If the function is called with no arguments, the default scene (zencad.default_scene) is displayed.

show also has a set of parameters to support animation functions for the model (see Animation).

The show behavior is covered in more detail in (Internal Kitchen)