1 Draw Test Harness {#occt_user_guides__test_harness}
2 ===============================
6 @section occt_draw_1 Introduction
8 This manual explains how to use Draw, the test harness for Open CASCADE Technology (**OCCT**).
9 Draw is a command interpreter based on TCL and a graphical system used to test and demonstrate Open CASCADE Technology modeling libraries.
11 @subsection occt_draw_1_1 Overview
13 Draw is a test harness for Open CASCADE Technology. It provides a flexible and easy to use means of testing and demonstrating the OCCT modeling libraries.
15 Draw can be used interactively to create, display and modify objects such as curves, surfaces and topological shapes.
17 Scripts may be written to customize Draw and perform tests. New types of objects and new commands may be added using the C++ programing language.
21 * A command interpreter based on the TCL command language.
22 * A 3d graphic viewer based on the X system.
23 * A basic set of commands covering scripts, variables and graphics.
24 * A set of geometric commands allowing the user to create and modify curves and surfaces and to use OCCT geometry algorithms. This set of commands is optional.
25 * A set of topological commands allowing the user to create and modify BRep shapes and to use the OCCT topology algorithms.
28 There is also a set of commands for each delivery unit in the modeling libraries:
37 @subsection occt_draw_1_2 Contents of this documentation
39 This documentation describes:
41 * The command language.
42 * The basic set of commands.
43 * The graphical commands.
44 * The Geometry set of commands.
45 * The Topology set of commands.
47 * Data Exchange commands
48 * Shape Healing commands
50 This document is a reference manual. It contains a full description of each command. All descriptions have the format illustrated below for the exit command.
56 Terminates the Draw, TCL session. If the commands are read from a file using the source command, this will terminate the file.
61 # this is a very short example
66 @subsection occt_draw_1_3 Getting started
68 Install Draw and launch Emacs. Get a command line in Emacs using *Esc x* and key in *woksh*.
70 All DRAW Test Harness can be activated in the common executable called **DRAWEXE**. They are grouped in toolkits and can be loaded at run-time thereby implementing dynamically loaded plug-ins. Thus, it is possible to work only with the required commands adding them dynamically without leaving the Test Harness session.
72 Declaration of available plug-ins is done through the special resource file(s). The *pload* command loads the plug-in in accordance with the specified resource file and activates the commands implemented in the plug-in.
74 @subsubsection occt_draw_1_3_1 Launching DRAW Test Harness
76 Test Harness executable *DRAWEXE* is located in the <i>$CASROOT/\<platform\>/bin</i> directory (where \<platform\> is Win for Windows and Linux for Linux operating systems). Prior to launching it is important to make sure that the environment is correctly setup (usually this is done automatically after the installation process on Windows or after launching specific scripts on Linux).
79 @subsubsection occt_draw_1_3_2 Plug-in resource file
81 Open CASCADE Technology is shipped with the DrawPlugin resource file located in the <i>$CASROOT/src/DrawResources</i> directory.
83 The format of the file is compliant with standard Open CASCADE Technology resource files (see the *Resource_Manager.hxx* file for details).
85 Each key defines a sequence of either further (nested) keys or a name of the dynamic library. Keys can be nested down to an arbitrary level. However, cyclic dependencies between the keys are not checked.
87 **Example:** (excerpt from DrawPlugin):
88 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
89 OCAF : VISUALIZATION, OCAFKERNEL
95 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
97 @subsubsection occt_draw_1_3_3 Activation of commands implemented in the plug-in
99 To load a plug-in declared in the resource file and to activate the commands the following command must be used in Test Harness:
102 pload [-PluginFileName] [[Key1] [Key2]...]
107 * <i>-PluginFileName</i> -- defines the name of a plug-in resource file (prefix "-" is mandatory) described above. If this parameter is omitted then the default name *DrawPlugin* is used.
108 * *Key* -- defines the key(s) enumerating plug-ins to be loaded. If no keys are specified then the key named *DEFAULT* is used (if there is no such key in the file then no plug-ins are loaded).
110 According to the OCCT resource file management rules, to access the resource file the environment variable *CSF_PluginFileNameDefaults* (and optionally *CSF_PluginFileNameUserDefaults*) must be set and point to the directory storing the resource file. If it is omitted then the plug-in resource file will be searched in the <i>$CASROOT/src/DrawResources</i> directory.
113 Draw[] pload -DrawPlugin OCAF
115 This command will search the resource file *DrawPlugin* using variable *CSF_DrawPluginDefaults* (and *CSF_DrawPluginUserDefaults*) and will start with the OCAF key. Since the *DrawPlugin* is the file shipped with Open CASCADE Technology it will be found in the <i>$CASROOT/src/DrawResources</i> directory (unless this location is redefined by user's variables). The OCAF key will be recursively extracted into two toolkits/plug-ins: *TKDCAF* and *TKViewerTest* (e.g. on Windows they correspond to *TKDCAF.dll* and *TKViewerTest.dll*). Thus, commands implemented for Visualization and OCAF will be loaded and activated in Test Harness.
118 Draw[] pload (equivalent to pload -DrawPlugin DEFAULT).
120 This command will find the default DrawPlugin file and the DEFAULT key. The latter finally maps to the TKTopTest toolkit which implements basic modeling commands.
123 @section occt_draw_2 The Command Language
125 @subsection occt_draw_2_1 Overview
127 The command language used in Draw is Tcl. Tcl documentation such as "TCL and the TK Toolkit" by John K. Ousterhout (Addison-Wesley) will prove useful if you intend to use Draw extensively.
129 This chapter is designed to give you a short outline of both the TCL language and some extensions included in Draw. The following topics are covered:
131 * Syntax of the TCL language.
132 * Accessing variables in TCL and Draw.
133 * Control structures.
136 @subsection occt_draw_2_2 Syntax of TCL
138 TCL is an interpreted command language, not a structured language like C, Pascal, LISP or Basic. It uses a shell similar to that of csh. TCL is, however, easier to use than csh because control structures and procedures are easier to define. As well, because TCL does not assign a process to each command, it is faster than csh.
140 The basic program for TCL is a script. A script consists of one or more commands. Commands are separated by new lines or semicolons.
142 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
146 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
148 Each command consists of one or more *words*; the first word is the name of a command and additional words are arguments to that command.
150 Words are separated by spaces or tabs. In the preceding example each of the four commands has three words. A command may contain any number of words and each word is a string of arbitrary length.
152 The evaluation of a command by TCL is done in two steps. In the first step, the command is parsed and broken into words. Some substitutions are also performed. In the second step, the command procedure corresponding to the first word is called and the other words are interpreted as arguments. In the first step, there is only string manipulation, The words only acquire *meaning* in the second step by the command procedure.
154 The following substitutions are performed by TCL:
156 Variable substitution is triggered by the $ character (as with csh), the content of the variable is substitued; { } may be used as in csh to enclose the name of the variable.
159 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
160 # set a variable value
161 set file documentation
162 puts $file #to display file contents on the screen
164 # a simple substitution, set psfile to documentation.ps
168 # another substitution, set pfile to documentationPS
172 # delete files NEWdocumentation and OLDdocumentation
173 foreach prefix {NEW OLD} {rm $prefix$file}
174 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
176 Command substitution is triggered by the [ ] characters. The brackets must enclose a valid script. The script is evaluated and the result is substituted.
178 Compare command construction in csh.
181 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
184 # expr is a command evaluating a numeric expression
185 set radian [expr $pi*$degree/180]
186 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
188 Backslash substitution is triggered by the backslash character. It is used to insert special characters like $, [ , ] , etc. It is also useful to insert a new line, a backslash terminated line is continued on the following line.
190 TCL uses two forms of *quoting* to prevent substitution and word breaking.
192 Double quote *quoting* enables the definition of a string with space and tabs as a single word. Substitutions are still performed inside the inverted commas " ".
195 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
196 # set msg to ;the price is 12.00;
198 set msg ;the price is $price;
199 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
201 Braces *quoting* prevents all substitutions. Braces are also nested. The main use of braces is to defer evaluation when defining procedures and control structures. Braces are used for a clearer presentation of TCL scripts on several lines.
204 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
206 # this will loop for ever
207 # because while argument is ;0 < 3;
208 while ;$x < 3; {set x [expr $x+1]}
209 # this will terminate as expected because
210 # while argument is {$x < 3}
211 while {$x < 3} {set x [expr $x+1]}
212 # this can be written also
216 # the following cannot be written
217 # because while requires two arguments
222 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
224 Comments start with a \# character as the first non-blank character in a command. To add a comment at the end of the line, the comment must be preceded by a semi-colon to end the preceding command.
227 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
229 set a 1 # this is not a comment
230 set b 1; # this is a comment
231 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
233 The number of words is never changed by substitution when parsing in TCL. For example, the result of a substitution is always a single word. This is different from csh but convenient as the behavior of the parser is more predictable. It may sometimes be necessary to force a second round of parsing. **eval** accomplishes this: it accepts several arguments, concatenates them and executes the resulting script.
237 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
238 # I want to delete two files
242 # this will fail because rm will receive only one argument
243 # and complain that ;foo bar; does not exit
247 # a second evaluation will do it
248 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
250 @subsection occt_draw_2_3 Accessing variables in TCL and Draw
252 TCL variables have only string values. Note that even numeric values are stored as string literals, and computations using the **expr** command start by parsing the strings. Draw, however, requires variables with other kinds of values such as curves, surfaces or topological shapes.
254 TCL provides a mechanism to link user data to variables. Using this functionality, Draw defines its variables as TCL variables with associated data.
256 The string value of a Draw variable is meaningless. It is usually set to the name of the variable itself. Consequently, preceding a Draw variable with a <i>$</i> does not change the result of a command. The content of a Draw variable is accessed using appropriate commands.
258 There are many kinds of Draw variables, and new ones may be added with C++. Geometric and topological variables are described below.
260 Draw numeric variables can be used within an expression anywhere a Draw command requires a numeric value. The *expr* command is useless in this case as the variables are stored not as strings but as floating point values.
263 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
264 # dset is used for numeric variables
265 # pi is a predefined Draw variable
266 dset angle pi/3 radius 10
267 point p radius*cos(angle) radius*sin(angle) 0
268 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
269 It is recommended that you use TCL variables only for strings and Draw for numerals. That way, you will avoid the *expr* command. As a rule, Geometry and Topology require numbers but no strings.
271 @subsubsection occt_draw_2_3_1 set, unset
277 unset varname [varname varname ...]
280 *set* assigns a string value to a variable. If the variable does not already exist, it is created.
282 Without a value, *set* returns the content of the variable.
284 *unset* deletes variables. It is is also used to delete Draw variables.
287 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
294 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
296 **Note**, that the *set* command can set only one variable, unlike the *dset* command.
299 @subsubsection occt_draw_2_3_2 dset, dval
304 dset var1 value1 vr2 value2 ...
308 *dset* assigns values to Draw numeric variables. The argument can be any numeric expression including Draw numeric variables. Since all Draw commands expect a numeric expression, there is no need to use $ or *expr*. The *dset* command can assign several variables. If there is an odd number of arguments, the last variable will be assigned a value of 0. If the variable does not exist, it will be created.
310 *dval* evaluates an expression containing Draw numeric variables and returns the result as a string, even in the case of a single variable. This is not used in Draw commands as these usually interpret the expression. It is used for basic TCL commands expecting strings.
314 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
319 # no $ required for Draw commands
322 # "puts" prints a string
323 puts ;x = [dval x], cos(x/pi) = [dval cos(x/pi)];
324 == x = 10, cos(x/pi) = -0.99913874099467914
325 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
327 **Note,** that in TCL, parentheses are not considered to be special characters. Do not forget to quote an expression if it contains spaces in order to avoid parsing different words. <i>(a + b)</i> is parsed as three words: <i>"(a + b)"</i> or <i>(a+b)</i> are correct.
329 @subsubsection occt_draw_2_3_3 del, dall
333 del varname_pattern [varname_pattern ...]
337 *del* command does the same thing as *unset*, but it deletes the variables matched by the pattern.
339 *dall* command deletes all variables in the session.
341 @subsection occt_draw_2_4 lists
343 TCL uses lists. A list is a string containing elements separated by spaces or tabs. If the string contains braces, the braced part accounts as one element.
345 This allows you to insert lists within lists.
348 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
349 # a list of 3 strings
352 # a list of two strings the first is a list of 2
354 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
356 Many TCL commands return lists and **foreach** is a useful way to create loops on list elements.
358 @subsubsection occt_draw_2_5 Control Structures
360 TCL allows looping using control structures. The control structures are implemented by commands and their syntax is very similar to that of their C counterparts (**if**, **while**, **switch**, etc.). In this case, there are two main differences between TCL and C:
362 * You use braces instead of parentheses to enclose conditions.
363 * You do not start the script on the next line of your command.
366 @subsubsection occt_draw_2_5_1 if
371 if condition script [elseif script .... else script]
374 **If** evaluates the condition and the script to see whether the condition is true.
379 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
387 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
389 @subsubsection occt_draw_2_5_2 while, for, foreach
395 while condition script
396 for init condition reinit script
397 foreach varname list script
400 The three loop structures are similar to their C or csh equivalent. It is important to use braces to delay evaluation. **foreach** will assign the elements of the list to the variable before evaluating the script. \
403 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
406 while {[dval x] < 100} {
411 # incr var d, increments a variable of d (default 1)
412 for {set i 0} {$i < 10} {incr i} {
414 point p$i cos(angle0 sin(angle) 0
417 foreach object {crapo tomson lucas} {display $object}
418 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
420 @subsubsection occt_draw_2_5_3 break, continue
429 Within loops, the **break** and **continue** commands have the same effect as in C.
431 **break** interrupts the innermost loop and **continue** jumps to the next iteration.
434 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
435 # search the index for which t$i has value ;secret;
436 for {set i 1} {$i <= 100} {incr i} {
437 if {[set t$i] == ;secret;} break;
439 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
441 @subsection occt_draw_2_6 Procedures
443 TCL can be extended by defining procedures using the **proc** command, which sets up a context of local variables, binds arguments and executes a TCL script.
445 The only problematic aspect of procedures is that variables are strictly local, and as they are implicitly created when used, it may be difficult to detect errors.
447 There are two means of accessing a variable outside the scope of the current procedures: **global** declares a global variable (a variable outside all procedures); **upvar** accesses a variable in the scope of the caller. Since arguments in TCL are always string values, the only way to pass Draw variables is by reference, i.e. passing the name of the variable and using the **upvar** command as in the following examples.
449 As TCL is not a strongly typed language it is very difficult to detect programming errors and debugging can be tedious. TCL procedures are, of course, not designed for large scale software development but for testing and simple command or interactive writing.
452 @subsubsection occt_draw_2_6_1 proc
457 proc argumentlist script
460 **proc** defines a procedure. An argument may have a default value. It is then a list of the form {argument value}. The script is the body of the procedure.
462 **return** gives a return value to the procedure.
465 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
470 # procedure with arguments and default values
471 proc distance {x1 y1 {x2 0} {y2 0}} {
472 set d [expr (x2-x1)*(x2-x1) + (y2-y1)*(y2-y1)]
473 return [expr sqrt(d)]
476 if {$n == 0} {return 1} else {
477 return [expr n*[fact [expr n -1]]]
480 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
483 @subsubsection occt_draw_2_6_2 global, upvar
488 global varname [varname ...]
489 upvar varname localname [varname localname ...]
493 **global** accesses high level variables. Unlike C, global variables are not visible in procedures.
495 **upvar** gives a local name to a variable in the caller scope. This is useful when an argument is the name of a variable instead of a value. This is a call by reference and is the only way to use Draw variables as arguments.
497 **Note** that in the following examples the \$ character is always necessarily used to access the arguments.
500 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
501 # convert degree to radian
502 # pi is a global variable
503 proc deg2rad (degree} {
504 return [dval pi*$degree/2.]
506 # create line with a point and an angle
507 proc linang {linename x y angle} {
509 line l $x $y cos($angle) sin($angle)
511 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
513 @section occt_draw_3 Basic Commands
515 This chapter describes all the commands defined in the basic Draw package. Some are TCL commands, but most of them have been formulated in Draw. These commands are found in all Draw applications. The commands are grouped into four sections:
517 * General commands, which are used for Draw and TCL management.
518 * Variable commands, which are used to manage Draw variables such as storing and dumping.
519 * Graphic commands, which are used to manage the graphic system, and so pertain to views.
520 * Variable display commands, which are used to manage the display of objects within given views.
522 Note that Draw also features a GUI task bar providing an alternative way to give certain general, graphic and display commands
525 @subsection occt_draw_3_1 General commands
527 This section describes several useful commands:
529 * **help** to get information,
530 * **source** to eval a script from a file,
531 * **spy** to capture the commands in a file,
532 * **cpulimit** to limit the process cpu time,
533 * **wait** to waste some time,
534 * **chrono** to time commands.
536 @subsubsection occt_draw_3_1_1 help
541 help [command [helpstring group]]
544 Provides help or modifies the help information.
546 **help** without arguments lists all groups and the commands in each group.
548 Specifying the command returns its syntax and in some cases, information on the command, The joker \* is automatically added at the end so that all completing commands are returned as well.
551 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
552 # Gives help on all commands starting with *a*
553 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
556 @subsubsection occt_draw_3_1_2 source
565 The **exit** command will terminate the file.
567 @subsubsection occt_draw_3_1_3 spy
575 Saves interactive commands in the file. If spying has already been performed, the current file is closed. **spy** without an argument closes the current file and stops spying. If a file already exists, the file is overwritten. Commands are not appended.
577 If a command returns an error it is saved with a comment mark.
579 The file created by **spy** can be executed with the **source** command.
582 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
583 # all commands will be saved in the file ;session;
585 # the file ;session; is closed and commands are not saved
587 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
591 @subsubsection occt_draw_3_1_4 cpulimit
599 **cpulimit**limits a process after the number of seconds specified in nbseconds. It is used in tests to avoid infinite loops. **cpulimit** without arguments removes all existing limits.
602 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
603 #limit cpu to one hour
605 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
607 @subsubsection occt_draw_3_1_5 wait
613 Suspends execution for the number of seconds specified in *nbseconds*. The default value is ten (10) seconds. This is a useful command for a slide show.
616 # You have ten seconds ...
620 @subsubsection occt_draw_3_1_6 chrono
625 chrono [ name start/stop/reset/show/restart/[counter text]]
628 Without arguments, **chrono** activates Draw chronometers. The elapsed time ,cpu system and cpu user times for each command will be printed.
630 With arguments, **chrono** is used to manage activated chronometers. You can perform the following actions with a chronometer.
631 * run the chronometer (start).
632 * stop the chronometer (stop).
633 * reset the chronometer to 0 (reset).
634 * restart the chronometer (restart).
635 * display the current time (show).
636 * display the current time with specified text (output example - *COUNTER text: N*), command <i>testdiff</i> will compare such outputs between two test runs (counter).
639 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
641 ==Chronometers activated.
643 ==Elapsed time: 0 Hours 0 Minutes 0.0318 Seconds
644 ==CPU user time: 0.01 seconds
645 ==CPU system time: 0 seconds
646 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
648 @subsection occt_draw_3_2 Variable management commands
650 @subsubsection occt_draw_3_2_1 isdraw, directory
658 **isdraw** tests to see if a variable is a Draw variable. **isdraw** will return 1 if there is a Draw value attached to the variable.
660 Use **directory** to return a list of all Draw global variables matching a pattern.
663 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
676 # to destroy all Draw objects with name containing curve
677 foreach var [directory *curve*] {unset $var}
678 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
681 @subsubsection occt_draw_3_2_2 whatis, dump
686 whatis varname [varname ...]
687 dump varname [varname ...]
690 **whatis** returns short information about a Draw variable. This is usually the type name.
692 **dump** returns a brief type description, the coordinates, and if need be, the parameters of a Draw variable.
695 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
702 ***** Dump of c *****
708 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
710 **Note** The behavior of *whatis* on other variables (not Draw) is not excellent.
713 @subsubsection occt_draw_3_2_3 renamevar, copy
717 renamevar varname tovarname [varname tovarname ...]
718 copy varname tovarname [varname tovarname ...]
721 * **renamevar** changes the name of a Draw variable. The original variable will no longer exist. Note that the content is not modified. Only the name is changed.
722 * **copy** creates a new variable with a copy of the content of an existing variable. The exact behavior of **copy** is type dependent; in the case of certain topological variables, the content may still be shared.
725 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
729 # curves are copied, c2 will not be modified
731 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
733 @subsubsection occt_draw_3_2_4 datadir, save, restore
738 save variable [filename]
739 restore filename [variablename]
742 * **datadir** without arguments prints the path of the current data directory.
743 * **datadir** with an argument sets the data directory path. \
745 If the path starts with a dot (.) only the last directory name will be changed in the path.
747 * **save** writes a file in the data directory with the content of a variable. By default the name of the file is the name of the variable. To give a different name use a second argument.
748 * **restore** reads the content of a file in the data directory in a local variable. By default, the name of the variable is the name of the file. To give a different name, use a second argument.
750 The exact content of the file is type-dependent. They are usually ASCII files and so, architecture independent.
753 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
754 # note how TCL accesses shell environment variables
759 datadir $env(WBCONTAINER)/data/default
760 ==/adv_20/BAG/data/default
764 ==/adv_20/BAG/data/default/theBox
766 # when TCL does not find a command it tries a shell command
772 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
774 @subsection occt_draw_3_3 User defined commands
776 *DrawTrSurf* provides commands to create and display a Draw **geometric** variable from a *Geom_Geometry* object and also get a *Geom_Geometry* object from a Draw geometric variable name.
778 *DBRep* provides commands to create and display a Draw **topological** variable from a *TopoDS_Shape* object and also get a *TopoDS_Shape* object from a Draw topological variable name.
780 @subsubsection occt_draw_3_3_1 set
782 #### In *DrawTrSurf* package:
785 void Set(Standard_CString& Name,const gp_Pnt& G) ;
786 void Set(Standard_CString& Name,const gp_Pnt2d& G) ;
787 void Set(Standard_CString& Name,
788 const Handle(Geom_Geometry)& G) ;
789 void Set(Standard_CString& Name,
790 const Handle(Geom2d_Curve)& C) ;
791 void Set(Standard_CString& Name,
792 const Handle(Poly_Triangulation)& T) ;
793 void Set(Standard_CString& Name,
794 const Handle(Poly_Polygon3D)& P) ;
795 void Set(Standard_CString& Name,
796 const Handle(Poly_Polygon2D)& P) ;
799 #### In *DBRep* package:
802 void Set(const Standard_CString Name,
803 const TopoDS_Shape& S) ;
806 Example of *DrawTrSurf*
809 Handle(Geom2d_Circle) C1 = new Geom2d_Circle
810 (gce_MakeCirc2d (gp_Pnt2d(50,0,) 25));
811 DrawTrSurf::Set(char*, C1);
818 B = BRepPrimAPI_MakeBox (10,10,10);
822 @subsubsection occt_draw_3_3_2 get
824 #### In *DrawTrSurf* package:
827 Handle_Geom_Geometry Get(Standard_CString& Name) ;
830 #### In *DBRep* package:
833 TopoDS_Shape Get(Standard_CString& Name,
834 const TopAbs_ShapeEnum Typ = TopAbs_SHAPE,
835 const Standard_Boolean Complain
839 Example of *DrawTrSurf*
842 Standard_Integer MyCommand
843 (Draw_Interpretor& theCommands,
844 Standard_Integer argc, char** argv)
846 // Creation of a Geom_Geometry from a Draw geometric
848 Handle (Geom_Geometry) aGeom= DrawTrSurf::Get(argv[1]);
855 Standard_Integer MyCommand
856 (Draw_Interpretor& theCommands,
857 Standard_Integer argc, char** argv)
859 // Creation of a TopoDS_Shape from a Draw topological
861 TopoDS_Solid B = DBRep::Get(argv[1]);
865 @section occt_draw_4 Graphic Commands
867 Graphic commands are used to manage the Draw graphic system. Draw provides a 2d and a 3d viewer with up to 30 views. Views are numbered and the index of the view is displayed in the window’s title. Objects are displayed in all 2d views or in all 3d views, depending on their type. 2d objects can only be viewed in 2d views while 3d objects -- only in 3d views correspondingly.
869 @subsection occt_draw_4_1 Axonometric viewer
871 @subsubsection occt_draw_4_1_1 view, delete
875 view index type [X Y W H]
879 **view** is the basic view creation command: it creates a new view with the given index. If a view with this index already exits, it is deleted. The view is created with default parameters and X Y W H are the position and dimensions of the window on the screen. Default values are 0, 0, 500, 500.
881 As a rule it is far simpler either to use the procedures **axo**, **top**, **left** or to click on the desired view type in the menu under *Views* in the task bar..
883 **delete** deletes a view. If no index is given, all the views are deleted.
885 Type selects from the following range:
887 * *AXON* : Axonometric view
888 * *PERS* : Perspective view
889 * <i>+X+Y</i> : View on both axes (i.e. a top view), other codes are <i>-X+Y</i>, <i>+Y-Z</i>, etc.
890 * <i>-2D-</i> : 2d view
892 The index, the type, the current zoom are displayed in the window title .
895 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
896 # this is the content of the mu4 procedure
899 view 1 +X+Z 320 20 400 400
900 view 2 +X+Y 320 450 400 400
901 view 3 +Y+Z 728 20 400 400
902 view 4 AXON 728 450 400 400
904 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
906 See also: **axo, pers, top, bottom, left, right, front, back, mu4, v2d, av2d, smallview**
908 @subsubsection occt_draw_4_1_2 axo, pers, top, ...
919 All these commands are procedures used to define standard screen layout. They delete all existing views and create new ones. The layout usually complies with the European convention, i.e. a top view is under a front view.
921 * **axo** creates a large window axonometric view;
922 * **pers** creates a large window perspective view;
923 * **top**, **bottom**, **left**, **right**, **front**, **back** create a large window axis view;
924 * **mu4** creates four small window views: front, left, top and axo.
925 * **v2d** creates a large window 2d view.
926 * **av2d** creates two small window views, one 2d and one axo
927 * **smallview** creates a view at the bottom right of the screen of the given type.
929 See also: **view**, **delete**
931 @subsubsection occt_draw_4_1_3 mu, md, 2dmu, 2dmd, zoom, 2dzoom
942 * **mu** (magnify up) increases the zoom in one or several views by a factor of 10%.
943 * **md** (magnify down) decreases the zoom by the inverse factor. **2dmu** and **2dmd**
944 perform the same on one or all 2d views.
945 * **zoom** and **2dzoom** set the zoom factor to a value specified by you. The current zoom factor is always displayed in the window’s title bar. Zoom 20 represents a full screen view in a large window; zoom 10, a full screen view in a small one.
946 * **wzoom** (window zoom) allows you to select the area you want to zoom in on with the mouse. You will be prompted to give two of the corners of the area that you want to magnify and the rectangle so defined will occupy the window of the view.
949 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
957 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
958 See also: **fit**, **2dfit**
961 @subsubsection occt_draw_4_14 pu, pd, pl, pr, 2dpu, 2dpd, 2dpl, 2dpr
970 The <i>p_</i> commands are used to pan. **pu** and **pd** pan up and down respectively; **pl** and **pr** pan to the left and to the right respectively. Each time the view is displaced by 40 pixels. When no index is given, all views will pan in the direction specified.
972 # you have selected one anonometric view
977 # you have selected an mu4 view; the object in the third view will pan up
980 See also: **fit**, **2dfit**
983 @subsubsection occt_draw_4_1_5 fit, 2dfit
992 **fit** computes the best zoom and pans on the content of the view. The content of the view will be centered and fit the whole window.
994 When fitting all views a unique zoom is computed for all the views. All views are on the same scale.
997 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1002 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1003 See also: **zoom**, **mu**, **pu**
1006 @subsubsection occt_draw_4_1_6 u, d, l, r
1017 **u**, **d**, **l**, **r** Rotate the object in view around its axis by five degrees up, down, left or right respectively. This command is restricted to axonometric and perspective views.
1020 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1021 # rotate the view up
1023 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1025 @subsubsection occt_draw_4_1_7 focal, fu, fd
1034 * **focal** changes the vantage point in perspective views. A low f value increases the perspective effect; a high one give a perspective similar to that of an axonometric view. The default value is 500.
1035 * **fu** and **fd** increase or decrease the focal value by 10%. **fd** makes the eye closer to the object.
1038 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1041 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1043 **Note**: Do not use a negative or null focal value.
1047 @subsubsection occt_draw_4_1_8 color
1055 **color** sets the color to a value. The index of the *color* is a value between 0 and 15. The name is an X window color name. The list of these can be found in the file *rgb.txt* in the X library directory.
1057 The default values are: 0 White, 1 Red, 2 Green, 3 Blue, 4 Cyan, 5 Gold, 6 Magenta, 7 Marron, 8 Orange, 9 Pink, 10 Salmon, 11 Violet, 12 Yellow, 13 Khaki, 14 Coral.
1060 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1061 # change the value of blue
1063 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1066 **Note** that the color change will be visible on the next redraw of the views, for example, after *fit* or *mu*, etc.
1068 @subsubsection occt_draw_4_1_9 dtext
1072 dtext [x y [z]] string
1075 **dtext** displays a string in all 3d or 2d views. If no coordinates are given, a graphic selection is required. If two coordinates are given, the text is created in a 2d view at the position specified. With 3 coordinates, the text is created in a 3d view.
1077 The coordinates are real space coordinates.
1080 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1084 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1086 @subsubsection occt_draw_4_1_10 hardcopy, hcolor, xwd
1091 hcolor index width gray
1092 xwd [index] filename
1095 * **hardcopy** creates a postcript file called a4.ps in the current directory. This file contains the postscript description of the view index, and will allow you to print the view.
1096 * **hcolor** lets you change the aspect of lines in the postscript file. It allows to specify a width and a gray level for one of the 16 colors. **width** is measured in points with default value as 1, **gray** is the gray level from 0 = black to 1 = white with default value as 0. All colors are bound to the default values at the beginning.
1097 * **xwd** creates an X window xwd file from an active view. By default, the index is set to1. To visualize an xwd file, use the unix command **xwud**.
1100 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1101 # all blue lines (color 3)
1102 # will be half-width and gray
1105 # make a postscript file and print it
1109 # make an xwd file and display it
1112 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1114 **Note:** When more than one view is present, specify the index of the view.
1116 Only use a postscript printer to print postscript files.
1121 @subsubsection occt_draw_4_1_11 wclick, pick
1126 pick index X Y Z b [nowait]
1129 **wclick** defers an event until the mouse button is clicked. The message <code>just click</code> is displayed.
1131 Use the **pick** command to get graphic input. The arguments must be names for variables where the results are stored.
1132 * index: index of the view where the input was made.
1133 * X,Y,Z: 3d coordinates in real world.
1134 * b: b is the mouse button 1,2 or 3.
1136 When there is an extra argument, its value is not used and the command does not wait for a click; the value of b may then be 0 if there has not been a click.
1138 This option is useful for tracking the pointer.
1140 **Note** that the results are stored in Draw numeric variables.
1143 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1144 # make a circle at mouse location
1146 circle c x y z 0 0 1 1 0 0 0 30
1148 # make a dynamic circle at mouse location
1149 # stop when a button is clicked
1150 # (see the repaint command)
1153 while {[dval b] == 0} {
1154 pick index x y z b nowait
1155 circle c x y z 0 0 1 1 0 0 0 30
1158 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1159 See also: **repaint**
1162 Draw provides commands to manage the display of objects.
1163 * **display**, **donly** are used to display,
1164 * **erase**, **clear**, **2dclear** to erase.
1165 * **autodisplay** command is used to check whether variables are displayed when created.
1167 The variable name "." (dot) has a special status in Draw. Any Draw command expecting a Draw object as argument can be passed a dot. The meaning of the dot is the following.
1168 * If the dot is an input argument, a graphic selection will be made. Instead of getting the object from a variable, Draw will ask you to select an object in a view.
1169 * If the dot is an output argument, an unnamed object will be created. Of course this makes sense only for graphic objects: if you create an unnamed number you will not be able to access it. This feature is used when you want to create objects for display only.
1170 * If you do not see what you expected while executing loops or sourcing files, use the **repaint** and **dflush** commands.
1173 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1174 # OK use dot to dump an object on the screen
1179 #Not OK. display points on a curve c
1180 # with dot no variables are created
1181 for {set i 0} {$i <= 10} {incr i} {
1182 cvalue c $i/10 x y z
1187 # would have displayed only one point
1188 # because the precedent variable content is erased
1191 # is an other solution, creating variables
1194 # give a name to a graphic object
1196 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1199 @subsubsection occt_draw_4_1_12 autodisplay
1207 By default, Draw automatically displays any graphic object as soon as it is created. This behavior known as autodisplay can be removed with the command **autodisplay**. Without arguments, **autodisplay** toggles the autodisplay mode. The command always returns the current mode.
1209 When **autodisplay** is off, using the dot return argument is ineffective.
1212 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1221 # c is erased, but not displayed
1223 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1225 @subsubsection occt_draw_4_1_13 display, donly
1229 display varname [varname ...]
1230 donly varname [varname ...]
1233 * **display** makes objects visible.
1234 * **donly** *display only* makes objects visible and erases all other objects. It is very useful to extract one object from a messy screen.
1237 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1238 \# to see all objects
1239 foreach var [directory] {display $var}
1241 \# to select two objects and erase the other ones
1243 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1246 @subsubsection occt_draw_4_1_14 erase, clear, 2dclear
1251 erase [varname varname ...]
1256 **erase** removes objects from all views. **erase** without arguments erases everything in 2d and 3d.
1258 **clear** erases only 3d objects and **2dclear** only 2d objects. **erase** without arguments is similar to **clear; 2dclear**.
1262 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1263 # erase eveerything with a name starting with c_
1264 foreach var [directory c_*] {erase $var}
1268 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1270 @subsubsection occt_draw_4_1_14_1 disp, don, era
1272 These commands have the same meaning as correspondingly display, donly and erase, but with the difference that they evaluate the arguments using glob pattern rules. For example, to display all objects with names d_1, d_2, d_3, etc. it is enouth to run the command:
1277 @subsubsection occt_draw_4_1_15 repaint, dflush
1287 * **repaint** forces repainting of views.
1288 * **dflush** flushes the graphic buffers.
1290 These commands are useful within loops or in scripts.
1292 When an object is modified or erased, the whole view must be repainted. To avoid doing this too many times, Draw sets up a flag and delays the repaint to the end of the command in which the new prompt is issued. In a script, you may want to display the result of a change immediately. If the flag is raised, **repaint** will repaint the views and clear the flag.
1294 Graphic operations are buffered by Draw (and also by the X system). Usually the buffer is flushed at the end of a command and before graphic selection. If you want to flush the buffer from inside a script, use the **dflush** command.
1296 See also: @ref occt_draw_4_1_11 "pick" command.
1298 @subsection occt_draw_4_2 AIS viewer -- view commands
1300 @subsubsection occt_draw_4_2_1 vinit
1306 Creates a new View window with the specified *view_name*.
1307 By default the view is created in the viewer and in the graphic driver shared with the active view.
1310 name = {driverName/viewerName/viewName | viewerName/viewName | viewName}
1313 If *driverName* is not specified the driver will be shared with the active view.
1314 If *viewerName* is not specified the viewer will be shared with the active view.
1316 @subsubsection occt_draw_4_2_2 vhelp
1322 Displays help in the 3D viewer window. The help consists in a list of hotkeys and their functionalities.
1324 @subsubsection occt_draw_4_2_3 vtop
1331 Displays top view in the 3D viewer window. Orientation +X+Y.
1334 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1340 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1342 @subsubsection occt_draw_4_2_4 vaxo
1349 Displays axonometric view in the 3D viewer window. Orientation +X-Y+Z.
1352 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
1358 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1360 @subsubsection occt_draw_4_2_5 vsetbg
1364 vsetbg imagefile [filltype]
1367 Loads image file as background. *filltype* must be NONE, CENTERED, TILED or STRETCH.
1372 vsetbg myimage.brep CENTERED
1375 @subsubsection occt_draw_4_2_6 vclear
1381 Removes all objects from the viewer.
1383 @subsubsection occt_draw_4_2_7 vrepaint
1389 Forcibly redisplays the shape in the 3D viewer window.
1391 @subsubsection occt_draw_4_2_8 vfit
1397 Automatic zoom/panning. Objects in the view are visualized to occupy the maximum surface.
1399 @subsubsection occt_draw_4_2_9 vzfit
1406 Automatic depth panning. Objects in the view are visualized to occupy the maximum 3d space.
1408 @subsubsection occt_draw_4_2_10 vreadpixel
1412 vreadpixel xPixel yPixel [{rgb|rgba|depth|hls|rgbf|rgbaf}=rgba] [name]
1414 Read pixel value for active view.
1417 @subsubsection occt_draw_4_2_11 vselect
1421 vselect x1 y1 [x2 y2 [x3 y3 ... xn yn]] [-allowoverlap 0|1] [shift_selection = 0|1]
1424 Emulates different types of selection:
1426 * single mouse click selection
1427 * selection with a rectangle having the upper left and bottom right corners in <i>(x1,y1)</i> and <i>(x2,y2)</i> respectively
1428 * selection with a polygon having the corners in pixel positions <i>(x1,y1), (x2,y2),…, (xn,yn)</i>
1429 * <i> -allowoverlap </i> manages overlap and inclusion detection in rectangular selection. If the flag is set to 1, both sensitives that were included completely and overlapped partially by defined rectangle will be detected, otherwise algorithm will chose only fully included sensitives. Default behavior is to detect only full inclusion.
1430 * any of these selections if shift_selection is set to 1.
1432 @subsubsection occt_draw_4_2_12 vmoveto
1439 Emulates cursor movement to pixel position (x,y).
1441 @subsubsection occt_draw_4_2_13 vviewparams
1445 vviewparams [-scale [s]] [-eye [x y z]] [-at [x y z]] [-up [x y z]] [-proj [x y z]] [-center x y] [-size sx]
1447 Gets or sets the current view parameters.
1448 * If called without arguments, all view parameters are printed.
1450 * -scale [s] : prints or sets the relative scale of viewport.
1451 * -eye [x y z] : prints or sets the eye location.
1452 * -at [x y z] : prints or sets the view center.
1453 * -up [x y z] : prints or sets the up vector direction.
1454 * -proj [x y z] : prints or sets the view direction.
1455 * -center x y : sets the screen center location in pixels.
1456 * -size [sx] : prints viewport projection width and height sizes or changes the size of its maximum dimension.
1458 @subsubsection occt_draw_4_2_14 vchangeselected
1462 vchangeselected shape
1464 Adds a shape to selection or removes one from it.
1466 @subsubsection occt_draw_4_2_15 vzclipping
1470 vzclipping [mode] [depth width]
1472 Gets or sets ZClipping mode, width and depth, where
1473 - *mode = OFF|BACK|FRONT|SLICE*
1474 - *depth* is a real value from segment [0,1]
1475 - *width* is a real value from segment [0,1]
1477 @subsubsection occt_draw_4_2_16 vnbselected
1483 Returns the number of selected objects in the interactive context.
1485 @subsubsection occt_draw_4_2_18 vpurgedisplay
1489 vpurgedisplay [CollectorToo = 0|1]
1491 Removes structures which do not belong to objects displayed in neutral point.
1493 @subsubsection occt_draw_4_2_19 vhlr
1497 vhlr is_enabled={on|off} [show_hidden={1|0}]
1499 Hidden line removal algorithm:
1500 * <i>is_enabled</i> applies HLR algorithm.
1501 * <i>show_hidden</i> if equals to 1, hidden lines are drawn as dotted ones.
1503 @subsubsection occt_draw_4_2_20 vhlrtype
1507 vhlrtype algo_type={algo|polyalgo} [shape_1 ... shape_n]
1510 Changes the type of HLR algorithm used for shapes.
1511 If the algo_type is algo, the exact HLR algorithm is used, otherwise the polygonal algorithm is used for defined shapes.
1513 If no shape is specified through the command arguments, the given HLR algorithm_type is applied to all *AIS_Shape* isntances in the current context, and the command also changes the default HLR algorithm type.
1515 **Note** that this command works with instances of *AIS_Shape* or derived classes only, other interactive object types are ignored.
1517 @subsubsection occt_draw_4_2_21 vcamera
1521 vcamera [-ortho] [-projtype]
1523 [-fovy [Angle]] [-distance [Distance]]
1524 [-stereo] [-leftEye] [-rightEye]
1525 [-iod [Distance]] [-iodType [absolute|relative]]
1526 [-zfocus [Value]] [-zfocusType [absolute|relative]]
1529 Manages camera parameters.
1530 Prints the current value when the option is called without argument.
1532 Orthographic camera:
1533 * -ortho -- activates orthographic projection.
1536 * -persp -- activated perspective projection (mono);
1537 * -fovy -- field of view in y axis, in degrees;
1538 * -distance -- distance of eye from the camera center.
1540 Stereoscopic camera:
1541 * -stereo -- perspective projection (stereo);
1542 * -leftEye -- perspective projection (left eye);
1543 * -rightEye -- perspective projection (right eye);
1544 * -iod -- intraocular distance value;
1545 * -iodType -- distance type, absolute or relative;
1546 * -zfocus -- stereographic focus value;
1547 * -zfocusType -- focus type, absolute or relative.
1558 @subsubsection occt_draw_4_2_22 vstereo
1562 vstereo [0|1] [-mode Mode] [-reverse {0|1}] [-anaglyph Filter]
1565 Defines the stereo output mode. The following modes are available:
1566 * quadBuffer -- OpenGL QuadBuffer stereo, requires driver support. Should be called BEFORE *vinit*!
1567 * anaglyph -- Anaglyph glasses;
1568 * rowInterlaced -- row-interlaced display;
1569 * columnInterlaced -- column-interlaced display;
1570 * chessBoard -- chess-board output;
1571 * sideBySide -- horizontal pair;
1572 * overUnder -- vertical pair;
1573 Available Anaglyph filters for -anaglyph:
1574 * redCyan, redCyanSimple, yellowBlue, yellowBlueSimple, greenMagentaSimple.
1583 vcamera -stereo -iod 1
1588 @subsubsection occt_draw_4_2_23 vfrustumculling
1592 vfrustumculling [toEnable]
1595 Enables/disables objects clipping.
1598 @subsection occt_draw_4_3 AIS viewer -- display commands
1600 @subsubsection occt_draw_4_3_1 vdisplay
1604 vdisplay [-noupdate|-update] [-local] [-mutable] [-neutral]
1605 [-trsfPers {pan|zoom|rotate|trihedron|full|none}=none] [-trsfPersPos X Y [Z]] [-3d|-2d|-2dTopDown]
1606 [-dispMode mode] [-highMode mode]
1607 [-layer index] [-top|-topmost|-overlay|-underlay]
1609 name1 [name2] ... [name n]
1612 Displays named objects.
1613 Option <i>-local</i> enables display of objects in the local selection context.
1614 Local selection context will be opened if there is not any.
1616 * *noupdate* suppresses viewer redraw call.
1617 * *mutable* enables optimization for mutable objects.
1618 * *neutral* draws objects in the main viewer.
1619 * *layer* sets z-layer for objects. It can use <i>-overlay|-underlay|-top|-topmost</i> instead of <i>-layer index</i> for the default z-layers.
1620 * *top* draws objects on top of main presentations but below the topmost level.
1621 * *topmost* draws in overlay for 3D presentations with independent Depth.
1622 * *overlay* draws objects in overlay for 2D presentations (On-Screen-Display).
1623 * *underlay* draws objects in underlay for 2D presentations (On-Screen-Display).
1624 * *selectable|-noselect* controls selection of objects.
1625 * *trsfPers* sets transform persistence flags. Flag *full* allows to pan, zoom and rotate.
1626 * *trsfPersPos* sets an anchor point for transform persistence.
1627 * *2d|-2dTopDown* displays object in screen coordinates.
1628 * *dispmode* sets display mode for objects.
1629 * *highmode* sets highlight mode for objects.
1630 * *redisplay* recomputes presentation of objects.
1635 box b 40 40 40 10 10 10
1641 @subsubsection occt_draw_4_3_2 vdonly
1645 vdonly [-noupdate|-update] [name1] ... [name n]
1648 Displays only selected or named objects. If there are no selected or named objects, nothing is done.
1653 box b 40 40 40 10 10 10
1659 @subsubsection occt_draw_4_3_3 vdisplayall
1663 vdisplayall [-local]
1666 Displays all erased interactive objects (see vdir and vstate).
1667 Option <i>-local</i> enables displaying objects in the local selection context.
1672 box b 40 40 40 10 10 10
1678 @subsubsection occt_draw_4_3_4 verase
1682 verase [name1] [name2] … [name n]
1685 Erases some selected or named objects. If there are no selected or named objects, the whole viewer is erased.
1690 box b1 40 40 40 10 10 10
1691 box b2 -40 -40 -40 10 10 10
1695 # erase only first box
1697 # erase second box and sphere
1701 @subsubsection occt_draw_4_3_5 veraseall
1708 Erases all objects displayed in the viewer.
1713 box b1 40 40 40 10 10 10
1714 box b2 -40 -40 -40 10 10 10
1718 # erase only first box
1720 # erase second box and sphere
1724 @subsubsection occt_draw_4_3_6 vsetdispmode
1728 vsetdispmode [name] mode(0,1,2,3)
1731 Sets display mode for all, selected or named objects.
1732 * *0* (*WireFrame*),
1734 * *2* (*Quick HideLineremoval*),
1735 * *3* (*Exact HideLineremoval*).
1746 @subsubsection occt_draw_4_3_7 vdisplaytype
1753 Displays all objects of a given type.
1754 The following types are possible: *Point*, *Axis*, *Trihedron*, *PlaneTrihedron*, *Line*, *Circle*, *Plane*, *Shape*, *ConnectedShape*, *MultiConn.Shape*, *ConnectedInter.*, *MultiConn.*, *Constraint* and *Dimension*.
1756 @subsubsection occt_draw_4_3_8 verasetype
1763 Erases all objects of a given type.
1764 Possible type is *Point*, *Axis*, *Trihedron*, *PlaneTrihedron*, *Line*, *Circle*, *Plane*, *Shape*, *ConnectedShape*, *MultiConn.Shape*, *ConnectedInter.*, *MultiConn.*, *Constraint* and *Dimension*.
1766 @subsubsection occt_draw_4_3_9 vtypes
1773 Makes a list of known types and signatures in AIS.
1775 @subsubsection occt_draw_4_3_10 vaspects
1779 vaspects [-noupdate|-update] [name1 [name2 [...]] | -defaults]
1780 [-setVisibility 0|1]
1781 [-setColor ColorName] [-setcolor R G B] [-unsetColor]
1782 [-setMaterial MatName] [-unsetMaterial]
1783 [-setTransparency Transp] [-unsetTransparency]
1784 [-setWidth LineWidth] [-unsetWidth]
1785 [-setLineType {solid|dash|dot|dotDash}] [-unsetLineType]
1786 [-freeBoundary {off/on | 0/1}]
1787 [-setFreeBoundaryWidth Width] [-unsetFreeBoundaryWidth]
1788 [-setFreeBoundaryColor {ColorName | R G B}] [-unsetFreeBoundaryColor]
1789 [-subshapes subname1 [subname2 [...]]]
1790 [-isoontriangulation 0|1]
1791 [-setMaxParamValue {value}]
1795 Manages presentation properties of all, selected or named objects.
1796 * *-subshapes* -- assigns presentation properties to the specified sub-shapes.
1797 * *-defaults* -- assigns presentation properties to all objects that do not have their own specified properties and to all objects to be displayed in the future.
1798 If *-defaults* option is used there should not be any names of objects and *-subshapes* specifier.
1802 vsetcolor [-noupdate|-update] [name] ColorName
1807 Manages presentation properties (color, material, transparency) of all objects, selected or named.
1809 **Color**. The *ColorName* can be: *BLACK*, *MATRAGRAY*, *MATRABLUE*, *ALICEBLUE*, *ANTIQUEWHITE*, *ANTIQUEWHITE1*, *ANTIQUEWHITE2*, *ANTIQUEWHITE3*, *ANTIQUEWHITE4*, *AQUAMARINE1*, *AQUAMARINE2*, *AQUAMARINE4*, *AZURE*, *AZURE2*, *AZURE3*, *AZURE4*, *BEIGE*, *BISQUE*, *BISQUE2*, *BISQUE3*, *BISQUE4*, *BLANCHEDALMOND*, *BLUE1*, *BLUE2*, *BLUE3*, *BLUE4*, *BLUEVIOLET*, *BROWN*, *BROWN1*, *BROWN2*, *BROWN3*, *BROWN4*, *BURLYWOOD*, *BURLYWOOD1*, *BURLYWOOD2*, *BURLYWOOD3*, *BURLYWOOD4*, *CADETBLUE*, *CADETBLUE1*, *CADETBLUE2*, *CADETBLUE3*, *CADETBLUE4*, *CHARTREUSE*, *CHARTREUSE1*, *CHARTREUSE2*, *CHARTREUSE3*, *CHARTREUSE4*, *CHOCOLATE*, *CHOCOLATE1*, *CHOCOLATE2*, *CHOCOLATE3*, *CHOCOLATE4*, *CORAL*, *CORAL1*, *CORAL2*, *CORAL3*, *CORAL4*, *CORNFLOWERBLUE*, *CORNSILK1*, *CORNSILK2*, *CORNSILK3*, *CORNSILK4*, *CYAN1*, *CYAN2*, *CYAN3*, *CYAN4*, *DARKGOLDENROD*, *DARKGOLDENROD1*, *DARKGOLDENROD2*, *DARKGOLDENROD3*, *DARKGOLDENROD4*, *DARKGREEN*, *DARKKHAKI*, *DARKOLIVEGREEN*, *DARKOLIVEGREEN1*, *DARKOLIVEGREEN2*, *DARKOLIVEGREEN3*, *DARKOLIVEGREEN4*, *DARKORANGE*, *DARKORANGE1*, *DARKORANGE2*, *DARKORANGE3*, *DARKORANGE4*, *DARKORCHID*, *DARKORCHID1*, *DARKORCHID2*, *DARKORCHID3*, *DARKORCHID4*, *DARKSALMON*, *DARKSEAGREEN*, *DARKSEAGREEN1*, *DARKSEAGREEN2*, *DARKSEAGREEN3*, *DARKSEAGREEN4*, *DARKSLATEBLUE*, *DARKSLATEGRAY1*, *DARKSLATEGRAY2*, *DARKSLATEGRAY3*, *DARKSLATEGRAY4*, *DARKSLATEGRAY*, *DARKTURQUOISE*, *DARKVIOLET*, *DEEPPINK*, *DEEPPINK2*, *DEEPPINK3*, *DEEPPINK4*, *DEEPSKYBLUE1*, *DEEPSKYBLUE2*, *DEEPSKYBLUE3*, *DEEPSKYBLUE4*, *DODGERBLUE1*, *DODGERBLUE2*, *DODGERBLUE3*, *DODGERBLUE4*, *FIREBRICK*, *FIREBRICK1*, *FIREBRICK2*, *FIREBRICK3*, *FIREBRICK4*, *FLORALWHITE*, *FORESTGREEN*, *GAINSBORO*, *GHOSTWHITE*, *GOLD*, *GOLD1*, *GOLD2*, *GOLD3*, *GOLD4*, *GOLDENROD*, *GOLDENROD1*, *GOLDENROD2*, *GOLDENROD3*, *GOLDENROD4*, *GRAY*, *GRAY0*, *GRAY1*, *GRAY10*, *GRAY11*, *GRAY12*, *GRAY13*, *GRAY14*, *GRAY15*, *GRAY16*, *GRAY17*, *GRAY18*, *GRAY19*, *GRAY2*, *GRAY20*, *GRAY21*, *GRAY22*, *GRAY23*, *GRAY24*, *GRAY25*, *GRAY26*, *GRAY27*, *GRAY28*, *GRAY29*, *GRAY3*, *GRAY30*, *GRAY31*, *GRAY32*, *GRAY33*, *GRAY34*, *GRAY35*, *GRAY36*, *GRAY37*, *GRAY38*, *GRAY39*, *GRAY4*, *GRAY40*, *GRAY41*, *GRAY42*, *GRAY43*, *GRAY44*, *GRAY45*, *GRAY46*, *GRAY47*, *GRAY48*, *GRAY49*, *GRAY5*, *GRAY50*, *GRAY51*, *GRAY52*, *GRAY53*, *GRAY54*, *GRAY55*, *GRAY56*, *GRAY57*, *GRAY58*, *GRAY59*, *GRAY6*, *GRAY60*, *GRAY61*, *GRAY62*, *GRAY63*, *GRAY64*, *GRAY65*, *GRAY66*, *GRAY67*, *GRAY68*, *GRAY69*, *GRAY7*, *GRAY70*, *GRAY71*, *GRAY72*, *GRAY73*, *GRAY74*, *GRAY75*, *GRAY76*, *GRAY77*, *GRAY78*, *GRAY79*, *GRAY8*, *GRAY80*, *GRAY81*, *GRAY82*, *GRAY83*, *GRAY85*, *GRAY86*, *GRAY87*, *GRAY88*, *GRAY89*, *GRAY9*, *GRAY90*, *GRAY91*, *GRAY92*, *GRAY93*, *GRAY94*, *GRAY95*, *GREEN*, *GREEN1*, *GREEN2*, *GREEN3*, *GREEN4*, *GREENYELLOW*, *GRAY97*, *GRAY98*, *GRAY99*, *HONEYDEW*, *HONEYDEW2*, *HONEYDEW3*, *HONEYDEW4*, *HOTPINK*, *HOTPINK1*, *HOTPINK2*, *HOTPINK3*, *HOTPINK4*, *INDIANRED*, *INDIANRED1*, *INDIANRED2*, *INDIANRED3*, *INDIANRED4*, *IVORY*, *IVORY2*, *IVORY3*, *IVORY4*, *KHAKI*, *KHAKI1*, *KHAKI2*, *KHAKI3*, *KHAKI4*, *LAVENDER*, *LAVENDERBLUSH1*, *LAVENDERBLUSH2*, *LAVENDERBLUSH3*, *LAVENDERBLUSH4*, *LAWNGREEN*, *LEMONCHIFFON1*, *LEMONCHIFFON2*, *LEMONCHIFFON3*, *LEMONCHIFFON4*, *LIGHTBLUE*, *LIGHTBLUE1*, *LIGHTBLUE2*, *LIGHTBLUE3*, *LIGHTBLUE4*, *LIGHTCORAL*, *LIGHTCYAN1*, *LIGHTCYAN2*, *LIGHTCYAN3*, *LIGHTCYAN4*, *LIGHTGOLDENROD*, *LIGHTGOLDENROD1*, *LIGHTGOLDENROD2*, *LIGHTGOLDENROD3*, *LIGHTGOLDENROD4*, *LIGHTGOLDENRODYELLOW*, *LIGHTGRAY*, *LIGHTPINK*, *LIGHTPINK1*, *LIGHTPINK2*, *LIGHTPINK3*, *LIGHTPINK4*, *LIGHTSALMON1*, *LIGHTSALMON2*, *LIGHTSALMON3*, *LIGHTSALMON4*, *LIGHTSEAGREEN*, *LIGHTSKYBLUE*, *LIGHTSKYBLUE1*, *LIGHTSKYBLUE2*, *LIGHTSKYBLUE3*, *LIGHTSKYBLUE4*, *LIGHTSLATEBLUE*, *LIGHTSLATEGRAY*, *LIGHTSTEELBLUE*, *LIGHTSTEELBLUE1*, *LIGHTSTEELBLUE2*, *LIGHTSTEELBLUE3*, *LIGHTSTEELBLUE4*, *LIGHTYELLOW*, *LIGHTYELLOW2*, *LIGHTYELLOW3*, *LIGHTYELLOW4*, *LIMEGREEN*, *LINEN*, *MAGENTA1*, *MAGENTA2*, *MAGENTA3*, *MAGENTA4*, *MAROON*, *MAROON1*, *MAROON2*, *MAROON3*, *MAROON4*, *MEDIUMAQUAMARINE*, *MEDIUMORCHID*, *MEDIUMORCHID1*, *MEDIUMORCHID2*, *MEDIUMORCHID3*, *MEDIUMORCHID4*, *MEDIUMPURPLE*, *MEDIUMPURPLE1*, *MEDIUMPURPLE2*, *MEDIUMPURPLE3*, *MEDIUMPURPLE4*, *MEDIUMSEAGREEN*, *MEDIUMSLATEBLUE*, *MEDIUMSPRINGGREEN*, *MEDIUMTURQUOISE*, *MEDIUMVIOLETRED*, *MIDNIGHTBLUE*, *MINTCREAM*, *MISTYROSE*, *MISTYROSE2*, *MISTYROSE3*, *MISTYROSE4*, *MOCCASIN*, *NAVAJOWHITE1*, *NAVAJOWHITE2*, *NAVAJOWHITE3*, *NAVAJOWHITE4*, *NAVYBLUE*, *OLDLACE*, *OLIVEDRAB*, *OLIVEDRAB1*, *OLIVEDRAB2*, *OLIVEDRAB3*, *OLIVEDRAB4*, *ORANGE*, *ORANGE1*, *ORANGE2*, *ORANGE3*, *ORANGE4*, *ORANGERED*, *ORANGERED1*, *ORANGERED2*, *ORANGERED3*, *ORANGERED4*, *ORCHID*, *ORCHID1*, *ORCHID2*, *ORCHID3*, *ORCHID4*, *PALEGOLDENROD*, *PALEGREEN*, *PALEGREEN1*, *PALEGREEN2*, *PALEGREEN3*, *PALEGREEN4*, *PALETURQUOISE*, *PALETURQUOISE1*, *PALETURQUOISE2*, *PALETURQUOISE3*, *PALETURQUOISE4*, *PALEVIOLETRED*, *PALEVIOLETRED1*, *PALEVIOLETRED2*, *PALEVIOLETRED3*, *PALEVIOLETRED4*, *PAPAYAWHIP*, *PEACHPUFF*, *PEACHPUFF2*, *PEACHPUFF3*, *PEACHPUFF4*, *PERU*, *PINK*, *PINK1*, *PINK2*, *PINK3*, *PINK4*, *PLUM*, *PLUM1*, *PLUM2*, *PLUM3*, *PLUM4*, *POWDERBLUE*, *PURPLE*, *PURPLE1*, *PURPLE2*, *PURPLE3*, *PURPLE4*, *RED*, *RED1*, *RED2*, *RED3*, *RED4*, *ROSYBROWN*, *ROSYBROWN1*, *ROSYBROWN2*, *ROSYBROWN3*, *ROSYBROWN4*, *ROYALBLUE*, *ROYALBLUE1*, *ROYALBLUE2*, *ROYALBLUE3*, *ROYALBLUE4*, *SADDLEBROWN*, *SALMON*, *SALMON1*, *SALMON2*, *SALMON3*, *SALMON4*, *SANDYBROWN*, *SEAGREEN*, *SEAGREEN1*, *SEAGREEN2*, *SEAGREEN3*, *SEAGREEN4*, *SEASHELL*, *SEASHELL2*, *SEASHELL3*, *SEASHELL4*, *BEET*, *TEAL*, *SIENNA*, *SIENNA1*, *SIENNA2*, *SIENNA3*, *SIENNA4*, *SKYBLUE*, *SKYBLUE1*, *SKYBLUE2*, *SKYBLUE3*, *SKYBLUE4*, *SLATEBLUE*, *SLATEBLUE1*, *SLATEBLUE2*, *SLATEBLUE3*, *SLATEBLUE4*, *SLATEGRAY1*, *SLATEGRAY2*, *SLATEGRAY3*, *SLATEGRAY4*, *SLATEGRAY*, *SNOW*, *SNOW2*, *SNOW3*, *SNOW4*, *SPRINGGREEN*, *SPRINGGREEN2*, *SPRINGGREEN3*, *SPRINGGREEN4*, *STEELBLUE*, *STEELBLUE1*, *STEELBLUE2*, *STEELBLUE3*, *STEELBLUE4*, *TAN*, *TAN1*, *TAN2*, *TAN3*, *TAN4*, *THISTLE*, *THISTLE1*, *THISTLE2*, *THISTLE3*, *THISTLE4*, *TOMATO*, *TOMATO1*, *TOMATO2*, *TOMATO3*, *TOMATO4*, *TURQUOISE*, *TURQUOISE1*, *TURQUOISE2*, *TURQUOISE3*, *TURQUOISE4*, *VIOLET*, *VIOLETRED*, *VIOLETRED1*, *VIOLETRED2*, *VIOLETRED3*, *VIOLETRED4*, *WHEAT*, *WHEAT1*, *WHEAT2*, *WHEAT3*, *WHEAT4*, *WHITE*, *WHITESMOKE*, *YELLOW*, *YELLOW1*, *YELLOW2*, *YELLOW3*, *YELLOW4* and *YELLOWGREEN*.
1811 vaspects [name] [-setcolor ColorName] [-setcolor R G B] [-unsetcolor]
1812 vsetcolor [name] ColorName
1816 **Transparency. The *Transp* may be between 0.0 (opaque) and 1.0 (fully transparent).
1817 **Warning**: at 1.0 the shape becomes invisible.
1819 vaspects [name] [-settransparency Transp] [-unsettransparency]
1820 vsettransparency [name] Transp
1821 vunsettransparency [name]
1824 **Material**. The *MatName* can be *BRASS*, *BRONZE*, *COPPER*, *GOLD*, *PEWTER*, *PLASTER*, *PLASTIC*, *SILVER*, *STEEL*, *STONE*, *SHINY_PLASTIC*, *SATIN*, *METALIZED*, *NEON_GNC*, *CHROME*, *ALUMINIUM*, *OBSIDIAN*, *NEON_PHC*, *JADE*, *WATER*, *GLASS*, *DIAMOND* or *CHARCOAL*.
1826 vaspects [name] [-setmaterial MatName] [-unsetmaterial]
1827 vsetmaterial [name] MatName
1828 vunsetmaterial [name]
1831 **Line width**. Specifies width of the edges. The *LineWidth* may be between 0.0 and 10.0.
1833 vaspects [name] [-setwidth LineWidth] [-unsetwidth]
1834 vsetwidth [name] LineWidth
1846 vaspects -setcolor red -settransparency 0.2
1855 @subsubsection occt_draw_4_3_11 vsetshading
1859 vsetshading shapename [coefficient]
1862 Sets deflection coefficient that defines the quality of the shape’s representation in the shading mode. Default coefficient is 0.0008.
1874 @subsubsection occt_draw_4_3_12 vunsetshading
1878 vunsetshading [shapename]
1881 Sets default deflection coefficient (0.0008) that defines the quality of the shape’s representation in the shading mode.
1883 @subsubsection occt_draw_4_3_13 vsetam
1887 vsetam [shapename] mode
1890 Activates selection mode for all selected or named shapes:
1891 * *0* for *shape* itself,
1898 * *7* (*compounds*).
1909 @subsubsection occt_draw_4_3_14 vunsetam
1916 Deactivates all selection modes for all shapes.
1918 @subsubsection occt_draw_4_3_15 vdump
1922 vdump <filename>.{png|bmp|jpg|gif} [-width Width -height Height]
1923 [-buffer rgb|rgba|depth=rgb]
1924 [-stereo mono|left|right|blend|sideBySide|overUnder=mono]
1928 Extracts the contents of the viewer window to a image file.
1930 @subsubsection occt_draw_4_3_16 vdir
1937 Displays the list of displayed objects.
1939 @subsubsection occt_draw_4_3_17 vsub
1943 vsub 0/1(on/off)[shapename]
1946 Hilights/unhilights named or selected objects which are displayed at neutral state with subintensity color.
1959 @subsubsection occt_draw_4_3_20 vsensdis
1966 Displays active entities (sensitive entities of one of the standard types corresponding to active selection modes).
1968 Standard entity types are those defined in Select3D package:
1975 * sensitive triangulation
1976 * sensitive triangle
1977 Custom (application-defined) sensitive entity types are not processed by this command.
1979 @subsubsection occt_draw_4_3_21 vsensera
1986 Erases active entities.
1988 @subsubsection occt_draw_4_3_23 vr
1995 Reads shape from BREP-format file and displays it in the viewer.
2003 @subsubsection occt_draw_4_3_24 vstate
2007 vstate [-entities] [-hasSelected] [name1] ... [nameN]
2010 Reports show/hidden state for selected or named objects:
2011 * *entities* -- prints low-level information about detected entities;
2012 * *hasSelected* -- prints 1 if the context has a selected shape and 0 otherwise.
2014 @subsubsection occt_draw_4_3_25 vraytrace
2021 Turns on/off ray tracing renderer.
2023 @subsubsection occt_draw_4_3_26 vrenderparams
2027 vrenderparams [-rayTrace|-raster] [-rayDepth 0..10] [-shadows {on|off}]
2028 [-reflections {on|off}] [-fsaa {on|off}] [-gleam {on|off}]
2029 [-gi {on|off}] [-brng {on|off}] [-env {on|off}]
2030 [-shadin {color|flat|gouraud|phong}]
2033 Manages rendering parameters:
2034 * rayTrace -- Enables GPU ray-tracing
2035 * raster -- Disables GPU ray-tracing
2036 * rayDepth -- Defines maximum ray-tracing depth
2037 * shadows -- Enables/disables shadows rendering
2038 * reflections -- Enables/disables specular reflections
2039 * fsaa -- Enables/disables adaptive anti-aliasing
2040 * gleam -- Enables/disables transparency shadow effects
2041 * gi -- Enables/disables global illumination effects
2042 * brng -- Enables/disables blocked RNG (fast coherent PT)
2043 * env -- Enables/disables environment map background
2044 * shadingModel -- Controls shading model from enumeration color, flat, gouraud, phong
2046 Unlike *vcaps*, these parameters dramatically change visual properties.
2047 The command is intended to control presentation quality depending on hardware capabilities and performance.
2056 vrenderparams -shadows 1 -reflections 1 -fsaa 1
2058 @subsubsection occt_draw_4_3_27 vshaderprog
2062 'vshaderprog [name] pathToVertexShader pathToFragmentShader'
2063 or 'vshaderprog [name] off' to disable GLSL program
2064 or 'vshaderprog [name] phong' to enable per-pixel lighting calculations
2067 Enables rendering using a shader program.
2069 @subsubsection occt_draw_4_3_28 vsetcolorbg
2076 Sets background color.
2081 vsetcolorbg 200 0 200
2084 @subsection occt_draw_4_4 AIS viewer -- object commands
2086 @subsubsection occt_draw_4_4_1 vtrihedron
2090 vtrihedron name [-dispMode {wf|sh|wireframe|shading}]
2092 [-zaxis u v w -xaxis u v w ]
2093 [-drawaxes {X|Y|Z|XY|YZ|XZ|XYZ}]
2094 [-hidelabels {on|off}]"
2095 [-label {XAxis|YAxis|ZAxis} value]"
2096 [-attribute {XAxisLength|YAxisLength|ZAxisLength
2097 |TubeRadiusPercent|ConeRadiusPercent"
2098 |ConeLengthPercent|OriginRadiusPercent"
2099 |ShadingNumberOfFacettes} value]"
2100 [-color {Origin|XAxis|YAxis|ZAxis|XOYAxis|YOZAxis"
2101 |XOZAxis|Whole} {r g b | colorName}]"
2102 [-textcolor {r g b | colorName}]"
2103 [-arrowscolor {r g b | colorName}]"
2104 [-priority {Origin|XAxis|YAxis|ZAxis|XArrow"
2105 |YArrow|ZArrow|XOYAxis|YOZAxis"
2106 |XOZAxis|Whole} value]
2110 Creates a new *AIS_Trihedron* object or changes existing trihedron. If no argument is set, the default trihedron (0XYZ) is created.
2117 vtrihedron t2 -dispmode shading -origin -200 -200 -300
2118 vtrihedron t2 -color XAxis Quantity_NOC_RED
2119 vtrihedron t2 -color YAxis Quantity_NOC_GREEN
2120 vtrihedron t2 -color ZAxis|Origin Quantity_NOC_BLUE1
2123 @subsubsection occt_draw_4_4_2 vplanetri
2130 Creates a plane from a trihedron selection. If no arguments are set, the default plane is created.
2133 @subsubsection occt_draw_4_4_3 vsize
2140 Changes the size of a named or selected trihedron. If the name is not defined: it affects the selected trihedrons otherwise nothing is done. If the value is not defined, it is set to 100 by default.
2146 vtrihedron tr2 0 0 0 1 0 0 1 0 0
2150 @subsubsection occt_draw_4_4_4 vaxis
2154 vaxis name [Xa Ya Za Xb Yb Zb]
2157 Creates an axis. If the values are not defined, an axis is created by interactive selection of two vertices or one edge
2163 vaxis axe1 0 0 0 1 0 0
2166 @subsubsection occt_draw_4_4_5 vaxispara
2173 Creates an axis by interactive selection of an edge and a vertex.
2175 @subsubsection occt_draw_4_4_6 vaxisortho
2182 Creates an axis by interactive selection of an edge and a vertex. The axis will be orthogonal to the selected edge.
2184 @subsubsection occt_draw_4_4_7 vpoint
2188 vpoint name [Xa Ya Za]
2191 Creates a point from coordinates. If the values are not defined, a point is created by interactive selection of a vertice or an edge (in the center of the edge).
2199 @subsubsection occt_draw_4_4_8 vplane
2203 vplane name [AxisName] [PointName]
2204 vplane name [PointName] [PointName] [PointName]
2205 vplane name [PlaneName] [PointName]
2208 Creates a plane from named or interactively selected entities.
2217 vaxis axe1 0 0 0 0 0 1
2219 vplane plane1 axe1 p1
2222 @subsubsection occt_draw_4_4_9 vplanepara
2229 Creates a plane from interactively selected vertex and face.
2231 @subsubsection occt_draw_4_4_10 vplaneortho
2238 Creates a plane from interactive selected face and coplanar edge.
2240 @subsubsection occt_draw_4_4_11 vline
2244 vline name [PointName] [PointName]
2245 vline name [Xa Ya Za Xb Yb Zb]
2248 Creates a line from coordinates, named or interactively selected vertices.
2257 vline line2 0 0 0 50 0 1
2260 @subsubsection occt_draw_4_4_12 vcircle
2264 vcircle name [PointName PointName PointName IsFilled]
2265 vcircle name [PlaneName PointName Radius IsFilled]
2268 Creates a circle from named or interactively selected entities. Parameter IsFilled is defined as 0 or 1.
2277 vcircle circle1 p1 p2 p3 1
2280 @subsubsection occt_draw_4_4_13 vtri2d
2287 Creates a plane with a 2D trihedron from an interactively selected face.
2289 @subsubsection occt_draw_4_4_14 vselmode
2293 vselmode [object] mode_number is_turned_on=(1|0)
2296 Sets the selection mode for an object. If the object value is not defined, the selection mode is set for all displayed objects.
2297 *Mode_number* is a non-negative integer encoding different interactive object classes.
2298 For shapes the following *mode_number* values are allowed:
2309 * 1 if mode is to be switched on
2310 * 0 if mode is to be switched off
2318 vtriangle triangle1 p1 p2 p3
2321 @subsubsection occt_draw_4_4_15 vconnect
2325 vconnect vconnect name Xo Yo Zo object1 object2 ... [color=NAME]
2328 Creates *AIS_ConnectedInteractive* object from the input object and location and displays it.
2335 vsegment segment p1 p2
2336 restore CrankArm.brep obj
2338 vconnect new obj 100100100 1 0 0 0 0 1
2341 @subsubsection occt_draw_4_4_16 vtriangle
2345 vtriangle name PointName PointName PointName
2348 Creates and displays a filled triangle from named points.
2356 vtriangle triangle1 p1 p2 p3
2359 @subsubsection occt_draw_4_4_17 vsegment
2363 vsegment name PointName PointName
2366 Creates and displays a segment from named points.
2373 vsegment segment p1 p2
2376 @subsubsection occt_draw_4_4_18 vpointcloud
2380 vpointcloud name shape [-randColor] [-normals] [-noNormals]
2383 Creates an interactive object for an arbitrary set of points from the triangulated shape.
2385 * *randColor* -- generates a random color per point;
2386 * *normals* -- generates a normal per point (default);
2387 * *noNormals* -- does not generate a normal per point.
2390 vpointcloud name x y z r npts {surface|volume} [-randColor] [-normals] [-noNormals]
2392 Creates an arbitrary set of points (npts) randomly distributed on a spheric surface or within a spheric volume (x y z r).
2394 * *randColor* -- generates a random color per point;
2395 * *normals* -- generates a normal per point (default);
2396 * *noNormals* -- does not generate a normal per point.
2401 vpointcloud pc 0 0 0 100 100000 surface -randColor
2405 @subsubsection occt_draw_4_4_19 vclipplane
2409 vclipplane maxplanes <view_name> -- gets plane limit for the view.
2410 vclipplane create <plane_name> -- creates a new plane.
2411 vclipplane delete <plane_name> -- deletes a plane.
2412 vclipplane clone <source_plane> <plane_name> -- clones the plane definition.
2413 vclipplane set/unset <plane_name> object <object list> -- sets/unsets the plane for an IO.
2414 vclipplane set/unset <plane_name> view <view list> -- sets/unsets plane for a view.
2415 vclipplane change <plane_name> on/off -- turns clipping on/off.
2416 vclipplane change <plane_name> equation <a> <b> <c> <d> -- changes plane equation.
2417 vclipplane change <plane_name> capping on/off -- turns capping on/off.
2418 vclipplane change <plane_name> capping color <r> <g> <b> -- sets color.
2419 vclipplane change <plane name> capping texname <texture> -- sets texture.
2420 vclipplane change <plane_name> capping texscale <sx> <sy> -- sets texture scale.
2421 vclipplane change <plane_name> capping texorigin <tx> <ty> -- sets texture origin.
2422 vclipplane change <plane_name> capping texrotate <angle> -- sets texture rotation.
2423 vclipplane change <plane_name> capping hatch on/off/<id> -- sets hatching mask.
2426 Manages clipping planes
2431 vclipplane create pln1
2432 vclipplane change pln1 equation 1 0 0 -0.1
2433 vclipplane set pln1 view Driver1/Viewer1/View1
2442 @subsubsection occt_draw_4_4_20 vdimension
2446 vdimension name {-angle|-length|-radius|-diameter} -shapes shape1 [shape2 [shape3]]
2447 [-text 3d|2d wf|sh|wireframe|shading IntegerSize]
2448 [-label left|right|hcenter|hfit top|bottom|vcenter|vfit]
2449 [-arrow external|internal|fit] [{-arrowlength|-arlen} RealArrowLength]
2450 [{-arrowangle|-arangle} ArrowAngle(degrees)] [-plane xoy|yoz|zox]
2451 [-flyout FloatValue -extension FloatValue]
2452 [-autovalue] [-value CustomRealValue] [-textvalue CustomTextValue]
2453 [-dispunits DisplayUnitsString]
2454 [-modelunits ModelUnitsString] [-showunits | -hideunits]
2457 Builds angle, length, radius or diameter dimension interactive object **name**.
2459 **Attension:** length dimension can't be built without working plane.
2466 vdimension dim1 -length -plane xoy -shapes p1 p2
2469 vdimension dim2 -angle -shapes p1 p2 p3
2471 vcircle circle p1 p2 p3 0
2472 vdimension dim3 -radius -shapes circle
2476 @subsubsection occt_draw_4_4_21 vdimparam
2480 vdimparam name [-text 3d|2d wf|sh|wireframe|shading IntegerSize]
2481 [-label left|right|hcenter|hfit top|bottom|vcenter|vfit]
2482 [-arrow external|internal|fit]
2483 [{-arrowlength|-arlen} RealArrowLength]
2484 [{-arrowangle|-arangle} ArrowAngle(degrees)]
2485 [-plane xoy|yoz|zox]
2486 [-flyout FloatValue -extension FloatValue]
2488 [-value CustomRealValue]
2489 [-textvalue CustomTextValue]
2490 [-dispunits DisplayUnitsString]
2491 [-modelunits ModelUnitsString]
2492 [-showunits | -hideunits]
2495 Sets parameters for angle, length, radius and diameter dimension **name**.
2502 vdimension dim1 -length -plane xoy -shapes p1 p2
2503 vdimparam dim1 -flyout -15 -arrowlength 4 -showunits -value 10
2505 vdimparam dim1 -textvalue "w_1"
2506 vdimparam dim1 -autovalue
2509 @subsubsection occt_draw_4_4_22 vangleparam
2513 vangleparam name [-type interior|exterior]
2514 [-showarrow first|second|both|none]
2517 Sets parameters for angle dimension **name**.
2525 vdimension dim1 -angle -plane xoy -shapes p1 p2 p3
2527 vangleparam dim1 -type exterior -showarrow first
2530 @subsubsection occt_draw_4_4_23 vlengthparam
2534 vlengthparam name [-type interior|exterior]
2535 [-showarrow first|second|both|none]
2538 Sets parameters for length dimension **name**.
2545 vdimension dim1 -length -plane xoy -shapes p1 p2
2549 vlengthparam dim1 -direction ox
2552 @subsubsection occt_draw_4_4_24 vmovedim
2556 vmovedim [name] [x y z]
2559 Moves picked or named (if **name** parameter is defined) dimension
2560 to picked mouse position or input point with coordinates **x**,**y**,**z**.
2561 Text label of dimension **name** is moved to position, another parts of dimension
2569 vdimension dim1 -length -plane xoy -shapes p1 p2
2570 vmovedim dim1 -10 30 0
2574 @subsection occt_draw_4_5 AIS viewer -- Mesh Visualization Service
2576 **MeshVS** (Mesh Visualization Service) component provides flexible means of displaying meshes with associated pre- and post- processor data.
2578 @subsubsection occt_draw_4_5_1 meshfromstl
2582 meshfromstl meshname file
2585 Creates a *MeshVS_Mesh* object based on STL file data. The object will be displayed immediately.
2589 meshfromstl mesh myfile.stl
2592 @subsubsection occt_draw_4_5_2 meshdispmode
2596 meshdispmode meshname displaymode
2599 Changes the display mode of object **meshname**. The **displaymode** is integer, which can be:
2600 * *1* for *wireframe*,
2601 * *2* for *shading* mode, or
2602 * *3* for *shrink* mode.
2607 meshfromstl mesh myfile.stl
2611 @subsubsection occt_draw_4_5_3 meshselmode
2615 meshselmode meshname selectionmode
2618 Changes the selection mode of object **meshname**. The *selectionmode* is integer OR-combination of mode flags. The basic flags are the following:
2619 * *1* -- node selection;
2620 * *2* -- 0D elements (not supported in STL);
2621 * *4* -- links (not supported in STL);
2627 meshfromstl mesh myfile.stl
2631 @subsubsection occt_draw_4_5_4 meshshadcolor
2635 meshshadcolor meshname red green blue
2638 Changes the face interior color of object **meshname**. The *red*, *green* and *blue* are real values between *0* and *1*.
2643 meshfromstl mesh myfile.stl
2644 meshshadcolormode mesh 0.5 0.5 0.5
2647 @subsubsection occt_draw_4_5_5 meshlinkcolor
2651 meshlinkcolor meshname red green blue
2654 Changes the color of face borders for object **meshname**. The *red*, *green* and *blue* are real values between *0* and *1*.
2659 meshfromstl mesh myfile.stl
2660 meshlinkcolormode mesh 0.5 0.5 0.5
2663 @subsubsection occt_draw_4_5_6 meshmat
2667 meshmat meshname material
2670 Changes the material of object **meshname**.
2672 *material* is represented with an integer value as follows (equivalent to enumeration *Graphic3d_NameOfMaterial*):
2683 * *10 -- SHINY_PLASTIC,*
2685 * *12 -- METALIZED,*
2688 * *15 -- ALUMINIUM,*
2693 * *20 -- UserDefined*
2698 meshfromstl mesh myfile.stl
2702 @subsubsection occt_draw_4_5_7 meshshrcoef
2706 meshshrcoef meshname shrinkcoefficient
2709 Changes the value of shrink coefficient used in the shrink mode. In the shrink mode the face is shown as a congruent part of a usual face, so that *shrinkcoefficient* controls the value of this part. The *shrinkcoefficient* is a positive real number.
2714 meshfromstl mesh myfile.stl
2715 meshshrcoef mesh 0.05
2718 @subsubsection occt_draw_4_5_8 meshshow
2725 Displays **meshname** in the viewer (if it is erased).
2730 meshfromstl mesh myfile.stl
2734 @subsubsection occt_draw_4_5_9 meshhide
2741 Hides **meshname** in the viewer.
2746 meshfromstl mesh myfile.stl
2750 @subsubsection occt_draw_4_5_10 meshhidesel
2754 meshhidesel meshname
2757 Hides only selected entities. The other part of **meshname** remains visible.
2759 @subsubsection occt_draw_4_5_11 meshshowsel
2763 meshshowsel meshname
2766 Shows only selected entities. The other part of **meshname** becomes invisible.
2768 @subsubsection occt_draw_4_5_12 meshshowall
2772 meshshowall meshname
2775 Changes the state of all entities to visible for **meshname**.
2777 @subsubsection occt_draw_4_5_13 meshdelete
2784 Deletes MeshVS_Mesh object **meshname**.
2789 meshfromstl mesh myfile.stl
2793 @subsection occt_draw_4_6 VIS Viewer commands
2795 A specific plugin with alias *VIS* should be loaded to have access to VIS functionality in DRAW Test Harness:
2801 @subsubsection occt_draw_4_6_1 ivtkinit
2808 Creates a window for VTK viewer.
2810 @figure{/user_guides/draw_test_harness/images/draw_image001.png,"",225}
2812 @subsubsection occt_draw_4_6_2 ivtkdisplay
2816 ivtkdisplay name1 [name2] …[name n]
2819 Displays named objects.
2829 @figure{/user_guides/draw_test_harness/images/draw_image002.png,"",261}
2832 @subsubsection occt_draw_4_6_3 ivtkerase
2836 ivtkerase [name1] [name2] … [name n]
2839 Erases named objects. If no arguments are passed, erases all displayed objects.
2852 # erase only the cylinder
2854 # erase the sphere and the cone
2858 @subsubsection occt_draw_4_6_4 ivtkfit
2865 Automatic zoom/panning.
2867 @subsubsection occt_draw_4_6_5 ivtkdispmode
2871 ivtksetdispmode [name] {0|1}
2874 Sets display mode for a named object. If no arguments are passed, sets the given display mode for all displayed objects
2875 The possible modes are: 0 (WireFrame) and 1 (Shading).
2884 # set shading mode for the cone
2888 @figure{/user_guides/draw_test_harness/images/draw_image003.png,"",262}
2890 @subsubsection occt_draw_4_6_6 ivtksetselmode
2894 ivtksetselmode [name] mode {0|1}
2897 Sets selection mode for a named object. If no arguments are passed, sets the given selection mode for all the displayed objects.
2902 # load a shape from file
2903 restore CrankArm.brep a
2904 # display the loaded shape
2906 # set the face selection mode
2907 ivtksetselmode a 4 1
2910 @figure{/user_guides/draw_test_harness/images/draw_image004.png,"",291}
2912 @subsubsection occt_draw_4_6_7 ivtkmoveto
2919 Imitates mouse cursor moving to point with the given display coordinates **x**,**y**.
2929 @subsubsection occt_draw_4_6_8 ivtkselect
2936 Imitates mouse cursor moving to point with the given display coordinates and performs selection at this point.
2946 @subsubsection occt_draw_4_6_9 ivtkdump
2950 ivtkdump *filename* [buffer={rgb|rgba|depth}] [width height] [stereoproj={L|R}]
2953 Dumps the contents of VTK viewer to image. It supports:
2954 * dumping in different raster graphics formats: PNG, BMP, JPEG, TIFF or PNM.
2955 * dumping of different buffers: RGB, RGBA or depth buffer.
2956 * defining of image sizes (width and height in pixels).
2957 * dumping of stereo projections (left or right).
2964 ivtkdump D:/ConeSnapshot.png rgb 768 768
2967 @subsubsection occt_draw_4_6_10 ivtkbgcolor
2972 ivtkbgcolor r g b [r2 g2 b2]
2975 Sets uniform background color or gradient background if second triple of parameters is set. Color parameters r,g,b have to be chosen in the interval [0..255].
2980 ivtkbgcolor 200 220 250
2983 @figure{/user_guides/draw_test_harness/images/draw_image005.png,"",196}
2986 ivtkbgcolor 10 30 80 255 255 255
2989 @figure{/user_guides/draw_test_harness/images/draw_image006.png,"",190}
2991 @section occt_draw_5 OCAF commands
2993 This chapter contains a set of commands for Open CASCADE Technology Application Framework (OCAF).
2996 @subsection occt_draw_5_1 Application commands
2999 @subsubsection occt_draw_5_1_1 NewDocument
3003 NewDocument docname [format]
3006 Creates a new **docname** document with MDTV-Standard or described format.
3010 # Create new document with default (MDTV-Standard) format
3013 # Create new document with BinOcaf format
3014 NewDocument D2 BinOcaf
3017 @subsubsection occt_draw_5_1_2 IsInSession
3024 Returns *0*, if **path** document is managed by the application session, *1* -- otherwise.
3028 IsInSession /myPath/myFile.std
3031 @subsubsection occt_draw_5_1_3 ListDocuments
3038 Makes a list of documents handled during the session of the application.
3041 @subsubsection occt_draw_5_1_4 Open
3045 Open path docname [-stream]
3048 Retrieves the document of file **docname** in the path **path**. Overwrites the document, if it is already in session.
3050 option <i>-stream</i> activates usage of alternative interface of OCAF persistence working with C++ streams instead of file names.
3054 Open /myPath/myFile.std D
3057 @subsubsection occt_draw_5_1_5 Close
3064 Closes **docname** document. The document is no longer handled by the applicative session.
3071 @subsubsection occt_draw_5_1_6 Save
3078 Saves **docname** active document.
3085 @subsubsection occt_draw_5_1_7 SaveAs
3089 SaveAs docname path [-stream]
3092 Saves the active document in the file **docname** in the path **path**. Overwrites the file if it already exists.
3094 option <i>-stream</i> activates usage of alternative interface of OCAF persistence working with C++ streams instead of file names.
3098 SaveAs D /myPath/myFile.std
3101 @subsection occt_draw_5_2 Basic commands
3103 @subsubsection occt_draw_5_2_1 Label
3111 Creates the label expressed by <i>\<entry\></i> if it does not exist.
3118 @subsubsection occt_draw_5_2_2 NewChild
3123 NewChild docname [taggerlabel = Root label]
3125 Finds (or creates) a *TagSource* attribute located at father label of <i>\<taggerlabel\></i> and makes a new child label.
3129 # Create new child of root label
3132 # Create new child of existing label
3137 @subsubsection occt_draw_5_2_3 Children
3141 Children docname label
3143 Returns the list of attributes of label.
3150 @subsubsection occt_draw_5_2_4 ForgetAll
3154 ForgetAll docname label
3156 Forgets all attributes of the label.
3164 @subsubsection occt_draw_5_3 Application commands
3166 @subsubsection occt_draw_5_3_1 Main
3173 Returns the main label of the framework.
3180 @subsubsection occt_draw_5_3_2 UndoLimit
3184 UndoLimit docname [value=0]
3188 Sets the limit on the number of Undo Delta stored. **0** will disable Undo on the document. A negative *value* means that there is no limit. Note that by default Undo is disabled. Enabling it will take effect with the next call to *NewCommand*. Of course, this limit is the same for Redo
3195 @subsubsection occt_draw_5_3_3 Undo
3199 Undo docname [value=1]
3202 Undoes **value** steps.
3209 @subsubsection occt_draw_5_3_4 Redo
3213 Redo docname [value=1]
3216 Redoes **value** steps.
3223 @subsubsection occt_draw_5_3_5 OpenCommand
3230 Opens a new command transaction.
3237 @subsubsection occt_draw_5_3_6 CommitCommand
3241 CommitCommand docname
3244 Commits the Command transaction.
3251 @subsubsection occt_draw_5_3_7 NewCommand
3258 This is a shortcut for Commit and Open transaction.
3265 @subsubsection occt_draw_5_3_8 AbortCommand
3269 AbortCommand docname
3272 Aborts the Command transaction.
3279 @subsubsection occt_draw_5_3_9 Copy
3283 Copy docname entry Xdocname Xentry
3286 Copies the contents of *entry* to *Xentry*. No links are registered.
3293 @subsubsection occt_draw_5_3_10 UpdateLink
3297 UpdateLink docname [entry]
3300 Updates external reference set at *entry*.
3307 @subsubsection occt_draw_5_3_11 CopyWithLink
3311 CopyWithLink docname entry Xdocname Xentry
3314 Aborts the Command transaction.
3315 Copies the content of *entry* to *Xentry*. The link is registered with an *Xlink* attribute at *Xentry* label.
3319 CopyWithLink D1 0:2 D2 0:4
3322 @subsubsection occt_draw_5_3_12 UpdateXLinks
3326 UpdateXLinks docname entry
3329 Sets modifications on labels impacted by external references to the *entry*. The *document* becomes invalid and must be recomputed
3336 @subsubsection occt_draw_5_3_13 DumpDocument
3340 DumpDocument docname
3343 Displays parameters of *docname* document.
3351 @subsection occt_draw_5_4 Data Framework commands
3354 @subsubsection occt_draw_5_4_1 MakeDF
3361 Creates a new data framework.
3368 @subsubsection occt_draw_5_4_2 ClearDF
3375 Clears a data framework.
3382 @subsubsection occt_draw_5_4_3 CopyDF
3386 CopyDF dfname1 entry1 [dfname2] entry2
3389 Copies a data framework.
3396 @subsubsection occt_draw_5_4_4 CopyLabel
3400 CopyLabel dfname fromlabel tolablel
3407 CopyLabel D1 0:2 0:4
3410 @subsubsection occt_draw_5_4_5 MiniDumpDF
3417 Makes a mini-dump of a data framework.
3424 @subsubsection occt_draw_5_4_6 XDumpDF
3431 Makes an extended dump of a data framework.
3438 @subsection occt_draw_5_5 General attributes commands
3441 @subsubsection occt_draw_5_5_1 SetInteger
3445 SetInteger dfname entry value
3448 Finds or creates an Integer attribute at *entry* label and sets *value*.
3452 SetInteger D 0:2 100
3455 @subsubsection occt_draw_5_5_2 GetInteger
3459 GetInteger dfname entry [drawname]
3462 Gets a value of an Integer attribute at *entry* label and sets it to *drawname* variable, if it is defined.
3466 GetInteger D 0:2 Int1
3469 @subsubsection occt_draw_5_5_3 SetReal
3473 SetReal dfname entry value
3476 Finds or creates a Real attribute at *entry* label and sets *value*.
3483 @subsubsection occt_draw_5_5_4 GetReal
3487 GetReal dfname entry [drawname]
3490 Gets a value of a Real attribute at *entry* label and sets it to *drawname* variable, if it is defined.
3497 @subsubsection occt_draw_5_5_5 SetIntArray
3501 SetIntArray dfname entry lower upper value1 value2 …
3504 Finds or creates an IntegerArray attribute at *entry* label with lower and upper bounds and sets **value1*, *value2*...
3508 SetIntArray D 0:2 1 4 100 200 300 400
3511 @subsubsection occt_draw_5_5_6 GetIntArray
3515 GetIntArray dfname entry
3518 Gets a value of an *IntegerArray* attribute at *entry* label.
3525 @subsubsection occt_draw_5_5_7 SetRealArray
3529 SetRealArray dfname entry lower upper value1 value2 …
3532 Finds or creates a RealArray attribute at *entry* label with lower and upper bounds and sets *value1*, *value2*…
3536 GetRealArray D 0:2 1 4 100. 200. 300. 400.
3539 @subsubsection occt_draw_5_5_8 GetRealArray
3543 GetRealArray dfname entry
3546 Gets a value of a RealArray attribute at *entry* label.
3553 @subsubsection occt_draw_5_5_9 SetComment
3557 SetComment dfname entry value
3560 Finds or creates a Comment attribute at *entry* label and sets *value*.
3564 SetComment D 0:2 "My comment"
3567 @subsubsection occt_draw_5_5_10 GetComment
3571 GetComment dfname entry
3574 Gets a value of a Comment attribute at *entry* label.
3581 @subsubsection occt_draw_5_5_11 SetExtStringArray
3585 SetExtStringArray dfname entry lower upper value1 value2 …
3588 Finds or creates an *ExtStringArray* attribute at *entry* label with lower and upper bounds and sets *value1*, *value2*…
3592 SetExtStringArray D 0:2 1 3 *string1* *string2* *string3*
3595 @subsubsection occt_draw_5_5_12 GetExtStringArray
3599 GetExtStringArray dfname entry
3602 Gets a value of an ExtStringArray attribute at *entry* label.
3606 GetExtStringArray D 0:2
3609 @subsubsection occt_draw_5_5_13 SetName
3613 SetName dfname entry value
3616 Finds or creates a Name attribute at *entry* label and sets *value*.
3620 SetName D 0:2 *My name*
3623 @subsubsection occt_draw_5_5_14 GetName
3627 GetName dfname entry
3630 Gets a value of a Name attribute at *entry* label.
3637 @subsubsection occt_draw_5_5_15 SetReference
3641 SetReference dfname entry reference
3644 Creates a Reference attribute at *entry* label and sets *reference*.
3648 SetReference D 0:2 0:4
3651 @subsubsection occt_draw_5_5_16 GetReference
3655 GetReference dfname entry
3658 Gets a value of a Reference attribute at *entry* label.
3665 @subsubsection occt_draw_5_5_17 SetUAttribute
3669 SetUAttribute dfname entry localGUID
3672 Creates a UAttribute attribute at *entry* label with *localGUID*.
3676 set localGUID "c73bd076-22ee-11d2-acde-080009dc4422"
3677 SetUAttribute D 0:2 ${localGUID}
3680 @subsubsection occt_draw_5_5_18 GetUAttribute
3684 GetUAttribute dfname entry loacalGUID
3687 Finds a *UAttribute* at *entry* label with *localGUID*.
3691 set localGUID "c73bd076-22ee-11d2-acde-080009dc4422"
3692 GetUAttribute D 0:2 ${localGUID}
3695 @subsubsection occt_draw_5_5_19 SetFunction
3699 SetFunction dfname entry ID failure
3702 Finds or creates a *Function* attribute at *entry* label with driver ID and *failure* index.
3706 set ID "c73bd076-22ee-11d2-acde-080009dc4422"
3707 SetFunction D 0:2 ${ID} 1
3710 @subsubsection occt_draw_5_5_20 GetFunction
3714 GetFunction dfname entry ID failure
3717 Finds a Function attribute at *entry* label and sets driver ID to *ID* variable and failure index to *failure* variable.
3721 GetFunction D 0:2 ID failure
3724 @subsubsection occt_draw_5_5_21 NewShape
3728 NewShape dfname entry [shape]
3731 Finds or creates a Shape attribute at *entry* label. Creates or updates the associated *NamedShape* attribute by *shape* if *shape* is defined.
3739 @subsubsection occt_draw_5_5_22 SetShape
3743 SetShape dfname entry shape
3746 Creates or updates a *NamedShape* attribute at *entry* label by *shape*.
3754 @subsubsection occt_draw_5_5_23 GetShape
3758 GetShape2 dfname entry shape
3761 Sets a shape from NamedShape attribute associated with *entry* label to *shape* draw variable.
3768 @subsection occt_draw_5_6 Geometric attributes commands
3771 @subsubsection occt_draw_5_6_1 SetPoint
3775 SetPoint dfname entry point
3778 Finds or creates a Point attribute at *entry* label and sets *point* as generated in the associated *NamedShape* attribute.
3786 @subsubsection occt_draw_5_6_2 GetPoint
3790 GetPoint dfname entry [drawname]
3793 Gets a vertex from *NamedShape* attribute at *entry* label and sets it to *drawname* variable, if it is defined.
3800 @subsubsection occt_draw_5_6_3 SetAxis
3804 SetAxis dfname entry axis
3807 Finds or creates an Axis attribute at *entry* label and sets *axis* as generated in the associated *NamedShape* attribute.
3811 line l 10 20 30 100 200 300
3815 @subsubsection occt_draw_5_6_4 GetAxis
3819 GetAxis dfname entry [drawname]
3822 Gets a line from *NamedShape* attribute at *entry* label and sets it to *drawname* variable, if it is defined.
3829 @subsubsection occt_draw_5_6_5 SetPlane
3833 SetPlane dfname entry plane
3836 Finds or creates a Plane attribute at *entry* label and sets *plane* as generated in the associated *NamedShape* attribute.
3840 plane pl 10 20 30 -1 0 0
3844 @subsubsection occt_draw_5_6_6 GetPlane
3848 GetPlane dfname entry [drawname]
3851 Gets a plane from *NamedShape* attribute at *entry* label and sets it to *drawname* variable, if it is defined.
3858 @subsubsection occt_draw_5_6_7 SetGeometry
3862 SetGeometry dfname entry [type] [shape]
3865 Creates a Geometry attribute at *entry* label and sets *type* and *shape* as generated in the associated *NamedShape* attribute if they are defined. *type* must be one of the following: *any, pnt, lin, cir, ell, spl, pln, cyl*.
3870 SetGeometry D 0:2 pnt p
3873 @subsubsection occt_draw_5_6_8 GetGeometryType
3877 GetGeometryType dfname entry
3880 Gets a geometry type from Geometry attribute at *entry* label.
3884 GetGeometryType D 0:2
3887 @subsubsection occt_draw_5_6_9 SetConstraint
3891 SetConstraint dfname entry keyword geometrie [geometrie …]
3892 SetConstraint dfname entry "plane" geometrie
3893 SetConstraint dfname entry "value" value
3896 1. Creates a Constraint attribute at *entry* label and sets *keyword* constraint between geometry(ies).
3897 *keyword* must be one of the following:
3898 *rad, dia, minr, majr, tan, par, perp, concentric, equal, dist, angle, eqrad, symm, midp, eqdist, fix, rigid,* or *from, axis, mate, alignf, aligna, axesa, facesa, round, offset*
3899 2. Sets plane for the existing constraint.
3900 3. Sets value for the existing constraint.
3904 SetConstraint D 0:2 "value" 5
3907 @subsubsection occt_draw_5_6_10 GetConstraint
3911 GetConstraint dfname entry
3914 Dumps a Constraint attribute at *entry* label
3921 @subsubsection occt_draw_5_6_11 SetVariable
3925 SetVariable dfname entry isconstant(0/1) units
3928 Creates a Variable attribute at *entry* label and sets *isconstant* flag and *units* as a string.
3932 SetVariable D 0:2 1 "mm"
3935 @subsubsection occt_draw_5_6_12 GetVariable
3939 GetVariable dfname entry isconstant units
3942 Gets an *isconstant* flag and units of a Variable attribute at *entry* label.
3946 GetVariable D 0:2 isconstant units
3947 puts "IsConstant=${isconstant}"
3948 puts "Units=${units}"
3951 @subsection occt_draw_5_7 Tree attributes commands
3954 @subsubsection occt_draw_5_7_1 RootNode
3958 RootNode dfname treenodeentry [ID]
3961 Returns the ultimate father of *TreeNode* attribute identified by its *treenodeentry* and its *ID* (or default ID, if *ID* is not defined).
3964 @subsubsection occt_draw_5_7_2 SetNode
3968 SetNode dfname treenodeentry [ID]
3971 Creates a *TreeNode* attribute on the *treenodeentry* label with its tree *ID* (or assigns a default ID, if the *ID* is not defined).
3974 @subsubsection occt_draw_5_7_3 AppendNode
3978 AppendNode dfname fatherentry childentry [fatherID]
3982 Inserts a *TreeNode* attribute with its tree *fatherID* (or default ID, if *fatherID* is not defined) on *childentry* as last child of *fatherentry*.
3987 @subsubsection occt_draw_5_7_4 PrependNode
3991 PrependNode dfname fatherentry childentry [fatherID]
3995 Inserts a *TreeNode* attribute with its tree *fatherID* (or default ID, if *fatherID* is not defined) on *childentry* as first child of *fatherentry*.
3998 @subsubsection occt_draw_5_7_5 InsertNodeBefore
4002 InsertNodeBefore dfname treenodeentry beforetreenode [ID]
4005 Inserts a *TreeNode* attribute with tree *ID* (or default ID, if *ID* is not defined) *beforetreenode* before *treenodeentry*.
4008 @subsubsection occt_draw_5_7_6 InsertNodeAfter
4012 InsertNodeAfter dfname treenodeentry aftertreenode [ID]
4015 Inserts a *TreeNode* attribute with tree *ID* (or default ID, if *ID* is not defined) *aftertreenode* after *treenodeentry*.
4018 @subsubsection occt_draw_5_7_7 DetachNode
4022 DetachNode dfname treenodeentry [ID]
4025 Removes a *TreeNode* attribute with tree *ID* (or default ID, if *ID* is not defined) from *treenodeentry*.
4028 @subsubsection occt_draw_5_7_8 ChildNodeIterate
4032 ChildNodeIterate dfname treenodeentry alllevels(0/1) [ID]
4036 Iterates on the tree of *TreeNode* attributes with tree *ID* (or default ID, if *ID* is not defined). If *alllevels* is set to *1* it explores not only the first, but all the sub Step levels.
4052 AppendNode D 0:2 0:4
4053 AppendNode D 0:2 0:5
4054 PrependNode D 0:4 0:3
4055 PrependNode D 0:4 0:8
4056 PrependNode D 0:4 0:9
4058 InsertNodeBefore D 0:5 0:6
4059 InsertNodeAfter D 0:4 0:7
4065 ChildNodeIterate D 0:2 1
4075 # List only first levels
4076 ChildNodeIterate D 0:2 1
4084 @subsubsection occt_draw_5_7_9 InitChildNodeIterator
4088 InitChildNodeIterator dfname treenodeentry alllevels(0/1) [ID]
4092 Initializes the iteration on the tree of *TreeNode* attributes with tree *ID* (or default ID, if *ID* is not defined). If *alllevels* is set to *1* it explores not only the first, but also all sub Step levels.
4096 InitChildNodeIterate D 0:5 1
4098 for {set i 1} {$i < 100} {incr i} {
4099 if {[ChildNodeMore] == *TRUE*} {
4100 puts *Tree node = [ChildNodeValue]*
4105 puts "aChildNumber=$aChildNumber"
4108 @subsubsection occt_draw_5_7_10 ChildNodeMore
4115 Returns TRUE if there is a current item in the iteration.
4118 @subsubsection occt_draw_5_7_11 ChildNodeNext
4125 Moves to the next Item.
4128 @subsubsection occt_draw_5_7_12 ChildNodeValue
4135 Returns the current treenode of *ChildNodeIterator*.
4138 @subsubsection occt_draw_5_7_13 ChildNodeNextBrother
4142 ChildNodeNextBrother
4145 Moves to the next *Brother*. If there is none, goes up. This method is interesting only with *allLevels* behavior.
4148 @subsection occt_draw_5_8 Standard presentation commands
4151 @subsubsection occt_draw_5_8_1 AISInitViewer
4155 AISInitViewer docname
4158 Creates and sets *AISViewer* attribute at root label, creates AIS viewer window.
4165 @subsubsection occt_draw_5_8_2 AISRepaint
4172 Updates the AIS viewer window.
4179 @subsubsection occt_draw_5_8_3 AISDisplay
4183 AISDisplay docname entry [not_update]
4186 Displays a presantation of *AISobject* from *entry* label in AIS viewer. If *not_update* is not defined then *AISobject* is recomputed and all visualization settings are applied.
4193 @subsubsection occt_draw_5_8_4 AISUpdate
4197 AISUpdate docname entry
4200 Recomputes a presentation of *AISobject* from *entry* label and applies the visualization setting in AIS viewer.
4207 @subsubsection occt_draw_5_8_5 AISErase
4211 AISErase docname entry
4214 Erases *AISobject* of *entry* label in AIS viewer.
4221 @subsubsection occt_draw_5_8_6 AISRemove
4225 AISRemove docname entry
4228 Erases *AISobject* of *entry* label in AIS viewer, then *AISobject* is removed from *AIS_InteractiveContext*.
4235 @subsubsection occt_draw_5_8_7 AISSet
4239 AISSet docname entry ID
4242 Creates *AISPresentation* attribute at *entry* label and sets as driver ID. ID must be one of the following: *A* (*axis*), *C* (*constraint*), *NS* (*namedshape*), *G* (*geometry*), *PL* (*plane*), *PT* (*point*).
4249 @subsubsection occt_draw_5_8_8 AISDriver
4253 AISDriver docname entry [ID]
4256 Returns DriverGUID stored in *AISPresentation* attribute of an *entry* label or sets a new one. ID must be one of the following: *A* (*axis*), *C* (*constraint*), *NS* (*namedshape*), *G* (*geometry*), *PL* (*plane*), *PT* (*point*).
4264 @subsubsection occt_draw_5_8_9 AISUnset
4268 AISUnset docname entry
4271 Deletes *AISPresentation* attribute (if it exists) of an *entry* label.
4278 @subsubsection occt_draw_5_8_10 AISTransparency
4282 AISTransparency docname entry [transparency]
4285 Sets (if *transparency* is defined) or gets the value of transparency for *AISPresentation* attribute of an *entry* label.
4289 AISTransparency D 0:5 0.5
4292 @subsubsection occt_draw_5_8_11 AISHasOwnTransparency
4296 AISHasOwnTransparency docname entry
4299 Tests *AISPresentation* attribute of an *entry* label by own transparency.
4303 AISHasOwnTransparency D 0:5
4306 @subsubsection occt_draw_5_8_12 AISMaterial
4310 AISMaterial docname entry [material]
4313 Sets (if *material* is defined) or gets the value of transparency for *AISPresentation* attribute of an *entry* label. *material* is integer from 0 to 20 (see @ref occt_draw_4_5_6 "meshmat" command).
4320 @subsubsection occt_draw_5_8_13 AISHasOwnMaterial
4324 AISHasOwnMaterial docname entry
4327 Tests *AISPresentation* attribute of an *entry* label by own material.
4331 AISHasOwnMaterial D 0:5
4334 @subsubsection occt_draw_5_8_14 AISColor
4338 AISColor docname entry [color]
4341 Sets (if *color* is defined) or gets value of color for *AISPresentation* attribute of an *entry* label. *color* is integer from 0 to 516 (see color names in *vsetcolor*).
4348 @subsubsection occt_draw_5_8_15 AISHasOwnColor
4352 AISHasOwnColor docname entry
4355 Tests *AISPresentation* attribute of an *entry* label by own color.
4359 AISHasOwnColor D 0:5
4362 @section occt_draw_6 Geometry commands
4364 @subsection occt_draw_6_1 Overview
4366 Draw provides a set of commands to test geometry libraries. These commands are found in the TGEOMETRY executable, or in any Draw executable which includes *GeometryTest* commands.
4368 In the context of Geometry, Draw includes the following types of variable:
4371 * The 2d curve, which corresponds to *Curve* in *Geom2d*.
4372 * The 3d curve and surface, which correspond to *Curve* and *Surface* in <a href="user_guides__modeling_data.html#occt_modat_1">Geom package</a>.
4374 Draw geometric variables never share data; the *copy* command will always make a complete copy of the content of the variable.
4376 The following topics are covered in the nine sections of this chapter:
4378 * **Curve creation** deals with the various types of curves and how to create them.
4379 * **Surface creation** deals with the different types of surfaces and how to create them.
4380 * **Curve and surface modification** deals with the commands used to modify the definition of curves and surfaces, most of which concern modifications to bezier and bspline curves.
4381 * **Geometric transformations** covers translation, rotation, mirror image and point scaling transformations.
4382 * **Curve and Surface Analysis** deals with the commands used to compute points, derivatives and curvatures.
4383 * **Intersections** presents intersections of surfaces and curves.
4384 * **Approximations** deals with creating curves and surfaces from a set of points.
4385 * **Constraints** concerns construction of 2d circles and lines by constraints such as tangency.
4386 * **Display** describes commands to control the display of curves and surfaces.
4388 Where possible, the commands have been made broad in application, i.e. they apply to 2d curves, 3d curves and surfaces. For instance, the *circle* command may create a 2d or a 3d circle depending on the number of arguments given.
4390 Likewise, the *translate* command will process points, curves or surfaces, depending on argument type. You may not always find the specific command you are looking for in the section where you expect it to be. In that case, look in another section. The *trim* command, for example, is described in the surface section. It can, nonetheless, be used with curves as well.
4392 @subsection occt_draw_6_2 Curve creation
4394 This section deals with both points and curves. Types of curves are:
4396 * Analytical curves such as lines, circles, ellipses, parabolas, and hyperbolas.
4397 * Polar curves such as bezier curves and bspline curves.
4398 * Trimmed curves and offset curves made from other curves with the *trim* and *offset* commands. Because they are used on both curves and surfaces, the *trim* and *offset* commands are described in the *surface creation* section.
4399 * NURBS can be created from other curves using *convert* in the *Surface Creation* section.
4400 * Curves can be created from the isoparametric lines of surfaces by the *uiso* and *viso* commands.
4401 * 3d curves can be created from 2d curves and vice versa using the *to3d* and *to2d* commands. The *project* command computes a 2d curve on a 3d surface.
4403 Curves are displayed with an arrow showing the last parameter.
4406 @subsubsection occt_draw_6_2_1 point
4413 Creates a 2d or 3d point, depending on the number of arguments.
4424 @subsubsection occt_draw_6_2_2 line
4428 line name x y [z] dx dy [dz]
4432 Creates a 2d or 3d line. *x y z* are the coordinates of the line’s point of origin; *dx, dy, dz* give the direction vector.
4434 A 2d line will be represented as *x y dx dy*, and a 3d line as *x y z dx dy dz* . A line is parameterized along its length starting from the point of origin along the direction vector. The direction vector is normalized and must not be null. Lines are infinite, even though their representation is not.
4438 # a 2d line at 45 degrees of the X axis
4441 # a 3d line through the point 10 0 0 and parallel to Z
4445 @subsubsection occt_draw_6_2_3 circle
4449 circle name x y [z [dx dy dz]] [ux uy [uz]] radius
4452 Creates a 2d or a 3d circle.
4454 In 2d, *x, y* are the coordinates of the center and *ux, uy* define the vector towards the point of origin of the parameters. By default, this direction is (1,0). The X Axis of the local coordinate system defines the origin of the parameters of the circle. Use another vector than the x axis to change the origin of parameters.
4456 In 3d, *x, y, z* are the coordinates of the center; *dx, dy, dz* give the vector normal to the plane of the circle. By default, this vector is (0,0,1) i.e. the Z axis (it must not be null). *ux, uy, uz* is the direction of the origin; if not given, a default direction will be computed. This vector must neither be null nor parallel to *dx, dy, dz*.
4458 The circle is parameterized by the angle in [0,2*pi] starting from the origin and. Note that the specification of origin direction and plane is the same for all analytical curves and surfaces.
4462 # A 2d circle of radius 5 centered at 10,-2
4465 # another 2d circle with a user defined origin
4466 # the point of parameter 0 on this circle will be
4467 # 1+sqrt(2),1+sqrt(2)
4470 # a 3d circle, center 10 20 -5, axis Z, radius 17
4471 circle c3 10 20 -5 17
4473 # same 3d circle with axis Y
4474 circle c4 10 20 -5 0 1 0 17
4476 # full 3d circle, axis X, origin on Z
4477 circle c5 10 20 -5 1 0 0 0 0 1 17
4480 @subsubsection occt_draw_6_2_4 ellipse
4484 ellipse name x y [z [dx dy dz]] [ux uy [uz]] firstradius secondradius
4487 Creates a 2d or 3d ellipse. In a 2d ellipse, the first two arguments define the center; in a 3d ellipse, the first three. The axis system is given by *firstradius*, the major radius, and *secondradius*, the minor radius. The parameter range of the ellipse is [0,2.*pi] starting from the X axis and going towards the Y axis. The Draw ellipse is parameterized by an angle:
4490 P(u) = O + firstradius*cos(u)*Xdir + secondradius*sin(u)*Ydir
4494 * P is the point of parameter *u*,
4495 * *O, Xdir* and *Ydir* are respectively the origin, *X Direction* and *Y Direction* of its local coordinate system.
4499 # default 2d ellipse
4500 ellipse e1 10 5 20 10
4502 # 2d ellipse at angle 60 degree
4503 ellipse e2 0 0 1 2 30 5
4505 # 3d ellipse, in the XY plane
4506 ellipse e3 0 0 0 25 5
4508 # 3d ellipse in the X,Z plane with axis 1, 0 ,1
4509 ellipse e4 0 0 0 0 1 0 1 0 1 25 5
4512 @subsubsection occt_draw_6_2_5 hyperbola
4516 hyperbola name x y [z [dx dy dz]] [ux uy [uz]] firstradius secondradius
4519 Creates a 2d or 3d conic. The first arguments define the center. The axis system is given by *firstradius*, the major radius, and *secondradius*, the minor radius. Note that the hyperbola has only one branch, that in the X direction.
4521 The Draw hyperbola is parameterized as follows:
4523 P(U) = O + firstradius*Cosh(U)*XDir + secondradius*Sinh(U)*YDir
4527 * *P* is the point of parameter *U*,
4528 * *O, XDir* and *YDir* are respectively the origin, *X Direction* and *YDirection* of its local coordinate system.
4532 # default 2d hyperbola, with asymptotes 1,1 -1,1
4533 hyperbola h1 0 0 30 30
4535 # 2d hyperbola at angle 60 degrees
4536 hyperbola h2 0 0 1 2 20 20
4538 # 3d hyperbola, in the XY plane
4539 hyperbola h3 0 0 0 50 50
4542 @subsubsection occt_draw_6_2_6 parabola
4546 parabola name x y [z [dx dy dz]] [ux uy [uz]] FocalLength
4549 Creates a 2d or 3d parabola. in the axis system defined by the first arguments. The origin is the apex of the parabola.
4551 The *Geom_Parabola* is parameterized as follows:
4554 P(u) = O + u*u/(4.*F)*XDir + u*YDir
4558 * *P* is the point of parameter *u*,
4559 * *O, XDir* and *YDir* are respectively the origin, *X Direction* and *Y Direction* of its local coordinate system,
4560 * *F* is the focal length of the parabola.
4567 # 2d parabola with convexity +Y
4568 parabola p2 0 0 0 1 50
4570 # 3d parabola in the Y-Z plane, convexity +Z
4571 parabola p3 0 0 0 1 0 0 0 0 1 50
4574 @subsubsection occt_draw_6_2_7 beziercurve, 2dbeziercurve
4578 beziercurve name nbpole pole, [weight]
4579 2dbeziercurve name nbpole pole, [weight]
4582 Creates a 3d rational or non-rational Bezier curve. Give the number of poles (control points,) and the coordinates of the poles *(x1 y1 z1 [w1] x2 y2 z2 [w2])*. The degree will be *nbpoles-1*. To create a rational curve, give weights with the poles. You must give weights for all poles or for none. If the weights of all the poles are equal, the curve is polynomial, and therefore non-rational.
4586 # a rational 2d bezier curve (arc of circle)
4587 2dbeziercurve ci 3 0 0 1 10 0 sqrt(2.)/2. 10 10 1
4589 # a 3d bezier curve, not rational
4590 beziercurve cc 4 0 0 0 10 0 0 10 0 10 10 10 10
4593 @subsubsection occt_draw_6_2_8 bsplinecurve, 2dbsplinecurve, pbsplinecurve, 2dpbsplinecurve
4597 bsplinecurve name degree nbknots knot, umult pole, weight
4598 2dbsplinecurve name degree nbknots knot, umult pole, weight
4600 pbsplinecurve name degree nbknots knot, umult pole, weight (periodic)
4601 2dpbsplinecurve name degree nbknots knot, umult pole, weight (periodic)
4604 Creates 2d or 3d bspline curves; the **pbsplinecurve** and **2dpbsplinecurve** commands create periodic bspline curves.
4606 A bspline curve is defined by its degree, its periodic or non-periodic nature, a table of knots and a table of poles (i.e. control points). Consequently, specify the degree, the number of knots, and for each knot, the multiplicity, for each pole, the weight. In the syntax above, the commas link the adjacent arguments which they fall between: knot and multiplicities, pole and weight.
4608 The table of knots is an increasing sequence of reals without repetition.
4609 Multiplicities must be lower or equal to the degree of the curve. For non-periodic curves, the first and last multiplicities can be equal to degree+1. For a periodic curve, the first and last multiplicities must be equal.
4611 The poles must be given with their weights, use weights of 1 for a non rational curve, the number of poles must be:
4613 * For a non periodic curve: Sum of multiplicities - degree + 1
4614 * For a periodic curve: Sum of multiplicities - last multiplicity
4618 # a bspline curve with 4 poles and 3 knots
4619 bsplinecurve bc 2 3 0 3 1 1 2 3 \
4620 10 0 7 1 7 0 7 1 3 0 8 1 0 0 7 1
4621 # a 2d periodic circle (parameter from 0 to 2*pi !!)
4623 2dpbsplinecurve c 2 \
4624 4 0 2 pi/1.5 2 pi/0.75 2 2*pi 2 \
4634 **Note** that you can create the **NURBS** subset of bspline curves and surfaces by trimming analytical curves and surfaces and executing the command *convert*.
4637 @subsubsection occt_draw_6_2_9 uiso, viso
4645 Creates a U or V isoparametric curve from a surface.
4649 # create a cylinder and extract iso curves
4656 **Note** that this cannot be done from offset surfaces.
4659 @subsubsection occt_draw_6_2_10 to3d, to2d
4663 to3d name curve2d [plane]
4664 to2d name curve3d [plane]
4667 Create respectively a 3d curve from a 2d curve and a 2d curve from a 3d curve. The transformation uses a planar surface to define the XY plane in 3d (by default this plane is the default OXYplane). **to3d** always gives a correct result, but as **to2d** is not a projection, it may surprise you. It is always correct if the curve is planar and parallel to the plane of projection. The points defining the curve are projected on the plane. A circle, however, will remain a circle and will not be changed to an ellipse.
4671 # the following commands
4673 plane p -2 1 0 1 2 3
4676 # will create the same circle as
4677 circle c -2 1 0 1 2 3 5
4680 See also: **project**
4683 @subsubsection occt_draw_6_2_11 project
4687 project name curve3d surface
4690 Computes a 2d curve in the parametric space of a surface corresponding to a 3d curve. This can only be used on analytical surfaces.
4692 If we, for example, intersect a cylinder and a plane and project the resulting ellipse on the cylinder, this will create a 2d sinusoid-like bspline.
4701 @subsection occt_draw_6_3 Surface creation
4703 The following types of surfaces exist:
4704 * Analytical surfaces: plane, cylinder, cone, sphere, torus;
4705 * Polar surfaces: bezier surfaces, bspline surfaces;
4706 * Trimmed and Offset surfaces;
4707 * Surfaces produced by Revolution and Extrusion, created from curves with the *revsurf* and *extsurf*;
4710 Surfaces are displayed with isoparametric lines. To show the parameterization, a small parametric line with a length 1/10 of V is displayed at 1/10 of U.
4712 @subsubsection occt_draw_6_3_1 plane
4716 plane name [x y z [dx dy dz [ux uy uz]]]
4719 Creates an infinite plane.
4721 A plane is the same as a 3d coordinate system, *x,y,z* is the origin, *dx, dy, dz* is the Z direction and *ux, uy, uz* is the X direction.
4723 The plane is perpendicular to Z and X is the U parameter. *dx,dy,dz* and *ux,uy,uz* must not be null or collinear. *ux,uy,uz* will be modified to be orthogonal to *dx,dy,dz*.
4725 There are default values for the coordinate system. If no arguments are given, the global system (0,0,0), (0,0,1), (1,0,0). If only the origin is given, the axes are those given by default(0,0,1), (1,0,0). If the origin and the Z axis are given, the X axis is generated perpendicular to the Z axis.
4727 Note that this definition will be used for all analytical surfaces.
4731 # a plane through the point 10,0,0 perpendicular to X
4732 # with U direction on Y
4733 plane p1 10 0 0 1 0 0 0 1 0
4735 # an horixontal plane with origin 10, -20, -5
4739 @subsubsection occt_draw_6_3_2 cylinder
4743 cylinder name [x y z [dx dy dz [ux uy uz]]] radius
4746 A cylinder is defined by a coordinate system, and a radius. The surface generated is an infinite cylinder with the Z axis as the axis. The U parameter is the angle starting from X going in the Y direction.
4750 # a cylinder on the default Z axis, radius 10
4753 # a cylinder, also along the Z axis but with origin 5,
4755 cylinder c2 5 10 -3 10
4757 # a cylinder through the origin and on a diagonal
4758 # with longitude pi/3 and latitude pi/4 (euler angles)
4759 dset lo pi/3. la pi/4.
4760 cylinder c3 0 0 0 cos(la)*cos(lo) cos(la)*sin(lo)
4764 @subsubsection occt_draw_6_3_3 cone
4768 cone name [x y z [dx dy dz [ux uy uz]]] semi-angle radius
4770 Creates a cone in the infinite coordinate system along the Z-axis. The radius is that of the circle at the intersection of the cone and the XY plane. The semi-angle is the angle formed by the cone relative to the axis; it should be between -90 and 90. If the radius is 0, the vertex is the origin.
4774 # a cone at 45 degrees at the origin on Z
4777 # a cone on axis Z with radius r1 at z1 and r2 at z2
4778 cone c2 0 0 z1 180.*atan2(r2-r1,z2-z1)/pi r1
4781 @subsubsection occt_draw_6_3_4 sphere
4785 sphere name [x y z [dx dy dz [ux uy uz]]] radius
4788 Creates a sphere in the local coordinate system defined in the **plane** command. The sphere is centered at the origin.
4790 To parameterize the sphere, *u* is the angle from X to Y, between 0 and 2*pi. *v* is the angle in the half-circle at angle *u* in the plane containing the Z axis. *v* is between -pi/2 and pi/2. The poles are the points Z = +/- radius; their parameters are u,+/-pi/2 for any u in 0,2*pi.
4794 # a sphere at the origin
4796 # a sphere at 10 10 10, with poles on the axis 1,1,1
4797 sphere s2 10 10 10 1 1 1 10
4800 @subsubsection occt_draw_6_3_5 torus
4804 torus name [x y z [dx dy dz [ux uy uz]]] major minor
4807 Creates a torus in the local coordinate system with the given major and minor radii. *Z* is the axis for the major radius. The major radius may be lower in value than the minor radius.
4809 To parameterize a torus, *u* is the angle from X to Y; *v* is the angle in the plane at angle *u* from the XY plane to Z. *u* and *v* are in 0,2*pi.
4813 # a torus at the origin
4816 # a torus in another coordinate system
4817 torus t2 10 5 -2 2 1 0 20 5
4821 @subsubsection occt_draw_6_3_6 beziersurf
4825 beziersurf name nbupoles nbvolpes pole, [weight]
4828 Use this command to create a bezier surface, rational or non-rational. First give the numbers of poles in the u and v directions.
4830 Then give the poles in the following order: *pole(1, 1), pole(nbupoles, 1), pole(1, nbvpoles)* and *pole(nbupoles, nbvpoles)*.
4832 Weights may be omitted, but if you give one weight you must give all of them.
4836 # a non-rational degree 2,3 surface
4838 0 0 0 10 0 5 20 0 0 \
4839 0 10 2 10 10 3 20 10 2 \
4840 0 20 10 10 20 20 20 20 10 \
4841 0 30 0 10 30 0 20 30 0
4844 @subsubsection occt_draw_6_3_7 bsplinesurf, upbsplinesurf, vpbsplinesurf, uvpbsplinesurf
4848 bsplinesurf name udegree nbuknots uknot umult ... nbvknot vknot
4849 vmult ... x y z w ...
4855 * **bsplinesurf** generates bspline surfaces;
4856 * **upbsplinesurf** creates a bspline surface periodic in u;
4857 * **vpbsplinesurf** creates one periodic in v;
4858 * **uvpbsplinesurf** creates one periodic in uv.
4860 The syntax is similar to the *bsplinecurve* command. First give the degree in u and the knots in u with their multiplicities, then do the same in v. The poles follow. The number of poles is the product of the number in u and the number in v.
4862 See *bsplinecurve* to compute the number of poles, the poles are first given in U as in the *beziersurf* command. You must give weights if the surface is rational.
4866 # create a bspline surface of degree 1 2
4867 # with two knots in U and three in V
4872 0 10 2 1 10 10 3 1 \
4873 0 20 10 1 10 20 20 1 \
4878 @subsubsection occt_draw_6_3_8 trim, trimu, trimv
4882 trim newname name [u1 u2 [v1 v2]]
4887 The **trim** commands create trimmed curves or trimmed surfaces. Note that trimmed curves and surfaces are classes of the *Geom* package.
4888 * *trim* creates either a new trimmed curve from a curve or a new trimmed surface in u and v from a surface.
4889 * *trimu* creates a u-trimmed surface,
4890 * *trimv* creates a v-trimmed surface.
4892 After an initial trim, a second execution with no parameters given recreates the basis curve. The curves can be either 2d or 3d. If the trimming parameters decrease and if the curve or surface is not periodic, the direction is reversed.
4894 **Note** that a trimmed curve or surface contains a copy of the basis geometry: modifying that will not modify the trimmed geometry. Trimming trimmed geometry will not create multiple levels of trimming. The basis geometry will be used.
4898 # create a 3d circle
4901 # trim it, use the same variable, the original is
4905 # the original can be recovered!
4911 # the original is not the trimmed curve but the basis
4914 # as the circle is periodic, the two following commands
4919 # trim an infinite cylinder
4924 @subsubsection occt_draw_6_3_9 offset
4928 offset name basename distance [dx dy dz]
4931 Creates offset curves or surfaces at a given distance from a basis curve or surface. Offset curves and surfaces are classes from the *Geom *package.
4933 The curve can be a 2d or a 3d curve. To compute the offsets for a 3d curve, you must also give a vector *dx,dy,dz*. For a planar curve, this vector is usually the normal to the plane containing the curve.
4935 The offset curve or surface copies the basic geometry, which can be modified later.
4939 # graphic demonstration that the outline of a torus
4940 # is the offset of an ellipse
4943 torus t 0 0 0 0 cos(angle) sin(angle) 50 20
4945 ellipse e 0 0 0 50 50*sin(angle)
4946 # note that the distance can be negative
4947 offset l1 e 20 0 0 1
4950 @subsubsection occt_draw_6_3_10 revsurf
4954 revsurf name curvename x y z dx dy dz
4957 Creates a surface of revolution from a 3d curve.
4959 A surface of revolution or revolved surface is obtained by rotating a curve (called the *meridian*) through a complete revolution about an axis (referred to as the *axis of revolution*). The curve and the axis must be in the same plane (the *reference plane* of the surface). Give the point of origin x,y,z and the vector dx,dy,dz to define the axis of revolution.
4961 To parameterize a surface of revolution: u is the angle of rotation around the axis. Its origin is given by the position of the meridian on the surface. v is the parameter of the meridian.
4965 # another way of creating a torus like surface
4967 revsurf s c 0 0 0 0 1 0
4970 @subsubsection occt_draw_6_3_11 extsurf
4974 extsurf newname curvename dx dy dz
4977 Creates a surface of linear extrusion from a 3d curve. The basis curve is swept in a given direction,the *direction of extrusion* defined by a vector.
4979 In the syntax, *dx,dy,dz* gives the direction of extrusion.
4981 To parameterize a surface of extrusion: *u* is the parameter along the extruded curve; the *v* parameter is along the direction of extrusion.
4985 # an elliptic cylinder
4986 ellipse e 0 0 0 10 5
4992 @subsubsection occt_draw_6_3_12 convert
4996 convert newname name
4999 Creates a 2d or 3d NURBS curve or a NURBS surface from any 2d curve, 3d curve or surface. In other words, conics, beziers and bsplines are turned into NURBS. Offsets are not processed.
5003 # turn a 2d arc of a circle into a 2d NURBS
5008 # an easy way to make a planar bspline surface
5014 **Note** that offset curves and surfaces are not processed by this command.
5016 @subsection occt_draw_6_4 Curve and surface modifications
5018 Draw provides commands to modify curves and surfaces, some of them are general, others restricted to bezier curves or bsplines.
5020 General modifications:
5022 * Reversing the parametrization: **reverse**, **ureverse**, **vreverse**
5024 Modifications for both bezier curves and bsplines:
5026 * Exchanging U and V on a surface: **exchuv**
5027 * Segmentation: **segment**, **segsur**
5028 * Increasing the degree: **incdeg**, **incudeg**, **incvdeg**
5029 * Moving poles: **cmovep**, **movep**, **movecolp**, **moverowp**
5031 Modifications for bezier curves:
5033 * Adding and removing poles: **insertpole**, **rempole**, **remcolpole**, **remrowpole**
5035 Modifications for bspline:
5037 * Inserting and removing knots: **insertknot**, **remknot**, **insertuknot**, **remuknot**, **insetvknot**, **remvknot**
5038 * Modifying periodic curves and surfaces: **setperiodic**, **setnotperiodic**, **setorigin**, **setuperiodic**, **setunotperiodic**, **setuorigin**, **setvperiodic**, **setvnotperiodic**, **setvorigin**
5042 @subsubsection occt_draw_6_4_1 reverse, ureverse, vreverse
5048 ureverse surfacename
5049 vreverse surfacename
5052 The **reverse** command reverses the parameterization and inverses the orientation of a 2d or 3d curve. Note that the geometry is modified. To keep the curve or the surface, you must copy it before modification.
5054 **ureverse** or **vreverse** reverse the u or v parameter of a surface. Note that the new parameters of the curve may change according to the type of curve. For instance, they will change sign on a line or stay 0,1 on a bezier.
5056 Reversing a parameter on an analytical surface may create an indirect coordinate system.
5060 # reverse a trimmed 2d circle
5065 # dumping c will show that it is now trimmed between
5066 # 3*pi/2 and 7*pi/4 i.e. 2*pi-pi/2 and 2*pi-pi/4
5069 @subsubsection occt_draw_6_4_2 exchuv
5076 For a bezier or bspline surface this command exchanges the u and v parameters.
5080 # exchanging u and v on a spline (made from a cylinder)
5087 @subsubsection occt_draw_6_4_3 segment, segsur
5091 segment curve Ufirst Ulast
5092 segsur surface Ufirst Ulast Vfirst Vlast
5095 **segment** and **segsur** segment a bezier curve and a bspline curve or surface respectively.
5097 These commands modify the curve to restrict it between the new parameters: *Ufirst*, the starting point of the modified curve, and *Ulast*, the end point. *Ufirst* is less than *Ulast*.
5099 This command must not be confused with **trim** which creates a new geometry.
5103 # segment a bezier curve in half
5104 beziercurve c 3 0 0 0 10 0 0 10 10 0
5105 segment c ufirst ulast
5108 @subsubsection occt_draw_6_4_4 iincudeg, incvdeg
5112 incudeg surfacename newdegree
5113 incvdeg surfacename newdegree
5116 **incudeg** and **incvdeg** increase the degree in the U or V parameter of a bezier or bspline surface.
5120 # make a planar bspline and increase the degree to 2 3
5128 **Note** that the geometry is modified.
5131 @subsubsection occt_draw_6_4_5 cmovep, movep, movecolp, moverowp
5135 cmovep curve index dx dy [dz]
5136 movep surface uindex vindex dx dy dz
5137 movecolp surface uindex dx dy dz
5138 moverowp surface vindex dx dy dz
5141 **move** methods translate poles of a bezier curve, a bspline curve or a bspline surface.
5142 * **cmovep** and **movep** translate one pole with a given index.
5143 * **movecolp** and **moverowp** translate a whole column (expressed by the *uindex*) or row (expressed by the *vindex*) of poles.
5147 # start with a plane
5148 # transform to bspline, raise degree and add relief
5150 trim p p -10 10 -10 10
5159 @subsubsection occt_draw_6_4_6 insertpole, rempole, remcolpole, remrowpole
5163 insertpole curvename index x y [z] [weight]
5164 rempole curvename index
5165 remcolpole surfacename index
5166 remrowpole surfacename index
5169 **insertpole** inserts a new pole into a 2d or 3d bezier curve. You may add a weight for the pole. The default value for the weight is 1. The pole is added at the position after that of the index pole. Use an index 0 to insert the new pole before the first one already existing in your drawing.
5171 **rempole** removes a pole from a 2d or 3d bezier curve. Leave at least two poles in the curves.
5173 **remcolpole** and **remrowpole** remove a column or a row of poles from a bezier surface. A column is in the v direction and a row in the u direction The resulting degree must be at least 1; i.e there will be two rows and two columns left.
5177 # start with a segment, insert a pole at end
5178 # then remove the central pole
5179 beziercurve c 2 0 0 0 10 0 0
5180 insertpole c 2 10 10 0
5184 @subsubsection occt_draw_6_4_7 insertknot, insertuknot, insertvknot
5188 insertknot name knot [mult = 1] [knot mult ...]
5189 insertuknot surfacename knot mult
5190 insertvknot surfacename knot mult
5193 **insertknot** inserts knots in the knot sequence of a bspline curve. You must give a knot value and a target multiplicity. The default multiplicity is 1. If there is already a knot with the given value and a multiplicity lower than the target one, its multiplicity will be raised.
5195 **insertuknot** and **insertvknot** insert knots in a surface.
5199 # create a cylindrical surface and insert a knot
5201 trim c c 0 pi/2 0 10
5203 insertuknot c1 pi/4 1
5206 @subsubsection occt_draw_6_4_8 remknot, remuknot, remvknot
5210 remknot index [mult] [tol]
5211 remuknot index [mult] [tol]
5212 remvknot index [mult] [tol]
5215 **remknot** removes a knot from the knot sequence of a curve or a surface. Give the index of the knot and optionally, the target multiplicity. If the target multiplicity is not 0, the multiplicity of the knot will be lowered. As the curve may be modified, you are allowed to set a tolerance to control the process. If the tolerance is low, the knot will only be removed if the curve will not be modified.
5217 By default, if no tolerance is given, the knot will always be removed.
5221 # bspline circle, remove a knot
5228 **Note** that Curves or Surfaces may be modified.
5231 @subsubsection occt_draw_6_4_9 setperiodic, setnotperiodic, setuperiodic, setunotperiodic, setvperiodic, setvnotperiodic
5236 setnotperiodic curve
5237 setuperiodic surface
5238 setunotperiodic surface
5239 setvperiodic surface
5240 setvnotperiodic surface
5243 **setperiodic** turns a bspline curve into a periodic bspline curve; the knot vector stays the same and excess poles are truncated. The curve may be modified if it has not been closed. **setnotperiodic** removes the periodicity of a periodic curve. The pole table mau be modified. Note that knots are added at the beginning and the end of the knot vector and the multiplicities are knots set to degree+1 at the start and the end.
5245 **setuperiodic** and **setvperiodic** make the u or the v parameter of bspline surfaces periodic; **setunotperiodic**, and **setvnotperiodic** remove periodicity from the u or the v parameter of bspline surfaces.
5249 # a circle deperiodicized
5255 @subsubsection occt_draw_6_4_10 setorigin, setuorigin, setvorigin
5259 setorigin curvename index
5260 setuorigin surfacename index
5261 setuorigin surfacename index
5264 These commands change the origin of the parameters on periodic curves or surfaces. The new origin must be an existing knot. To set an origin other than an existing knot, you must first insert one with the *insertknot* command.
5268 # a torus with new U and V origins
5276 @subsection occt_draw_6_5 Transformations
5278 Draw provides commands to apply linear transformations to geometric objects: they include translation, rotation, mirroring and scaling.
5280 @subsubsection occt_draw_6_5_1 translate, dtranslate
5284 translate name [names ...] dx dy dz
5285 2dtranslate name [names ...] dx dy
5288 The **Translate** command translates 3d points, curves and surfaces along a vector *dx,dy,dz*. You can translate more than one object with the same command.
5290 For 2d points or curves, use the **2dtranslate** command.
5297 torus t 10 20 30 5 2
5298 translate p c t 0 0 15
5302 *Objects are modified by this command.*
5304 @subsubsection occt_draw_6_5_2 rotate, 2drotate
5308 rotate name [name ...] x y z dx dy dz angle
5309 2drotate name [name ...] x y angle
5312 The **rotate** command rotates a 3d point curve or surface. You must give an axis of rotation with a point *x,y,z*, a vector *dx,dy,dz* and an angle in degrees.
5314 For a 2d rotation, you need only give the center point and the angle. In 2d or 3d, the angle can be negative.
5318 # make a helix of circles. create a script file with
5319 this code and execute it using **source**.
5321 for {set i 1} {$i <= 10} {incr i} {
5322 copy c[expr $i-1] c$i
5324 rotate c$i 0 0 0 0 0 1 36
5328 @subsubsection occt_draw_6_5_3 pmirror, lmirror, smirror, dpmirror, dlmirror
5332 pmirror name [names ...] x y z
5333 lmirror name [names ...] x y z dx dy dz
5334 smirror name [names ...] x y z dx dy dz
5335 2dpmirror name [names ...] x y
5336 2dlmirror name [names ...] x y dx dy
5339 The mirror commands perform a mirror transformation of 2d or 3d geometry.
5341 * **pmirror** is the point mirror, mirroring 3d curves and surfaces about a point of symmetry.
5342 * **lmirror** is the line mirror commamd, mirroring 3d curves and surfaces about an axis of symmetry.
5343 * **smirror** is the surface mirror, mirroring 3d curves and surfaces about a plane of symmetry. In the last case, the plane of symmetry is perpendicular to dx,dy,dz.
5344 * **2dpmirror** is the point mirror in 2D.
5345 * **2dlmirror** is the axis symmetry mirror in 2D.
5349 # build 3 images of a torus
5350 torus t 10 10 10 1 2 3 5 1
5354 lmirror t2 0 0 0 1 0 0
5356 smirror t3 0 0 0 1 0 0
5359 @subsubsection occt_draw_6_5_4 pscale, dpscale
5363 pscale name [name ...] x y z s
5364 2dpscale name [name ...] x y s
5367 The **pscale** and **2dpscale** commands transform an object by point scaling. You must give the center and the scaling factor. Because other scalings modify the type of the object, they are not provided. For example, a sphere may be transformed into an ellipsoid. Using a scaling factor of -1 is similar to using **pmirror**.
5372 # double the size of a sphere
5377 @subsection occt_draw_6_6 Curve and surface analysis
5379 **Draw** provides methods to compute information about curves and surfaces:
5381 * **coord** to find the coordinates of a point.
5382 * **cvalue** and **2dcvalue** to compute points and derivatives on curves.
5383 * **svalue** to compute points and derivatives on a surface.
5384 * **localprop** and **minmaxcurandif** to compute the curvature on a curve.
5385 * **parameters** to compute (u,v) values for a point on a surface.
5386 * **proj** and **2dproj** to project a point on a curve or a surface.
5387 * **surface_radius** to compute the curvature on a surface.
5389 @subsubsection occt_draw_6_6_1 coord
5396 Sets the x, y (and optionally z) coordinates of the point P.
5408 @subsubsection occt_draw_6_6_2 cvalue, 2dcvalue
5412 cvalue curve U x y z [d1x d1y d1z [d2x d2y d2z]]
5413 2dcvalue curve U x y [d1x d1y [d2x d2y]]
5416 For a curve at a given parameter, and depending on the number of arguments, **cvalue** computes the coordinates in *x,y,z*, the first derivative in *d1x,d1y,d1z* and the second derivative in *d2x,d2y,d2z*.
5420 Let on a bezier curve at parameter 0 the point is the first pole; the first derivative is the vector to the second pole multiplied by the degree; the second derivative is the difference first to the second pole, second to the third pole multipied by *degree-1* :
5423 2dbeziercurve c 4 0 0 1 1 2 1 3 0
5424 2dcvalue c 0 x y d1x d1y d2x d2y
5426 # values of x y d1x d1y d2x d2y
5430 @subsubsection occt_draw_6_6_3 svalue
5434 svalue surfname U v x y z [dux duy duz dvx dvy dvz [d2ux d2uy d2uz d2vx d2vy d2vz d2uvx d2uvy d2uvz]]
5437 Computes points and derivatives on a surface for a pair of parameter values. The result depends on the number of arguments. You can compute the first and the second derivatives.
5441 # display points on a sphere
5443 for {dset t 0} {[dval t] <= 1} {dset t t+0.01} {
5444 svalue s t*2*pi t*pi-pi/2 x y z
5449 @subsubsection occt_draw_6_6_4 localprop, minmaxcurandinf
5453 localprop curvename U
5454 minmaxcurandinf curve
5457 **localprop** computes the curvature of a curve.
5458 **minmaxcurandinf** computes and prints the parameters of the points where the curvature is minimum and maximum on a 2d curve.
5462 # show curvature at the center of a bezier curve
5463 beziercurve c 3 0 0 0 10 2 0 20 0 0
5468 @subsubsection occt_draw_6_6_5 parameters
5472 parameters surf/curve x y z U [V]
5475 Returns the parameters on the surface of the 3d point *x,y,z* in variables *u* and *v*. This command may only be used on analytical surfaces: plane, cylinder, cone, sphere and torus.
5479 # Compute parameters on a plane
5480 plane p 0 0 10 1 1 0
5481 parameters p 5 5 5 u v
5482 # the values of u and v are : 0 5
5485 @subsubsection occt_draw_6_6_6 proj, 2dproj
5493 Use **proj** to project a point on a 3d curve or a surface and **2dproj** for a 2d curve.
5495 The command will compute and display all points in the projection. The lines joining the point to the projections are created with the names *ext_1, ext_2, ... *
5499 Let us project a point on a torus
5504 == ext_1 ext_2 ext_3 ext_4
5507 @subsubsection occt_draw_6_6_7 surface_radius
5511 surface_radius surface u v [c1 c2]
5514 Computes the main curvatures of a surface at parameters *(u,v)*. If there are extra arguments, their curvatures are stored in variables *c1* and *c2*.
5518 Let us compute curvatures of a cylinder:
5522 surface_radius c pi 3 c1 c2
5523 == Min Radius of Curvature : -5
5524 == Min Radius of Curvature : infinite
5528 @subsection occt_draw_6_7 Intersections
5530 * **intersect** computes intersections of surfaces;
5531 * **2dintersect** computes intersections of 2d curves.
5532 * **intconcon** computes intersections of 2d conic curves.
5534 @subsubsection occt_draw_6_7_1 intersect
5538 intersect name surface1 surface2
5541 Intersects two surfaces; if there is one intersection curve it will be named *name*, if there are more than one they will be named *name_1*, *name_2*, ...
5547 plane p 0 0 40 0 1 5
5551 @subsubsection occt_draw_6_7_2 2dintersect
5555 2dintersect curve1 [curve2] [-tol tol] [-state]
5558 Displays the intersection points between 2d curves.
5560 -tol - allows changing the intersection tolerance (default value is 1.e-3);
5561 -state - allows printing the intersection state for each point.
5565 # intersect two 2d ellipses
5567 ellipse e2 0 0 0 1 5 2
5568 2dintersect e1 e2 -tol 1.e-10 -state
5571 @subsubsection occt_draw_6_7_3 intconcon
5575 intconcon curve1 curve2
5578 Displays the intersection points between two 2d curves.
5579 Curves must be only conic sections: 2d lines, circles, ellipses,
5580 hyperbolas, parabolas. The algorithm from *IntAna2d_AnaIntersection* is used.
5584 # intersect two 2d ellipses
5586 ellipse e2 0 0 0 1 5 2
5590 @subsection occt_draw_6_8 Approximations
5592 Draw provides command to create curves and surfaces by approximation.
5594 * **2dapprox** fits a curve through 2d points;
5595 * **appro** fits a curve through 3d points;
5596 * **surfapp** and **grilapp** fit a surface through 3d points;
5597 * **2dinterpolate** interpolates a curve.
5599 @subsubsection occt_draw_6_8_1 appro, dapprox
5603 appro result nbpoint [curve]
5604 2dapprox result nbpoint [curve / x1 y1 x2 y2]
5607 These commands fit a curve through a set of points. First give the number of points, then choose one of the three ways available to get the points. If you have no arguments, click on the points. If you have a curve argument or a list of points, the command launches computation of the points on the curve.
5611 Let us pick points and they will be fitted
5617 @subsubsection occt_draw_6_8_2 surfapp, grilapp
5622 surfapp name nbupoints nbvpoints x y z ....
5623 grilapp name nbupoints nbvpoints xo dx yo dy z11 z12 ...
5626 * **surfapp** fits a surface through an array of u and v points, nbupoints*nbvpoints.
5627 * **grilapp** has the same function, but the x,y coordinates of the points are on a grid starting at x0,y0 with steps dx,dy.
5631 # a surface using the same data as in the beziersurf
5634 0 0 0 10 0 5 20 0 0 \
5635 0 10 2 10 10 3 20 10 2 \
5636 0 20 10 10 20 20 20 20 10 \
5637 0 30 0 10 30 0 20 30 0
5640 @subsection occt_draw_6_9 Projections
5642 Draw provides commands to project points/curves on curves/surfaces.
5644 * **proj** projects point on the curve/surface (see @ref occt_draw_6_6_6 "proj command description");
5645 * **project** projects 3D curve on the surface (see @ref occt_draw_6_2_11 "project command description");
5646 * **projponf** projects point on the face.
5648 @subsubsection occt_draw_6_9_1 projponf
5652 projponf face pnt [extrema flag: -min/-max/-minmax] [extrema algo: -g(grad)/-t(tree)]
5655 **projponf** projects point *pnt* on the face *face*.
5656 You can change the Extrema options:
5657 * To change the Extrema search algorithm use the following options:<br>
5658 -g - for Grad algorithm;<br>
5659 -t - for Tree algorithm;
5660 * To change the Extrema search solutions use the following options:<br>
5661 -min - to look for Min solutions;<br>
5662 -max - to look for Max solutions;<br>
5663 -minmax - to look for MinMax solutions.
5677 @subsection occt_draw_6_10 Constraints
5679 * **cirtang** constructs 2d circles tangent to curves;
5680 * **lintan** constructs 2d lines tangent to curves.
5683 @subsubsection occt_draw_6_10_1 cirtang
5687 cirtang result [-t <Tolerance>] -c <curve> -p <point> -r <Radius>...
5690 Builds all circles satisfying the condition:
5691 1. the circle must be tangent to every given curve;
5692 2. the circle must pass through every given point;
5693 3. the radius of the circle must be equal to the requested one.
5695 Only following set of input data is supported: Curve-Curve-Curve, Curve-Curve-Point, Curve-Curve-Radius, Curve-Point-Point, Curve-Point-Radius, Point-Point-Point, Point-Point-Radius. The solutions will be stored in variables *result_1*, *result_2*, etc.
5699 # a point, a line and a radius. 2 solutions of type Curve-Point-Radius (C-P-R)
5702 cirtang c -p p -c l -r 4
5703 == Solution of type C-P-R is: c_1 c_2
5706 Additionally it is possible to create a circle(s) with given center and tangent to the given curve (Curve-Point type).
5711 2dbsplinecurve cc 1 2 0 2 1 2 -10 -5 1 10 -5 1
5712 cirtang r -p pp -c cc
5713 == Solution of type C-P is: r_1 r_2
5716 @subsubsection occt_draw_6_10_2 lintan
5720 lintan name curve curve [angle]
5723 Builds all 2d lines tangent to two curves. If the third angle argument is given the second curve must be a line and **lintan** will build all lines tangent to the first curve and forming the given angle with the line. The angle is given in degrees. The solutions are named *name_1*, *name_2*, etc.
5727 # lines tangent to 2 circles, 4 solutions
5732 # lines at 15 degrees tangent to a circle and a line, 2
5733 solutions: l1_1 l1_2
5739 @subsection occt_draw_6_11 Display
5741 Draw provides commands to control the display of geometric objects. Some display parameters are used for all objects, others are valid for surfaces only, some for bezier and bspline only, and others for bspline only.
5743 On curves and surfaces, you can control the mode of representation with the **dmode** command. You can control the parameters for the mode with the **defle** command and the **discr** command, which control deflection and discretization respectively.
5745 On surfaces, you can control the number of isoparametric curves displayed on the surface with the **nbiso** command.
5747 On bezier and bspline curve and surface you can toggle the display of the control points with the **clpoles** and **shpoles** commands.
5749 On bspline curves and surfaces you can toggle the display of the knots with the **shknots** and **clknots** commands.
5752 @subsubsection occt_draw_6_11_1 dmod, discr, defle
5756 dmode name [name ...] u/d
5757 discr name [name ...] nbintervals
5758 defle name [name ...] deflection
5761 **dmod** command allows choosing the display mode for a curve or a surface.
5763 In mode *u*, or *uniform deflection*, the points are computed to keep the polygon at a distance lower than the deflection of the geometry. The deflection is set with the *defle* command. This mode involves intensive use of computational power.
5765 In *d*, or discretization mode, a fixed number of points is computed. This number is set with the *discr* command. This is the default mode. On a bspline, the fixed number of points is computed for each span of the curve. (A span is the interval between two knots).
5767 If the curve or the isolines seem to present too many angles, you can either increase the discretization or lower the deflection, depending on the mode. This will increase the number of points.
5771 # increment the number of points on a big circle
5779 @subsubsection occt_draw_6_11_2 nbiso
5783 nbiso name [names...] nuiso nviso
5786 Changes the number of isoparametric curves displayed on a surface in the U and V directions. On a bspline surface, isoparametric curves are displayed by default at knot values. Use *nbiso* to turn this feature off.
5790 Let us display 35 meridians and 15 parallels on a sphere:
5796 @subsubsection occt_draw_6_11_3 clpoles, shpoles
5804 On bezier and bspline curves and surfaces, the control polygon is displayed by default: *clpoles* erases it and *shpoles* restores it.
5808 Let us make a bezier curve and erase the poles
5811 beziercurve c 3 0 0 0 10 0 0 10 10 0
5815 @subsubsection occt_draw_6_11_4 clknots, shknots
5823 By default, knots on a bspline curve or surface are displayed with markers at the points with parametric value equal to the knots. *clknots* removes them and *shknots* restores them.
5827 # hide the knots on a bspline curve
5828 bsplinecurve bc 2 3 0 3 1 1 2 3 \
5829 10 0 7 1 7 0 7 1 3 0 8 1 0 0 7 1
5834 @section occt_draw_7 Topology commands
5836 Draw provides a set of commands to test OCCT Topology libraries. The Draw commands are found in the DRAWEXE executable or in any executable including the BRepTest commands.
5838 Topology defines the relationship between simple geometric entities, which can thus be linked together to represent complex shapes. The type of variable used by Topology in Draw is the shape variable.
5840 The <a href="user_guides__modeling_data.html#occt_modat_5">different topological shapes</a> include:
5842 * **COMPOUND**: A group of any type of topological object.
5843 * **COMPSOLID**: A set of solids connected by their faces. This expands the notions of WIRE and SHELL to solids.
5844 * **SOLID**: A part of space limited by shells. It is three dimensional.
5845 * **SHELL**: A set of faces connected by their edges. A shell can be open or closed.
5846 * **FACE**: In 2d, a plane; in 3d, part of a surface. Its geometry is constrained (trimmed) by contours. It is two dimensional.
5847 * **WIRE**: A set of edges connected by their vertices. It can be open or closed depending on whether the edges are linked or not.
5848 * **EDGE**: A topological element corresponding to a restrained curve. An edge is generally limited by vertices. It has one dimension.
5849 * **VERTEX**: A topological element corresponding to a point. It has a zero dimension.
5851 Shapes are usually shared. **copy** will create a new shape which shares its representation with the original. Nonetheless, two shapes sharing the same topology can be moved independently (see the section on **transformation**).
5853 The following topics are covered in the eight sections of this chapter:
5855 * Basic shape commands to handle the structure of shapes and control the display.
5856 * Curve and surface topology, or methods to create topology from geometry and vice versa.
5857 * Primitive construction commands: box, cylinder, wedge etc.
5858 * Sweeping of shapes.
5859 * Transformations of shapes: translation, copy, etc.
5860 * Topological operations, or booleans.
5861 * Drafting and blending.
5863 * Analysis of shapes.
5866 @subsection occt_draw_7_1 Basic topology
5868 The set of basic commands allows simple operations on shapes, or step-by-step construction of objects. These commands are useful for analysis of shape structure and include:
5870 * **isos** and **discretisation** to control display of shape faces by isoparametric curves .
5871 * **orientation**, **complement** and **invert** to modify topological attributes such as orientation.
5872 * **explode**, **exwire** and **nbshapes** to analyze the structure of a shape.
5873 * **emptycopy**, **add**, **compound** to create shapes by stepwise construction.
5875 In Draw, shapes are displayed using isoparametric curves. There is color coding for the edges:
5877 * a red edge is an isolated edge, which belongs to no faces.
5878 * a green edge is a free boundary edge, which belongs to one face,
5879 * a yellow edge is a shared edge, which belongs to at least two faces.
5882 @subsubsection occt_draw_7_1_1 isos, discretisation
5886 isos [name ...][nbisos]
5887 discretisation nbpoints
5890 Determines or changes the number of isoparametric curves on shapes.
5892 The same number is used for the u and v directions. With no arguments, *isos* prints the current default value. To determine, the number of isos for a shape, give it name as the first argument.
5894 *discretisation* changes the default number of points used to display the curves. The default value is 30.
5898 # Display only the edges (the wireframe)
5902 **Warning**: don’t confuse *isos* and *discretisation* with the geometric commands *nbisos* and *discr*.
5905 @subsubsection occt_draw_7_1_2 orientation, complement, invert, normals, range
5909 orientation name [name ...] F/R/E/I
5910 complement name [name ...]
5912 normals s (length = 10), disp normals
5913 range name value value
5916 * **orientation** -- assigns the orientation of simple and complex shapes to one of the following four values: *FORWARD, REVERSED, INTERNAL, EXTERNAL*.
5917 * **complement** -- changes the current orientation of shapes to its complement: *FORWARD* to *REVERSED* and *INTERNAL* to *EXTERNAL*.
5918 * **invert** -- creates a copy of the original shape with a reversed orientation of all subshapes. For example, it may be useful to reverse the normals of a solid.
5919 * *normals** -- returns the assignment of colors to orientation values.
5920 * **range** -- defines the length of a selected edge by defining the values of a starting point and an end point.
5924 # to invert normals of a box
5930 # to assign a value to an edge
5932 # to define the box as edges
5934 b_1 b_2 b_3 b_4 b_5 b_6 b_7 b_8 b_9 b_10 b_11 b_12
5935 # to define as an edge
5937 # to define the length of the edge as starting from 0
5942 @subsubsection occt_draw_7_1_3 explode, exwire, nbshapes
5946 explode name [C/So/Sh/F/W/E/V]
5951 **explode** extracts subshapes from an entity. The subshapes will be named *name_1*, *name_2*, ... Note that they are not copied but shared with the original.
5953 With name only, **explode** will extract the first sublevel of shapes: the shells of a solid or the edges of a wire, for example. With one argument, **explode** will extract all subshapes of that type: *C* for compounds, *So* for solids, *Sh* for shells, *F* for faces, *W* for wires, *E* for edges, *V* for vertices.
5955 **exwire** is a special case of **explode** for wires, which extracts the edges in an ordered way, if possible. Each edge, for example, is connected to the following one by a vertex.
5957 **nbshapes** counts the number of shapes of each type in an entity.
5964 # whatis returns the type and various information
5966 = b is a shape SOLID FORWARD Free Modified
5971 = b_1 is a shape SHELL FORWARD Modified Orientable
5974 # extract the edges b_1, ... , b_12
5981 Number of shapes in b
5993 @subsubsection occt_draw_7_1_4 emptycopy, add, compound
5997 emptycopy [newname] name
5999 compound [name ...] compoundname
6002 **emptycopy** returns an empty shape with the same orientation, location, and geometry as the target shape, but with no sub-shapes. If the **newname** argument is not given, the new shape is stored with the same name. This command is used to modify a frozen shape. A frozen shape is a shape used by another one. To modify it, you must **emptycopy** it. Its subshape may be reinserted with the **add** command.
6004 **add** inserts shape *C* into shape *S*. Verify that *C* and *S* reference compatible types of objects:
6005 * Any *Shape* can be added to a *Compound*.
6006 * Only a *Solid* can be added to a *CompSolid*.
6007 * Only a *Shell* can *Edge* or a *Vertex* can be added into a *Solid*.
6008 * Only a *Face* can be added to a *Shell*.
6009 * Only a *Wire* and *Vertex* can be added in a *Solid*.
6010 * Only an *Edge* can be added to a *Wire*.
6011 * Only a *Vertex* can be added to an *Edge*.
6012 * Nothing can be added to a *Vertex*.
6014 **emptycopy** and **add** should be used with care.
6016 On the other hand, **compound** is a safe way to achieve a similar result. It creates a compound from shapes. If no shapes are given, the compound is empty.
6020 # a compound with three boxes
6028 @subsubsection occt_draw_7_1_5 compare
6032 compare shape1 shape2
6035 **compare** compares the two shapes *shape1* and *shape2* using the methods *TopoDS_Shape::IsSame()* and *TopoDS_Shape::IsEqual()*.
6051 # shapes are not same
6054 @subsubsection occt_draw_7_1_6 issubshape
6058 issubshape subshape shape
6061 **issubshape** checks if the shape *subshape* is sub-shape of the shape *shape* and gets its index in the shape.
6068 # b_2 is sub-shape of b. Index in the shape: 2.
6072 @subsection occt_draw_7_2 Curve and surface topology
6074 This group of commands is used to create topology from shapes and to extract shapes from geometry.
6076 * To create vertices, use the **vertex** command.
6077 * To create edges use, the **edge**, **mkedge** commands.
6078 * To create wires, use the **wire**, **polyline**, **polyvertex** commands.
6079 * To create faces, use the **mkplane**, **mkface** commands.
6080 * To extract the geometry from edges or faces, use the **mkcurve** and **mkface** commands.
6081 * To extract the 2d curves from edges or faces, use the **pcurve** command.
6084 @subsubsection occt_draw_7_2_1 vertex
6088 vertex name [x y z / p edge]
6091 Creates a vertex at either a 3d location x,y,z or the point at parameter p on an edge.
6098 @subsubsection occt_draw_7_2_1a mkpoint
6105 Creates a point from the coordinates of a given vertex.
6112 @subsubsection occt_draw_7_2_2 edge, mkedge, uisoedge, visoedge
6116 edge name vertex1 vertex2
6117 mkedge edge curve [surface] [pfirst plast] [vfirst [pfirst] vlast [plast]]
6118 uisoedge edge face u v1 v2
6119 visoedge edge face v u1 u2
6122 * **edge** creates a straight line edge between two vertices.
6123 * **mkedge** generates edges from curves<.Two parameters can be given for the vertices: the first and last parameters of the curve are given by default. Vertices can also be given with their parameters, this option allows blocking the creation of new vertices. If the parameters of the vertices are not given, they are computed by projection on the curve. Instead of a 3d curve, a 2d curve and a surface can be given.
6127 # straight line edge
6132 # make a circular edge
6136 # A similar result may be achieved by trimming the curve
6137 # The trimming is removed by mkedge
6142 * **visoedge** and **uisoedge** are commands that generate a *uiso* parameter edge or a *viso* parameter edge.
6146 # to create an edge between v1 and v2 at point u
6147 # to create the example plane
6156 # to create the edge in the plane at the u axis point
6157 0.5, and between the v axis points v=0.2 and v =0.8
6158 uisoedge e p 0.5 0.20 0.8
6161 @subsubsection occt_draw_7_2_3 wire, polyline, polyvertex
6165 wire wirename e1/w1 [e2/w2 ...]
6166 polyline name x1 y1 z1 x2 y2 z2 ...
6167 polyvertex name v1 v2 ...
6170 **wire** creates a wire from edges or wires. The order of the elements should ensure that the wire is connected, and vertex locations will be compared to detect connection. If the vertices are different, new edges will be created to ensure topological connectivity. The original edge may be copied in the new one.
6172 **polyline** creates a polygonal wire from point coordinates. To make a closed wire, you should give the first point again at the end of the argument list.
6174 **polyvertex** creates a polygonal wire from vertices.
6178 # create two polygonal wires
6179 # glue them and define as a single wire
6180 polyline w1 0 0 0 10 0 0 10 10 0
6181 polyline w2 10 10 0 0 10 0 0 0 0
6185 @subsubsection occt_draw_7_2_4 profile
6189 profile name [code values] [code values] ...
6193 **profile** builds a profile in a plane using a moving point and direction. By default, the profile is closed and a face is created. The original point is 0 0, and direction is 1 0 situated in the XY plane.
6196 | **Code** | **Values ** | **Action** |
6197 | :------------ | :------------- | :---------------- |
6198 | O | X Y Z | Sets the origin of the plane |
6199 | P | DX DY DZ UX UY UZ | Sets the normal and X of the plane |
6200 | F | X Y | Sets the first point |
6201 | X | DX | Translates a point along X |
6202 | Y | DY | Translates a point along Y |
6203 | L | DL | Translates a point along direction |
6204 | XX | X | Sets point X coordinate |
6205 | YY | Y | Sets point Y coordinate |
6206 | T | DX DY | Translates a point |
6207 | TT | X Y | Sets a point |
6208 | R | Angle | Rotates direction |
6209 | RR | Angle | Sets direction |
6210 | D | DX DY | Sets direction |
6211 | IX | X | Intersects with vertical |
6212 | IY | Y | Intersects with horizontal |
6213 | C | Radius Angle | Arc of circle tangent to direction |
6216 Codes and values are used to define the next point or change the direction. When the profile changes from a straight line to a curve, a tangent is created. All angles are in degrees and can be negative.
6218 The point [code values] can be repeated any number of times and in any order to create the profile contour.
6222 | No suffix | Makes a closed face |
6223 | W | Make a closed wire |
6224 | WW | Make an open wire |
6226 The profile shape definition is the suffix; no suffix produces a face, *w* is a closed wire, *ww* is an open wire.
6228 Code letters are not case-sensitive.
6232 # to create a trianglular plane using a vertex at the
6233 origin, in the xy plane
6234 profile p O 0 0 0 X 1 Y 0 x 1 y 1
6239 # to create a contour using the different code
6242 # two vertices in the xy plane
6243 profile p F 1 0 x 2 y 1 ww
6245 # to view from a point normal to the plane
6248 # add a circular element of 45 degrees
6249 profile p F 1 0 x 2 y 1 c 1 45 ww
6251 # add a tangential segment with a length value 1
6252 profile p F 1 0 x 2 y 1 c 1 45 l 1 ww
6254 # add a vertex with xy values of 1.5 and 1.5
6255 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 ww
6257 # add a vertex with the x value 0.2, y value is constant
6258 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 ww
6260 # add a vertex with the y value 2 x value is constant
6261 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 yy 2 ww
6263 # add a circular element with a radius value of 1 and a circular value of 290 degrees
6264 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 yy 2 c 1 290
6266 # wire continues at a tangent to the intersection x = 0
6267 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 yy 2 c 1 290 ix 0 ww
6269 # continue the wire at an angle of 90 degrees until it intersects the y axis at y= -o.3
6270 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 yy 2 c 1 290 ix 0 r 90 ix -0.3 ww
6273 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 yy 2 c 1 290 ix 0 r 90 ix -0.3 w
6275 # to create the plane with the same contour
6276 profile p F 1 0 x 2 y 1 c 1 45 l 1 tt 1.5 1.5 xx 0.2 yy 2 c 1 290 ix 0 r 90 ix -0.3
6279 @subsubsection occt_draw_7_2_5 bsplineprof
6283 bsplineprof name [S face] [W WW]
6286 * for an edge : \<digitizes\> ... <mouse button 2>
6287 * to end profile : <mouse button 3>
6289 Builds a profile in the XY plane from digitizes. By default the profile is closed and a face is built.
6291 **bsplineprof** creates a 2d profile from bspline curves using the mouse as the input. *MB1* creates the points, *MB2* finishes the current curve and starts the next curve, *MB3* closes the profile.
6293 The profile shape definition is the suffix; no suffix produces a face, **w** is a closed wire, **ww** is an open wire.
6297 #to view the xy plane
6299 #to create a 2d curve with the mouse
6301 # click mb1 to start the curve
6302 # click mb1 to create the second vertex
6303 # click mb1 to create a curve
6305 #click mb2 to finish the curve and start a new curve
6307 # click mb1 to create the second curve
6308 # click mb3 to create the face
6311 @subsubsection occt_draw_7_2_6 mkoffset
6313 **mkoffset** creates a parallel wire in the same plane using a face or an existing continuous set of wires as a reference. The number of occurrences is not limited.
6314 The offset distance defines the spacing and the positioning of the occurrences.
6318 mkoffset result shape nboffset stepoffset [jointype(a/i) [alt]]
6321 * *result* - the base name for the resulting wires. The index of the occurrence (starting with 1) will be added to this name, so the resulting wires will have the names - *result_1*, *result_2* ...;
6322 * *shape* - input shape (face or compound of wires);
6323 * *nboffset* - the number of the parallel occurrences;
6324 * *stepoffset* - offset distance between occurrences;
6325 * *jointype(a/i)* - join type (a for *arc* (default) and i for *intersection*);
6326 * *alt* - altitude from the plane of the input face in relation to the normal to the face.
6331 # Create a box and select a face
6334 # Create three exterior parallel contours with an offset value of 2
6336 # wires r_1, r_2 and r_3 are created
6338 # Create three exterior parallel contours with an offset value of 2 without round corners
6339 mkoffset r b_1 3 2 i
6340 # wires r_1, r_2 and r_3 are created
6342 # Create one interior parallel contour with an offset value of 0.4
6343 mkoffset r b_1 1 -0.4
6346 **Note** that on a concave input contour for an interior step *mkoffset* command may produce several wires which will be contained in a single compound.
6350 # to create the example contour
6351 profile p F 0 0 x 2 y 4 tt 1 1 tt 0 4 w
6352 # creates an incoherent interior offset
6353 mkoffset r p 1 -0.50
6355 # creates two incoherent wires
6356 mkoffset r p 1 -0.55
6357 # r_1 is a compound of two wires
6360 @subsubsection occt_draw_7_2_7 mkplane, mkface
6365 mkface name surface [ufirst ulast vfirst vlast]
6368 **mkplane** generates a face from a planar wire. The planar surface will be constructed with an orientation which keeps the face inside the wire.
6370 **mkface** generates a face from a surface. Parameter values can be given to trim a rectangular area. The default boundaries are those of the surface.
6374 # make a polygonal face
6375 polyline f 0 0 0 20 0 0 20 10 0 10 10 0 10 20 0 0 20 0 0 0 0
6378 # make a cylindrical face
6380 trim g g -pi/3 pi/2 0 15
6384 @subsubsection occt_draw_7_2_8 mkcurve, mksurface
6392 **mkcurve** creates a 3d curve from an edge. The curve will be trimmed to the edge boundaries.
6394 **mksurface** creates a surface from a face. The surface will not be trimmed.
6404 @subsubsection occt_draw_7_2_9 pcurve
6409 pcurve [name edgename] facename
6412 Extracts the 2d curve of an edge on a face. If only the face is specified, the command extracts all the curves and colors them according to their orientation. This is useful in checking to see if the edges in a face are correctly oriented, i.e. they turn counter-clockwise. To make curves visible, use a fitted 2d view.
6416 # view the pcurves of a face
6425 @subsubsection occt_draw_7_2_10 chfi2d
6429 chfi2d result face [edge1 edge2 (F radius/CDD d1 d2/CDA d ang) ....
6433 Creates chamfers and fillets on 2D objects. Select two adjacent edges and:
6435 * two respective distance values
6436 * a distance value and an angle
6438 The radius value produces a fillet between the two faces.
6440 The distance is the length value from the edge between the two selected faces in a normal direction.
6444 Let us create a 2d fillet:
6448 profile p x 2 y 2 x -2
6449 chfi2d cfr p . . F 0.3
6456 Let us create a 2d chamfer using two distances:
6459 profile p x 2 y 2 x -2
6460 chfi2d cfr p . . CDD 0.3 0.6
6467 Let us create a 2d chamfer using a defined distance and angle
6471 profile p x 2 y 2 x -2
6472 chfi2d cfr p . . CDA 0.3 75
6479 @subsubsection occt_draw_7_2_11 nproject
6483 nproject pj e1 e2 e3 ... surf -g -d [dmax] [Tol
6484 [continuity [maxdeg [maxseg]]]
6487 Creates a shape projection which is normal to the target surface.
6491 # create a curved surface
6500 translate ll 2 -0.5 0
6506 #display in four views
6509 # create the example shape
6510 circle c 1.8 -0.5 1 0 1 0 1 0 0 0.4
6513 # create the normal projection of the shape(circle)
6518 @subsection occt_draw_7_3 Primitives
6520 Primitive commands make it possible to create simple shapes. They include:
6522 * **box** and **wedge** commands.
6523 * **pcylinder**, **pcone**, **psphere**, **ptorus** commands.
6524 * **halfspace** command
6527 @subsubsection occt_draw_7_3_1 box, wedge
6531 box name [x y z] dx dy dz
6532 wedge name dx dy dz ltx / xmin zmin xmax xmax
6535 **box** creates a box parallel to the axes with dimensions *dx,dy,dz*. *x,y,z* is the corner of the box. It is the default origin.
6537 **wedge** creates a box with five faces called a wedge. One face is in the OXZ plane, and has dimensions *dx,dz* while the other face is in the plane *y = dy*. This face either has dimensions *ltx, dz* or is bounded by *xmin,zmin,xmax,zmax*.
6539 The other faces are defined between these faces. The face in the *y=yd* plane may be degenerated into a line if *ltx = 0*, or a point if *xmin = xmax* and *ymin = ymax*. In these cases, the line and the point both have 5 faces each. To position the wedge use the *ttranslate* and *trotate* commands.
6543 # a box at the origin
6547 box b2 30 30 40 10 20 30
6552 # a wedge with a sharp edge (5 faces)
6556 wedge w3 20 20 20 10 10 10 10
6559 @subsubsection occt_draw_7_3_2 pcylinder, pcone, psphere, ptorus
6563 pcylinder name [plane] radius height [angle]
6564 pcone name [plane] radius1 radius2 height [angle]
6565 pcone name [plane] radius1 radius2 height [angle]
6566 psphere name [plane] radius1 [angle1 angle2] [angle]
6567 ptorus name [plane] radius1 radius2 [angle1 angle2] [angle]
6570 All these commands create solid blocks in the default coordinate system, using the Z axis as the axis of revolution and the X axis as the origin of the angles. To use another system, translate and rotate the resulting solid or use a plane as first argument to specify a coordinate system. All primitives have an optional last argument which is an angle expressed in degrees and located on the Z axis, starting from the X axis. The default angle is 360.
6572 **pcylinder** creates a cylindrical block with the given radius and height.
6574 **pcone** creates a truncated cone of the given height with radius1 in the plane z = 0 and radius2 in the plane z = height. Neither radius can be negative, but one of them can be null.
6576 **psphere** creates a solid sphere centered on the origin. If two angles, *angle1* and *angle2*, are given, the solid will be limited by two planes at latitude *angle1* and *angle2*. The angles must be increasing and in the range -90,90.
6578 **ptorus** creates a solid torus with the given radii, centered on the origin, which is a point along the z axis. If two angles increasing in degree in the range 0 -- 360 are given, the solid will be bounded by two planar surfaces at those positions on the circle.
6585 # a quarter of a truncated cone
6586 pcone co 15 10 10 90
6588 # three-quarters of sphere
6595 @subsubsection occt_draw_7_3_3 halfspace
6599 halfspace result face/shell x y z
6602 **halfspace** creates an infinite solid volume based on a face in a defined direction. This volume can be used to perform the boolean operation of cutting a solid by a face or plane.
6608 ==b_1 b_2 b_3 b_4 b_5 b_6
6609 halfspace hr b_3 0.5 0.5 0.5
6613 @subsection occt_draw_7_4 Sweeping
6615 Sweeping creates shapes by sweeping out a shape along a defined path:
6617 * **prism** -- sweeps along a direction.
6618 * **revol** -- sweeps around an axis.
6619 * **pipe** -- sweeps along a wire.
6620 * **mksweep** and **buildsweep** -- to create sweeps by defining the arguments and algorithms.
6621 * **thrusections** -- creates a sweep from wire in different planes.
6624 @subsubsection occt_draw_7_4_1 prism
6628 prism result base dx dy dz [Copy | Inf | SemiInf]
6631 Creates a new shape by sweeping a shape in a direction. Any shape can be swept: a vertex gives an edge; an edge gives a face; and a face gives a solid.
6633 The shape is swept along the vector *dx dy dz*. The original shape will be shared in the result unless *Copy* is specified. If *Inf* is specified the prism is infinite in both directions. If *SemiInf* is specified the prism is infinite in the *dx,dy,dz* direction, and the length of the vector has no importance.
6637 # sweep a planar face to make a solid
6638 polyline f 0 0 0 10 0 0 10 5 0 5 5 0 5 15 0 0 15 0 0 0 0
6642 @subsubsection occt_draw_7_4_2 revol
6646 revol result base x y z dx dy dz angle [Copy]
6649 Creates a new shape by sweeping a base shape through an angle along the axis *x,y,z dx,dy,dz*. As with the prism command, the shape can be of any type and is not shared if *Copy* is specified.
6653 # shell by wire rotation
6654 polyline w 0 0 0 10 0 0 10 5 0 5 5 0 5 15 0 0 15 0
6655 revol s w 20 0 0 0 1 0 90
6659 @subsubsection occt_draw_7_4_3 pipe
6663 pipe name wire_spine Profile
6666 Creates a new shape by sweeping a shape known as the profile along a wire known as the spine.
6670 # sweep a circle along a bezier curve to make a solid
6673 beziercurve spine 4 0 0 0 10 0 0 10 10 0 20 10 0
6676 circle profile 0 0 0 1 0 0 2
6677 mkedge profile profile
6678 wire profile profile
6679 mkplane profile profile
6680 pipe p spine profile
6683 @subsubsection occt_draw_7_4_4 mksweep, addsweep, setsweep, deletesweep, buildsweep, simulsweep
6688 addsweep wire[vertex][-M][-C] [auxiilaryshape]
6690 setsweep options [arg1 [arg2 [...]]]
6691 simulsweep r [n] [option]
6692 buildsweep [r] [option] [Tol]
6696 * *-FR* : Tangent and Normal are defined by a Frenet trihedron
6697 * *-CF* : Tangent is given by Frenet, the Normal is computed to minimize the torsion
6698 * *-DX Surf* : Tangent and Normal are given by Darboux trihedron, surf must be a shell or a face
6699 * *-CN dx dy dz* : BiNormal is given by *dx dy dz*
6700 * *-FX Tx Ty TZ [Nx Ny Nz]* : Tangent and Normal are fixed
6703 These commands are used to create a shape from wires. One wire is designated as the contour that defines the direction; it is called the spine. At least one other wire is used to define the the sweep profile.
6704 * **mksweep** -- initializes the sweep creation and defines the wire to be used as the spine.
6705 * **addsweep** -- defines the wire to be used as the profile.
6706 * **deletesweep** -- cancels the choice of profile wire, without leaving the mksweep mode. You can re-select a profile wire.
6707 * **setsweep** -- commands the algorithms used for the construction of the sweep.
6708 * **simulsweep** -- can be used to create a preview of the shape. [n] is the number of sections that are used to simulate the sweep.
6709 * **buildsweep** -- creates the sweep using the arguments defined by all the commands.
6713 #create a sweep based on a semi-circular wire using the
6715 #create a circular figure
6716 circle c2 0 0 0 1 0 0 10
6717 trim c2 c2 -pi/2 pi/2
6723 # to display all the options for a sweep
6725 #to create a sweep using the Frenet algorithm where the
6726 #normal is computed to minimise the torsion
6729 # to simulate the sweep with a visual approximation
6733 @subsubsection occt_draw_7_4_5 thrusections
6737 thrusections [-N] result issolid isruled wire1 wire2 [..wire..]
6740 **thrusections** creates a shape using wires that are positioned in different planes. Each wire selected must have the same number of edges and vertices.
6741 A bezier curve is generated between the vertices of each wire. The option *[-N]* means that no check is made on wires for direction.
6745 #create three wires in three planes
6746 polyline w1 0 0 0 5 0 0 5 5 0 2 3 0
6747 polyline w2 0 1 3 4 1 3 4 4 3 1 3 3
6748 polyline w3 0 0 5 5 0 5 5 5 5 2 3 5
6750 thrusections th issolid isruled w1 w2 w3
6751 ==thrusections th issolid isruled w1 w2 w3
6752 Tolerances obtenues -- 3d : 0
6757 @subsection occt_draw_7_5 Topological transformation
6759 Transformations are applications of matrices. When the transformation is nondeforming, such as translation or rotation, the object is not copied. The topology localcoordinate system feature is used. The copy can be enforced with the **tcopy** command.
6761 * **tcopy** -- makes a copy of the structure of a shape.
6762 * **ttranslate**, **trotate**, **tmove** and **reset** -- move a shape.
6763 * **tmirror** and **tscale** -- always modify the shape.
6766 @subsubsection occt_draw_7_5_1 tcopy
6770 tcopy name toname [name toname ...]
6773 Copies the structure of one shape, including the geometry, into another, newer shape.
6777 # create an edge from a curve and copy it
6778 beziercurve c 3 0 0 0 10 0 0 20 10 0
6783 # now modify the curve, only e1 and e2 will be modified
6786 @subsubsection occt_draw_7_5_2 tmove, treset
6790 tmove name [name ...] shape
6791 reset name [name ...]
6794 **tmove** and **reset** modify the location, or the local coordinate system of a shape.
6796 **tmove** applies the location of a given shape to other shapes. **reset** restores one or several shapes it to its or their original coordinate system(s).
6802 box b2 20 0 0 10 10 10
6803 # translate the first box
6804 ttranslate b1 0 10 0
6805 # and apply the same location to b2
6807 # return to original positions
6811 @subsubsection occt_draw_7_5_3 ttranslate, trotate
6815 ttranslate [name ...] dx dy dz
6816 trotate [name ...] x y z dx dy dz angle
6819 **ttranslate** translates a set of shapes by a given vector, and **trotate** rotates them by a given angle around an axis. Both commands only modify the location of the shape.
6820 When creating multiple shapes, the same location is used for all the shapes. (See *toto.tcl* example below. Note that the code of this file can also be directly executed in interactive mode.)
6822 Locations are very economic in the data structure because multiple occurences of an object share the topological description.
6826 # make rotated copies of a sphere in between two cylinders
6827 # create a file source toto.tcl
6829 for {set i 0} {$i < 360} {incr i 20} {
6831 trotate s$i 0 0 0 0 0 1 $i
6834 # create two cylinders
6837 ttranslate c2 0 0 20
6841 ttranslate s 25 0 12.5
6843 # call the source file for multiple copies
6847 @subsubsection occt_draw_7_5_4 tmirror, tscale
6851 tmirror name x y z dx dy dz
6852 tscale name x y z scale
6855 * **tmirror** makes a mirror copy of a shape about a plane x,y,z dx,dy,dz.
6857 * **Tscale** applies a central homotopic mapping to a shape.
6861 # mirror a portion of cylinder about the YZ plane
6862 pcylinder c1 10 10 270
6864 tmirror c2 15 0 0 1 0 0
6870 @subsection occt_draw_7_6 Old Topological operations
6872 * **fuse**, **cut**, **common** are boolean operations.
6873 * **section**, **psection** compute sections.
6874 * **sewing** joins two or more shapes.
6877 @subsubsection occt_draw_7_6_1 fuse, cut, common
6879 These commands are no longer supported, so the result may be unpredictable.
6880 Please use the commands bfuse, bcut, bcommon instead.
6884 fuse name shape1 shape2
6885 cut name shape1 shape2
6886 common name shape1 shape2
6889 **fuse** creates a new shape by a boolean operation on two existing shapes. The new shape contains both originals intact.
6891 **cut** creates a new shape which contains all parts of the second shape but only the first shape without the intersection of the two shapes.
6893 **common** creates a new shape which contains only what is in common between the two original shapes in their intersection.
6897 # all four boolean operations on a box and a cylinder
6899 box b 0 -10 5 20 20 10
6903 ttranslate s1 40 0 0
6906 ttranslate s2 -40 0 0
6909 ttranslate s3 0 40 0
6912 ttranslate s4 0 -40 0
6916 @subsubsection occt_draw_7_6_2 section, psection
6918 These commands are no longer supported, so the result may be unpredictable.
6919 Please use the command bsection instead.
6923 section result shape1 shape2
6924 psection name shape plane
6927 **section** creates a compound object consisting of the edges for the intersection curves on the faces of two shapes.
6929 **psection** creates a planar section consisting of the edges for the intersection curves on the faces of a shape and a plane.
6933 # section line between a cylinder and a box
6935 box b 0 0 5 15 15 15
6936 trotate b 0 0 0 1 1 1 20
6939 # planar section of a cone
6941 plane p 0 0 15 1 1 2
6945 @subsubsection occt_draw_7_6_3 sewing
6949 sewing result [tolerance] shape1 shape2 ...
6952 **Sewing** joins shapes by connecting their adjacent or near adjacent edges. Adjacency can be redefined by modifying the tolerance value.
6956 # create two adjacent boxes
6961 sr is a shape COMPOUND FORWARD Free Modified
6964 @subsection occt_draw_7_7 New Topological operations
6966 The new algorithm of Boolean operations avoids a large number of weak points and limitations presented in the old Boolean operation algorithm.
6967 It also provides wider range of options and diagnostics.
6968 The algorithms of Boolean component are fully described in the @ref occt_algorithms_1 "Boolean Operations" of boolean operation user guide.
6970 For the Draw commands to perform operations in Boolean component please read the dedicated section @ref occt_draw_bop "Boolean operations commands"
6973 @subsection occt_draw_7_8 Drafting and blending
6975 Drafting is creation of a new shape by tilting faces through an angle.
6977 Blending is the creation of a new shape by rounding edges to create a fillet.
6979 * Use the **depouille** command for drafting.
6980 * Use the **chamf** command to add a chamfer to an edge
6981 * Use the **blend** command for simple blending.
6982 * Use **bfuseblend** for a fusion + blending operation.
6983 * Use **bcutblend** for a cut + blending operation.
6984 * Use **buildevol**, **mkevol**, **updatevol** to realize varying radius blending.
6987 @subsubsection occt_draw_7_8_1 depouille
6991 dep result shape dirx diry dirz face angle x y x dx dy dz [face angle...]
6994 Creates a new shape by drafting one or more faces of a shape.
6996 Identify the shape(s) to be drafted, the drafting direction, and the face(s) with an angle and an axis of rotation for each face. You can use dot syntax to identify the faces.
7000 # draft a face of a box
7003 == b_1 b_2 b_3 b_4 b_5 b_6
7005 dep a b 0 0 1 b_2 10 0 10 0 1 0 5
7008 @subsubsection occt_draw_7_8_2 chamf
7012 chamf newname shape edge face S dist
7013 chamf newname shape edge face dist1 dist2
7014 chamf newname shape edge face A dist angle
7017 Creates a chamfer along the edge between faces using:
7019 * a equal distances from the edge
7020 * the edge, a face and distance, a second distance
7021 * the edge, a reference face and an angle
7023 Use the dot syntax to select the faces and edges.
7027 Let us create a chamfer based on equal distances from the edge (45 degree angle):
7031 chamf ch b . . S 0.5
7035 # select an adjacent face
7038 Let us create a chamfer based on different distances from the selected edge:
7041 chamf ch b . . 0.3 0.4
7045 # select an adjacent face
7048 Let us create a chamfer based on a distance from the edge and an angle:
7052 chamf ch b . . A 0.4 30
7056 # select an adjacent face
7059 @subsubsection occt_draw_7_8_3 blend
7063 blend result object rad1 ed1 rad2 ed2 ... [R/Q/P]
7066 Creates a new shape by filleting the edges of an existing shape. The edge must be inside the shape. You may use the dot syntax. Note that the blend is propagated to the edges of tangential planar, cylindrical or conical faces.
7070 # blend a box, click on an edge
7073 ==tolerance ang : 0.01
7074 ==tolerance 3d : 0.0001
7075 ==tolerance 2d : 1e-05
7077 ==tolblend 0.01 0.0001 1e-05 0.001
7079 # click on the edge you want ot fillet
7081 ==COMPUTE: temps total 0.1s dont :
7082 ==- Init + ExtentAnalyse 0s
7083 ==- PerformSetOfSurf 0.02s
7084 ==- PerformFilletOnVertex 0.02s
7086 ==- Reconstruction 0.06s
7090 @subsubsection occt_draw_7_8_4 bfuseblend
7094 bfuseblend name shape1 shape2 radius [-d]
7097 Creates a boolean fusion of two shapes and then blends (fillets) the intersection edges using the given radius.
7098 Option [-d] enables the Debugging mode in which the error messages, if any, will be printed.
7102 # fuse-blend two boxes
7105 ttranslate b2 -10 10 3
7106 bfuseblend a b1 b2 1
7109 @subsubsection occt_draw_7_8_4a bcutblend
7113 bcutblend name shape1 shape2 radius [-d]
7116 Creates a boolean cut of two shapes and then blends (fillets) the intersection edges using the given radius.
7117 Option [-d] enables the Debugging mode in which the error messages, if any, will be printed.
7121 # cut-blend two boxes
7124 ttranslate b2 -10 10 3
7128 @subsubsection occt_draw_7_8_5 mkevol, updatevol, buildevol
7132 mkevol result object (then use updatevol) [R/Q/P]
7133 updatevol edge u1 radius1 [u2 radius2 ...]
7137 These three commands work together to create fillets with evolving radii.
7139 * **mkevol** allows specifying the shape and the name of the result. It returns the tolerances of the fillet.
7140 * **updatevol** allows describing the filleted edges you want to create. For each edge, you give a set of coordinates: parameter and radius and the command prompts you to pick the edge of the shape which you want to modify. The parameters will be calculated along the edges and the radius function applied to the whole edge.
7141 * **buildevol** produces the result described previously in **mkevol** and **updatevol**.
7145 # makes an evolved radius on a box
7148 ==tolerance ang : 0.01
7149 ==tolerance 3d : 0.0001
7150 ==tolerance 2d : 1e-05
7152 ==tolblend 0.01 0.0001 1e-05 0.001
7155 updatevol . 0 1 1 3 2 2
7159 ==Dump of SweepApproximation
7160 ==Error 3d = 1.28548881203818e-14
7161 ==Error 2d = 1.3468326936926e-14 ,
7162 ==1.20292299999388e-14
7163 ==2 Segment(s) of degree 3
7165 ==COMPUTE: temps total 0.91s dont :
7166 ==- Init + ExtentAnalyse 0s
7167 ==- PerformSetOfSurf 0.33s
7168 ==- PerformFilletOnVertex 0.53s
7170 ==- Reconstruction 0.04s
7175 @subsection occt_draw_defeaturing Defeaturing
7177 Draw command **removefeatures** is intended for performing @ref occt_modalg_defeaturing "3D Model Defeaturing", i.e. it performs the removal of the requested features from the shape.
7181 removefeatures result shape f1 f2 ... [-nohist] [-parallel]
7184 result - result of the operation;
7185 shape - the shape to remove the features from;
7186 f1, f2 - features to remove from the shape;
7189 nohist - disables the history collection;
7190 parallel - enables the parallel processing mode.
7194 @subsection occt_draw_7_9 Analysis of topology and geometry
7196 Analysis of shapes includes commands to compute length, area, volumes and inertial properties, as well as to compute some aspects impacting shape validity.
7198 * Use **lprops**, **sprops**, **vprops** to compute integral properties.
7199 * Use **bounding** to compute and to display the bounding box of a shape.
7200 * Use **distmini** to calculate the minimum distance between two shapes.
7201 * Use **isbbinterf** to check if the two shapes are interfered by their bounding boxes.
7202 * Use **xdistef**, **xdistcs**, **xdistcc**, **xdistc2dc2dss**, **xdistcc2ds** to check the distance between two objects on even grid.
7203 * Use **checkshape** to check validity of the shape.
7204 * Use **tolsphere** to see the tolerance spheres of all vertices in the shape.
7205 * Use **validrange** to check range of an edge not covered by vertices.
7208 @subsubsection occt_draw_7_9_1 lprops, sprops, vprops
7217 * **lprops** computes the mass properties of all edges in the shape with a linear density of 1;
7218 * **sprops** of all faces with a surface density of 1;
7219 * **vprops** of all solids with a density of 1.
7221 All three commands print the mass, the coordinates of the center of gravity, the matrix of inertia and the moments. Mass is either the length, the area or the volume. The center and the main axis of inertia are displayed.
7225 # volume of a cylinder
7229 Mass : 6283.18529981086
7232 X = 4.1004749224903e-06
7233 Y = -2.03392858349861e-16
7237 366519.141445068 5.71451850691484e-12
7239 5.71451850691484e-12 366519.141444962
7240 2.26823064169991e-10 0.257640437382627
7241 2.26823064169991e-10 314159.265358863
7244 IX = 366519.141446336
7245 IY = 366519.141444962
7246 I.Z = 314159.265357595
7250 @subsubsection occt_draw_7_9_2 bounding
7254 bounding {-s shape | -c xmin ymin zmin xmax ymax zmax} [-obb] [-shape name] [-dump] [-notriangulation] [-perfmeter name NbIters] [-save xmin ymin zmin xmax ymax zmax] [-nodraw] [-optimal] [-exttoler]
7257 Computes and displays the bounding box (BndBox) of a shape. The bounding box is a cuboid that circumscribes the source shape.
7258 Generaly, bounding boxes can be divided into two main types:
7259 - axis-aligned BndBox (AABB). I.e. the box whose edges are parallel to an axis of World Coordinate System (WCS);
7260 - oriented BndBox (OBB). I.e. not AABB.
7262 Detailed information about this command is availabe in DRAW help-system (enter "help bounding" in DRAW application).
7264 **Example 1: Creation of AABB with given corners**
7266 bounding -c 50 100 30 180 200 100 -shape result
7273 **Example 2: Compare AABB and OBB**
7275 # Create a torus and rotate it
7277 trotate t 5 10 15 1 1 1 28
7279 # Create AABB from the torus
7280 bounding -s t -shape ra -dump -save x1 y1 z1 x2 y2 z2
7281 ==Axes-aligned bounding box
7282 ==X-range: -26.888704600189307 23.007685197265488
7283 ==Y-range: -22.237699567214314 27.658690230240481
7284 ==Z-range: -13.813966507560762 12.273995247458407
7286 # Obtain the boundaries
7287 dump x1 y1 z1 x2 y2 z2
7288 ==*********** Dump of x1 *************
7291 ==*********** Dump of y1 *************
7294 ==*********** Dump of z1 *************
7297 ==*********** Dump of x2 *************
7300 ==*********** Dump of y2 *************
7303 ==*********** Dump of z2 *************
7306 # Compute the volume of AABB
7310 # Let us check this value
7311 dval (x2-x1)*(y2-y1)*(z2-z1)
7312 ==64949.886543606823
7315 The same result is obtained.
7318 # Create OBB from the torus
7319 bounding -s t -shape ro -dump -obb
7320 ==Oriented bounding box
7321 ==Center: -1.9405097014619073 2.7104953315130857 -0.76998563005117782
7322 ==X-axis: 0.31006700219833244 -0.23203206410428409 0.9219650619059514
7323 ==Y-axis: 0.098302309139513336 -0.95673739537318336 -0.27384340837854165
7324 ==Z-axis: 0.94561890324040099 0.17554109923901748 -0.27384340837854493
7325 ==Half X: 5.0000002000000077
7326 ==Half Y: 26.783728747002169
7327 ==Half Z: 26.783728747002165
7329 # Compute the volume of OBB
7334 As we can see, the volume of OBB is significantly less than the volume of AABB.
7336 @subsubsection occt_draw_7_9_2a isbbinterf
7340 isbbinterf shape1 shape2 [-o]
7343 Checks whether the bounding boxes created from the given shapes are interfered. If "-o"-option is switched on then the oriented boxes will be checked. Otherwise, axis-aligned boxes will be checked.
7345 **Example 1: Not interfered AABB**
7347 box b1 100 60 140 20 10 80
7348 box b2 210 200 80 120 60 90
7350 ==The shapes are NOT interfered by AABB.
7353 **Example 2: Interfered AABB**
7356 box b2 100 100 100 50 50 50
7358 ==The shapes are interfered by AABB.
7361 **Example 3: Not interfered OBB**
7365 trotate b1 -150 -150 -150 1 2 3 -40
7366 trotate b2 -150 -150 -150 1 5 2 60
7368 # Check of interference
7370 ==The shapes are NOT interfered by OBB.
7373 **Example 4: Interfered OBB**
7377 trotate b1 -50 -50 -50 1 1 1 -40
7378 trotate b2 -50 -50 -50 1 1 1 60
7380 # Check of interference
7382 ==The shapes are interfered by OBB.
7385 @subsubsection occt_draw_7_9_3 distmini
7389 distmini name Shape1 Shape2
7392 Calculates the minimum distance between two shapes. The calculation returns the number of solutions, if more than one solution exists. The options are displayed in the viewer in red and the results are listed in the shell window. The *distmini* lines are considered as shapes which have a value v.
7396 box b 0 0 0 10 20 30
7397 box b2 30 30 0 10 20 30
7399 ==the distance value is : 22.3606797749979
7400 ==the number of solutions is :2
7403 ==the type of the solution on the first shape is 0
7404 ==the type of the solution on the second shape is 0
7405 ==the coordinates of the point on the first shape are:
7407 ==the coordinates of the point on the second shape
7411 ==solution number 2:
7412 ==the type of the solution on the first shape is 0
7413 ==the type of the solution on the second shape is 0
7414 ==the coordinates of the point on the first shape are:
7416 ==the coordinates of the point on the second shape
7423 @subsubsection occt_draw_7_9_4 xdistef, xdistcs, xdistcc, xdistc2dc2dss, xdistcc2ds
7428 xdistcs curve surface firstParam lastParam [NumberOfSamplePoints]
7429 xdistcc curve1 curve2 startParam finishParam [NumberOfSamplePoints]
7430 xdistcc2ds c curve2d surf startParam finishParam [NumberOfSamplePoints]
7431 xdistc2dc2dss curve2d_1 curve2d_2 surface_1 surface_2 startParam finishParam [NumberOfSamplePoints]
7434 It is assumed that curves have the same parametrization range and *startParam* is less than *finishParam*.
7436 Commands with prefix *xdist* allow checking the distance between two objects on even grid:
7437 * **xdistef** -- distance between edge and face;
7438 * **xdistcs** -- distance between curve and surface. This means that the projection of each sample point to the surface is computed;
7439 * **xdistcc** -- distance between two 3D curves;
7440 * **xdistcc2ds** -- distance between 3d curve and 2d curve on surface;
7441 * **xdistc2dc2dss** -- distance between two 2d curves on surface.
7448 xdistcs c_1 s1 0 1 100
7449 xdistcc2ds c_1 c2d2_1 s2 0 1
7450 xdistc2dc2dss c2d1_1 c2d2_1 s1 s2 0 1 1000
7453 @subsubsection occt_draw_7_9_5 checkshape
7457 checkshape [-top] shape [result] [-short]
7461 * *top* -- optional parameter, which allows checking only topological validity of a shape.
7462 * *shape* -- the only required parameter, defines the name of the shape to check.
7463 * *result* -- optional parameter, defines custom prefix for the output shape names.
7464 * *short* -- a short description of the check.
7466 **checkshape** examines the selected object for topological and geometric coherence. The object should be a three dimensional shape.
7470 # checkshape returns a comment valid or invalid
7473 # returns the comment
7474 this shape seems to be valid
7477 @subsubsection occt_draw_7_9_6 tolsphere
7485 * *shape* -- the name of the shape to process.
7487 **tolsphere** shows vertex tolerances by drawing spheres around each vertex in the shape. Each sphere is assigned a name of the shape with suffix "_vXXX", where XXX is the number of the vertex in the shape.
7491 # tolsphere returns all names of created spheres.
7493 settolerance b1 0.05
7495 # creates spheres and returns the names
7496 b1_v1 b1_v2 b1_v3 b1_v4 b1_v5 b1_v6 b1_v7 b1_v8
7499 @subsubsection occt_draw_7_9_7 validrange
7503 validrange edge [(out) u1 u2]
7507 * *edge* -- the name of the edge to analyze.
7508 * *u1*, *u2* -- optional names of variables to put into the range.
7510 **validrange** computes valid range of the edge. If *u1* and *u2* are not given, it returns the first and the last parameters. Otherwise, it sets variables *u1* and *u2*.
7519 1.9884375000000002e-008 3.1415926337054181
7522 1.9884375000000002e-008
7528 @subsection occt_draw_7_10 Surface creation
7530 Surface creation commands include surfaces created from boundaries and from spaces between shapes.
7531 * **gplate** creates a surface from a boundary definition.
7532 * **filling** creates a surface from a group of surfaces.
7534 @subsubsection occt_draw_7_10_1 gplate,
7538 gplate result nbrcurfront nbrpntconst [SurfInit] [edge 0] [edge tang (1:G1;2:G2) surf]...[point] [u v tang (1:G1;2:G2) surf] ...
7541 Creates a surface from a defined boundary. The boundary can be defined using edges, points, or other surfaces.
7549 beziercurve c1 3 0 0 0 1 0 1 2 0 0
7555 trotate e3 0 0 0 0 0 1 90
7558 # create the surface
7559 gplate r1 4 0 p e1 0 e2 0 e3 0 e4 0
7561 ======== Results ===========
7562 DistMax=8.50014503228635e-16
7564 Calculation time: 0.33
7566 Approximation results
7567 Approximation error : 2.06274907619957e-13
7568 Criterium error : 4.97600631215754e-14
7570 #to create a surface defined by edges and passing through a point
7571 # to define the border edges and the point
7576 beziercurve c1 3 0 0 0 1 0 1 2 0 0
7582 trotate e3 0 0 0 0 0 1 90
7587 # to create the surface
7588 gplate r2 4 1 p e1 0 e2 0 e3 0 e4 0 pp
7590 ======== Results ===========
7591 DistMax=3.65622157610934e-06
7593 Calculculation time: 0.27
7595 Approximation results
7596 Approximation error : 0.000422195884750181
7597 Criterium error : 3.43709808053967e-05
7600 @subsubsection occt_draw_7_10_2 filling, fillingparam
7604 filling result nbB nbC nbP [SurfInit] [edge][face]order...
7605 edge[face]order... point/u v face order...
7608 Creates a surface between borders. This command uses the **gplate** algorithm but creates a surface that is tangential to the adjacent surfaces. The result is a smooth continuous surface based on the G1 criterion.
7610 To define the surface border:
7612 * enter the number of edges, constraints, and points
7613 * enumerate the edges, constraints and points
7615 The surface can pass through other points. These are defined after the border definition.
7617 You can use the *fillingparam* command to access the filling parameters.
7621 * <i>-l</i> : to list current values
7622 * <i>-i</i> : to set default values
7623 * <i>-rdeg nbPonC nbIt anis </i> : to set filling options
7624 * <i>-c t2d t3d tang tcur </i> : to set tolerances
7625 * <i>-a maxdeg maxseg </i> : Approximation option
7629 # to create four curved survaces and a point
7634 beziercurve c1 3 0 0 0 1 0 1 2 0 0
7640 trotate e3 0 0 0 0 0 1 90
7651 # to create a tangential surface
7652 filling r1 4 0 0 p e1 f1 1 e2 f2 1 e3 f3 1 e4 f4 1
7653 # to create a tangential surface passing through point pp
7654 filling r2 4 0 1 p e1 f1 1 e2 f2 1 e3 f3 1 e4 f4 1 pp#
7655 # to visualise the surface in detail
7657 # to display the current filling parameters
7674 @subsection occt_draw_7_11 Complex Topology
7676 Complex topology is the group of commands that modify the topology of shapes. This includes feature modeling.
7679 @subsubsection occt_draw_7_11_1 offsetshape, offsetcompshape
7683 offsetshape r shape offset [tol] [face ...]
7684 offsetcompshape r shape offset [face ...]
7687 **offsetshape** and **offsetcompshape** assign a thickness to the edges of a shape. The *offset* value can be negative or positive. This value defines the thickness and direction of the resulting shape. Each face can be removed to create a hollow object.
7689 The resulting shape is based on a calculation of intersections. In case of simple shapes such as a box, only the adjacent intersections are required and you can use the **offsetshape** command.
7691 In case of complex shapes, where intersections can occur from non-adjacent edges and faces, use the **offsetcompshape** command. **comp** indicates complete and requires more time to calculate the result.
7693 The opening between the object interior and exterior is defined by the argument face or faces.
7699 == b1_1 b1_2 b1_3 b1_4 b1_5 b1_6
7700 offsetcompshape r b1 -1 b1_3
7703 @subsubsection occt_draw_7_11_2 featprism, featdprism, featrevol, featlf, featrf
7707 featprism shape element skface Dirx Diry Dirz Fuse(0/1/2) Modify(0/1)
7708 featdprism shape face skface angle Fuse(0/1/2) Modify(0/1)
7709 featrevol shape element skface Ox Oy Oz Dx Dy Dz Fuse(0/1/2) Modify(0/1)
7710 featlf shape wire plane DirX DirY DirZ DirX DirY DirZ Fuse(0/1/2) Modify(0/1)
7711 featrf shape wire plane X Y Z DirX DirY DirZ Size Size Fuse(0/1/2) Modify(0/1)
7712 featperform prism/revol/pipe/dprism/lf result [[Ffrom] Funtil]
7713 featperformval prism/revol/dprism/lf result value
7716 **featprism** loads the arguments for a prism with contiguous sides normal to the face.
7718 **featdprism** loads the arguments for a prism which is created in a direction normal to the face and includes a draft angle.
7720 **featrevol** loads the arguments for a prism with a circular evolution.
7722 **featlf** loads the arguments for a linear rib or slot. This feature uses planar faces and a wire as a guideline.
7724 **featrf** loads the arguments for a rib or slot with a curved surface. This feature uses a circular face and a wire as a guideline.
7726 **featperform** loads the arguments to create the feature.
7728 **featperformval** uses the defined arguments to create a feature with a limiting value.
7730 All the features are created from a set of arguments which are defined when you initialize the feature context. Negative values can be used to create depressions.
7734 Let us create a feature prism with a draft angle and a normal direction :
7737 # create a box with a wire contour on the upper face
7739 profil f O 0 0 1 F 0.25 0.25 x 0.5 y 0.5 x -0.5
7741 # loads the feature arguments defining the draft angle
7742 featdprism b f b_6 5 1 0
7743 # create the feature
7744 featperformval dprism r 1
7745 ==BRepFeat_MakeDPrism::Perform(Height)
7746 BRepFeat_Form::GlobalPerform ()
7752 Let us create a feature prism with circular direction :
7755 # create a box with a wire contour on the upper face
7757 profil f O 0 0 1 F 0.25 0.25 x 0.5 y 0.5 x -0.5
7759 # loads the feature arguments defining a rotation axis
7760 featrevol b f b_6 1 0 1 0 1 0 1 0
7761 featperformval revol r 45
7762 ==BRepFeat_MakeRevol::Perform(Angle)
7763 BRepFeat_Form::GlobalPerform ()
7770 Let us create a slot using the linear feature :
7773 #create the base model using the multi viewer
7775 profile p x 5 y 1 x -3 y -0.5 x -1.5 y 0.5 x 0.5 y 4 x -1 y -5
7777 # create the contour for the linear feature
7778 vertex v1 -0.2 4 0.3
7780 vertex v3 0.2 0.2 0.3
7782 vertex v5 4 -0.2 0.3
7789 plane pl 0.2 0.2 0.3 0 0 1
7790 # loads the linear feature arguments
7791 featlf pr w pl 0 0 0.3 0 0 0 0 1
7792 featperform lf result
7795 Let us create a rib using the revolution feature :
7798 #create the base model using the multi viewer
7801 # create the contour for the revolution feature
7802 profile w c 1 190 WW
7803 trotate w 0 0 0 1 0 0 90
7805 trotate w -3 0 1.5 0 0 1 180
7806 plane pl -3 0 1.5 0 1 0
7807 # loads the revolution feature arguments
7808 featrf c1 w pl 0 0 0 0 0 1 0.3 0.3 1 1
7809 featperform rf result
7812 @subsubsection occt_draw_7_11_3 draft
7816 draft result shape dirx diry dirz angle shape/surf/length [-IN/-OUT] [Ri/Ro] [-Internal]
7819 Computes a draft angle surface from a wire. The surface is determined by the draft direction, the inclination of the draft surface, a draft angle, and a limiting distance.
7821 * The draft angle is measured in radians.
7822 * The draft direction is determined by the argument -INTERNAL
7823 * The argument Ri/Ro deftermines wether the corner edges of the draft surfaces are angular or rounded.
7824 * Arguments that can be used to define the surface distance are:
7825 * length, a defined distance
7826 * shape, until the surface contacts a shape
7827 * surface, until the surface contacts a surface.
7829 **Note** that the original aim of adding a draft angle to a shape is to produce a shape which can be removed easily from a mould. The Examples below use larger angles than are used normally and the calculation results returned are not indicated.
7833 # to create a simple profile
7834 profile p F 0 0 x 2 y 4 tt 0 4 w
7835 # creates a draft with rounded angles
7836 draft res p 0 0 1 3 1 -Ro
7837 # to create a profile with an internal angle
7838 profile p F 0 0 x 2 y 4 tt 1 1.5 tt 0 4 w
7839 # creates a draft with rounded external angles
7840 draft res p 0 0 1 3 1 -Ro
7843 @subsubsection occt_draw_7_11_4 deform
7847 deform newname name CoeffX CoeffY CoeffZ
7850 Modifies the shape using the x, y, and z coefficients. You can reduce or magnify the shape in the x,y, and z directions.
7856 # the conversion to bspline is followed by the
7861 @subsubsection occt_draw_7_11_5 nurbsconvert
7866 nurbsconvert result name [result name]
7869 Changes the NURBS curve definition of a shape to a Bspline curve definition. This conversion is required for assymetric deformation and prepares the arguments for other commands such as **deform**. The conversion can be necessary when transferring shape data to other applications.
7872 @subsubsection occt_draw_7_11_6 edgestofaces
7874 **edgestofaces** - The command allows building planar faces from the planar edges randomly located in 3D space.
7876 It has the following syntax:
7878 edgestofaces r_faces edges [-a AngTol -s Shared(0/1)]
7881 * -a AngTol - angular tolerance used for distinguishing the planar faces;
7882 * -s Shared(0/1) - boolean flag which defines whether the input edges are already shared or have to be intersected.
7884 @subsection occt_draw_hist History commands
7886 Draw module for @ref occt_modalg_hist "History Information support" includes the command to save history of modifications performed by Boolean operation or sibling commands into a drawable object and the actual history commands:
7888 * **setfillhistory**;
7894 @subsubsection occt_draw_hist_set setfillhistory
7896 *setfillhistory* command controls if the history is needed to be filled in the supported algorithms and saved into the session after the algorithm is done.
7897 By default it is TRUE, i.e. the history is filled and saved.
7901 setfillhistory : Controls the history collection by the algorithms and its saving into the session after algorithm is done.
7902 Usage: setfillhistory [flag]
7903 w/o arguments prints the current state of the option;
7904 flag == 0 - history will not be collected and saved;
7905 flag != 0 - history will be collected and saved into the session (default).
7915 # No history has been prepared yet.
7920 # *********** Dump of h *************
7922 # - 2 Deleted shapes;
7923 # - 52 Modified shapes;
7924 # - 0 Generated shapes.
7927 @subsubsection occt_draw_hist_save savehistory
7929 *savehistory* command saves the history from the session into a drawable object with the given name.
7933 savehistory : savehistory name
7936 If the history of shape modifications performed during an operation is needed, the *savehistory* command should be called after the command performing the operation.
7937 If another operation supporting history will be performed before the history of the first operation is saved it will be overwritten with the new history.
7942 box b2 5 0 0 10 10 15
7944 savehistory fuse_hist
7947 #*********** Dump of fuse_hist *************
7949 # - 4 Deleted shapes;
7950 # - 20 Modified shapes;
7951 # - 6 Generated shapes.
7954 savehistory usd_hist
7956 #*********** Dump of usd_hist *************
7958 # - 14 Deleted shapes;
7959 # - 28 Modified shapes;
7960 # - 0 Generated shapes.
7963 @subsubsection occt_draw_hist_isdel isdeleted
7965 *isdeleted* command checks if the given shape has been deleted in the given history.
7969 isdeleted : isdeleted history shape
7978 savehistory com_hist
7979 # all vertices, edges and faces of the b2 are deleted
7980 foreach s [join [list [explode b2 v] [explode b2 e] [explode b2 f] ] ] {
7981 isdeleted com_hist $s
7986 @subsubsection occt_draw_hist_mod modified
7988 *modified* command returns the shapes Modified from the given shape in the given history. All modified shapes are put into a compound. If the shape has not been modified, the resulting compound will be empty. Note that if the shape has been modified into a single shape only, it will be returned without enclosure into the compound.
7992 modified : modified modified_shapes history shape
8001 savehistory fillet_hist
8005 modified m3 fillet_hist b_3
8006 modified m5 fillet_hist b_5
8009 @subsubsection occt_draw_hist_gen generated
8011 *generated* command returns the shapes Generated from the given shape in the given history. All generated shapes are put into a compound. If no shapes have been generated from the shape, the resulting compound will be empty. Note that; if the shape has generated a single shape only, it will be returned without enclosure into the compound.
8015 generated : generated generated_shapes history shape
8020 polyline w1 0 0 0 10 0 0 10 10 0
8021 polyline w2 5 1 10 9 1 10 9 5 10
8023 thrusections r 0 0 w1 w2
8025 savehistory loft_hist
8030 generated g11 loft_hist w1_1
8031 generated g12 loft_hist w1_2
8032 generated g21 loft_hist w2_1
8033 generated g22 loft_hist w2_2
8042 @subsubsection occt_draw_hist_extension Enabling Draw history support for the algorithms
8044 Draw History mechanism allows fast and easy enabling of the Draw history support for the OCCT algorithms supporting standard history methods.
8045 To enable History commands for the algorithm it is necessary to save the history of the algorithm into the session.
8046 For that, it is necessary to put the following code into the command implementation just after the command is done:
8048 BRepTest_Objects::SetHistory(ListOfArguments, Algorithm);
8051 Here is the example of how it is done in the command performing Split operation (see implementation of the *bapisplit* command):
8053 BRepAlgoAPI_Splitter aSplitter;
8054 // setting arguments
8055 aSplitter.SetArguments(BOPTest_Objects::Shapes());
8057 aSplitter.SetTools(BOPTest_Objects::Tools());
8060 aSplitter.SetRunParallel(BOPTest_Objects::RunParallel());
8061 aSplitter.SetFuzzyValue(BOPTest_Objects::FuzzyValue());
8062 aSplitter.SetNonDestructive(BOPTest_Objects::NonDestructive());
8063 aSplitter.SetGlue(BOPTest_Objects::Glue());
8064 aSplitter.SetCheckInverted(BOPTest_Objects::CheckInverted());
8065 aSplitter.SetUseOBB(BOPTest_Objects::UseOBB());
8066 aSplitter.SetToFillHistory(BRepTest_Objects::IsHistoryNeeded());
8068 // performing operation
8071 if (BRepTest_Objects::IsHistoryNeeded())
8073 // Store the history for the Objects (overwrites the history in the session)
8074 BRepTest_Objects::SetHistory(BOPTest_Objects::Shapes(), aSplitter);
8075 // Add the history for the Tools
8076 BRepTest_Objects::AddHistory(BOPTest_Objects::Tools(), aSplitter);
8080 The method *BRepTest_Objects::IsHistoryNeeded()* controls if the history is needed to be filled in the algorithm and saved into the session after the algorithm is done (*setfillhistory* command controls this option in DRAW).
8083 @subsection occt_draw_7_12 Texture Mapping to a Shape
8085 Texture mapping allows you to map textures on a shape. Textures are texture image files and several are predefined. You can control the number of occurrences of the texture on a face, the position of a texture and the scale factor of the texture.
8087 @subsubsection occt_draw_7_12_1 vtexture
8091 vtexture NameOfShape TextureFile
8092 vtexture NameOfShape
8093 vtexture NameOfShape ?
8094 vtexture NameOfShape IdOfTexture
8097 **TextureFile** identifies the file containing the texture you want. The same syntax without **TextureFile** disables texture mapping. The question-mark <b>?</b> lists available textures. **IdOfTexture** allows applying predefined textures.
8099 @subsubsection occt_draw_7_12_2 vtexscale
8103 vtexscale NameOfShape ScaleU ScaleV
8104 vtexscale NameOfShape ScaleUV
8105 vtexscale NameOfShape
8108 *ScaleU* and *Scale V* allow scaling the texture according to the U and V parameters individually, while *ScaleUV* applies the same scale to both parameters.
8110 The syntax without *ScaleU*, *ScaleV* or *ScaleUV* disables texture scaling.
8112 @subsubsection occt_draw_7_12_3 vtexorigin
8116 vtexorigin NameOfShape UOrigin VOrigin
8117 vtexorigin NameOfShape UVOrigin
8118 vtexorigin NameOfShape
8121 *UOrigin* and *VOrigin* allow placing the texture according to the U and V parameters individually, while *UVOrigin* applies the same position value to both parameters.
8123 The syntax without *UOrigin*, *VOrigin* or *UVOrigin* disables origin positioning.
8125 @subsubsection occt_draw_7_12_4 vtexrepeat
8129 vtexrepeat NameOfShape URepeat VRepeat
8130 vtexrepeat NameOfShape UVRepeat
8131 vtexrepeat NameOfShape
8134 *URepeat* and *VRepeat* allow repeating the texture along the U and V parameters individually, while *UVRepeat* applies the same number of repetitions for both parameters.
8136 The same syntax without *URepeat*, *VRepeat* or *UVRepeat* disables texture repetition.
8138 @subsubsection occt_draw_7_12_5 vtexdefault
8142 vtexdefault NameOfShape
8145 *Vtexdefault* sets or resets the texture mapping default parameters.
8149 * *URepeat = VRepeat = 1* no repetition
8150 * *UOrigin = VOrigin = 1* origin set at (0,0)
8151 * *UScale = VScale = 1* texture covers 100% of the face
8154 @section occt_draw_bop Boolean Operations Commands
8156 This chapter describes existing commands of Open CASCADE Draw Test Harness that are used for performing, analyzing, debugging the algorithm in Boolean Component.
8157 See @ref occt_user_guides__boolean_operations "Boolean operations" user's guide for the description of these algorithms.
8159 @subsection occt_draw_bop_two Boolean Operations on two operands
8161 All commands in this section perform Boolean operations on two shapes. One of them is considered as object, and the other as a tool.
8163 @subsubsection occt_draw_bop_two_bop bop, bopfuse, bopcut, boptuc, bopcommon, bopsection
8165 These commands perform Boolean operations on two shapes:
8166 * **bop** performs intersection of given shapes and stores the intersection results into internal Data Structure.
8167 * **bopfuse** creates a new shape representing the union of two shapes.
8168 * **bopcut** creates a new shape representing a subtraction of a second argument from the first one.
8169 * **boptuc** creates a new shape representing a subtraction of a first argument from the second one.
8170 * **bopcommon** creates a new shape representing the intersection of two shapes.
8171 * **bopsection** creates a new shape representing the intersection edges and vertices between shapes.
8173 These commands allow intersecting the shapes only once for building all types of Boolean operations. After *bop* command is done, the other commands in this category use the intersection results prepared by *bop*.
8174 It may be very useful as the intersection part is usually most time-consuming part of the operation.
8187 Let's produce all four boolean operations on a box and a cylinder performing intersection only once:
8189 box b 0 -10 5 20 20 10
8192 # intersect the shape, storing results into data structure
8201 # opposite cut operation
8212 @subsubsection occt_draw_bop_two_bapi bfuse, bcut, btuc, bcommon, bsection
8214 These commands also perform Boolean operations on two shapes. These are the short variants of the bop* commands.
8215 Each of these commands performs both intersection and building the result and may be useful if you need only the result of a single boolean operation.
8219 bcommon result shape1 shape2
8220 bfuse result shape1 shape2
8221 bcut result shape1 shape2
8222 btuc result shape1 shape2
8225 **bection** command has some additional options for faces intersection:
8227 bsection result shape1 shape2 [-n2d/-n2d1/-n2d2] [-na]
8230 result - result of the operation
8231 shape1, shape2 - arguments of the operation
8232 -n2d - disables PCurve construction on both objects
8233 -n2d1 - disables PCurve construction on first object
8234 -n2d2 - disables PCurve construction on second object
8235 -na - disables approximation of the section curves
8238 @subsection occt_draw_bop_multi Boolean Operations on multiple arguments
8240 The modern Boolean Operations algorithm available in Open CASCADE Technology is capable of performing a Boolean Operations not only on two shapes, but on arbitrary number of shapes.
8241 In terms of Boolean Operations these arguments are divided on two groups **Objects** and **Tools**. The meaning of these groups is similar to the single object and tool of Boolean Operations on two shapes.
8243 The Boolean operations are based on the General Fuse operation (see @ref occt_algorithms_7 "General Fuse algorithm") which splits all input shapes basing on the intersection results.
8244 Depending on the type of Boolean operation the BOP algorithm choses the necessary splits of the arguments.
8246 @subsection occt_draw_bop_general_com General commands for working with multiple arguments
8248 The algorithms based on General Fuse operation are using the same commands for adding and clearing the arguments list and for performing intersection of these arguments.
8250 @subsubsection occt_draw_bop_general_com_add Adding arguments of operation
8252 The following commands are used to add the objects and tools for Boolean operations:
8253 * **baddobjects** *S1 S2...Sn* -- adds shapes *S1, S2, ... Sn* as Objects;
8254 * **baddtools** *S1 S2...Sn* -- adds shapes *S1, S2, ... Sn* as Tools;
8256 The following commands are used to clear the objects and tools:
8257 * **bclearobjects** -- clears the list of Objects;
8258 * **bcleartools** -- clears the list of Tools;
8260 So, when running subsequent operation in one Draw session, make sure you cleared the Objects and Tools from previous operation. Otherwise, the new arguments will be added to the current ones.
8262 @subsubsection occt_draw_bop_general_com_fill Intersection of the arguments
8264 The command **bfillds** performs intersection of the arguments (**Objects** and **Tools**) and stores the intersection results into internal Data Structure.
8267 @subsection occt_draw_bop_build Building the result of operations
8269 @subsubsection occt_draw_bop_build_BOP Boolean operation
8271 The command **bbop** is used for building the result of Boolean Operation. It has to be used after **bfillds** command.
8278 result - result of the operation
8279 iOp - type of Boolean Operation. It could have the following values:
8280 0 - COMMON operation
8283 3 - CUT21 (opposite CUT, i.e. objects and tools are swapped) operation
8284 4 - SECTION operation
8290 box b2 5 5 5 10 10 10
8291 box b3 -5 -5 -5 10 10 10
8293 # Clear objects and tools from previous runs
8298 # add b2 and b3 as tools
8300 # perform intersection
8310 @subsubsection occt_draw_bop_build_GF General Fuse operation
8312 The command **bbuild** is used for building the result of General Fuse Operation. It has to be used after **bfillds** command.
8313 General Fuse operation does not make the difference between Objects and Tools considering both as objects.
8322 box b2 5 5 5 10 10 10
8323 box b3 -5 -5 -5 10 10 10
8325 # Clear objects and tools from previous runs
8330 # add b2 and b3 as tools
8332 # perform intersection
8338 @subsubsection occt_draw_bop_build_Split Split operation
8340 Split operation splits the **Objects** by the **Tools**.
8341 The command **bsplit** is used for building the result of Split operation. It has to be used after **bfillds** command.
8346 box b2 5 5 5 10 10 10
8347 box b3 -5 -5 -5 10 10 10
8349 # Clear objects and tools from previous runs
8354 # add b2 and b3 as tools
8356 # perform intersection
8362 @subsubsection occt_draw_bop_build_CB Cells Builder
8364 Please see the @ref occt_algorithms_10c_Cells_1 "Cells Builder Usage" for the Draw usage of Cells Builder algorithm.
8367 @subsubsection occt_draw_bop_build_API Building result through API
8369 The following commands are used to perform the operation using API implementation of the algorithms:
8370 * **bapibuild** -- to perform API general fuse operation.
8371 * **bapibop** -- to perform API Boolean operation.
8372 * **bapisplit** -- to perform API Split operation.
8374 These commands have the same syntax as the analogical commands described above.
8377 @subsection occt_draw_bop_options Setting options for the operation
8379 The algorithms in Boolean component have a wide range of options.
8380 To see the current state of all option the command **boptions** should be used.
8381 It has the following syntax:
8385 -default - allows to set all options to default state.
8388 To have an effect the options should be set before the operation (before *bfillds* command).
8390 @subsubsection occt_draw_bop_options_par Parallel processing mode
8392 **brunparallel** command enables/disables the parallel processing mode of the operation.
8399 flag is the boolean flag controlling the mode:
8400 flag == 0 - parallel processing mode is off.
8401 flag != 0 - parallel processing mode is on.
8404 The command is applicable for all commands in the component.
8406 @subsubsection occt_draw_bop_options_safe Safe processing mode
8408 **bnondestructive** command enables/disables the safe processing mode in which the input arguments are protected from modification.
8412 bnondestructive flag
8415 flag is the boolean flag controlling the mode:
8416 flag == 0 - safe processing mode is off.
8417 flag != 0 - safe processing mode is on.
8420 The command is applicable for all commands in the component.
8422 @subsubsection occt_draw_bop_options_fuzzy Fuzzy option
8424 **bfuzzyvalue** command sets the additional tolerance for operations.
8431 The command is applicable for all commands in the component.
8433 @subsubsection occt_draw_bop_options_glue Gluing option
8435 **bglue** command sets the gluing mode for the BOP algorithms.
8442 0 - disables gluing mode.
8443 1 - enables the Shift gluing mode.
8444 2 - enables the Full gluing mode.
8447 The command is applicable for all commands in the component.
8449 @subsubsection occt_draw_bop_options_checkinv Check inversion of input solids
8451 **bcheckinverted** command enables/disables the check of the input solids on inverted status in BOP algorithms.
8455 bcheckinverted 0 (off) / 1 (on)
8458 The command is applicable for all commands in the component.
8460 @subsubsection occt_draw_bop_options_obb OBB usage
8462 **buseobb** commannd enables/disables the usage of OBB in BOP algorithms.
8466 buseobb 0 (off) / 1 (on)
8469 The command is applicable for all commands in the component.
8471 @subsubsection occt_draw_bop_options_simplify Result simplification
8473 **bsimplify** command enables/disables the result simplification after BOP. The command is applicable only to the API variants of GF, BOP and Split operations.
8477 bsimplify [-e 0/1] [-f 0/1] [-a tol]
8480 -e 0/1 - enables/disables edges unification
8481 -f 0/1 - enables/disables faces unification
8482 -a tol - changes default angular tolerance of unification algo.
8485 @subsubsection occt_draw_bop_options_warn Drawing warning shapes
8487 **bdrawwarnshapes** command enables/disables drawing of waring shapes of BOP algorithms.
8491 bdrawwarnshapes 0 (do not draw) / 1 (draw warning shapes)
8494 The command is applicable for all commands in the component.
8497 @subsection occt_draw_bop_check Check commands
8499 The following commands are analyzing the given shape on the validity of Boolean operation.
8501 @subsubsection occt_draw_bop_check_1 bopcheck
8505 bopcheck shape [level of check: 0 - 9]
8508 It checks the given shape for self-interference. The optional level of check allows limiting the check to certain intersection types. Here are the types of interferences that will be checked for given level of check:
8511 * 2 - V/V, V/E and E/E;
8512 * 3 - V/V, V/E, E/E and V/F;
8513 * 4 - V/V, V/E, E/E, V/F and E/F;
8514 * 5 - V/V, V/E, E/E, V/F, E/F and F/F;
8515 * 6 - V/V, V/E, E/E, V/F, E/F, F/F and V/S;
8516 * 7 - V/V, V/E, E/E, V/F, E/F, F/F, V/S and E/S;
8517 * 8 - V/V, V/E, E/E, V/F, E/F, F/F, V/S, E/S and F/S;
8518 * 9 - V/V, V/E, E/E, V/F, E/F, F/F, V/S, E/S, F/S and S/S - all interferences (Default value)
8528 In this example one box is completely included into other box. So the output shows that all sub-shapes of b2 interfering with the solid b1.
8529 **bopcheck** command does not modifies the input shape, thus can be safely used.
8532 @subsubsection occt_draw_bop_check_2 bopargcheck
8534 **bopargcheck** syntax:
8536 bopargcheck Shape1 [[Shape2] [-F/O/C/T/S/U] [/R|F|T|V|E|I|P|C|S]] [#BF]
8538 -<Boolean Operation>
8545 For example: "bopargcheck s1 s2 -F" enables checking for Fuse operation
8549 R (disable small edges (shrank range) test)
8550 F (disable faces verification test)
8551 T (disable tangent faces searching test)
8552 V (disable test possibility to merge vertices)
8553 E (disable test possibility to merge edges)
8554 I (disable self-interference test)
8555 P (disable shape type test)
8556 C (disable test for shape continuity)
8557 S (disable curve on surface check)
8558 For example: "bopargcheck s1 s2 /RI" disables small edge detection and self-intersection detection
8559 default - all options are enabled
8561 #<Additional Test Options>
8562 B (stop test on first faulty found); default OFF
8563 F (full output for faulty shapes); default - output in a short format
8565 NOTE: <Boolean Operation> and <Test Options> are used only for couple of argument shapes, except I and P options that are always used for couple of shapes as well as for single shape test.
8568 As you can see *bopargcheck* performs more extended check of the given shapes than *bopcheck*.
8571 Let's make an edge with big vertices:
8583 Here is the output of this command:
8585 Made faulty shape: s1si_1
8586 Made faulty shape: s1se_1
8587 Faulties for FIRST shape found : 2
8588 ---------------------------------
8589 Shapes are not suppotrted by BOP: NO
8590 Self-Intersections : YES Cases(1) Total shapes(2)
8591 Check for SI has been aborted : NO
8592 Too small edges : YES Cases(1) Total shapes(1)
8594 Too close vertices : DISABLED
8595 Too close edges : DISABLED
8596 Shapes with Continuity C0 : NO
8597 Invalid Curve on Surface : NO
8599 Faulties for SECOND shape found : 0
8602 @subsection occt_draw_bop_debug Debug commands
8604 The following terms and definitions are used in this chapter:
8605 * **DS** -- internal data structure used by the algorithm (*BOPDS_DS* object).
8606 * **PaveFiller** -- intersection part of the algorithm (*BOPAlgo_PaveFiller* object).
8607 * **Builder** -- builder part of the algorithm (*BOPAlgo_Builder* object).
8608 * **IDS Index** -- the index of the vector *myLines*.
8610 @subsubsection occt_draw_bop_debug_int Intersection Part commands
8612 All commands listed below are available when the Intersection Part of the algorithm is done (i.e. after the command *bfillds*).
8622 * all BRep shapes of arguments that are in the DS [default];
8623 * <i>-v</i> : only vertices of arguments that are in the DS;
8624 * <i>-e</i> : only edges of arguments that are in the DS;
8625 * <i>-f</i> : only faces of arguments that are in the DS.
8629 Prints contents of the DS.
8635 Ranges:2 number of ranges
8636 range: 0 33 indices for range 1
8637 range: 34 67 indices for range 2
8638 Shapes:68 total number of source shapes
8640 1 : SHELL { 2 12 22 26 30 32 }
8641 2 : FACE { 4 5 6 7 8 9 10 11 }
8642 3 : WIRE { 4 7 9 11 }
8650 @code 0 : SOLID { 1 } @endcode has the following meaning:
8651 * *0* -- index in the DS;
8652 * *SOLID* -- type of the shape;
8653 * <i>{ 1 }</i> -- a DS index of the successors.
8662 Prints DS index of shape *S*.
8672 Prints pairs of DS indices of source shapes that are intersected in terms of bounding boxes.
8674 <i>[t1 t2]</i> are types of the shapes:
8681 Draw[104]> bopiterator 6 4
8690 * *bopiterator 6 4* prints pairs of indices for types: edge/face;
8691 * *z58 z12* -- DS indices of intersecting edge and face.
8701 Prints contents of *myInterfTB* for the type of interference *t*:
8702 * *t=0* : vertex/vertex;
8703 * *t=1* : vertex/edge;
8704 * *t=2* : edge/edge;
8705 * *t=3* : vertex/face;
8706 * *t=4* : edge/face.
8710 Draw[108]> bopinterf 4
8711 EF: (58, 12, 68), (17, 56, 69), (19, 64, 70), (45, 26, 71), (29, 36, 72), (38, 32, 73), 6 EF found.
8714 Here, record <i>(58, 12, 68)</i> means:
8715 * *58* -- a DS index of the edge;
8716 * *12* -- a DS index of the face;
8717 * *68* -- a DS index of the new vertex.
8722 Displays split edges.
8727 edge 58 : z58_74 z58_75
8728 edge 17 : z17_76 z17_77
8729 edge 19 : z19_78 z19_79
8730 edge 45 : z45_80 z45_81
8731 edge 29 : z29_82 z29_83
8732 edge 38 : z38_84 z38_85
8735 * *edge 58* -- 58 is a DS index of the original edge.
8736 * *z58_74 z58_75* -- split edges, where 74, 75 are DS indices of the split edges.
8745 Prints Common Blocks for:
8746 * all source edges (by default);
8747 * the source edge with the specified index *nE*.
8753 PB:{ E:71 orE:17 Pave1: { 68 3.000 } Pave2: { 18 10.000 } }
8757 This command dumps common blocks for the source edge with index 17.
8758 * *PB* -- information about the Pave Block;
8759 * *71* -- a DS index of the split edge
8760 * *17* -- a DS index of the original edge
8761 * <i>Pave1 : { 68 3.000 }</i> -- information about the Pave:
8762 * *68* -- a DS index of the vertex of the pave
8763 * *3.000* -- a parameter of vertex 68 on edge 17
8764 * *Faces: 36* -- 36 is a DS index of the face the common block belongs to.
8773 Prints Face Info about IN-parts for the face with DS index *nF*.
8779 PB:{ E:71 orE:17 Pave1: { 68 3.000 } Pave2: { 18 10.000 } }
8780 PB:{ E:75 orE:19 Pave1: { 69 3.000 } Pave2: { 18 10.000 } }
8786 * <i>PB:{ E:71 orE:17 Pave1: { 68 3.000 } Pave2: { 18 10.000 } }</i> -- information about the Pave Block;
8787 * <i>vrts In ... 18 </i> -- a DS index of the vertex IN the face.
8795 Print Face Info about ON-parts for the face with DS index *nF*.
8801 PB:{ E:72 orE:38 Pave1: { 69 0.000 } Pave2: { 68 10.000 } }
8802 PB:{ E:76 orE:45 Pave1: { 69 0.000 } Pave2: { 71 10.000 } }
8803 PB:{ E:78 orE:43 Pave1: { 71 0.000 } Pave2: { 70 10.000 } }
8804 PB:{ E:74 orE:41 Pave1: { 68 0.000 } Pave2: { 70 10.000 } }
8809 * <i>PB:{ E:72 orE:38 Pave1: { 69 0.000 } Pave2: { 68 10.000 } }</i> -- information about the Pave Block;
8810 * <i>vrts On: ... 68 69 70 71</i> -- DS indices of the vertices ON the face.
8819 Prints the information about the shape with DS index *nF*.
8827 * *rank: 0* -- means that shape 5 results from the Argument with index 0.
8831 Draw[118]> bopwho 68
8834 FF curves: (12, 56),
8835 FF curves: (12, 64),
8838 This means that shape 68 is a result of the following interferences:
8839 * *EF: (58, 12)* -- edge 58 / face 12
8840 * *FF curves: (12, 56)* -- edge from the intersection curve between faces 12 and 56
8841 * *FF curves: (12, 64)* -- edge from the intersection curve between faces 12 and 64
8850 * <i>-v</i> -- displays all new vertices produced during the operation;
8851 * <i>-e</i> -- displays all new edges produced during the operation.
8853 @subsubsection occt_draw_bop_debug_build Building Part commands
8855 The commands listed below are available when the Building Part of the algorithm is done (i.e. after the command *bbuild*).
8863 Shows the compound of shapes that are images of shape *S* from the argument.
8866 @section occt_draw_8 Data Exchange commands
8868 This chapter presents some general information about Data Exchange (DE) operations.
8870 DE commands are intended for translation files of various formats (IGES,STEP) into OCCT shapes with their attributes (colors, layers etc.)
8872 This files include a number of entities. Each entity has its own number in the file which we call label and denote as # for a STEP file and D for an IGES file. Each file has entities called roots (one or more). A full description of such entities is contained in the Users' Guides
8873 * for <a href="user_guides__step.html#occt_step_1">STEP format</a> and
8874 * for <a href="user_guides__iges.html#occt_iges_1">IGES format</a>.
8876 Each Draw session has an interface model, which is a structure for keeping various information.
8878 The first step of translation is loading information from a file into a model.
8879 The second step is creation of an OpenCASCADE shape from this model.
8881 Each entity from a file has its own number in the model (num). During the translation a map of correspondences between labels(from file) and numbers (from model) is created.
8883 The model and the map are used for working with most of DE commands.
8885 @subsection occt_draw_8_1 IGES commands
8887 @subsubsection occt_draw_8_1_1 igesread
8891 igesread <file_name> <result_shape_name> [<selection>]
8894 Reads an IGES file to an OCCT shape. This command will interactively ask the user to select a set of entities to be converted.
8897 | N | Mode | Description |
8898 | :-- | :-- | :---------- |
8899 | 0 | End | finish conversion and exit igesbrep |
8900 | 1 | Visible roots | convert only visible roots |
8901 | 2 | All roots | convert all roots |
8902 | 3 | One entity | convert entity with number provided by the user |
8903 | 4 | Selection | convert only entities contained in selection |
8906 After the selected set of entities is loaded the user will be asked how loaded entities should be converted into OCCT shapes (e.g., one shape per root or one shape for all the entities). It is also possible to save loaded shapes in files, and to cancel loading.
8908 The second parameter of this command defines the name of the loaded shape. If several shapes are created, they will get indexed names. For instance, if the last parameter was *s*, they will be *s_1, ... s_N*.
8910 <i>\<selection\></i> specifies the scope of selected entities in the model, by default it is *xst-transferrable-roots*. If we use symbol <i>*</i> as <i>\<selection\></i> all roots will be translated.
8912 See also the detailed description of <a href="user_guides__iges.html#occt_iges_2_3_4">Selecting IGES entities</a>.
8916 # translation all roots from file
8917 igesread /disk01/files/model.igs a *
8920 @subsubsection occt_draw_8_1_2 tplosttrim
8924 tplosttrim [<IGES_type>]
8927 Sometimes the trimming contours of IGES faces (i.e., entity 141 for 143, 142 for 144) can be lost during translation due to fails. This command gives us a number of lost trims and the number of corresponding IGES entities.
8928 It outputs the rank and numbers of faces that lost their trims and their numbers for each type (143, 144, 510) and their total number. If a face lost several of its trims it is output only once.
8929 Optional parameter <i>\<IGES_type\></i> can be *0TrimmedSurface, BoundedSurface* or *Face* to specify the only type of IGES faces.
8933 tplosttrim TrimmedSurface
8936 @subsubsection occt_draw_8_1_3 brepiges
8940 brepiges <shape_name> <filename.igs>
8943 Writes an OCCT shape to an IGES file.
8947 # write shape with name aa to IGES file
8948 brepiges aa /disk1/tmp/aaa.igs
8949 == unit (write) : MM
8950 == mode write : Faces
8951 == To modifiy : command param
8952 == 1 Shapes written, giving 345 Entities
8953 == Now, to write a file, command : writeall filename
8954 == Output on file : /disk1/tmp/aaa.igs
8958 @subsection occt_draw_8_2 STEP commands
8960 These commands are used during the translation of STEP models.
8963 @subsubsection occt_draw_8_2_1 stepread
8967 stepread file_name result_shape_name [selection]
8970 Read a STEP file to an OCCT shape.
8971 This command will interactively ask the user to select a set of entities to be converted:
8973 | N | Mode | Description |
8974 | :---- | :---- | :---- |
8975 | 0 | End | Finish transfer and exit stepread |
8976 | 1 | root with rank 1 | Transfer first root |
8977 | 2 | root by its rank | Transfer root specified by its rank |
8978 | 3 | One entity | Transfer entity with a number provided by the user |
8979 | 4 | Selection | Transfer only entities contained in selection |
8981 After the selected set of entities is loaded the user will be asked how loaded entities should be converted into OCCT shapes.
8982 The second parameter of this command defines the name of the loaded shape. If several shapes are created, they will get indexed names. For instance, if the last parameter was *s*, they will be *s_1, ... s_N*.
8983 <i>\<selection\></i> specifies the scope of selected entities in the model. If we use symbol <i>*</i> as <i>\<selection\></i> all roots will be translated.
8985 See also the detailed description of <a href="user_guides__step.html#occt_step_2_3_6">Selecting STEP entities</a>.
8989 # translation all roots from file
8990 stepread /disk01/files/model.stp a *
8993 @subsubsection occt_draw_8_2_2 stepwrite
8997 stepwrite mode shape_name file_name
9000 Writes an OCCT shape to a STEP file.
9002 The following modes are available :
9003 * *a* -- as is -- the mode is selected automatically depending on the type & geometry of the shape;
9004 * *m* -- *manifold_solid_brep* or *brep_with_voids*
9005 * *f* -- *faceted_brep*
9006 * *w* -- *geometric_curve_set*
9007 * *s* -- *shell_based_surface_model*
9009 For further information see <a href="#user_guides__step.html#occt_step_6_5">Writing a STEP file</a>.
9013 Let us write shape *a* to a STEP file in mode *0*.
9016 stepwrite 0 a /disk1/tmp/aaa.igs
9020 @subsection occt_draw_8_3 General commands
9022 These are auxilary commands used for the analysis of result of translation of IGES and STEP files.
9024 @subsubsection occt_draw_8_3_1 count
9028 count <counter> [<selection>]
9031 Calculates statistics on the entities in the model and outputs a count of entities.
9033 The optional selection argument, if specified, defines a subset of entities, which are to be taken into account. The first argument should be one of the currently defined counters.
9035 | Counter | Operation |
9036 | :-------- | :-------- |
9037 | xst-types | Calculates how many entities of each OCCT type exist |
9038 | step214-types | Calculates how many entities of each STEP type exist |
9045 @subsubsection occt_draw_8_3_2 data
9052 Obtains general statistics on the loaded data.
9053 The information printed by this command depends on the symbol specified.
9057 # print full information about warnings and fails
9062 | :------ | :------ |
9063 | g | Prints the information contained in the header of the file |
9064 | c or f | Prints messages generated during the loading of the STEP file (when the procedure of the integrity of the loaded data check is performed) and the resulting statistics (f works only with fail messages while c with both fail and warning messages) |
9065 | t | The same as c or f, with a list of failed or warned entities |
9066 | m or l | The same as t but also prints a status for each entity |
9067 | e | Lists all entities of the model with their numbers, types, validity status etc. |
9068 | R | The same as e but lists only root entities |
9072 @subsubsection occt_draw_8_3_3 elabel
9079 Entities in the IGES and STEP files are numbered in the succeeding order. An entity can be identified either by its number or by its label. Label is the letter ‘#'(for STEP, for IGES use ‘D’) followed by the rank. This command gives us a label for an entity with a known number.
9086 @subsubsection occt_draw_8_3_4 entity
9090 entity <#(D)>_or_<num> <level_of_information>
9093 The content of an IGES or STEP entity can be obtained by using this command.
9094 Entity can be determined by its number or label.
9095 <i>\<level_of_information\></i> has range [0-6]. You can get more information about this level using this command without parameters.
9099 # full information for STEP entity with label 84
9103 @subsubsection occt_draw_8_3_5 enum
9110 Prints a number for the entity with a given label.
9114 # give a number for IGES entity with label 21
9118 @subsubsection occt_draw_8_3_6 estatus
9122 estatus <#(D)>_or_<num>
9125 The list of entities referenced by a given entity and the list of entities referencing to it can be obtained by this command.
9132 @subsubsection occt_draw_8_3_7 fromshape
9136 fromshape <shape_name>
9139 Gives the number of an IGES or STEP entity corresponding to an OCCT shape. If no corresponding entity can be found and if OCCT shape is a compound the command explodes it to subshapes and try to find corresponding entities for them.
9146 @subsubsection occt_draw_8_3_8 givecount
9150 givecount <selection_name> [<selection_name>]
9154 Prints a number of loaded entities defined by the selection argument.
9155 Possible values of \<selection_name\> you can find in the “IGES FORMAT Users’s Guide”.
9159 givecount xst-model-roots
9162 @subsubsection occt_draw_8_3_9 givelist
9166 givelist <selection_name>
9169 Prints a list of a subset of loaded entities defined by the selection argument:
9170 | Selection | Description |
9171 | :-------- | :----------- |
9172 | xst-model-all | all entities of the model |
9173 | xst-model-roots | all roots |
9174 | xst-pointed | (Interactively) pointed entities (not used in DRAW) |
9175 | xst-transferrable-all | all transferable (recognized) entities |
9176 | xst-transferrable-roots | Transferable roots |
9181 # give a list of all entities of the model
9182 givelist xst-model-all
9185 @subsubsection occt_draw_8_3_10 listcount
9187 Syntax: listcount \<counter\> [\<selection\> ...]
9189 Prints a list of entities per each type matching the criteria defined by arguments.
9190 Optional <i>\<selection\></i> argument, if specified, defines a subset of entities, which are to be taken into account. Argument <i>\<counter\></i> should be one of the currently defined counters:
9192 | Counter | Operation |
9193 | :----- | :------ |
9194 | xst-types | Calculates how many entities of each OCCT type exist |
9195 | iges-types | Calculates how many entities of each IGES type and form exist |
9196 | iges-levels | Calculates how many entities lie in different IGES levels |
9203 @subsubsection occt_draw_8_3_11 listitems
9210 This command prints a list of objects (counters, selections etc.) defined in the current session.
9213 @subsubsection occt_draw_8_3_12 listtypes
9217 listtypes [<selection_name> ...]
9220 Gives a list of entity types which were encountered in the last loaded file (with a number of entities of each type). The list can be shown not for all entities but for a subset of them. This subset is defined by an optional selection argument.
9223 @subsubsection occt_draw_8_3_13 newmodel
9230 Clears the current model.
9233 @subsubsection occt_draw_8_3_14 param
9237 param [<parameter>] [<value>]
9240 This command is used to manage translation parameters.
9241 Command without arguments gives a full list of parameters with current values.
9242 Command with <i>\<parameter\></i> (without <i><value></i>) gives us the current value of this parameter and all possible values for it. Command with <i><value></i> sets this new value to <i>\<parameter\></i>.
9246 Let us get the information about possible schemes for writing STEP file :
9249 param write.step.schema
9252 @subsubsection occt_draw_8_3_15 sumcount
9256 sumcount <counter> [<selection> ...]
9259 Prints only a number of entities per each type matching the criteria defined by arguments.
9266 @subsubsection occt_draw_8_3_16 tpclear
9273 Clears the map of correspondences between IGES or STEP entities and OCCT shapes.
9277 @subsubsection occt_draw_8_3_17 tpdraw
9281 tpdraw <#(D)>_or_<num>
9289 @subsubsection occt_draw_8_3_18 tpent
9293 tpent <#(D)>_or_<num>
9296 Get information about the result of translation of the given IGES or STEP entity.
9303 @subsubsection occt_draw_8_3_19 tpstat
9307 tpstat [*|?]<symbol> [<selection>]
9311 Provides all statistics on the last transfer, including a list of transferred entities with mapping from IGES or STEP to OCCT types, as well as fail and warning messages. The parameter <i>\<symbol\></i> defines what information will be printed:
9313 * *g* -- General statistics (a list of results and messages)
9314 * *c* -- Count of all warning and fail messages
9315 * *C* -- List of all warning and fail messages
9316 * *f* -- Count of all fail messages
9317 * *F* -- List of all fail messages
9318 * *n* -- List of all transferred roots
9319 * *s* -- The same, with types of source entity and the type of result
9320 * *b* -- The same, with messages
9321 * *t* -- Count of roots for geometrical types
9322 * *r* -- Count of roots for topological types
9323 * *l* -- The same, with the type of the source entity
9325 The sign \* before parameters *n, s, b, t, r* makes it work on all entities (not only on roots).
9327 The sign ? before *n, s, b, t* limits the scope of information to invalid entities.
9329 Optional argument \<selection\> can limit the action of the command to the selection, not to all entities.
9331 To get help, run this command without arguments.
9335 # translation ratio on IGES faces
9336 tpstat *l iges-faces
9339 @subsubsection occt_draw_8_3_20 xload
9346 This command loads an IGES or STEP file into memory (i.e. to fill the model with data from the file) without creation of an OCCT shape.
9350 xload /disk1/tmp/aaa.stp
9354 @subsection occt_draw_8_4 Overview of XDE commands
9356 These commands are used for translation of IGES and STEP files into an XCAF document (special document is inherited from CAF document and is intended for Extended Data Exchange (XDE) ) and working with it. XDE translation allows reading and writing of shapes with additional attributes -- colors, layers etc. All commands can be divided into the following groups:
9357 * XDE translation commands
9358 * XDE general commands
9359 * XDE shape’s commands
9360 * XDE color’s commands
9361 * XDE layer’s commands
9362 * XDE property’s commands
9364 Reminding: All operations of translation are performed with parameters managed by command @ref occt_draw_8_3_14 "param".
9366 @subsubsection occt_draw_8_4_1 ReadIges
9370 ReadIges document file_name
9373 Reads information from an IGES file to an XCAF document.
9377 ReadIges D /disk1/tmp/aaa.igs
9378 ==> Document saved with name D
9381 @subsubsection occt_draw_8_4_2 ReadStep
9385 ReadStep <document> <file_name>
9388 Reads information from a STEP file to an XCAF document.
9392 ReadStep D /disk1/tmp/aaa.stp
9393 == Document saved with name D
9396 @subsubsection occt_draw_8_4_3 WriteIges
9400 WriteIges <document> <file_name>
9405 WriteIges D /disk1/tmp/aaa.igs
9408 @subsubsection occt_draw_8_4_4 WriteStep
9412 WriteStep <document> <file_name>
9415 Writes information from an XCAF document to a STEP file.
9419 WriteStep D /disk1/tmp/aaa.stp
9422 @subsubsection occt_draw_8_4_5 XFileCur
9429 Returns the name of file which is set as the current one in the Draw session.
9437 @subsubsection occt_draw_8_4_6 XFileList
9444 Returns a list all files that were transferred by the last transfer. This command is meant (assigned) for the assemble step file.
9449 ==> *as1-ct-Bolt.stp*
9450 ==> *as1-ct-L-Bracktet.stp*
9451 ==> *as1-ct-LBA.stp*
9452 ==> *as1-ct-NBA.stp*
9456 @subsubsection occt_draw_8_4_7 XFileSet
9463 Sets the current file taking it from the components list of the assemble file.
9467 XFileSet as1-ct-NBA.stp
9470 @subsubsection occt_draw_8_4_8 XFromShape
9477 This command is similar to the command @ref occt_draw_8_3_7 "fromshape", but gives additional information about the file name. It is useful if a shape was translated from several files.
9482 ==> Shape a: imported from entity 217:#26 in file as1-ct-Nut.stp
9485 @subsection occt_draw_8_5 XDE general commands
9487 @subsubsection occt_draw_8_5_1 XNewDoc
9494 Creates a new XCAF document.
9501 @subsubsection occt_draw_8_5_2 XShow
9505 XShow <document> [ <label1> … ]
9508 Shows a shape from a given label in the 3D viewer. If the label is not given -- shows all shapes from the document.
9512 # show shape from label 0:1:1:4 from document D
9516 @subsubsection occt_draw_8_5_3 XStat
9523 Prints common information from an XCAF document.
9528 ==>Statistis of shapes in the document:
9532 ==>Total number of labels for shapes in the document = 32
9533 ==>Number of labels with name = 27
9534 ==>Number of labels with color link = 3
9535 ==Number of labels with layer link = 0
9536 ==>Statistis of Props in the document:
9537 ==>Number of Centroid Props = 5
9538 ==>Number of Volume Props = 5
9539 ==>Number of Area Props = 5
9540 ==>Number of colors = 4
9541 ==>BLUE1 RED YELLOW BLUE2
9542 ==>Number of layers = 0
9545 @subsubsection occt_draw_8_5_4 XWdump
9549 XWdump <document> <filename>
9552 Saves the contents of the viewer window as an image (XWD, png or BMP file).
9553 <i>\<filename\></i> must have a corresponding extention.
9557 XWdump D /disk1/tmp/image.png
9560 @subsubsection occt_draw_8_5_5 Xdump
9564 Xdump <document> [int deep {0|1}]
9567 Prints information about the tree structure of the document. If parameter 1 is given, then the tree is printed with a link to shapes.
9572 ==> ASSEMBLY 0:1:1:1 L-BRACKET(0xe8180448)
9573 ==> ASSEMBLY 0:1:1:2 NUT(0xe82151e8)
9574 ==> ASSEMBLY 0:1:1:3 BOLT(0xe829b000)
9575 ==> ASSEMBLY 0:1:1:4 PLATE(0xe8387780)
9576 ==> ASSEMBLY 0:1:1:5 ROD(0xe8475418)
9577 ==> ASSEMBLY 0:1:1:6 AS1(0xe8476968)
9578 ==> ASSEMBLY 0:1:1:7 L-BRACKET-ASSEMBLY(0xe8476230)
9579 ==> ASSEMBLY 0:1:1:1 L-BRACKET(0xe8180448)
9580 ==> ASSEMBLY 0:1:1:8 NUT-BOLT-ASSEMBLY(0xe8475ec0)
9581 ==> ASSEMBLY 0:1:1:2 NUT(0xe82151e8)
9582 ==> ASSEMBLY 0:1:1:3 BOLT(0xe829b000)
9586 @subsection occt_draw_8_6 XDE shape commands
9588 @subsubsection occt_draw_8_6_1 XAddComponent
9592 XAddComponent <document> <label> <shape>
9595 Adds a component shape to assembly.
9599 Let us add shape b as component shape to assembly shape from label *0:1:1:1*
9602 XAddComponent D 0:1:1:1 b
9605 @subsubsection occt_draw_8_6_2 XAddShape
9609 XAddShape <document> <shape> [makeassembly=1]
9612 Adds a shape (or an assembly) to a document. If this shape already exists in the document, then prints the label which points to it. By default, a new shape is added as an assembly (i.e. last parameter 1), otherwise it is necessary to pass 0 as the last parameter.
9616 # add shape b to document D
9619 # if pointed shape is compound and last parameter in
9620 # XAddShape command is used by default (1), then for
9621 # each subshapes new label is created
9624 @subsubsection occt_draw_8_6_3 XFindComponent
9628 XFindComponent <document> <shape>
9631 Prints a sequence of labels of the assembly path.
9638 @subsubsection occt_draw_8_6_4 XFindShape
9642 XFindShape <document> <shape>
9645 Finds and prints a label with an indicated top-level shape.
9652 @subsubsection occt_draw_8_6_5 XGetFreeShapes
9656 XGetFreeShapes <document> [shape_prefix]
9659 Print labels or create DRAW shapes for all free shapes in the document.
9660 If *shape_prefix* is absent -- prints labels, else -- creates DRAW shapes with names
9661 <i>shape_prefix</i>_num (i.e. for example: there are 3 free shapes and *shape_prefix* = a therefore shapes will be created with names a_1, a_2 and a_3).
9663 **Note**: a free shape is a shape to which no other shape refers to.
9668 == 0:1:1:6 0:1:1:10 0:1:1:12 0:1:1:13
9671 == sh_1 sh_2 sh_3 sh_4
9674 @subsubsection occt_draw_8_6_6 XGetOneShape
9678 XGetOneShape <shape> <document>
9681 Creates one DRAW shape for all free shapes from a document.
9688 @subsubsection occt_draw_8_6_7 XGetReferredShape
9692 XGetReferredShape <document> <label>
9695 Prints a label that contains a top-level shape that corresponds to a shape at a given label.
9699 XGetReferredShape D 0:1:1:1:1
9702 @subsubsection occt_draw_8_6_8 XGetShape
9706 XGetShape <result> <document> <label>
9709 Puts a shape from the indicated label in document to result.
9713 XGetShape b D 0:1:1:3
9716 @subsubsection occt_draw_8_6_9 XGetTopLevelShapes
9720 XGetTopLevelShapes <document>
9723 Prints labels that contain top-level shapes.
9727 XGetTopLevelShapes D
9728 == 0:1:1:1 0:1:1:2 0:1:1:3 0:1:1:4 0:1:1:5 0:1:1:6 0:1:1:7
9732 @subsubsection occt_draw_8_6_10 XLabelInfo
9736 XLabelInfo <document> <label>
9739 Prints information about a shape, stored at an indicated label.
9743 XLabelInfo D 0:1:1:6
9744 ==> There are TopLevel shapes. There is an Assembly. This Shape is not used.
9747 @subsubsection occt_draw_8_6_11 XNewShape
9751 XNewShape <document>
9754 Creates a new empty top-level shape.
9761 @subsubsection occt_draw_8_6_12 XRemoveComponent
9765 XRemoveComponent <document> <label>
9768 Removes a component from the components label.
9772 XRemoveComponent D 0:1:1:1:1
9775 @subsubsection occt_draw_8_6_13 XRemoveShape
9779 XRemoveShape <document> <label>
9782 Removes a shape from a document (by it’s label).
9786 XRemoveShape D 0:1:1:2
9789 @subsubsection occt_draw_8_6_14 XSetShape
9793 XSetShape <document> <label> <shape>
9796 Sets a shape at the indicated label.
9800 XSetShape D 0:1:1:3 b
9803 @subsubsection occt_draw_8_6_15 XUpdateAssemblies
9807 XUpdateAssemblies <document>
9810 Updates all assembly compounds in the XDE document.
9817 @subsection occt_draw_8_7_ XDE color commands
9819 @subsubsection occt_draw_8_7_1 XAddColor
9823 XAddColor <document> <R> <G> <B>
9826 Adds color in document to the color table. Parameters R,G,B are real.
9830 XAddColor D 0.5 0.25 0.25
9833 @subsubsection occt_draw_8_7_2 XFindColor
9837 XFindColor <document> <R> <G> <B>
9840 Finds a label where the indicated color is situated.
9844 XFindColor D 0.25 0.25 0.5
9848 @subsubsection occt_draw_8_7_3 XGetAllColors
9852 XGetAllColors <document>
9855 Prints all colors that are defined in the document.
9860 ==> RED DARKORANGE BLUE1 GREEN YELLOW3
9863 @subsubsection occt_draw_8_7_4 XGetColor
9867 XGetColor <document> <label>
9870 Returns a color defined at the indicated label from the color table.
9878 @subsubsection occt_draw_8_7_5 XGetObjVisibility
9882 XGetObjVisibility <document> {<label>|<shape>}
9885 Returns the visibility of a shape.
9889 XGetObjVisibility D 0:1:1:4
9892 @subsubsection occt_draw_8_7_6 XGetShapeColor
9896 XGetShapeColor <document> <label> <colortype(s|c)>
9899 Returns the color defined by label. If <i>colortype</i>=’s’ -- returns surface color, else -- returns curve color.
9903 XGetShapeColor D 0:1:1:4 c
9906 @subsubsection occt_draw_8_7_7 XRemoveColor
9910 XRemoveColor <document> <label>
9913 Removes a color from the color table in a document.
9917 XRemoveColor D 0:1:2:1
9920 @subsubsection occt_draw_8_7_8 XSetColor
9924 XSetColor <document> {<label>|<shape>} <R> <G> <B>
9927 Sets an RGB color to a shape given by label.
9931 XsetColor D 0:1:1:4 0.5 0.5 0.
9934 @subsubsection occt_draw_8_7_9 XSetObjVisibility
9938 XSetObjVisibility <document> {<label>|<shape>} {0|1}
9941 Sets the visibility of a shape.
9945 # set shape from label 0:1:1:4 as invisible
9946 XSetObjVisibility D 0:1:1:4 0
9949 @subsubsection occt_draw_8_7_10 XUnsetColor
9953 XUnsetColor <document> {<label>|<shape>} <colortype>
9956 Unset a color given type (‘s’ or ‘c’) for the indicated shape.
9960 XUnsetColor D 0:1:1:4 s
9964 @subsection occt_draw_8_8_ XDE layer commands
9966 @subsubsection occt_draw_8_8_1 XAddLayer
9970 XAddLayer <document> <layer>
9973 Adds a new layer in an XCAF document.
9980 @subsubsection occt_draw_8_8_2 XFindLayer
9984 XFindLayer <document> <layer>
9987 Prints a label where a layer is situated.
9995 @subsubsection occt_draw_8_8_3 XGetAllLayers
9999 XGetAllLayers <document>
10002 Prints all layers in an XCAF document.
10007 == *0:1:1:3* *Bolt* *0:1:1:9*
10010 @subsubsection occt_draw_8_8_4 XGetLayers
10014 XGetLayers <document> {<shape>|<label>}
10017 Returns names of layers, which are pointed to by links of an indicated shape.
10021 XGetLayers D 0:1:1:3
10025 @subsubsection occt_draw_8_8_5 XGetOneLayer
10029 XGetOneLayer <document> <label>
10032 Prints the name of a layer at a given label.
10036 XGetOneLayer D 0:1:3:2
10039 @subsubsection occt_draw_8_8_6 XIsVisible
10043 XIsVisible <document> {<label>|<layer>}
10046 Returns 1 if the indicated layer is visible, else returns 0.
10050 XIsVisible D 0:1:3:1
10053 @subsubsection occt_draw_8_8_7 XRemoveAllLayers
10057 XRemoveAllLayers <document>
10060 Removes all layers from an XCAF document.
10067 @subsubsection occt_draw_8_8_8 XRemoveLayer
10071 XRemoveLayer <document> {<label>|<layer>}
10074 Removes the indicated layer from an XCAF document.
10078 XRemoveLayer D layer2
10081 @subsubsection occt_draw_8_8_9 XSetLayer
10085 XSetLayer XSetLayer <document> {<shape>|<label>} <layer> [shape_in_one_layer {0|1}]
10089 Sets a reference between a shape and a layer (adds a layer if it is necessary).
10090 Parameter <i>\<shape_in_one_layer\></i> shows whether a shape could be in a number of layers or only in one (0 by default).
10094 XSetLayer D 0:1:1:2 layer2
10097 @subsubsection occt_draw_8_8_10 XSetVisibility
10101 XSetVisibility <document> {<label>|<layer>} <isvisible {0|1}>
10104 Sets the visibility of a layer.
10108 # set layer at label 0:1:3:2 as invisible
10109 XSetVisibility D 0:1:3:2 0
10112 @subsubsection occt_draw_8_8_11 XUnSetAllLayers
10116 XUnSetAllLayers <document> {<label>|<shape>}
10119 Unsets a shape from all layers.
10123 XUnSetAllLayers D 0:1:1:2
10126 @subsubsection occt_draw_8_8_12 XUnSetLayer
10130 XUnSetLayer <document> {<label>|<shape>} <layer>
10133 Unsets a shape from the indicated layer.
10137 XUnSetLayer D 0:1:1:2 layer1
10140 @subsection occt_draw_8_9 XDE property commands
10142 @subsubsection occt_draw_8_9_1 XCheckProps
10146 XCheckProps <document> [ {0|deflection} [<shape>|<label>] ]
10149 Gets properties for a given shape (*volume*, *area* and <i>centroid</i>) and compares them with the results after internal calculations. If the second parameter is 0, the standard OCCT tool is used for the computation of properties. If the second parameter is not 0, it is processed as a deflection. If the deflection is positive the computation is done by triangulations, if it is negative -- meshing is forced.
10153 # check properties for shapes at label 0:1:1:1 from
10154 # document using standard Open CASCADE Technology tools
10155 XCheckProps D 0 0:1:1:1
10156 == Label 0:1:1:1 ;L-BRACKET*
10157 == Area defect: -0.0 ( 0%)
10158 == Volume defect: 0.0 ( 0%)
10159 == CG defect: dX=-0.000, dY=0.000, dZ=0.000
10162 @subsubsection occt_draw_8_9_2 XGetArea
10166 XGetArea <document> {<shape>|<label>}
10169 Returns the area of a given shape.
10174 == 24628.31815094999
10177 @subsubsection occt_draw_8_9_3 XGetCentroid
10181 XGetCentroid <document> {<shape>|<label>}
10184 Returns the center of gravity coordinates of a given shape.
10188 XGetCentroid D 0:1:1:1
10191 @subsubsection occt_draw_8_9_4 XGetVolume
10195 XGetVolume <document> {<shape>|<label>}
10198 Returns the volume of a given shape.
10202 XGetVolume D 0:1:1:1
10205 @subsubsection occt_draw_8_9_5 XSetArea
10209 XSetArea <document> {<shape>|<label>} <area>
10212 Sets new area to attribute list ??? given shape.
10216 XSetArea D 0:1:1:1 2233.99
10219 @subsubsection occt_draw_8_9_6 XSetCentroid
10223 XSetCentroid <document> {<shape>|<label>} <x> <y> <z>
10226 Sets new center of gravity to the attribute list given shape.
10230 XSetCentroid D 0:1:1:1 0. 0. 100.
10233 @subsubsection occt_draw_8_9_7 XSetMaterial
10237 XSetMaterial <document> {<shape>|<label>} <name> <density(g/cu sm)>
10240 Adds a new label with material into the material table in a document, and adds a link to this material to the attribute list of a given shape or a given label. The last parameter sets the density of a pointed material.
10244 XSetMaterial D 0:1:1:1 Titanium 8899.77
10247 @subsubsection occt_draw_8_9_8 XSetVolume
10251 XSetVolume <document> {<shape>|<label>} <volume>
10254 Sets new volume to the attribute list ??? given shape.
10258 XSetVolume D 0:1:1:1 444555.33
10261 @subsubsection occt_draw_8_9_9 XShapeMassProps
10265 XShapeMassProps <document> [ <deflection> [{<shape>|<label>}] ]
10268 Computes and returns real mass and real center of gravity for a given shape or for all shapes in a document. The second parameter is used for calculation of the volume and CG(center of gravity). If it is 0, then the standard CASCADE tool (geometry) is used for computation, otherwise -- by triangulations with a given deflection.
10273 == Shape from label : 0:1:1:1
10274 == Mass = 193.71681469282299
10275 == CenterOfGravity X = 14.594564763807696,Y =
10276 20.20271885211281,Z = 49.999999385313245
10277 == Shape from label : 0:1:1:2 not have a mass
10281 @subsubsection occt_draw_8_9_10 XShapeVolume
10285 XShapeVolume <shape> <deflection>
10288 Calculates the real volume of a pointed shape with a given deflection.
10295 @section occt_draw_9 Shape Healing commands
10299 @subsection occt_draw_9_1 General commands
10301 @subsubsection occt_draw_9_1_1 bsplres
10305 bsplres <result> <shape> <tol3d> <tol2d< <reqdegree> <reqnbsegments> <continuity3d> <continuity2d> <PriorDeg> <RationalConvert>
10308 Performs approximations of a given shape (BSpline curves and surfaces or other surfaces) to BSpline with given required parameters. The specified continuity can be reduced if the approximation with a specified continuity was not done successfully. Results are put into the shape, which is given as a parameter result. For a more detailed description see the ShapeHealing User’s Guide (operator: **BSplineRestriction**).
10310 @subsubsection occt_draw_9_1_2 checkfclass2d
10314 checkfclass2d <face> <ucoord> <vcoord>
10317 Shows where a point which is given by coordinates is located in relation to a given face -- outbound, inside or at the bounds.
10321 checkfclass2d f 10.5 1.1
10325 @subsubsection occt_draw_9_1_3 checkoverlapedges
10329 checkoverlapedges <edge1> <edge2> [<toler> <domaindist>]
10332 Checks the overlapping of two given edges. If the distance between two edges is less than the given value of tolerance then edges are overlapped. Parameter \<domaindist\> sets length of part of edges on which edges are overlapped.
10336 checkoverlapedges e1 e2
10339 @subsubsection occt_draw_9_1_4 comtol
10343 comptol <shape> [nbpoints] [prefix]
10346 Compares the real value of tolerance on curves with the value calculated by standard (using 23 points). The maximal value of deviation of 3d curve from pcurve at given simple points is taken as a real value (371 is by default). Command returns the maximal, minimal and average value of tolerance for all edges and difference between real values and set values. Edges with the maximal value of tolerance and relation will be saved if the ‘prefix’ parameter is given.
10352 ==> Edges tolerance computed by 871 points:
10353 ==> MAX=8.0001130696523449e-008 AVG=6.349346868091096e-009 MIN=0
10354 ==> Relation real tolerance / tolerance set in edge
10355 ==> MAX=0.80001130696523448 AVG=0.06349345591805905 MIN=0
10356 ==> Edge with max tolerance saved to t_edge_tol
10357 ==> Concerned faces saved to shapes t_1, t_2
10360 @subsubsection occt_draw_9_1_5 convtorevol
10364 convtorevol <result> <shape>
10367 Converts all elementary surfaces of a given shape into surfaces of revolution.
10368 Results are put into the shape, which is given as the <i>\<result\></i> parameter.
10375 @subsubsection occt_draw_9_1_6 directfaces
10379 directfaces <result> <shape>
10382 Converts indirect surfaces and returns the results into the shape, which is given as the result parameter.
10389 @subsubsection occt_draw_9_1_7 expshape
10393 expshape <shape> <maxdegree> <maxseg>
10396 Gives statistics for a given shape. This test command is working with Bezier and BSpline entities.
10401 ==> Number of Rational Bspline curves 128
10402 ==> Number of Rational Bspline pcurves 48
10405 @subsubsection occt_draw_9_1_8 fixsmall
10409 fixsmall <result> <shape> [<toler>=1.]
10412 Fixes small edges in given shape by merging adjacent edges with agiven tolerance. Results are put into the shape, which is given as the result parameter.
10419 @subsubsection occt_draw_9_1_9 fixsmalledges
10423 fixsmalledges <result> <shape> [<toler> <mode> <maxangle>]
10426 Searches at least one small edge at a given shape. If such edges have been found, then small edges are merged with a given tolerance. If parameter <i>\<mode\></i> is equal to *Standard_True* (can be given any values, except 2), then small edges, which can not be merged, are removed, otherwise they are to be kept (*Standard_False* is used by default). Parameter <i>\<maxangle\></i> sets a maximum possible angle for merging two adjacent edges, by default no limit angle is applied (-1). Results are put into the shape, which is given as parameter result.
10430 fixsmalledges r a 0.1 1
10433 @subsubsection occt_draw_9_1_10 fixshape
10437 fixshape <result> <shape> [<preci> [<maxpreci>]] [{switches}]
10440 Performs fixes of all sub-shapes (such as *Solids*, *Shells*, *Faces*, *Wires* and *Edges*) of a given shape. Parameter <i>\<preci\></i> sets a basic precision value, <i>\<maxpreci\></i> sets the maximal allowed tolerance. Results are put into the shape, which is given as parameter result. <b>{switches}</b> allows to tune parameters of ShapeFix
10442 The following syntax is used:
10443 * <i>\<symbol\></i> may be
10444 * "-" to set parameter off,
10446 * "*" to set default
10447 * <i>\<parameter\></i> is identified by letters:
10448 * l -- FixLackingMode
10449 * o -- FixOrientationMode
10450 * h -- FixShiftedMode
10451 * m -- FixMissingSeamMode
10452 * d -- FixDegeneratedMode
10453 * s -- FixSmallMode
10454 * i -- FixSelfIntersectionMode
10455 * n -- FixNotchedEdgesMode
10456 For enhanced message output, use switch '+?'
10463 @subsubsection occt_draw_9_1_11 fixwgaps
10467 fixwgaps <result> <shape> [<toler>=0]
10470 Fixes gaps between ends of curves of adjacent edges (both 3d and pcurves) in wires in a given shape with a given tolerance. Results are put into the shape, which is given as parameter result.
10477 @subsubsection occt_draw_9_1_12 offsetcurve, offset2dcurve
10481 offsetcurve <result> <curve> <offset> <direction(as point)>
10482 offset2dcurve <result> <curve> <offset>
10485 **offsetcurve** works with the curve in 3d space, **offset2dcurve** in 2d space.
10487 Both commands are intended to create a new offset curve by copying the given curve to distance, given by parameter <i>\<offset\></i>. Parameter <i>\<direction\></i> defines direction of the offset curve. It is created as a point. For correct work of these commands the direction of normal of the offset curve must be perpendicular to the plane, the basis curve is located there. Results are put into the curve, which is given as parameter <i>\<result\></i>.
10492 offsetcurve r c 20 pp
10495 @subsubsection occt_draw_9_1_13 projcurve
10499 projcurve <edge>|<curve3d>|<curve3d first last> <X> <Y> <Z>
10502 **projcurve** returns the projection of a given point on a given curve. The curve may be defined by three ways: by giving the edge name, giving the 3D curve and by giving the unlimited curve and limiting it by pointing its start and finish values.
10506 projcurve k_1 0 1 5
10507 ==Edge k_1 Params from 0 to 1.3
10508 ==Precision (BRepBuilderAPI) : 9.9999999999999995e-008 ==Projection : 0 1 5
10509 ==Result : 0 1.1000000000000001 0
10510 ==Param = -0.20000000000000001 Gap = 5.0009999000199947
10513 @subsubsection occt_draw_9_1_14 projpcurve
10517 projpcurve <edge> <face> <Tol> <X> <Y> <Z> [<start_param>]
10520 **projpcurve** returns the projection of a given point on a given curve on surface. The curve on surface is defined by giving the edge and face names. Edge must have curve 2D repesentation on the face. Optional parameter <i>\<start_param\></i> is any parameter of pcurve, which is used by algoritm as start point for searching projection of given point with help of local Extrema algorithm. If this parameter is not set, algorithm uses whole parametric interval of pcurve for searching projection.
10525 # Using global searching
10526 projpcurve f_1 f 1.e-7 0.877 0 0.479
10527 ==Point: 0.87762772831890712 0 0.47934285275342808
10528 ==Param: 0.49990578239977856
10529 ==Dist: 0.0007152557954264938
10533 # Using starting parameter on edge
10534 projpcurve f_1 f 1.e-7 0.877 0 0.479 .6
10535 ==Point: 0.87762772831890712 0 0.47934285275342808
10536 ==Param: 0.49990578239977856
10537 ==Dist: 0.0007152557954264938
10540 @subsubsection occt_draw_9_1_15 projface
10544 projface <face> <X> <Y> [<Z>]
10547 Returns the projection of a given point to a given face in 2d or 3d space. If two coordinates (2d space) are given then returns coordinates projection of this point in 3d space and vice versa.
10551 projface a_1 10.0 0.0
10552 == Point UV U = 10 V = 0
10553 == = proj X = -116 Y = -45 Z = 0
10556 @subsubsection occt_draw_9_1_16 scaleshape
10560 scaleshape <result> <shape> <scale>
10563 Returns a new shape, which is the result of scaling of a given shape with a coefficient equal to the parameter <i>\<scale\></i>. Tolerance is calculated for the new shape as well.
10567 scaleshape r a_1 0.8
10570 @subsubsection occt_draw_9_1_17 settolerance
10574 settolerance <shape> [<mode>=v-e-w-f-a] <val>(fix value) or
10578 Sets new values of tolerance for a given shape. If the second parameter <i>mode</i> is given, then the tolerance value is set only for these sub shapes.
10582 settolerance a 0.001
10585 @subsubsection occt_draw_9_1_18 splitface
10589 splitface <result> <face> [u usplit1 usplit2...] [v vsplit1 vsplit2 ...]
10592 Splits a given face in parametric space and puts the result into the given parameter <i>\<result\></i>.
10593 Returns the status of split face.
10597 # split face f by parameter u = 5
10599 ==> Splitting by U: ,5
10603 @subsubsection occt_draw_9_1_19 statshape
10607 statshape <shape> [particul]
10610 Returns the number of sub-shapes, which compose the given shape. For example, the number of solids, number of faces etc. It also returns the number of geometrical objects or sub-shapes with a specified type, example, number of free faces, number of C0
10611 surfaces. The last parameter becomes out of date.
10618 ==> 402 Edge (oriented)
10619 ==> 402 Edge (Shared)
10622 ==> 804 Vertex (Oriented)
10623 ==> 402 Vertex (Shared)
10625 ==> 4 Face with more than one wire
10626 ==> 34 bspsur: BSplineSurface
10629 @subsubsection occt_draw_9_1_20 tolerance
10633 tolerance <shape> [<mode>:D v e f c] [<tolmin> <tolmax>:real]
10636 Returns tolerance (maximal, avg and minimal values) of all given shapes and tolerance of their *Faces*, *Edges* and *Vertices*. If parameter <i>\<tolmin\></i> or <i>\<tolmax\></i> or both of them are given, then sub-shapes are returned as a result of analys of this shape, which satisfy the given tolerances. If a particular value of entity ((**D**)all shapes (**v**) *vertices* (**e**) *edges* (**f**) *faces* (**c**) *combined* (*faces*)) is given as the second parameter then only this group will be analyzed for tolerance.
10641 ==> Tolerance MAX=0.31512672416608001 AVG=0.14901359484722074 MIN=9.9999999999999995e-08
10642 ==> FACE : MAX=9.9999999999999995e-08 AVG=9.9999999999999995e-08 MIN=9.9999999999999995e-08
10643 ==> EDGE : MAX=0.31512672416608001 AVG=0.098691334511810405 MIN=9.9999999999999995e-08
10644 ==> VERTEX : MAX=0.31512672416608001 AVG=0.189076074499648 MIN=9.9999999999999995e-08
10646 tolerance a v 0.1 0.001
10647 ==> Analysing Vertices gives 6 Shapes between tol1=0.10000000000000001 and tol2=0.001 , named tol_1 to tol_6
10651 @subsection occt_draw_9_2 Conversion commands
10653 @subsubsection occt_draw_9_2_1 DT_ClosedSplit
10657 DT_ClosedSplit <result> <shape>
10660 Divides all closed faces in the shape (for example cone) and returns result of given shape into shape, which is given as parameter result. Number of faces in resulting shapes will be increased.
10661 Note: A closed face is a face with one or more seam.
10668 @subsubsection occt_draw_9_2_2 DT_ShapeConvert, DT_ShapeConvertRev
10672 DT_ShapeConvert <result> <shape> <convert2d> <convert3d>
10673 DT_ShapeConvertRev <result> <shape> <convert2d> <convert3d>
10676 Both commands are intended for the conversion of 3D, 2D curves to Bezier curves and surfaces to Bezier based surfaces. Parameters convert2d and convert3d take on a value 0 or 1. If the given value is 1, then the conversion will be performed, otherwise it will not be performed. The results are put into the shape, which is given as parameter Result. Command *DT_ShapeConvertRev* differs from *DT_ShapeConvert* by converting all elementary surfaces into surfaces of revolution first.
10680 DT_ShapeConvert r a 1 1
10684 @subsubsection occt_draw_9_2_3 DT_ShapeDivide
10688 DT_ShapeDivide <result> <shape> <tol>
10691 Divides the shape with C1 criterion and returns the result of geometry conversion of a given shape into the shape, which is given as parameter result. This command illustrates how class *ShapeUpgrade_ShapeDivideContinuity* works. This class allows to convert geometry with a continuity less than the specified continuity to geometry with target continuity. If conversion is not possible then the geometrical object is split into several ones, which satisfy the given tolerance. It also returns the status shape splitting:
10692 * OK : no splitting was done
10693 * Done1 : Some edges were split
10694 * Done2 : Surface was split
10695 * Fail1 : Some errors occurred
10699 DT_ShapeDivide r a 0.001
10703 @subsubsection occt_draw_9_2_4 DT_SplitAngle
10707 DT_SplitAngle <result> <shape> [MaxAngle=95]
10710 Works with all revolved surfaces, like cylinders, surfaces of revolution, etc. This command divides given revolved surfaces into segments so that each resulting segment covers not more than the given *MaxAngle* degrees and puts the result of splitting into the shape, which is given as parameter result. Values of returned status are given above.
10711 This command illustrates how class *ShapeUpgrade_ShapeDivideAngle* works.
10719 @subsubsection occt_draw_9_2_5 DT_SplitCurve
10723 DT_SplitCurve <curve> <tol> <split(0|1)>
10726 Divides the 3d curve with C1 criterion and returns the result of splitting of the given curve into a new curve. If the curve had been divided by segments, then each segment is put to an individual result. This command can correct a given curve at a knot with the given tolerance, if it is impossible, then the given surface is split at that knot. If the last parameter is 1, then 5 knots are added at the given curve, and its surface is split by segments, but this will be performed not for all parametric spaces.
10733 @subsubsection occt_draw_9_2_6 DT_SplitCurve2d
10737 DT_SplitCurve2d Curve Tol Split(0/1)
10740 Works just as **DT_SplitCurve** (see above), only with 2d curve.
10744 DT_SplitCurve2d r c
10747 @subsubsection occt_draw_9_2_7 DT_SplitSurface
10751 DT_SplitSurface <result> <Surface|GridSurf> <tol> <split(0|1)>
10754 Divides surface with C1 criterion and returns the result of splitting of a given surface into surface, which is given as parameter result. If the surface has been divided into segments, then each segment is put to an individual result. This command can correct a given C0 surface at a knot with a given tolerance, if it is impossible, then the given surface is split at that knot. If the last parameter is 1, then 5 knots are added to the given surface, and its surface is split by segments, but this will be performed not for all parametric spaces.
10760 # split surface with name "su"
10761 DT_SplitSurface res su 0.1 1
10763 ==> appel a SplitSurface::Init
10764 ==> appel a SplitSurface::Build
10765 ==> appel a SplitSurface::GlobalU/VKnots
10766 ==> nb GlobalU;nb GlobalV=7 2 0 1 2 3 4 5 6.2831853072 0 1
10767 ==> appel a Surfaces
10768 ==> transfert resultat
10769 ==> res1_1_1 res1_2_1 res1_3_1 res1_4_1 res1_5_1 res1_6_1
10773 @subsubsection occt_draw_9_2_8 DT_ToBspl
10777 DT_ToBspl <result> <shape>
10780 Converts a surface of linear extrusion, revolution and offset surfaces into BSpline surfaces. Returns the result into the shape, which is given as parameter result.
10785 == error = 5.20375663162094e-08 spans = 10
10786 == Surface is aproximated with continuity 2
10789 @section occt_draw_10 Performance evaluation commands
10792 @subsection occt_draw_10_1 VDrawSphere
10796 vdrawsphere shapeName Fineness [X=0.0 Y=0.0 Z=0.0] [Radius=100.0] [ToEnableVBO=1] [NumberOfViewerUpdate=1] [ToShowEdges=0]
10799 Calculates and displays in a given number of steps a sphere with given coordinates, radius and fineness. Returns the information about the properties of the sphere, the time and the amount of memory required to build it.
10801 This command can be used for visualization performance evaluation instead of the outdated Visualization Performance Meter.
10805 vdrawsphere s 200 1 1 1 500 1
10806 == Compute Triangulation...
10807 == NumberOfPoints: 39602
10808 == NumberOfTriangles: 79200
10809 == Amount of memory required for PolyTriangulation without Normals: 2 Mb
10810 == Amount of memory for colors: 0 Mb
10811 == Amount of memory for PolyConnect: 1 Mb
10812 == Amount of graphic card memory required: 2 Mb
10813 == Number of scene redrawings: 1
10814 == CPU user time: 15.6000999999998950 msec
10815 == CPU system time: 0.0000000000000000 msec
10816 == CPU average time of scene redrawing: 15.6000999999998950 msec
10820 @section occt_draw_12 Simple vector algebra and measurements
10822 This section contains description of auxiliary commands that can be useful for simple calculations and manipulations needed when analyzing complex models.
10824 @subsection occt_draw_12_1 Vector algebra commands
10826 This section describes commands providing simple calculations with 2D and 3D vectors. The vector is represented by a TCL list of double values (coordinates). The commands get input vector coordinates from the command line as distinct values. So, if you have a vector stored in a variable you need to use *eval* command as a prefix, for example, to compute the magnitude of cross products of two vectors given by 3 points the following commands can be used:
10828 Draw[10]> set vec1 [vec 12 28 99 12 58 99]
10830 Draw[13]> set vec2 [vec 12 28 99 16 21 89]
10832 Draw[14]> set cross [eval cross $vec1 $vec2]
10834 Draw[15]> eval module $cross
10838 @subsubsection occt_draw_12_1_1 vec
10842 vec <x1> <y1> <z1> <x2> <y2> <z2>
10845 Returns coordinates of vector between two 3D points.
10852 @subsubsection occt_draw_12_1_2 2dvec
10856 2dvec <x1> <y1> <x2> <y2>
10859 Returns coordinates of vector between two 2D points.
10866 @subsubsection occt_draw_12_1_3 pln
10870 pln <x1> <y1> <z1> <x2> <y2> <z2> <x3> <y3> <z3>
10873 Returns plane built on three points. A plane is represented by 6 double values: coordinates of the origin point and the normal directoin.
10877 pln 1 2 3 6 5 4 9 8 7
10880 @subsubsection occt_draw_12_1_4 module
10887 Returns module of a vector.
10894 @subsubsection occt_draw_12_1_5 2dmodule
10901 Returns module of a 2D vector.
10908 @subsubsection occt_draw_12_1_6 norm
10915 Returns unified vector from a given 3D vector.
10922 @subsubsection occt_draw_12_1_7 2dnorm
10929 Returns unified vector from a given 2D vector.
10936 @subsubsection occt_draw_12_1_8 inverse
10940 inverse <x> <y> <z>
10943 Returns inversed 3D vector.
10950 @subsubsection occt_draw_12_1_9 2dinverse
10957 Returns inversed 2D vector.
10964 @subsubsection occt_draw_12_1_10 2dort
10971 Returns 2D vector rotated on 90 degrees.
10978 @subsubsection occt_draw_12_1_11 distpp
10982 distpp <x1> <y1> <z1> <x2> <y2> <z2>
10985 Returns distance between two 3D points.
10992 @subsubsection occt_draw_12_1_12 2ddistpp
10996 2ddistpp <x1> <y1> <x2> <y2>
10999 Returns distance between two 2D points.
11006 @subsubsection occt_draw_12_1_13 distplp
11010 distplp <x0> <y0> <z0> <nx> <ny> <nz> <xp> <yp> <zp>
11013 Returns distance between plane defined by point and normal direction and another point.
11017 distplp 0 0 0 0 0 1 5 6 7
11020 @subsubsection occt_draw_12_1_14 distlp
11024 distlp <x0> <y0> <z0> <dx> <dy> <dz> <xp> <yp> <zp>
11027 Returns distance between 3D line defined by point and direction and another point.
11031 distlp 0 0 0 1 0 0 5 6 7
11034 @subsubsection occt_draw_12_1_15 2ddistlp
11038 2ddistlp <x0> <y0> <dx> <dy> <xp> <yp>
11041 Returns distance between 2D line defined by point and direction and another point.
11045 2ddistlp 0 0 1 0 5 6
11048 @subsubsection occt_draw_12_1_16 distppp
11052 distppp <x1> <y1> <z1> <x2> <y2> <z2> <x3> <y3> <z3>
11055 Returns deviation of point (x2,y2,z2) from segment defined by points (x1,y1,z1) and (x3,y3,z3).
11059 distppp 0 0 0 1 1 0 2 0 0
11062 @subsubsection occt_draw_12_1_17 2ddistppp
11066 2ddistppp <x1> <y1> <x2> <y2> <x3> <y3>
11069 Returns deviation of point (x2,y2) from segment defined by points (x1,y1) and (x3,y3). The result is a signed value. It is positive if the point (x2,y2) is on the left side of the segment, and negative otherwise.
11073 2ddistppp 0 0 1 -1 2 0
11076 @subsubsection occt_draw_12_1_18 barycen
11080 barycen <x1> <y1> <z1> <x2> <y2> <z2> <par>
11083 Returns point of a given parameter between two 3D points.
11087 barycen 0 0 0 1 1 1 0.3
11090 @subsubsection occt_draw_12_1_19 2dbarycen
11094 2dbarycen <x1> <y1> <x2> <y2> <par>
11097 Returns point of a given parameter between two 2D points.
11101 2dbarycen 0 0 1 1 0.3
11104 @subsubsection occt_draw_12_1_20 cross
11108 cross <x1> <y1> <z1> <x2> <y2> <z2>
11111 Returns cross product of two 3D vectors.
11118 @subsubsection occt_draw_12_1_21 2dcross
11122 2dcross <x1> <y1> <x2> <y2>
11125 Returns cross product of two 2D vectors.
11132 @subsubsection occt_draw_12_1_22 dot
11136 dot <x1> <y1> <z1> <x2> <y2> <z2>
11139 Returns scalar product of two 3D vectors.
11146 @subsubsection occt_draw_12_1_23 2ddot
11150 2ddot <x1> <y1> <x2> <y2>
11153 Returns scalar product of two 2D vectors.
11160 @subsubsection occt_draw_12_1_24 scale
11164 scale <x> <y> <z> <factor>
11167 Returns 3D vector multiplied by scalar.
11174 @subsubsection occt_draw_12_1_25 2dscale
11178 2dscale <x> <y> <factor>
11181 Returns 2D vector multiplied by scalar.
11188 @subsection occt_draw_12_2 Measurements commands
11190 This section describes commands that make possible to provide measurements on a model.
11192 @subsubsection occt_draw_12_2_1 pnt
11199 Returns coordinates of point in the given Draw variable. Object can be of type point or vertex. Actually this command is built up from the commands @ref occt_draw_7_2_1a "mkpoint" and @ref occt_draw_6_6_1 "coord".
11207 @subsubsection occt_draw_12_2_2 pntc
11214 Returns coordinates of point on 3D curve with given parameter. Actually this command is based on the command @ref occt_draw_6_6_2 "cvalue".
11222 @subsubsection occt_draw_12_2_3 2dpntc
11226 2dpntc <curv2d> <par>
11229 Returns coordinates of point on 2D curve with given parameter. Actually this command is based on the command @ref occt_draw_6_6_2 "2dcvalue".
11234 2dpntc c [dval pi/2]
11237 @subsubsection occt_draw_12_2_4 pntsu
11241 pntsu <surf> <u> <v>
11244 Returns coordinates of point on surface with given parameters. Actually this command is based on the command @ref occt_draw_6_6_3 "svalue".
11249 pntsu s [dval pi/2] 5
11252 @subsubsection occt_draw_12_2_5 pntcons
11256 pntcons <curv2d> <surf> <par>
11259 Returns coordinates of point on surface defined by point on 2D curve with given parameter. Actually this command is based on the commands @ref occt_draw_6_6_2 "2dcvalue" and @ref occt_draw_6_6_3 "svalue".
11265 pntcons c s [dval pi/2]
11268 @subsubsection occt_draw_12_2_6 drseg
11272 drseg <name> <x1> <y1> <z1> <x2> <y2> <z2>
11275 Creates a linear segment between two 3D points. The new object is given the *name*. The object is drawn in the axonometric view.
11279 drseg s 0 0 0 1 0 0
11282 @subsubsection occt_draw_12_2_7 2ddrseg
11286 2ddrseg <name> <x1> <y1> <x2> <y2>
11289 Creates a linear segment between two 2D points. The new object is given the *name*. The object is drawn in the 2D view.
11296 @subsubsection occt_draw_12_2_8 mpick
11303 Prints in the console the coordinates of a point clicked by mouse in a view (axonometric or 2D). This command will wait for mouse click event in a view.
11310 @subsubsection occt_draw_12_2_9 mdist
11317 Prints in the console the distance between two points clicked by mouse in a view (axonometric or 2D). This command will wait for two mouse click events in a view.
11324 @section occt_draw_13 Inspector commands
11327 This section describes commands that make possible to use Inspector.
11329 @subsection occt_draw_13_1 tinspector
11333 tinspector [-plugins {name1 ... [nameN] | all}]
11335 [-shape object [name1] ... [nameN]]
11336 [-open file_name [name1] ... [nameN]]
11338 [-select {object | name1 ... [nameN]}]
11341 Starts inspection tool.
11343 * *plugins* enters plugins that should be added in the inspector.
11344 Available names are: *dfbrowser*, *vinspector* and *shapeview*.
11345 Plugins order will be the same as defined in the arguments.
11346 'all' adds all available plugins in the order:
11347 DFBrowser, VInspector and ShapeView.
11348 If at the first call this option is not used, 'all' option is applied;
11349 * *activate* activates the plugin in the tool view.
11350 If at the first call this option is not used, the first plugin is activated;
11351 * *shape* initializes plugin(s) by the shape object. If 'name' is empty, initializes all plugins;
11352 * *open* gives the file to the plugin(s). If the plugin is active after open, the content will be updated;
11353 * *update* updates content of the active plugin;
11354 * *select* sets the parameter that should be selected in an active tool view.
11355 Depending on the active tool the parameter is:
11356 ShapeView: 'object' is an instance of *TopoDS_Shape TShape*,
11357 DFBrowser: 'name' is an entry of *TDF_Label* and 'name2' (optionally) for *TDF_Attribute* type name,
11358 VInspector: 'object' is an instance of *AIS_InteractiveObject*;
11359 * *show* sets Inspector view visible or hidden. The first call of this command will show it.
11363 pload DCAF INSPECTOR
11365 NewDocument Doc BinOcaf
11369 SetInteger Doc ${aLabel} ${aSetAttr1}
11371 tinspector -plugins dfbrowser -select 0:2 TDataStd_Integer
11376 pload ALL INSPECTOR
11379 box b2 100 200 220 100 120 100
11381 tinspector -plugins shapeview -shape b1 -shape b2 -select b1
11386 pload ALL INSPECTOR
11388 tinspector -plugins vinspector
11391 box box_1 100 100 100
11394 box box_2 180 120 200 150 150 150
11401 tinspector -update -select box_1
11405 @section occt_draw_11 Extending Test Harness with custom commands
11408 The following chapters explain how to extend Test Harness with custom commands and how to activate them using a plug-in mechanism.
11411 @subsection occt_draw_11_1 Custom command implementation
11413 Custom command implementation has not undergone any changes since the introduction of the plug-in mechanism. The syntax of every command should still be like in the following example.
11417 static Standard_Integer myadvcurve(Draw_Interpretor& di, Standard_Integer n, char** a)
11423 For examples of existing commands refer to Open CASCADE Technology (e.g. GeomliteTest.cxx).
11426 @subsection occt_draw_11_2 Registration of commands in Test Harness
11428 To become available in the Test Harness the custom command must be registered in it. This should be done as follows.
11432 void MyPack::CurveCommands(Draw_Interpretor& theCommands)
11435 char* g = "Advanced curves creation";
11437 theCommands.Add ( "myadvcurve", "myadvcurve name p1 p2 p3 - Creates my advanced curve from points",
11438 __FILE__, myadvcurve, g );
11443 @subsection occt_draw_11_3 Creating a toolkit (library) as a plug-in
11445 All custom commands are compiled and linked into a dynamic library (.dll on Windows, or .so on Unix/Linux). To make Test Harness recognize it as a plug-in it must respect certain conventions. Namely, it must export function *PLUGINFACTORY()* accepting the Test Harness interpreter object (*Draw_Interpretor*). This function will be called when the library is dynamically loaded during the Test Harness session.
11447 This exported function *PLUGINFACTORY()* must be implemented only once per library.
11449 For convenience the *DPLUGIN* macro (defined in the *Draw_PluginMacro.hxx* file) has been provided. It implements the *PLUGINFACTORY()* function as a call to the *Package::Factory()* method and accepts *Package* as an argument. Respectively, this *Package::Factory()* method must be implemented in the library and activate all implemented commands.
11453 #include <Draw_PluginMacro.hxx>
11455 void MyPack::Factory(Draw_Interpretor& theDI)
11459 MyPack::CurveCommands(theDI);
11463 // Declare entry point PLUGINFACTORY
11467 @subsection occt_draw_11_4 Creation of the plug-in resource file
11469 As mentioned above, the plug-in resource file must be compliant with Open CASCADE Technology requirements (see *Resource_Manager.hxx* file for details). In particular, it should contain keys separated from their values by a colon (;:;).
11470 For every created plug-in there must be a key. For better readability and comprehension it is recommended to have some meaningful name.
11471 Thus, the resource file must contain a line mapping this name (key) to the library name. The latter should be without file extension (.dll on Windows, .so on Unix/Linux) and without the ;lib; prefix on Unix/Linux.
11472 For several plug-ins one resource file can be created. In such case, keys denoting plug-ins can be combined into groups, these groups -- into their groups and so on (thereby creating some hierarchy). Any new parent key must have its value as a sequence of child keys separated by spaces, tabs or commas. Keys should form a tree without cyclic dependencies.
11474 **Examples** (file MyDrawPlugin):
11476 ! Hierarchy of plug-ins
11477 ALL : ADVMODELING, MESHING
11479 ADVMODELING : ADVSURF, ADVCURV
11481 ! Mapping from naming to toolkits (libraries)
11482 ADVSURF : TKMyAdvSurf
11483 ADVCURV : TKMyAdvCurv
11487 For other examples of the plug-in resource file refer to the @ref occt_draw_1_3_2 "Plug-in resource file" chapter above or to the <i>$CASROOT/src/DrawPlugin</i> file shipped with Open CASCADE Technology.
11490 @subsection occt_draw_11_5 Dynamic loading and activation
11492 Loading a plug-in and activating its commands is described in the @ref occt_draw_1_3_3 "Activation of the commands implemented in the plug-in" chapter.
11494 The procedure consists in defining the system variables and using the *pload* commands in the Test Harness session.
11498 Draw[]> set env(CSF_MyDrawPluginDefaults) /users/test
11499 Draw[]> pload -MyDrawPlugin ALL