构造一个材质对象。

语法

material ST_MakeMaterial(cstring ambient default NULL,
                         cstring diffuse default NULL,
                         cstring specular default NULL,
                         integer shininess default NULL,
                         integer transparency default NULL,
                         integer texture_index default NULL);
material ST_MakeMaterial(text table_name,
                         text column_name,
                         text key_value,
                         text schema_name default NULL);
material ST_MakeMaterial(cstring attributes,
                         texture[] textures default NULL);

参数

参数名称描述
ambient环境颜色光，用16进制字符串表示RGBA颜色，例如：#FF88FF00。
diffuse散射光，用16进制字符串表示RGBA颜色，例如：#FF88FF00。
specular镜面光颜色，用16进制字符串表示RGBA颜色，例如：#FF88FF00。
shininess光泽度，取值：0~100。
transparency透明度，取值：0~100。
texture_index材质所对应纹理的索引信息，取值：0~32767。
table_name已存在material的表名。
column_name已存在material的列名。
key_value已存在material的查询唯一ID，用于where条件中。
schema_name已存在material的方案名，默认为用户search path中表所在的Schema。
attributes基于JSON类型的材质描述信息，形式为GLTF中的PBR材质描述。
texturesmaterial所包含的textures数组。

描述

构造一个材质对象。
  • 语法一提供了基于OpenCL类型的材质描述信息，最终会转换为基于JSON的表述形式。
  • 语法二提供了基于其他表中存储的材质信息，可以有效地降低Mesh的数据量，方便统一进行修改。
  • 语法三提供了基于JSON类型的材质描述信息。

示例

  • 语法一：
    -- form 1
SELECT ST_AsText(ST_MakeMaterial('#FFDDEEAA', '#FFDDEEAA', '#FFDDEEAA', 30, 70, 2));

--------------------------------------------------------------------------------
{"type":"raw", "attributes": {"ambient":"#FFDDEEAA","diffuse":"#FFDDEEAA","specular":"#FFDDEEAA","shininess":30,"transparency":70,"texture":2}}


-- form 1
SELECT ST_AsText(ST_MakeMaterial(diffuse => '#FFDDEEAA'));

-------------------------
 {"type":"raw", "attributes": {"diffuse":"#FFDDEEAA"}}
  • 语法二：
    -- form 2，reference to other material object
 SELECT ST_AsText(ST_MakeMaterial('t_material'::text,
    'the_material'::text,
    'num=1'::text));
 -----------------------------
 {"type":"db", "attributes": {"schema":"public","table":"t_material","column":"the_material","key":"num=1"}}
  • 语法三：
    -- form3, with PBR json string and textures
SELECT ST_AsText(ST_MakeMaterial('{"pbrMetallicRoughness": {"baseColorFactor": [ 1.000, 0.766, 0.336, 1.0 ], "metallicFactor": 0.5,"roughnessFactor": 0.1}}',
                                 ARRAY(SELECT the_texture from t_texture)));
-----------------------------
{"type":"raw", "textures":[{"compressionType" : "None", "format" : "JPEG", "wrap" : "Wrap", "type" : "Raw", "depth" : 3, "width" : 256, "height" : 256, "size" : 6, "data" : "313233343536"}], "attributes": {"pbrMetallicRoughness":{"baseColorFactor":[1.0,0.766,0.336,1.0],"metallicFactor":0.5,"roughnessFactor":0.1}}}