TYPE: SOP
TITLE: AttribStringEdit SOP

AttribStringEdit is used to edit string attributes.

The attributes may be explicitly specified in the corresponding attribute text
field. Exclusion is specified by preceding an attribute name with the carat
character (^). All available attributes can be specified by leaving the field
blank or entering an asterisk (*) in the field. If the first attribute is
preceded by a carat then all attributes are assumed to be transferred except
where explicitly excluded. In all other cases, no attributes are assumed
except where explicitly included. Note that only string attributes are
considered.

The active filters that are defined in the Editor tab are applied in sequence
to the attributes that are specified in the Attributes tab.

The From and To parameters are any string patterns like "str[1-9:2]" or
"t[xyz]". The From parameter also allows matching patterns like
"str* and str?". Examples:

~c(
    From                To              Produces
~c)

Simple matching assuming an input of str1 str2 str3:

~c(
    str1 str2 str3      tx ty tz        tx ty tz
    str[1-3]            t[xyz]          tx ty tz
    str[1-3]            tx ty tz rx     tx ty tz
    str[1-2]            tx ty           tx ty str3
~c)

Simple matching assuming an input of tx ty tz:

~c(
    t[xyz]              [XYZ]trans      Xtrans Ytrans Ztrans
~c)

Change strings that start with "bob" to strings that start with "carol":

~c(
    bob*                carol*
~c)

Replace strings with "hand" in the middle to strings with "foot" in place:

~c(
    *hand*              *foot*
~c)

Swap words in a name, where the words are separated by _ :

~c(
    *_*                 *(1)_*(0)       a_x changes to x_a
~c)

Wildcard matching, assuming an input of str1 str2 str3:

~c(
    str?                t?              t1  t2  t3
    *                   op:*            op:str1  op:str2  op:str3
    *r*                 *ring*          string1  string2 string3
    *[1-3:2]            foot[11-13:2]   foot11  str2  foot13
    *                   string[3,1,2]   string3 string1 string2
~c)

See the manual for more pattern matching options in the section Standard
Options of CHOPs.

Examples:
    ~c(Detail(pCaptPath) From(chain_*) To(arm_*)~c) - pCaptPath string "chain_bone7/cregion 0" is converted to "arm_bone7/cregion 0".

Parameters:
    Detail			- String detail attributes to edit.
    Primitives			- String primitive attributes to edit.
    Points			- String point attributes to edit.
    Vertices			- String vertex attributes to edit.
    From			- The string pattern to rename. See examples above.
    To				- The replacement pattern for the string. See examples above.

See also: Attribute
