The draw module provides the basic user interface to the OpenGL rendering capabilities of pyFormex. The full contents of this module is available to scripts running in the pyFormex GUI without the need to import it.
Classes defined in module draw
Functions defined in module draw
Close the GUI.
Calling this function from a script closes the GUI and terminates pyFormex.
Close the named dialog.
Closes the InputDialog with the given name. If multiple dialogs are open with the same name, all these dialogs are closed.
This only works for dialogs owned by the pyFormex GUI.
Show a short message widget and wait for user acknowledgement.
There are three levels of messages: ‘info’, ‘warning’ and ‘error’. They differ only in the icon that is shown next to the test. By default, the message widget has a single button with the text ‘OK’. The dialog is closed if the user clicks a button. The return value is the button text.
Show an informational message and wait for user acknowledgement.
Show a warning message and wait for user acknowledgement.
Show an error message and wait for user acknowledgement.
Ask a question and present possible answers.
Return answer if accepted or default if rejected. The remaining arguments are passed to the InputDialog getResult method.
Show a Yes/No question and return True/False depending on answer.
Display a text in a dialog window.
Creates a dialog window displaying some text. The dialog can be modal (blocking user input to the main window) or modeless. Scrollbars aree added if the text is too large to display at once. By default, the dialog has a single button to close the dialog.
Parameters:
Returns:
Modal dialog: | the result of the dialog after closing. The result is a dictionary with a single key: ‘text’ having the displayed text as a value. If an itemtype ‘text’ was used, this may be a changed text. |
---|---|
Modeless dialog: | |
the open dialog window itself. |
Display a text file.
This will use the showText() function to display a text read from a file. By default this uses a monospaced font. Other arguments may also be passed to ShowText.
Show the docstring of an object.
Parameters:
Load a file into the editor.
Parameters:
Loading a file in the editor is done by executing an external command with the filename as argument. The command to be used can be set in the configuration. If none is set, pyFormex will try to lok at the EDITOR and VISUAL environment settings.
The main author of pyFormex uses ‘emacsclient’ as editor command, to load the files in a running copy of Emacs.
Ask the value of some items to the user.
Create an interactive widget to let the user set the value of some items. The items are specified as a list of dictionaries. Each dictionary contains the input arguments for a widgets.InputItem. It is often convenient to use one of the _I, _G, ot _T functions to create these dictionaries. These will respectively create the input for a simpleInputItem, a groupInputItem or a tabInputItem.
For convenience, simple items can also be specified as a tuple. A tuple (key,value) will be transformed to a dict {‘key’:key, ‘value’:value}.
See the widgets.InputDialog class for complete description of the available input items.
The remaining arguments are keyword arguments that are passed to the widgets.InputDialog.getResult method. A timeout (in seconds) can be specified to have the input dialog interrupted automatically.
Returns a dictionary with the results: for each input item there is a (key,value) pair. Returns an empty dictionary if the dialog was canceled. Sets the dialog timeout and accepted status in global variables.
Returns the current dialog widget.
This returns the dialog widget created by the askItems() function, while the dialog is still active. If no askItems() has been called or if the user already closed the dialog, None is returned.
Returns True if the last askItems() dialog was accepted.
Returns True if the last askItems() dialog was rejected.
Returns True if the last askItems() dialog timed out.
Ask for a file name or multiple file names using a file dialog.
cur is a directory or filename. All the files matching the filter in that directory (or that file’s directory) will be shown. If cur is a file, it will be selected as the current filename.
Unless the user cancels the operation, or the change parameter was set to False, the parent directory of the selected file will become the new working directory.
Ask a single new filename.
This is a convenience function for calling askFilename with the arguments exist=False.
Interactively select a directory and change the current workdir.
The user is asked to select a directory through the standard file dialog. Initially, the dialog shows all the subdirectories in the specified path, or by default in the current working directory.
The selected directory becomes the new working directory, unless the user canceled the operation, or the change parameter was set to False.
Ask the user to change the current workdir if it is not writable.
Returns True if the new workdir is writable.
Print a message on the message board.
If a logfile was opened, the message is also written to the log file.
Print a message on the message board.
If a logfile was opened, the message is also written to the log file.
Flatten a list of geometric objects.
Each item in the list should be either:
This function will flatten the lists and replace the string items with the object they point to. The result is a single list of drawable objects. This function does not enforce the objects to be drawable. That should be done by the caller.
Filters the drawable objects from a list.
The input is a list, usually of drawable objects. For each item in the list, the following is done:
The result is a list of drawable objects (since a Formex is drawable).
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 one of:
The variables are replaced with their value and the lists are flattened, to create a single list of objects. This then filtered for the drawable objects, and the resulting list of drawables is drawn using the remaining arguments.
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.
if color is None, it is drawn with the color specified on creation. if color is ‘prop’ and a colormap was installed, props define color. else, color should be an array of RGB values, either with shape (3,) for a single color, or (nelems,3) for differently colored elements
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).
Move the camera thus that object comes fully into view.
object can be anything having a bbox() method or a list thereof. if no view is given, the default is used.
The camera is moved with fixed axis directions to a place where the whole object can be viewed using a 45. degrees lens opening. This technique may change in future!
Set default values for the draw options.
Draw options are a set of options that hold default values for the draw() function arguments and for some canvas settings. The draw options can be specified either as a dictionary, or as keyword arguments.
reset the canvas
Set shrinking on or off, and optionally set shrink factor
Draw a set of vectors.
If size==None, draws the vectors v at the points P. If size is specified, draws the vectors size*normalize(v) P, v and size are single points or sets of points. If sets, they should be of the same size.
Other drawoptions can be specified and will be passed to the draw function.
Draw a list of marks at points X.
X is a Coords array. M is a list with the same length as X. The string representation of the marks are drawn at the corresponding 3D coordinate.
Draw the feature edges of a Mesh
Draw numbers on all elements of F.
numbers is an array with F.nelems() integer numbers. If no numbers are given, the range from 0 to nelems()-1 is used. Normally, the numbers are drawn at the centroids of the elements. A translation may be given to put the numbers out of the centroids, e.g. to put them in front of the objects to make them visible, or to allow to view a mark at the centroids. If an offset is specified, it is added to the shown numbers.
Draw property numbers on all elements of F.
This calls drawNumbers to draw the property numbers on the elements. All arguments of drawNumbers except numbers may be passed. If the object F thus not have property numbers, -1 values are drawn.
Draw (local) numbers on all vertices of F.
Normally, the numbers are drawn at the location of the vertices. A translation may be given to put the numbers out of the location, e.g. to put them in front of the objects to make them visible, or to allow to view a mark at the vertices.
Draw the bounding box of the geometric object F.
F is any object that has a bbox method. Returns the drawn Annotation.
Draw the principal axes of the geometric object F.
F is any object that has a coords attribute. If specified, weight is an array of weights attributed to the points of F. It should have the same length as F.coords.
Draw a text at a 3D point P.
Draw the axes of a CoordinateSystem.
CS is a CoordinateSystem. If not specified, the global coordinate system is used. Other arguments can be added just like in the AxesActor class.
While you can draw a CoordinateSystem using the draw() function, this function gives a better result because it has specialized color and annotation settings and provides reasonable deafults.
Draw an image as a colored Formex
Draws a raster image as a colored Formex. While there are other and better ways to display an image in pyFormex (such as using the imageView widget), this function allows for interactive handling the image using the OpenGL infrastructure.
Parameters:
Returns the drawn Actor.
See also drawImage().
Draws an image as a viewport decoration.
Parameters:
Returns the Decoration drawn.
Note that the Decoration has a fixed size (and position) on the canvas and will not scale when the viewport size is changed. The bgcolor() function can be used to draw an image that completely fills the background.
Draw two viewport axes at a 3D position.
Draw an actor and update the screen.
Draw an Actor/Annotation/Decoration and update the screen.
Remove an item or a number of items from the canvas.
Use the return value from one of the draw... functions to remove the item that was drawn from the canvas. A single item or a list of items may be specified.
Show a named view, either a builtin or a user defined.
This shows the current scene from another viewing angle. Switching views of a scene is much faster than redrawing a scene. Therefore this function is prefered over draw() when the actors in the scene remain unchanged and only the camera viewpoint changes.
Just like draw(), this function obeys the drawing lock mechanism, and by default it will restart the lock to retard the next draing operation.
Toggle the display of the global axes on or off.
If on is True, the axes triade is displayed, if False it is removed. The default (None) toggles between on and off.
Show a text at position x,y using font.
Draw an annotation.
Draw a decoration.
Create a new named view (or redefine an old).
The angles are (longitude, latitude, twist). By default, the view is local to the script’s viewport. If gui is True, it is also added to the GUI.
Set the default view for future drawing operations.
If no angles are specified, the name should be an existing view, or the predefined value ‘last’. If angles are specified, this is equivalent to createView(name,angles) followed by setView(name).
Change the background color and image.
Parameters:
Set the default foreground color.
Set the highlight color.
Gets/Sets the current canvas color map
Return a list of predefined render profiles.
Change the rendering profile to a predefined mode.
Currently the following modes are defined:
Set the lights on or off
Set the transparency mode on or off.
Set the value of one of the material lighting parameters
typ is one of ‘ambient’,’specular’,’emission’,’shininess’ val is a value between 0.0 and 1.0
Set the linewidth to be used in line drawings.
Set the linewidth to be used in line drawings.
Set the size to be used in point drawings.
Resize the canvas to (width x height).
If a negative value is given for either width or height, the corresponding size is set equal to the maximum visible size (the size of the central widget of the main window).
Note that changing the canvas size when multiple viewports are active is not approved.
Clear the canvas.
This is a low level function not intended for the user.
Clear the canvas.
Removes everything from the current scene and displays an empty background.
This function waits for the drawing lock to be released, but will not reset it.
Get/Set the draw delay time.
Returns the current setting of the draw wait time (in seconds). This drawing delay is obeyed by drawing and viewing operations.
A parameter may be given to set the delay time to a new value. It should be convertable to a float. The function still returns the old setting. This may be practical to save that value to restore it later.
Wait until the drawing lock is released.
This uses the drawing lock mechanism to pause. The drawing lock ensures that subsequent draws are retarded to give the user the time to view. The use of this function is prefered over that of pause() or sleep(), because it allows your script to continue the numerical computations while waiting to draw the next screen.
This function can be used to retard other functions than draw and view.
Start the current script or if already running, continue it.
Replay the current app.
This works pretty much like the play() function, but will reload the current application prior to running it. This function is especially interesting during development of an application. If the current application is a script, then it is equivalent with play().
Releases the drawing lock mechanism indefinely.
Releasing the drawing lock indefinely means that the lock will not be set again and your script will execute till the end.
Pause the execution until an external event occurs or timeout.
When the pause statement is executed, execution of the pyformex script is suspended until some external event forces it to proceed again. Clicking the PLAY, STEP or CONTINUE button will produce such an event.
Sleep until key/mouse press in the canvas or until timeout
Wake up from the sleep function.
This is the only way to exit the sleep() function. Default is to wake up from the current sleep. A mode > 0 forces wakeup for longer period.
Zoom a rectangle selected by the user.
Zoom thus that the specified bbox becomes visible.
Zoom thus that all actors become visible.
Fly through the current scene along the specified path.
This function moves the camera through the subsequent elements of the Formex. For each element the first point is used as the center of the camera and the second point as the eye (the center of the scene looked at). For a 3-plex Formex, the third point is used to define the upvector (i.e. the vertical axis of the image) of the camera. For a 2-plex Formex, the upvector is constant as specified in the arguments.
Select the current viewport.
n is an integer number in the range of the number of viewports, or is one of the viewport objects in pyformex.GUI.viewports
if n is None, selects the current GUI viewport for drawing
Return the number of viewports.
Set the viewports layout.
Add a new viewport.
Remove the last viewport.
Link viewport vp to viewport tovp.
Both vp and tovp should be numbers of viewports.
Update the GUI.
Highlight the i-th actor in the scene.
Highlight a selection of actors on the canvas.
K is Collection of actors as returned by the pick() method. colormap is a list of two colors, for the actors not in, resp. in the Collection K.
Highlight a selection of actor elements on the canvas.
K is Collection of actor elements as returned by the pick() method. colormap is a list of two colors, for the elements not in, resp. in the Collection K.
Highlight a selection of actor edges on the canvas.
K is Collection of TriSurface actor edges as returned by the pick() method. colormap is a list of two colors, for the edges not in, resp. in the Collection K.
Highlight a selection of actor elements on the canvas.
K is Collection of actor elements as returned by the pick() method.
Highlight a selection of partitions on the canvas.
K is a Collection of actor elements, where each actor element is connected to a collection of property numbers, as returned by the partitionCollection() method.
Remove the highlights from the current viewport
Enter interactive picking mode and return selection.
See viewport.py for more details. This function differs in that it provides default highlighting during the picking operation, a button to stop the selection operation
Parameters:
Highlight a Collection of actor/elements.
K is usually the return value of a pick operation, but might also be set by the user. mode is one of the pick modes.
Set the drawing edit mode.
Enter interactive drawing mode and return the line drawing.
See viewport.py for more details. This function differs in that it provides default displaying during the drawing operation and a button to stop the drawing operation.
The drawing can be edited using the methods ‘undo’, ‘clear’ and ‘close’, which are presented in a combobox.
Show a line drawing.
L is usually the return value of an interactive draw operation, but might also be set by the user.
Reset the GUI to its default operating mode.
When an exception is raised during the execution of a script, the GUI may be left in a non-consistent state. This function may be called to reset most of the GUI components to their default operating mode.