def draw(F,
view=None,bbox=None,
color='prop',colormap=None,alpha=0.5,
mode=None,linewidth=None,shrink=None,marksize=None,
wait=True,clear=None,allviews=False):
"""Draw object(s) with specified settings and direct camera to it.
The first argument is an object to be drawn. All other arguments are
settings that influence how the object is being drawn.
F is either a Formex or a TriSurface object, or a name of such object
(global or exported), or a list thereof.
If F is a list, the draw() function is called repeatedly with each of
ithe items of the list as first argument and with the remaining arguments
unchanged.
The remaining arguments are drawing options. If None, they are filled in
from the current viewport drawing options.
view is either the name of a defined view or 'last' or None.
Predefined views are 'front','back','top','bottom','left','right','iso'.
With view=None the camera settings remain unchanged (but might be changed
interactively through the user interface). This may make the drawn object
out of view!
With view='last', the camera angles will be set to the same camera angles
as in the last draw operation, undoing any interactive changes.
The initial default view is 'front' (looking in the -z direction).
bbox specifies the 3D volume at which the camera will be aimed (using the
angles set by view). The camera position wil be set so that the volume
comes in view using the current lens (default 45 degrees).
bbox is a list of two points or compatible (array with shape (2,3)).
Setting the bbox to a volume not enclosing the object may make the object
invisible on the canvas.
The special value bbox='auto' will use the bounding box of the objects
getting drawn (object.bbox()), thus ensuring that the camera will focus
on these objects.
The special value bbox=None will use the bounding box of the previous
drawing operation, thus ensuring that the camera's target volume remains
unchanged.
color,colormap,linewidth,alpha,marksize are passed to the
creation of the 3D actor.
shrink is a floating point shrink factor that will be applied to object
before drawing it.
If the Formex has properties and a color list is specified, then the
the properties will be used as an index in the color list and each member
will be drawn with the resulting color.
If color is one color value, the whole Formex will be drawn with
that color.
Finally, if color=None is specified, the whole Formex is drawn in black.
Each draw action activates a locking mechanism for the next draw action,
which will only be allowed after drawdelay seconds have elapsed. This
makes it easier to see subsequent images and is far more elegant that an
explicit sleep() operation, because all script processing will continue
up to the next drawing instruction.
The value of drawdelay is set in the config, or 2 seconds by default.
The user can disable the wait cycle for the next draw operation by
specifying wait=False. Setting drawdelay=0 will disable the waiting
mechanism for all subsequent draw statements (until set >0 again).
"""
if type(F) == list:
actor = []
nowait = False
for Fi in F:
if Fi == F[-1]:
nowait = wait
actor.append(draw(Fi,view,bbox,
color,colormap,alpha,
mode,linewidth,shrink,marksize,
wait=nowait,clear=clear,allviews=allviews))
if Fi == F[0]:
clear = False
view = None
return actor
if type(F) == str:
F = named(F)
if F is None:
return None
if isinstance(F,formex.Formex):
pass
elif isinstance(F,surface.TriSurface):
pass
elif isinstance(F,tools.Plane):
pass
elif hasattr(F,'toFormex'):
F = F.toFormex()
# keep this below trying the 'toFormex' !!!
elif isinstance(F,coords.Coords):
F = Formex(F)
else:
# Don't know how to draw this object
raise RuntimeError,"draw() can not draw objects of type %s" % type(F)
GD.GUI.drawlock.wait()
if clear is None:
clear = GD.canvas.options.get('clear',False)
if clear:
clear_canvas()
if bbox is None:
bbox = GD.canvas.options.get('bbox','auto')
if view is not None and view != 'last':
GD.debug("SETTING VIEW to %s" % view)
setView(view)
if shrink is None:
shrink = GD.canvas.options.get('shrink',None)
if marksize is None:
marksize = GD.canvas.options.get('marksize',GD.cfg.get('marksize',5.0))
# Create the colors
if color == 'prop':
if hasattr(F,'p'):
color = F.p
else:
color = colors.black
elif color == 'random':
# create random colors
color = numpy.random.random((F.nelems(),3),dtype=float32)
GD.GUI.setBusy()
if shrink is not None:
#GD.debug("DRAWING WITH SHRINK = %s" % shrink)
F = _shrink(F,shrink)
try:
if isinstance(F,formex.Formex):
if F.nelems() == 0:
return None
actor = actors.FormexActor(F,color=color,colormap=colormap,alpha=alpha,mode=mode,linewidth=linewidth,marksize=marksize)
elif isinstance(F,surface.TriSurface):
if F.nelems() == 0:
return None
actor = actors.TriSurfaceActor(F,color=color,colormap=colormap,alpha=alpha,mode=mode,linewidth=linewidth)
elif isinstance(F,tools.Plane):
return drawPlane(F.point(),F.normal(),F.size())
GD.canvas.addActor(actor)
if view is not None or bbox not in [None,'last']:
#GD.debug("CHANGING VIEW to %s" % view)
if view == 'last':
view = GD.canvas.options['view']
if bbox == 'auto':
bbox = F.bbox()
#GD.debug("SET CAMERA TO: bbox=%s, view=%s" % (bbox,view))
GD.canvas.setCamera(bbox,view)
#setView(view)
GD.canvas.update()
GD.app.processEvents()
#GD.debug("AUTOSAVE %s" % image.autoSaveOn())
if image.autoSaveOn():
image.saveNext()
if wait: # make sure next drawing operation is retarded
GD.GUI.drawlock.lock()
finally:
GD.GUI.setBusy(False)
return actor
