*solidmap_prepare_usrdataptr

Used to setup the inputs to a solid mapping command block.

Syntax

*solidmap_prepare_usrdataptr type options

Type

HyperMesh Tcl Modify Command

Description

This command is used by the solid mapping algorithm to setup the source, destination and along inputs. It must be used within a *solidmap_begin and *solidmap_end command block. A single solidmap mesh is a result of the block of commands.

In a solidmap command block, all of the commands before *solidmap_end are for preparing input data. *solidmap_end is the command that actually performs the solid mapping.

A data input sub-block starts with this command and ends with either a call to *solidmap_end or the start of another data input sub-block. The three sub-block types do not all need to be present in a solidmap command block. Not all entity types included in options need to be input. For example:

*solidmap_prepare_usrdataptr "SOURCE" 10

Means in solidmap, lines and elements are used as the source. However, one could just input lines. The required elements would be calculated from these lines inside of the solidmapper. This is the auto-completion feature of solidmap.

Inputs

type: One of the three types of the input data sub block. Valid values are:; "SOURCE" - Data input next will be for defining the source.; "DEST" - Data input next will be for defining the destination.; "ALONG" - Data input next will be for defining the along.
options

For SOURCE data input blocks, elements (Bit3) are required to be specified even if Bit3 is 0. Internally, solidmap sets this bit to 1 for SOURCE data input blocks regardless of the user setting.

Example

For a solidmap using the following inputs:

Source geometry - lines 73 and 51;

Destination geometry - lines 32 and 41;

Along geometry - lines 74 and 75, surfaces 100 and 95, nodes 80 and 101-105;

Element size - 10

*solidmap_begin 1

*solidmap_prepare_userdataptr "SOURCE" 10
*createmark lines 1 73 51
*solid_prepare_entitylst lines 0

*solildmap_prepare_userdataptr "DEST" 2
*createmark lines 1 32 41
*solid_prepare_entitylst lines 0

*solidmap_prepare_userdataptr "ALONG" 7
*createmark lines 1 74 75
*solid_prepare_entitylst lines 0
*createmark surfs 1 100 95
*solid_prepare_entitylst surfs 0
*createlist nodes 2 80 101 102 103 104 105
*solid_prepare_nodeline 0

*solidmap_end 0 10 0 0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}