All Frameworks  Class Hierarchy  This Framework  Indexes

SPAds Global Function DM_add_pt_press

Adds a pressure point to deformable model and returns a new tag identifier or an error.

Role: Modifies the target deformable model.

Builds and adds to the target deformable model a DS_pressure point with a domain point and gain as specified by the input arguments. When tag equals -1 the system assigns the next available tag number to the newly created load. Otherwise, the input tag value is used as the load's tag number. When the negate_flag equals 0 the pressure load is applied in the deformable model's normal direction. When negate_flag is set, the pressure vector is negated before being applied.

When domain_flag is set to 1, dpt is given in the unit range and mapped to the dmod's actual domain range by this function. When domain_flag is set to 0, dpt is given in the dmod's original domain range (the one with which it was created). When domain_flag is set to 2, dpt is given in the dmod's pfunc's internal_pfunc_space.

tag_flag selects the target deformable model. When tag equals -1 the next available tag number is assigned to the newly created load. Otherwise, the input tag number is used. Other valid values for the tag flag are:

1	active deformable model
2	root deformable model

Otherwise, the target is the deformable model whose tag identifier equals abs(tag_flag).

Returns a newly created DS_load's tag number.

Errors:

DM_parse_tag_flag() errors

DM_scale_unit_dpt_to_pfunc()

errors

DM_BAD_TAG_VALUE

The tag value must be -1, to have the system assign one, or 2 or greater.

DM_NO_ROOT_DMOD

The the input deformable model cannot be NULL.

DM_BAD_NEGATE_FLAG_VALUE

The negate_flag must be a 0 or a 1.

DM_NULL_INPUT_PTR

The dpt cannot be NULL on input.

Effect: Changes model

Parameters:

rtn_err

out: 0=success or neg err code.

dmod

in: member of target dmod hierarchy to search.

tag_flag

in: specify tgt dmod 1 = active dmod 2 = root dmod else = member dmod with tag=tag_flag.

domain_flag

orig_dmod_space, 1=dpt in unit_space, 2=dpt in internal_pfunc_space.

dpt

in: load's domain loc, [u,v] sized:[Domain_dim].

gain

in: magnitude of load gain.

negate_flag

in: change normal dir (1=negate,0=do not).

tag

in: when = -1 assign next tag number else use this tag number.

sdmo

in:SDM_options pointer note: sets active dmod.

Copyright (c) 1989-2007 by Spatial Corp. All rights reserved.