materials.character will read the materials from an im3d compatible image file on disk.

materials.hxsurf will extract the materials from an hxsurf object

materials(x, ...)

# S3 method for default
materials(x, ...)

# S3 method for character
materials(x, ...)

# S3 method for hxsurf
materials(x, ...)



An object in memory or, for materials.character, an image on disk.


additional parameters passed to methods (presently ignored)


A data.frame with columns name, id, col


Note that the id column will be the 1-indexed order that the material appears in the surf$Region list for hxsurf objects and the 0-indexed mask values for an image.

Presently only AmiraMesh images are supported since they have a standardised way of encoding labels, whereas NRRDs would have to use key-value pairs according to some ad hoc convention.

See also