ATTR
nged
BRL-CAD
BRL-CAD MGED Commands

# attr

Used to create, change, retrieve, or view attributes of database objects.

        attr
        get
        set
        rm
        append
        show
        sort
        object_name
        arguments

## DESCRIPTION

Used to create, change, retrieve, or view attributes of database objects. The arguments for "set" and "append" subcommands are attribute name/value pairs. The arguments for "get," "rm," and "show" subcommands are attribute names. The arguments for the "sort" subcommand sets the sort type for the attributes of the object: 'case' (default), 'nocase', 'value', and 'value-nocase'. The "append" subcommand appends the provided value to an existing attribute, or creates a new attribute if it does not already exist. The "get" subcommand retrieves and displays the specified attributes. The "rm" subcommand deletes the specified attributes. The "show" subcommand does a "get" and displays the results in a user readable format. Note that the attribute names may not contain embedded white space, and if attribute values contain embedded white space, they must be surrounded by {} or double quotes.

Note that a newly formed region always has four attributes assigned to it:

- los

- material_id

- region

- region_id

The 'region' attribute is the 'region flag' mentioned in the edcomb command. Somewhat confusingly though, immediately upon completing the 'r' (region) command in mged a message like this is displayed:

    Defaulting item number to 1001
    Creating region with attrs: region_id=1000, air=0, los=0, material_id=1

However, the air attribute will not show in a 'attr show' command unless it is set to a non-zero value.

## EXAMPLES

The examples demonstrate the use of the `attr` command and subcommands to assign and list attributes of database objects.

### Assigns an attribute to an object.

mged> `attr set region_1 material_id 10`

  Assigns an attribute name "material_id" to region_1. Its value is 10.

### Assigns an attribute (with embedded white space in its value) to an object.

mged> `attr set region_1 comment {This is a comment for region_1}`

  Assigns an attribute named "comment" to region_1. Its value is "This is a comment for region_1."

### List all the attributes for an object

mged> `attr show region_1 comment`

  Lists all the attributes for region_1.

## SEE ALSO

attributes 5.

## AUTHOR

BRL-CAD Team

## COPYRIGHT

This software is Copyright (c) 2008-2013 United States Government as represented by the U.S. Army Research Laboratory. All rights reserved.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.