Skip to documentation
BRL-CAD
DocumentationAll documentsEnglish

ATTR(nged)

NAME

material - Used to create, change, retrieve, assign, import, or view materials and their properties.

On this page

SYNOPSIS

material assign {object_name_pattern} {material_name}
material create {object_name_pattern} {material_name}
material import [--id | --name] {file_name}
material get {object_name_pattern} [property_group_name] {property_name}
material remove {object_name_pattern} [property_group_name] {property_name}
material set {object_name_pattern} [property_group_name] {property_name} {property_value}

DESCRIPTION

Used to create, change, retrieve, assign, import, or view materials and their properties. Note that properties and property materials are cases sensitive and should not contain whitespace.

A newly formed material will have a minimum of the following data set on creation:

  • name

Material objects are made up of a name (seperate from the object name), parent value, and source value. All of which are variable length strings.

In addition to the three variable length string properties, material objects also contain four key-value lists used for storing additional material information:

  • physical

  • mechanical

  • optical

  • thermal

SUB-COMMANDS

assign

Set the material_name property of the specified object to the specified material. Operates similarly to attr set.

create

Initalize a new material and sets the name property to the value specified.

destroy

Destroy the material object.

get

Retrieve a property of the material, optionally from one of the material’s four material groups.

import

Import a density file’s entries into material objects. --id denotes the material object names will be the id of the entry in the density table, --name the name of the entry in the density file.

remove

Remove a material property from the object. (In the case of name, parent, and source this merely sets those values to NULL).

set

Set a material property on the object, optionally from one of the material’s four material groups.

EXAMPLES

The examples demonstrate the use of the material command and subcommands.

Example 1. Import a density file to material objects.
mged> material import --id .density

Imports the density file .density to material objects and names the objects based on the file’s ids.

Example 2. Get the density attribute of the material "copper" within the physical property group.
mged> material get copper physical density

Outputs the value of density.

AUTHOR

BRL-CAD Team

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

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org