Material and ambience names¶
The exact names of every built-in material and lighting preset, for use with the command line apply_mtl and apply_amb commands and the viewer messaging API apply_mtl message.
Using the names¶
- Materials:
apply_mtl <layer>:<material>. Material names are matched case-insensitively; layer names are case-sensitive. - Ambiences:
apply_amb <shelf>:<id>. The shelf is the lowercase alias (white,black,floor,sun) and the id is the preset id, e.g.Ambience07b. Both parts are case-sensitive. - Run
list_materialsandlist_ambiencesin a command line script to print these lists from the application itself.
apply_mtl Metal 01:Yellow Gold 18k
apply_mtl Gem 01:Diamond
apply_amb white:Ambience03w
Materials¶
Diamond (12)¶
Diamond, Diamond Fancy Yellow, Diamond Fancy Blue, Diamond Fancy Pink, Diamond Fancy Green, Diamond Fancy Orange, Diamond Fancy Red, Diamond Fancy Purple, Diamond Fancy Violet, Diamond Fancy Brown, Diamond Fancy Gray, Diamond Fancy Black
Gemstone (83)¶
Alexandrite Candelight, Alexandrite Daylight, Amethyst, Apatite, Aquamarine, Benitoite, Beryl, Beryl Golden, Beryl Green, Citrine, Citrine Madeira, Cubic Zirconia White, Cubic Zirconia Color, Diopside, Emerald, Fluorite, Garnet Almandine, Garnet Demantoid, Garnet Grossular, Garnet Hessonite, Garnet Malaya, Garnet Mozambique, Garnet Pyrope, Garnet Rhodolite, Garnet Spessartite, Garnet Tsavorite, Iolite, Kunzite, Kyanite, Moissanite, Moissanite Color, Morganite, Peridot, Quartz, Quartz Green, Quartz Lemon, Quartz Rose, Ruby, Ruby Australia, Ruby India, Ruby Madagascar, Ruby Mozambique, Ruby Tanzania, Ruby Thai, Sapphire Blue, Sapphire Green, Sapphire Orange, Sapphire Padparadcha, Sapphire Pink, Sapphire Purple, Sapphire White, Sapphire Yellow, Spinel Blue, Spinel Pink, Spinel Red, Tanzanite, Tanzanite Fancy Colors, Topaz Green, Topaz Imperial, Topaz London Blue, Topaz Mystic Pink, Topaz Mystic Sunrise, Topaz Passion Aqua Blue, Topaz Passion Glacier Blue, Topaz Passion Ice Blue, Topaz Passion Paradise Blue, Topaz Passion Teal, Topaz Sky Blue, Topaz Swiss Blue, Topaz White, Topaz Yellow, Tourmaline Blue Paraiba, Tourmaline Bronze, Tourmaline Chrome, Tourmaline Earth, Tourmaline Golden, Tourmaline Green, Tourmaline Green Paraiba, Tourmaline Olive, Tourmaline Pink, Tourmaline Red, Zircon Blue, Zircon Yellow
Note
The library spells it Alexandrite Candelight (sic). That exact spelling is what apply_mtl matches.
Metal (48)¶
Platinum 950, Palladium W Gold 18K, Palladium W Gold 14K, Palladium 950, White Gold 18k, White Gold 14k, White Gold 10k, Yellow Gold 22k, Yellow Gold 18k, Yellow Gold 14k, Yellow Gold 10k, Rose Gold 18k, Rose Gold 14k, Rose Gold 10k, Green Gold 18k, Green Gold 14k, Green Gold 10k, Silver 925, Cobalt Chrome, Stainless Steel, Rhodium, Titanium, Tungsten, Zirconium
Every metal also exists in a matte finish: append Matte to the name (e.g. Yellow Gold 18k Matte).
Opal (1)¶
Opal
Pearl (31)¶
Pearl White, Pearl White Overtone Pink, Pearl White Overtone Green, Pearl White Overtone Blue, Pearl White Overtone Red, Pearl Cream, Pearl Pink, Pearl Silver, Pearl Green, Pearl Olive, Pearl Blue, Pearl Grey, Pearl Black, Pearl Champagne, Pearl Gold, Pearl Bronze, Pearl Violet, Pearl Tahitian Purple, Pearl Tahitian Purple Green, Pearl Tahitian Green, Pearl Tahitian Blue, Pearl Tahitian Green Blue, Pearl Freshwater White, Pearl Freshwater White Cream, Pearl Freshwater Orange, Pearl Freshwater Pink, Pearl Freshwater Purple, Pearl Freshwater Blue, Pearl Freshwater Red, Pearl Freshwater Bronze, Pearl Freshwater Black
Plastic (Enamel) (88)¶
01 Generic A, 02 Generic B, 1010 Undercoat, 1020 Titanium, 1030 Foundation, 1040 Quill, 1050 Mat, 1110 Pastel, 1124 Cork, 1125 Nut, 1140 Chamois, 1150 Woodrow, 1170 Elk, 1175 Mocha, 1180 Briarwood, 1190 Peat, 1202 Off White, 1208 Cream, 1211 Candy, 1224 Melon, 1225 Lemon, 1237 Butter, 1238 Ivory, 1239 Mellow, 1240 Pine, 1305 Pastel, 1308 Lichen, 1315 Willow, 1319 Bitter, 1335 Pea, 1345 Hunters, 1360 Jungle, 1380 Mistletoe, 1390 Alpine, 1405 Pastel, 1410 Robins Egg, 1415 Sea Foam, 1420 Mint, 1422 Aqua Marine, 1425 Sapphire, 1430 Spruce, 1440 Delft, 1465 Peacock, 1505 Pastel, 1510 Ozone, 1515 Horizon, 1520 Calamine, 1522 French, 1525 Aqua, 1530 Twilight, 1540 Wedgewood, 1560 Bluejay, 1605 Isle, 1608 Storm, 1610 Sky, 1615 Atlantic, 1620 Daphne, 1645 Harvest, 1650 Yacht, 1660 Ultramarine, 1685 Cobalt, 1705 Petal, 1708 Pastel, 1710 Tallow, 1715 Clover, 1720 Mauve, 1745 Fox Glove, 1750 Orchid, 1760 Iris, 1780 Grape, 1810 Buttercup, 1820 Goldenrod, 1830 Marigold, 1840 Sunset, 1850 Pumpkin, 1860 Flame, 1870 Orient, 1880 Flame, 1890 Victoria, 1905 Pastel, 1910 Pussywillow, 1912 Nude, 1915 Dove, 1920 Stump, 1940 Steel, 1960 Blue, 1980 Bluish Black, 1995 1996 Black
Ambiences¶
Ambiences are lighting presets organized into shelves. Preset ids follow a simple pattern: Ambience + two-digit number + shelf letter.
| Shelf | Alias (for apply_amb) | Presets | Ids |
|---|---|---|---|
| White | white | 30 | Ambience01w through Ambience30w |
| Black | black | 30 | Ambience01b through Ambience30b |
| Floor | floor | 20 | Ambience01f through Ambience20f |
| Sun | sun | 30 | Ambience01s through Ambience30s |
apply_amb white:Ambience01w
apply_amb black:Ambience14b
apply_amb floor:Ambience07f
apply_amb sun:Ambience22s
Note
The editor UI shows display names like "Ambience 01w" (with a space); the id used by apply_amb has no space, exactly as in the table above.