明经通道 外部定义命令	明经通道 外部定义命令
rmat

创建、编辑、附着和拆离渲染材质（外部定义：render ARX 应用程序）

(c:rmat mode options)

参数

mode

字符串，缺省值为：

A 附着材质

C 复制材质

D 拆离材质

L 列出图形中的所有材质，或返回指定材质的定义

M 修改材质

N 创建新材质

options

有效值取决于指定的 mode。

A—附着材质

“A”（附着）模式将材质附着到选定的对象或 ACI（AutoCAD 颜色索引）值上，这由其第三个参数 (layer-name)的类型决定。

(c:rmat "A" name [aci | selection-set | layer-name])

参数

附着参数的说明如下表：

示例

将材质 PURPLE TIGER 附着到 ACI 1（红色）：

(c:rmat "A" "PURPLE TIGER" 1)

如果忽略第三个参数，则“A”模式返回包含三项的列表：

• 已附着指定材质的图层名列表。
• 已附着指定材质的 ACI 列表。
• 包含已附着指定材质的对象的选择集。

第三个参数被忽略时的返回值如下例：

命令： (c:rmat "a" "twood")

收集对象_ 已找到 1 个

(("first" "second")(135) <Selection set 12>))

材质索引值在区间 1-255 中时是 ACI 值，大于 255 的索引值表示 AutoCAD 渲染材质不是随 ACI 指定的。

C—复制材质

通过复制图形中已经存在的材质来创建新材质。

(c:rmat "C" cur_name new_name)

参数

cur_name

字符串，指定要复制的材质的名称。

new_name

字符串，指定新材质的名称。

示例

修改材质以改变其定义：

(c:rmat "C" "RED" "RED2")

D—拆离材质

“D”（拆离）模式可以从选定的对象、ACI（AutoCAD 颜色索引）值或图层上拆离材质，这由第三个参数 (selection-set) 的类型决定。

(c:rmat "D" name [aci | selection-set | layer-name])

参数

拆离参数的说明如下表：

示例

提示用户选择对象，然后将每个对象从其材质拆离：

(c:rmat "D" (ssget))

L—列出材质

列出图形中材质的定义。

(c:rmat "L" [name])

参数

name

字符串，指定要列出的材质定义。如果 name 参数被忽略，则 c:rmat 列出图形中的所有材质。

示例

列出图形中的所有材质。

命令： (c:rmat "L")

("*GLOBAL*" "BLUE GLASS" "WHITE PLASTIC" "TWOOD" "BEIGE MATTE")

列表中的第一个字符串指定缺省的全局材质“*全局*”，可以将此字符串象其他库或用户定义的材质一样传递给 c:rmat：

命令： (c:rmat "L" "*GLOBAL*")

("*GLOBAL*" "STANDARD" (-1.0 -1.0 -1.0) 0.7 ("" 0.0 0 (1.0 1.0) (0.0 0.0) 0.0 0 0) (-1.0 -1.0 -1.0) 0.1 (-1.0 -1.0 -1.0) 0.2 ("" 0.0 0) 0.5 0.0 ("" 0.0 0 (1.0 1.0) (0.0 0.0) 0.0 0 0) 1.0 ("" 0.0 0 (1.0 1.0) (0.0 0.0) 0.0 0 0))

材质定义中的列表项与“修改”或“新建”模式中的参数相同。

M—修改材质

“M”（修改）模式的选项与“N”（新建）模式的选项相同。如果某个参数为 nil或被从参数列表末尾忽略，则受该参数影响的特性保留当前值。

例如，如下调用将 BLUE MARBLE 改为具有黑色条纹的中等蓝石质颜色。

(c:rmat "M" "BLUE MARBLE" "marble" ’(0.5 0.5 1.0) ’(0.0 0.0 0.0))

N—新建材质

“N”（新建）模式创建新材质。此模式的参数不仅取决于模式本身，而且还取决于所创建材质的类型。过程性材质：大理石、花岗石和木材都有唯一的参数集合，并且这些参数与标准材质的参数不同。

参数

新建参数的说明如下表：

另外，每种位图的参数都以子表的形式指定。有关的详细信息，请参见“位图参数”。

Standard

材质类型字符串“STANDARD”指定创建新的标准材质。

