[Integration Kit Contents] [Integration Kit What's New] [Integration Kit Function Index] [More Documentation] [PTC]

Miscellaneous Inquiries

Units:
sd-inq-length-units
sd-inq-angle-units
sd-inq-mass-units

Version:
sd-inq-version-string
sd-inq-version

Language:
sd-inq-current-language

Part Checks:
sd-inq-clashing-color
sd-set-clashing-color
sd-inq-touching-color
sd-set-touching-color

Redraw Mode:
sd-inq-dynamic-redraw-mode
sd-set-dynamic-redraw-mode

Geometry Mode:
sd-inq-geometry-mode

Modify 3d Defaults:
sd-inq-mod3d-body-check-mode
sd-inq-mod3d-blend-labels-mode
sd-inq-mod3d-blend-preview-color
sd-inq-mod3d-blend-suppress-color

Catch Settings:
sd-inq-catch-extent
sd-inq-catch-range
sd-inq-catch-type
sd-inq-catch-project
sd-inq-catch-wp
sd-inq-catch-wp-scope
sd-inq-catch-part

Error:
sd-inq-error-obj

Commands:
sd-inq-curr-cmds

Model Clip Planes:
sd-inq-model-clip-plane-defined-p
sd-inq-model-clip-plane-enabled-p
sd-inq-model-clip-plane-origin
sd-inq-model-clip-plane-u-dir
sd-inq-model-clip-plane-w-dir
sd-inq-model-clipping-mode

Function Index Top of Page

SD-INQ-LENGTH-UNITS  [function]

(sd-inq-length-units)
Description:
Returns the current user units settings for length.

Return value:
units {LIST} - formatted as '(type factor), where:
type {KEYWORD} - one of the following:
:um - Micron
:uinch - Microinch
:mm - Millimeter
:mils - Mil
:cm - Centimeter
:inch - Inch
:m - Meter
:foot - Foot
:km - Kilometer
:yard - Yard
:miles - Mile
factor {LONG-FLOAT} - the length units scale factor

See Also:
UNITS [terminate action]

Function Index Top of Page

SD-INQ-ANGLE-UNITS  [function]

(sd-inq-angle-units)
Description:
Returns the current user units settings for angle.

Return value:
units {LIST} - formtted as '(type factor), where:
type {KEYWORD} - one of the following:
:deg - Degree
:rad - Radian
:grd - Grad
factor {LONG-FLOAT} - the angle units scale factor

See Also:
UNITS [terminate action]

Function Index Top of Page

SD-INQ-MASS-UNITS  [function]

(sd-inq-mass-units)
Description:
Returns the current user units settings for mass.

Return value:
units {LIST} - formtted as '(type factor), where:
type {KEYWORD} - one of the following:
:mg - Milligram
:oz - Ounce
:g - Gram
:lb - Pound
:kg - Kilogram
:cwt - Short Cwt
:t - Metric Ton
:ton - Short Ton
factor {LONG-FLOAT} - the mass units scale factor

See Also:
UNITS [terminate action]

Function Index Top of Page

SD-INQ-VERSION-STRING  [function]

(sd-inq-version-string)
Description:
Returns the internal string containing the version number and date of Creo Elements/Direct Modeling.
For example: "SolidDesigner 18.0 03-Feb-2011"

Return value:
version-string {STRING}

Function Index Top of Page

SD-INQ-VERSION  [function]

(sd-inq-version &optional modulename)
Description:
Returns a property list with the internal string of a module and the internal string containing the version number, the date of the module and other useful information. Not every module has module specific version information and not every module returns all values listed below.

Parameters:
modulename {STRING ["SolidDesigner"]}
Optional name of module to get the version information of. If not given, information about the "Creo Elements/Direct Modeling" application is returned.

Return values:
property list {LIST}
  • :full-string {STRING} - full string of the module information
  • :version {STRING} - version number, including major and minor version numbers and patches
  • :version-number {STRING} - full version number including the internal build number
  • :product-name {STRING} - name of the product as mentioned in the user interface
  • :release-name {STRING} - release name of the product as mentioned in data sheets and product descriptions
  • :major {STRING} - major version number
  • :minor {STRING} - minor version number
  • :date {STRING} - date of the version, format DD-MMM-YYYY
  • :base-directory {STRING} - directory of the module
  • :filing-release-name {STRING} - release name of the current file version
  • :filing-major {STRING} - major version number of the current file version
  • :filing-minor {STRING} - minor version number of the current file version
nil
failure, module not activated or no version information available

Examples:
(sd-inq-version)
  => (:full-string "Creo Elements/Direct Modeling 20.3  4-Jan-2011"
      :product-name "Modeling"
      :release-name "20.3.5.0"
      :version "20.3"
      :version-number "20.0.0.434"
      :major "20"
      :minor "3"
      :date "4-Jan-2011"
      :base-directory "C:/Program Files/PTC/Creo Elements/Direct Modeling 20.3.5.0"
      :filing-release-name "20.3.5.0"
      :filing-major "20"
      :filing-minor "3")

(sd-inq-version "ANNOTATION")
  => (:full-string "CoCreate Annotation Release 18.0  3-Feb-2011 build 851 (851)"
      :version "18.0"
      :major "18"
      :minor "0"
      :date "3-Feb-2011"
      :build "851")

(sd-inq-version "ModelManager")
  => (:fullstring "Model Manager Rev. 18.0"
      :version "18.0"
      :major "18"
      :minor "0")

See Also:
sd-inq-version-string

Function Index Top of Page

SD-INQ-CURRENT-LANGUAGE  [function]

(sd-inq-current-language)
Description:
Returns one of the following keywords:

Return value:
language-keyword {KEYWORD}
The application's user interface language.
This language is set by the command line options of the shortcuts, or by the environment variables SDLANG or LANG.

Function Index Top of Page

SD-INQ-CLASHING-COLOR  [function]

(sd-inq-clashing-color)
Description:
Returns the color used by the CLASH_3D action to display part interferences.

Return value:
color {GPNT3D} - R,G,B color vector

See Also:
CLASH_3D [terminate action]

Function Index Top of Page

SD-SET-CLASHING-COLOR  [function]

(sd-set-clashing-color color)
Description:
Sets the color used by the CLASH_3D action to display part interferences.

Parameters:
color {GPNT3D} - R,G,B color vector

See Also:
CLASH_3D [terminate action]

Function Index Top of Page

SD-INQ-TOUCHING-COLOR  [function]

(sd-inq-touching-color)
Description:
Returns the color used by the CLASH_3D action to highlight surfaces where part faces touch.

Return value:
color {GPNT3D} - R,G,B color vector

See Also:
CLASH_3D [terminate action]

Function Index Top of Page

SD-SET-TOUCHING-COLOR  [function]

(sd-set-touching-color color)
Description:
Sets the color used by the CLASH_3D action to highlight surfaces where part faces touch.

Parameters:
color {GPNT3D} - R,G,B color vector

See Also:
CLASH_3D [terminate action]

Function Index Top of Page

SD-INQ-DYNAMIC-REDRAW-MODE  [function]

(sd-inq-dynamic-redraw-mode)
Description:
Returns the graphics display mode used to display parts while the viewport orientation is being dynamically modified (e.g. dynamic viewing using the knob box or mouse).

Return value:
mode {KEYWORD} - one of the following:
:default
:shaded
:edged
:wire

See Also:
sd-set-dynamic-redraw-mode [function]

Function Index Top of Page

SD-SET-DYNAMIC-REDRAW-MODE  [function]

(sd-set-dynamic-redraw-mode mode)
Description:
Sets the graphics display mode used to display parts while the viewport orientation is being dynamically modified (e.g. dynamic viewing using the knob box or mouse).

Parameters:
mode {KEYWORD} - one of the following:
:default - use current viewport display settings
:shaded - display shaded faces only
:edged - display highlighted edges only
:wire - display wireframe only

Return value:
t - success
nil - invalid mode keyword

See Also:

Function Index Top of Page

SD-INQ-GEOMETRY-MODE  [function]

(sd-inq-geometry-mode)
Description:
Returns the mode used for drawing 2d geometry, which is either construction lines or regular (real) lines.

Return value:
mode {KEYWORD} - one of the following:
:real - 2d geometry is drawn with real lines
:construction - 2d geometry is drawn with construction lines

See Also:
GEOMETRY_MODE [interrupt action]

Function Index Top of Page

SD-INQ-MOD3D-BODY-CHECK-MODE  [function]

(sd-inq-mod3d-body-check-mode)
Description:
Returns the mode setting that specifies whether or not a body check is performed automatically after a 3d modify operation.

Return value:
mode {KEYWORD} - one of the following:
:auto_bodycheck
:no_auto_bodycheck

See Also:
MODIFY_3D_DEFAULT [interrupt action]

Function Index Top of Page

SD-INQ-MOD3D-BLEND-LABELS-MODE  [function]

(sd-inq-mod3d-blend-labels-mode)
Description:
Returns the mode setting that specifies whether or not blend radius labels are displayed during a blend modification operation.

Return value:
mode {KEYWORD} - one of the following:
:no_auto_labelfdbk - blend labels are not displayed
:auto_labelfdbk - blend labels are displayed

See Also:
MODIFY_3D_DEFAULT [interrupt action]
MODIFY_BLENDS [terminate action]

Function Index Top of Page

SD-INQ-MOD3D-BLEND-PREVIEW-COLOR  [function]

(sd-inq-mod3d-blend-preview-color)
Description:
Returns the color used to display blends during blend preview.

Return value:
color {GPNT3D} - R,G,B color vector

See Also:
BLEND_PREVIEW_COLOR [interrupt action]

Function Index Top of Page

SD-INQ-MOD3D-BLEND-SUPPRESS-COLOR  [function]

(sd-inq-mod3d-blend-suppress-color)
Description:
Returns the color used to display affected blends during a blend modification command.

Return value:
color {GPNT3D} - R,G,B color vector

See Also:
BLEND_SUPPRESS_COLOR [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-EXTENT  [function]

(sd-inq-catch-extent)
Description:
Returns a keyword indicating the extent that subsequent catch settings will apply to, which can be either "Next Catch", "Default 2D", or "Default 3D" (refer to the catch menu).

Return value:
extent {KEYWORD} - one of the following:
:next-catch
:default-2d
:default-3d

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-RANGE  [function]

(sd-inq-catch-range)
Description:
Returns the catch range in pixels (the length of the cursor cross-hairs).

Return value:
range {FIXNUM} - the catch range (cursor size) in pixels

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-TYPE  [function]

(sd-inq-catch-type [catch-mode])
Description:
Returns the catch type setting for the specified (or default) catch mode.

The term catch mode refers to the complete group of catch settings to be used in a particular situation (e.g. 2d vs. 3d catching). The :default-2d and :default-3d catch modes correspond to the :default-2d and :default-3d catch extents (see sd-inq-catch-extent) respectively. However, the :current catch mode corresponds to whichever catch extent is currently set (either :next-catch, :default-2d, or :default-3d).

Parameters:
catch-mode {KEYWORD [:current]}
The catch mode that the type setting applies to, which must be one of the following:
:current
:default-2d
:default-3d

Return value:
type {KEYWORD} - one of the following:
:all
:vertex
:intersection
:grid
:edge
:face
:workplane
:center

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-PROJECT  [function]

(sd-inq-catch-project [catch-mode])
Description:
Returns the catch project mode setting for the specified (or default) catch mode.

The term catch mode refers to the complete group of catch settings to be used in a particular situation (e.g. 2d vs. 3d catching). The :default-2d and :default-3d catch modes correspond to the :default-2d and :default-3d catch extents (see sd-inq-catch-extent) respectively. However, the :current catch mode corresponds to whichever catch extent is currently set (either :next-catch, :default-2d, or :default-3d).

Parameters:
catch-mode {KEYWORD [:current]}
The catch mode that the project mode setting applies to, which must be one of the following:
:current
:default-2d
:default-3d

Return value:
mode {KEYWORD} - one of the following:
:project
:no_project

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-WP  [function]

(sd-inq-catch-wp [catch-mode])
Description:
Returns the catch workplane status setting for the specified (or default) catch mode.

The term catch mode refers to the complete group of catch settings to be used in a particular situation (e.g. 2d vs. 3d catching). The :default-2d and :default-3d catch modes correspond to the :default-2d and :default-3d catch extents (see sd-inq-catch-extent) respectively. However, the :current catch mode corresponds to whichever catch extent is currently set (either :next-catch, :default-2d, or :default-3d).

Parameters:
catch-mode {KEYWORD [:current]}
The catch mode that the workplane status setting applies to, which must be one of the following:
:current
:default-2d
:default-3d

Return value:
status {KEYWORD} - one of the following:
:on
:off

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-WP-SCOPE  [function]

(defun sd-inq-catch-wp-scope [catch-mode])
Description:
Returns the catch workplane scope setting for the specified (or default) catch mode.

The term catch mode refers to the complete group of catch settings to be used in a particular situation (e.g. 2d vs. 3d catching). The :default-2d and :default-3d catch modes correspond to the :default-2d and :default-3d catch extents (see sd-inq-catch-extent) respectively. However, the :current catch mode corresponds to whichever catch extent is currently set (either :next-catch, :default-2d, or :default-3d).

Parameters:
catch-mode {KEYWORD [:current]}
The catch mode that the workplane scope setting applies to, which must be one of the following:
:current
:default-2d
:default-3d

Return value:
scope {KEYWORD} - one of the following:
:wp_all
:wp_current

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-CATCH-PART  [function]

(sd-inq-catch-part [catch-mode])
Description:
Returns the catch part status setting for the specified (or default) catch mode.

The term catch mode refers to the complete group of catch settings to be used in a particular situation (e.g. 2d vs. 3d catching). The :default-2d and :default-3d catch modes correspond to the :default-2d and :default-3d catch extents (see sd-inq-catch-extent) respectively. However, the :current catch mode corresponds to whichever catch extent is currently set (either :next-catch, :default-2d, or :default-3d).

Parameters:
catch-mode {KEYWORD [:current]}
The catch mode that the part status setting applies to, which must be one of the following:
:current
:default-2d
:default-3d

Return value:
status {KEYWORD} - one of the following:
:on
:off

See Also:
SET_CATCH_PARAMETERS [interrupt action]

Function Index Top of Page

SD-INQ-ERROR-OBJ  [function]

(sd-inq-error-obj [type])
Description:
Most of the interface functions return nil on failure. Some of the interface functions set an error object which you can inquire to get more information on what went wrong.

Parameters:
type {KEYWORD [:message]}
Used to specify the type of information which this function should return. You can pass one of the following keywords:
  • :message
  • :module
  • :code
  • :object
  • :all

Return value:
text {STRING} - which contains
  • a localized error message if type was set to :message
  • an internal error module identifier if type was set to :module
  • an error code string if type was set to :code
object {LISP object}
the LISP object which led to the error if type was set to :object
list {LIST}
contains the values of the single inquiries in the order :module, :code, :message and :object if type was set to :all
Example:
(sd-call-cmds (extrude :distance 42)
              :failure (sd-display-error (sd-inq-error-obj :message)))

Function Index Top of Page

SD-INQ-CURR-CMDS  [function]

(sd-inq-curr-cmds)
Description:
Returns a list of all currently active and suspended commands. This is a quite useful function to generate context sensitive help information.

Parameters:

Return value:
command-list {LIST of STRINGs}
Names of all currently active and suspended commands. The first list element is the most recent command.
Note: Internal utility commands like SELECT ("subactions") are listed too.
nil - no active or suspended command

Example:
(sd-inq-curr-cmds) => ("MEASURE_DIST_SA" "MEASURE_DIST" "SELECT" "EXTRUDE")

Function Index Top of Page

SD-INQ-MODEL-CLIP-PLANE-DEFINED-P  [function]

(sd-inq-model-clip-plane-defined-p [id])
Description:
Determines whether or not the specified clip plane is defined.

Parameters:
id {FIXNUM from 1 to 6} - The identifier of the clip plane to inquire.

Return value:
t - if the clip plane is defined
nil - in any other case

See Also:
MODEL_CLIPPLANE [terminate action]

Function Index Top of Page

SD-INQ-MODEL-CLIP-PLANE-ENABLED-P  [function]

(sd-inq-model-clip-plane-enabled-p [id])
Description:
Determines whether or not the specified clip plane is enabled.

Parameters:
id {FIXNUM from 1 to 6} - The identifier of the clip plane to inquire.

Return value:
t - if the clip plane is enabled
nil - in any other case

See Also:
MODEL_CLIPPLANE [terminate action]

Function Index Top of Page

SD-INQ-MODEL-CLIP-PLANE-ORIGIN  [function]

(sd-inq-model-clip-plane-origin [id])
Description:
Returns the origin of the specified model clip plane in global coordinates.

Parameters:
id {FIXNUM from 1 to 6} - The identifier of the clip plane to inquire.

Return value:
origin {GPNT3D} - The clip plane's origin in global coordinates.
nil - Either the specified clip plane is undefined or the identifier is invalid.

See Also:
MODEL_CLIPPLANE [terminate action]

Function Index Top of Page

SD-INQ-MODEL-CLIP-PLANE-U-DIR  [function]

(sd-inq-model-clip-plane-u-dir [id])
Description:
Returns the U-axis direction vector of the specified clip plane.

Parameters:
id {FIXNUM from 1 to 6} - The identifier of the clip plane to inquire.

Return value:
u-dir {GPNT3D} - The clip plane's U-axis direction vector.
nil - Either the specified clip plane is undefined or the identifier is invalid.

See Also:
MODEL_CLIPPLANE [terminate action]

Function Index Top of Page

SD-INQ-MODEL-CLIP-PLANE-W-DIR  [function]

(sd-inq-model-clip-plane-w-dir [id])
Description:
Returns the W-axis direction vector of the specified clip plane.

Parameters:
id {FIXNUM from 1 to 6} - The identifier of the clip plane to inquire.

Return value:
w-dir {GPNT3D} - The clip plane's W-axis direction vector.
nil - Either the specified clip plane is undefined or the identifier is invalid.

See Also:
MODEL_CLIPPLANE [terminate action]

Function Index Top of Page

SD-INQ-MODEL-CLIPPING-MODE  [function]

(sd-inq-model-clipping-mode)
Description: Returns whether model clip planes are applied to all objects or only to objects which have their clipping flag set.

Parameters:

Return value:
mode {KEYWORD} - one of the following:
:all - Clip planes are applied to all objects.
:selected - Clip planes are applied to objects which have their clipping flag set.

See Also:
MODEL_CLIPPLANE [terminate action]
(sd-inq-obj-clipping-flag)
[Integration Kit Contents] [Integration Kit What's New] [Integration Kit Function Index] [More Documentation] [PTC]
© 2023 Parametric Technology GmbH
(a subsidiary of PTC Inc.), All Rights Reserved