Create drawings from models (Creo Elements/Direct Annotation) > Advanced topics > Customization for advanced users > Geometry functions
  
Geometry functions
You can customize the following areas of Creo Elements/Direct Annotation relating to geometry:
The AM_UNDELETE_SETTINGS function
The SHOW_OWNER_FLAGS-UNDERGROUND_COLOR function
The DOCU-SET-PEN-AND-LINE-SIZE-MODE function
The AM_UNDELETE_SETTINGS function
The AM_UNDELETE_SETTINGS function can be used to set the default behavior of the Delete and Undelete commands. For example, deleted items are only hidden from the drawing by default, but you can change this setting so that elements are permanently deleted. Of course, any of the default selections can be changed when deleting and undeleting.
You can also change these defaults by entering AM_UNDELETE_SETTINGS in the user input line of Creo Elements/Direct Annotation. A menu appears in which you can change all the settings described below. To set the Delete and Undelete default selections automatically from start-up of Creo Elements/Direct Annotation, add the following function to the am_customize file or another customization file:
Syntax
(AM_UNDELETE_SETTINGS --+--> INIT_DEL_MANU option--------->+--->
                        |                            |
                        |--> DEL_PREVIOUS option---------->|
                        |                            |
                        |--> DEL_NOTHING option----------->|
                        |                            |
                        |--> DEL_ALL option--------------->|
                        |                            |
                        |--> 3D_HATCH_HANDLING option----->|
                        |                            |
                        |--> INIT_ACCESS_MODE option------>|
                        |                            |
                        |--> INIT_UND_MANU option--------->|
                        |                            |
                        |--> INIT_UND_CALC option--------->|
                        |                            |
                        |--> UNDEL_BACK_COLOR option------>|
                        |                            |
                        |--> UNDEL_CALC_COLOR option------>|
                        |                            |
                        |--> UNDEL_MANU_COLOR option------>|
                        |                            |
                        |--> UNDO_HIDE_COLOR option------->|
                        |                            |
                        |--> UNDO_FORW_COLOR option------->|
                        |                            |
                        |--> UNDO_BACK_COLOR option------->|
                        |                            |
                        |--> CANCEL_DELETE option--------->|
                        |                            |
                        |--> CANCEL_UNDELETE option------->|
                        |                            |
                        `--> DEPENDENCY option------------>'
INIT_DEL_MANU option
:INIT_DEL_MANU specifies whether or not manually-added elements should be available for selection during a Delete operation. The default is to enable selection of such elements (:ON).
Syntax
-->(:INIT_DEL_MANU)--+-->(:OFF)------->+-->
                     |                  ^                     
 `-->(:ON)-------->'
Suboptions
:OFF disables selection of manually-added elements.
:ON enables selection of manually-added elements.
Note that at least one of :INIT_DEL_MANU and :INIT_DEL_CALC must be set to :ON.
See also INIT_DEL_CALC option
INIT_DEL_CALC option
:INIT_DEL_CALC specifies whether or not calculated (view) geometry should be available for selection during a Delete operation. The default is to disable selection of calculated geometry (:OFF).
Syntax
-->(:INIT_DEL_CALC)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF disables selection of calculated geometry.
:ON enables selection of calculated geometry.
Note that at least one of :INIT_DEL_MANU and :INIT_DEL_CALC must be set to :ON.
See also INIT_DEL_MANU option
DEL_PREVIOUS option
:DEL_PREVIOUS specifies that the elements deleted in the current Delete operation should be permanently deleted, and not hidden. This is not the default selection (:DEL_NOTHING is).
Syntax
-->(:DEL_PREVIOUS)---->
Only one of :DEL_PREVIOUS, :DEL_NOTHING and :DEL_ALL can be set.
See also
DEL_NOTHING option
DEL_ALL option
DEL_NOTHING option
:DEL_NOTHING specifies that the elements deleted in the current Delete operation should be hidden, and not permanently deleted. This is the default selection.
Syntax
-->(:DEL_NOTHING)---->
Only one of :DEL_PREVIOUS, :DEL_NOTHING and :DEL_ALL can be set.
See also
DEL_PREVIOUS option
DEL_ALL option
DEL_ALL option
:DEL_ALL specifies that all elements in the Delete buffer should be permanently deleted, and not hidden. This is not the default selection (:DEL_NOTHING is).
Syntax
-->(:DEL_ALL)---->
Only one of :DEL_PREVIOUS, :DEL_NOTHING and :DEL_ALL can be set.
See also
DEL_NOTHING option
DEL_PREVIOUS option
3D_HATCH_HANDLING option
:3D_HATCH_HANDLING specifies whether automatically-generated hatching should be hidden or permanently removed when it is deleted. The default is to hide hatching so that it can be undeleted if necessary (:HIDE).
After an update, "deleted" hatching is automatically hidden or deleted again according to this setting. However, this only occurs when the outer and inner edge elements of the hatching have not changed completely.
Syntax
-->(:3D_HATCH_HANDLING)--+-->(:HIDE)------->+-->
| ^
`-->(:DELETE)----->'
Suboptions
:HIDE hides automatically-generated hatching.
:DELETE permanently deletes automatically-generated hatching.
INIT_ACCESS_MODE option
:INIT_ACCESS_MODE specifies whether the Undelete command should start in the Selected or Sequential mode. The default is to start in Selected mode (:SELECTED).
Syntax
-->(:INIT_ACCESS_MODE)--+-->(:SELECTED)------->+-->
| ^
`-->(:SEQUENTIAL)----->'
Suboptions
:SELECTED starts Undelete in the Selected mode.
:SEQUENTIAL starts Undelete in the Sequential mode.
INIT_UND_MANU option
:INIT_UND_MANU specifies whether or not manually-added elements should be available for selection during an Undelete operation in the Selected mode. The default is to enable selection of such elements (:ON).
Syntax
-->(:INIT_UND_MANU)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF disables selection of manually-added elements.
:ON enables selection of manually-added elements.
Note that at least one of :INIT_UND_MANU and :INIT_UND_CALC must be set to :ON.
See also INIT_UND_CALC option
INIT_UND_CALC option
:INIT_DEL_CALC specifies whether or not calculated (view) geometry should be available for selection during an Undelete operation in the Selected mode. The default is to enable selection of calculated geometry (:ON).
Syntax
-->(:INIT_UND_CALC)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF disables selection of calculated geometry.
:ON enables selection of calculated geometry.
Note that at least one of :INIT_UND_MANU and :INIT_UND_CALC must be set to :ON.
See also INIT_UND_MANU option
UNDEL_BACK_COLOR option
:UNDEL_BACK_COLOR determines the "dimmed" color of deleted objects during an undelete operation in both the Selected and Sequential modes. The default is grey.
Syntax
-->(:UNDEL_BACK_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_CALC_COLOR option
UNDEL_MANU_COLOR option
UNDO_HIDE_COLOR option
UNDO_FORW_COLOR option
UNDO_BACK_COLOR option
UNDEL_CALC_COLOR option
:UNDEL_CALC_COLOR determines the color of deleted calculated geometry during an undelete operation in the Selected mode. The default is orange.
Syntax
-->(:UNDEL_CALC_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_BACK_COLOR option
UNDEL_MANU_COLOR option
UNDEL_MANU_COLOR option
:UNDEL_MANU_COLOR determines the color of deleted manually-added elements during an undelete operation in the Selected mode. The default is blue.
Syntax
-->(:UNDEL_MANU_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_BACK_COLOR option
UNDEL_CALC_COLOR option
UNDO_HIDE_COLOR option
:UNDO_HIDE_COLOR determines the color of deleted elements during an undelete operation in the Sequential mode. This color is used to indicate all elements that can be undeleted. The default is yellow.
Syntax
-->(:UNDO_HIDE_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_BACK_COLOR option
UNDO_FORW_COLOR option
UNDO_BACK_COLOR option
UNDO_FORW_COLOR option
:UNDO_FORW_COLOR determines the color of deleted elements within the Forward sequence that will be re-deleted when you click Next. The number of elements highlighted in this color corresponds to the Forward value. This setting is relevant during an undelete operation in the Sequential mode. The default is red.
Syntax
-->(:UNDO_FORW_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_BACK_COLOR option
UNDO_HIDE_COLOR option
UNDO_BACK_COLOR option
UNDO_BACK_COLOR option
:UNDO_BACK_COLOR determines the color of deleted elements within the Backward sequence that will be undeleted when you click Next. The number of elements highlighted in this color corresponds to the Backward value. This setting is relevant during an undelete operation in the Sequential mode. The default is green.
Syntax
-->(:UNDO_BACK_COLOR)----->(:RGB n1,n2,n3)------>
Suboptions
You can enter an RGB color defined by three values.
See also
UNDEL_BACK_COLOR option
UNDO_HIDE_COLOR option
UNDO_FORW_COLOR option
CANCEL_DELETE option
:CANCEL_DELETE specifies whether or not a Delete operation needs to be confirmed by clicking OK. The default behavior is to cancel the Delete operation if OK is not clicked (:ON), but you can change this so that deletions are accepted immediately.
* 
When the "safety cancel" is disabled, clicking Cancel in the Delete menu will not undo that session's deletions. You will need to use Undelete to restore the deleted elements (as long as they remain in the Delete buffer).
Syntax
-->(:CANCEL_DELETE)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF specifies that deletions are effective as soon as they are made and will hold even when OK is not clicked (that is, when the Delete action is ended by starting another command).
:ON cancels the Delete operation when OK is not clicked.
See also
CANCEL_UNDELETE option
CANCEL_UNDELETE option
:CANCEL_UNDELETE specifies whether or not an Undelete operation needs to be confirmed by clicking OK. The default behavior is to cancel the Undelete operation if OK is not clicked (:ON), but you can change this so that restored elements are accepted immediately.
* 
When the "safety cancel" is disabled, clicking Cancel in the Undelete menu will not undo that session's undeletions. You will need to use Delete again to re-delete the restored elements.
Syntax
-->(:CANCEL_UNDELETE)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF specifies that undeletions are effective as soon as they are made and will hold even when OK is not clicked (that is, when the Undelete action is ended by starting another command).
:ON cancels the Undelete operation when OK is not clicked.
See also
CANCEL_DELETE option
DEPENDENCY option
:DEPENDENCY specifies whether or not Delete and Undelete act also upon those elements that "depend" on the element deleted or undeleted. The default behavior is to consider dependent elements when deleting and undeleting (:ON).
For example, with this switch on, deleting a line will also delete any dimensions, centerlines, and hatching attached to it. Likewise, undeleting a dimension, for example, will restore also the owning geometry referenced by the dimension.
Syntax
-->(:DEPENDENCY)--+-->(:OFF)------->+-->
| ^
`-->(:ON)-------->'
Suboptions
:OFF specifies that deletions and undeletions are taken individually; dependent elements are not affected.
:ON deletes and un-deletes also any elements dependent upon those selected.
The SHOW_OWNER_FLAGS-UNDERGROUND_COLOR function
When you use Hilight Owner, all elements not belonging to the owner in question are colored so that the owner's elements appear highlighted in their original colors. The SHOW_OWNER_FLAGS-UNDERGROUND_COLOR function can be used to set this "background" color. The default is gray.
Syntax
(SETQ (DOCU::SHOW_OWNER_FLAGS-UNDERGROUND_COLOR DOCU::*OWNER*) n1,n2,n3)
Options
You can enter an RGB color defined by three values.
The DOCU-SET-PEN-AND-LINE-SIZE-MODE function
The DOCU-SET-PEN-AND-LINE-SIZE-MODE function can be used to disable the line size or pensize options, or both, in Creo Elements/Direct Annotation settings menus. The disabled options are grayed out in the menus (such as those for geometry and reference line settings) and cannot be set by users. For example, you may want to disable the linesize setting so that all geometry is of absolute size and not affected by scaling.
To affect the line size and pensize functionality, add the following function to the am_customize file or another customization file:
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE --+--> BOTH option----------------->+--->
| ^
|--> PENSIZE_ONLY option--------->|
| |
|--> LINESIZE_ONLY option-------->|
| |
|--> PENSIZE_PREFERED option----->|
| |
|--> LINESIZE_PREFERED option---->|
| |
`--> NONE option----------------->'
BOTH option
:BOTH specifies that the pensize and line size options should both be available in the settings menus. This is the default Creo Elements/Direct Annotation behavior.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :BOTH)
PENSIZE_ONLY option
:PENSIZE_ONLY specifies that only the pensize option should be available in the settings menus. The line size setting is disabled.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :PENSIZE_ONLY)
LINESIZE_ONLY option
:LINESIZE_ONLY specifies that only the line size option should be available in the settings menus. The pensize setting is disabled.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :LINESIZE_ONLY)
PENSIZE_PREFERED option
:PENSIZE_PREFERED specifies that the line size option should be disabled in the settings menus whenever there is a pensize option.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :PENSIZE_PREFERED)
LINESIZE_PREFERED option
:LINESIZE_PREFERED specifies that the pensize option should be disabled in the settings menus whenever there is a line size option.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :LINESIZE_PREFERED)
NONE option
:NONE specifies that neither the pensize nor the line size option should be available in the settings menus; they are both disabled.
Syntax
(DOCU-SET-PEN-AND-LINE-SIZE-MODE :NONE)