(c:rmat "N" name "STANDARD" [color [color-weight [pattern

[ambient [amb-weight [ref1 [ref1-weight [ref1-map [roughness [transparency [opacitymap [refraction [bumpmap]]]]]]]]]]]]])

参数

Standard 参数的说明如下表：

示例

如下调用创建一个带图案贴图的洋红色材质：

(c:rmat "N" "RED LACQUER" "STANDARD" ; 名称和类型

'(1.0 0.0 0.0) (1.0) ; 颜色（红色）、权值和纹理贴图

'("INLAY.TGA” 0.75 0 (0.5 0.5) (0.3 0.3) 0.0 0 1)

'(1.0 0.0 0.0) 1.0   ; 环境色及其权值（和漫射一样）

'(1.0 0.0 0.0) 1.0   ; 反射色（白色）及其权值

nil                  ; 无反射贴图

0.2                  ; 粗糙度（低）

0.0                  ; 透明度（无）

nil                  ; 无不透明贴图

0.0                  ; 折射（无）

nil                  ; 无凹凸贴图

如下调用创建使用多个位图的材质 MAPS：

(c:rmat "N" "MAPS" "STANDARD"

'(1.0 0.0 0.0) (1.0) '("weave.tga" 1.0 0)

'(1.0 0.0 0.0) 1.0

'(1.0 0.0 0.0) 1.0 '("room.tga" 0.75)

0.5

0.0

'("hole.tga")

1.0

'("ridges.tga")

如下调用创建的材质不使用位图和缺省值，当用“照片级真实感渲染”的环境贴图或“照片级光线跟踪渲染”进行渲染时，材质的反射光由光线追踪生成。

(c:rmat "N" "SHINE" "STANDARD" nil nil nil nil nil nil nil '(nil nil 1))

Marble

材质类型字符串“MARBLE”指定创建新的大理石材质。

(c:rmat "N" name "MARBLE" [stone-color [vein-color [refl [refl-weight [refl-map [roughness [turbulence [sharpness [scale [bumpmap ]]]]]]]]]])

参数

Marble 参数的说明如下表：

示例

如下调用创建具有粉红色石质颜色和黑色纹理的大理石材质：

(c:rmat "N" "PINK MARBLE" "MARBLE" '(1.0 0.34 0.79))

Granite

材质类型字符串“GRANITE”指定创建新的花岗石材质。

(c:rmat "N" name "GRANITE" [first-color [amount1 [second-color [amount2 [third-color [amount3 [fourth-color [amount 4 [refl [refl-weight [refl-map [roughness [sharpness [scale [bumpmap ]]]]]]]]]]]]]]])

参数

The following table describes the granite arguments:

示例

创建花岗石材质，此材质没有暗灰色，而是更多地使用了黑色，并且用黄色取代了浅灰色：

(c:rmap "N" "YELLOW GRANITE" 

 nil 0.5 nil 0.0 nil 0.85 '(1.0 1.0 0.0) 0.6)

Wood

材质类型字符串“WOOD”指定创建新的木材材质。

(c:rmat "N" name "WOOD" [light-color [dark-color [refl [refl-weight [refl-map [roughness [ratio [density [width [shape [bumpmap ]]]]]]]]]]])

参数

Wood 参数的说明如下表：

示例

创建具有不规则颗粒的木材：

(c:rmat "N" "CRYPTO" "WOOD" nil nil nil nil nil nil nil nil nil 0.56)

位图参数

指定位图的参数被传递到列表中，该列表可以在 c:rmat 调用中用作子表（如随后各节开始处所示的形式）或在调用 c:rmat 之前赋值给符号。

图案/纹理

'(name[blend [repeat [scale [offset [reserved [map-style [auto-axis]]]]]]])

参数

图案/纹理参数的说明如下表：

反射/环境

'(name [blend [raytrace]])

参数

反射/环境参数的说明如下表：

不透明

'(name [blend [repeat [scale [offset [reserved [map-style [auto-axis]]]]]]])

参数

不透明参数的说明如下表：

凹凸贴图

'(name[amplitude [repeat [scale [offset [reserved [map-style [auto-axis]]]]]]])

凹凸参数的说明如下表：