Material

new Cesium.Material(options)
Scene/Material.js 260

材质是通过漫反射、镜面反射、法线、散射和alpha的组合来定义表面外观。 这些值是使用一个名为Fabric的JSON模式指定的，该模式被解析并组装到glsl着色器代码中。 查看wiki页面了解更多关于Fabric的信息。

基本材质类型和它们的uniforms
  • Color
    • color: rgba 颜色对象
  • Image
    • image: 图片路径
    • repeat: 对象，其x和y值指定重复图像的次数。
  • DiffuseMap
    • image: 图片路径
    • channels: 包含r、g、b和a的任意组合的三个字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数。
  • AlphaMap
    • image: 图片路径
    • channel: 一个包含r、g、b或a的字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数。
  • SpecularMap
    • image: 图片路径
    • channel: 一个包含r、g、b或a的字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数。
  • EmissionMap
    • image: 图片路径
    • channels: 包含r、g、b和a的任意组合的三个字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数
  • BumpMap
    • image: 图片路径
    • channel: 一个包含r、g、b或a的字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数
    • strength: 凹凸程度值在0.0和1.0之间
  • NormalMap
    • image: 图片路径
    • channels: 包含r、g、b和a的任意组合的三个字符串，用于选择所需的图像通道。
    • repeat: 对象，其x和y值指定重复图像的次数。
    • strength: 凹凸程度值在0.0和1.0之间
  • Grid
    • color: 整个材质的rgba颜色对象
    • cellAlpha: 网格线之间单元格的Alpha值,这个值会和color.alpha融合
    • lineCount: 对象，其x和y值分别指定列和行数。
    • lineThickness: 对象，其x和y值指定网格线的厚度(可用像素表示)。
    • lineOffset: 对象，其x和y值指定网格线的偏移量(范围为0到1)。
  • Stripe
    • horizontal: 决定条纹是水平还是垂直的布尔值。
    • evenColor: 条纹的第一种颜色
    • oddColor: 条纹的第二种颜色
    • offset: 控制从哪一点开始绘制图案的数字; with 0.0 being the beginning of the even color, 1.0 the beginning of the odd color, 2.0 being the even color again, and any multiple or fractional values being in between.
    • repeat: 条纹的总数
  • Checkerboard
    • lightColor: 棋盘明亮部分的颜色
    • darkColor: 棋盘暗淡部分的颜色
    • repeat: 对象，其x和y值分别指定列和行数。
  • Dot
    • lightColor: 点的颜色
    • darkColor: 背景颜色
    • repeat: 对象，其x和y值分别指定圆点的行数和列数。
  • Water
    • baseWaterColor: 水的基础颜色
    • blendColor: 用于混合从水到非水的地区的颜色
    • specularMap: 用于表示水域区域的单通道纹理。
    • normalMap: 水正常扰动的法线贴图。
    • frequency: 波浪数
    • normalMap: 水正常扰动的法线贴图。
    • animationSpeed: 水运动的速度.
    • amplitude: 水波振幅
    • specularIntensity: 镜面反射强度。
  • RimLighting
    • color: 扩散颜色和alpha.
    • rimColor: 边缘的扩散颜色和alpha.
    • width: 边缘的宽度
  • Fade
    • fadeInColor: diffuse color and alpha at time
    • fadeOutColor: diffuse color and alpha at maximumDistance from time
    • maximumDistance: Number between 0.0 and 1.0 where the fadeInColor becomes the fadeOutColor. A value of 0.0 gives the entire material a color of fadeOutColor and a value of 1.0 gives the the entire material a color of fadeInColor
    • repeat: true if the fade should wrap around the texture coodinates.
    • fadeDirection: Object with x and y values specifying if the fade should be in the x and y directions.
    • time: Object with x and y values between 0.0 and 1.0 of the fadeInColor position
  • PolylineArrow
    • color: 扩散的颜色和alpha
  • PolylineDash
    • color: 线的颜色
    • gapColor: 线的间隙的颜色
    • dashLength: Dash length in pixels.
    • dashPattern: The 16 bit stipple pattern for the line..
  • PolylineGlow
    • color: 辉光的颜色和最大的alpha值
    • glowPower: 辉光的强度
    • taperPower: 渐变效果的强度。
  • PolylineOutline
    • color: 内部线条的散射颜色和alpha值
    • outlineColor: 轮廓的散射颜色和alpha值
    • outlineWidth: 轮廓的宽度
  • ElevationContour
    • color: 等高线的颜色和alpha
    • spacing: 等高线间距，以米为单位。
    • width: 线宽，以像素为单位
  • ElevationRamp
    • image: 给地形着色的色带图像。
    • minimumHeight: 最低高度
    • maximumHeight: 最高高度
  • SlopeRamp
    • image: 给地形着色的色带图像
  • AspectRamp
    • image: color ramp image to use for color the terrain by aspect.
Name Type Description
options Object optional 具有下列属性的对象：
Name Type Default Description
strict Boolean false optional 是否为通常会被忽略的问题抛出错误。
translucent Boolean | function true optional 当 true时，此材质的几何图形将显示为半透明。
fabric Object 用于生成材质的fabric JSON。
Throws:
  • DeveloperError : fabric: uniform 类型无效。
  • DeveloperError : fabric: uniforms 和 materials不能共享同一属性。
  • DeveloperError : fabric: 不能在同一部分中包含源和分量。
  • DeveloperError : fabric: 属性名称无效，必须是 'type', 'materials', 'uniforms', 'components', 或 'source'。
  • DeveloperError : fabric: 属性名称无效，必须是 'diffuse', 'specular', 'shininess', 'normal', 'emission', 或 'alpha'。
  • DeveloperError : strict: 着色器代码不是字符串。
  • DeveloperError : strict: 着色器代码没有使用uniform。
  • DeveloperError : strict: 着色器代码没有使用material。
Example:
// 用fromType创建一个颜色材质:
polygon.material = Cesium.Material.fromType('Color');
polygon.material.uniforms.color = new Cesium.Color(1.0, 1.0, 0.0, 1.0);

// 创建默认材质:
polygon.material = new Cesium.Material();

// 用完整的Fabric，创建颜色材质:
polygon.material = new Cesium.Material({
    fabric : {
        type : 'Color',
        uniforms : {
            color : new Cesium.Color(1.0, 1.0, 0.0, 1.0)
        }
    }
});
Demo:
See:

Members

staticreadonlyCesium.Material.AlphaMapType : String
Scene/Material.js 1136

获取alpha贴图材质的名称。

staticreadonlyCesium.Material.AspectRampMaterialType : String
Scene/Material.js 1542

获取长宽比渐变材质的名称。

staticreadonlyCesium.Material.BumpMapType : String
Scene/Material.js 1199

获取凹凸贴图材质的名称。

staticreadonlyCesium.Material.CheckerboardType : String
Scene/Material.js 1287

获取棋盘材质的名称。

staticreadonlyCesium.Material.ColorType : String
Scene/Material.js 1069

获取颜色材质的名称。

staticCesium.Material.DefaultCubeMapId : String
Scene/Material.js 1062

获取或者设置默认立方体贴图的uniform值。

staticCesium.Material.DefaultImageId : String
Scene/Material.js 1056

获取或者设置默认纹理的uniform值.

staticreadonlyCesium.Material.DiffuseMapType : String
Scene/Material.js 1115

获取漫射贴图材质的名称。

staticreadonlyCesium.Material.DotType : String
Scene/Material.js 1309

获取点材质的名称。

staticreadonlyCesium.Material.ElevationContourType : String
Scene/Material.js 1487

获取等高线材质的名称。

staticreadonlyCesium.Material.ElevationRampType : String
Scene/Material.js 1506

获取高度分层设色材质的名称。

staticreadonlyCesium.Material.EmissionMapType : String
Scene/Material.js 1178

获取emmision map 材质的名称。

staticreadonlyCesium.Material.FadeType : String
Scene/Material.js 1381

获取淡入淡出材质的名称。

staticreadonlyCesium.Material.GridType : String
Scene/Material.js 1239

获取格网材质的名称。

staticreadonlyCesium.Material.ImageType : String
Scene/Material.js 1091

获取图像材质的名称。

staticreadonlyCesium.Material.NormalMapType : String
Scene/Material.js 1219

获取法线贴图材质的名称。

staticreadonlyCesium.Material.PolylineArrowType : String
Scene/Material.js 1409

获取箭头折线材质的名称。

staticreadonlyCesium.Material.PolylineDashType : String
Scene/Material.js 1426

获取折线辉光材料的名称。

staticreadonlyCesium.Material.PolylineGlowType : String
Scene/Material.js 1446

获取辉光折线材质的名称。

staticreadonlyCesium.Material.PolylineOutlineType : String
Scene/Material.js 1465

获取轮廓线材质的名称。

staticreadonlyCesium.Material.RimLightingType : String
Scene/Material.js 1359

获取边缘发光材质的名称。

staticreadonlyCesium.Material.SlopeRampMaterialType : String
Scene/Material.js 1525

获取坡度材质的名称。

staticreadonlyCesium.Material.SpecularMapType : String
Scene/Material.js 1157

获取高光贴图材质的名称。

staticreadonlyCesium.Material.StripeType : String
Scene/Material.js 1263

获取条纹材质的名称。

staticreadonlyCesium.Material.WaterType : String
Scene/Material.js 1331

获取水面材质的名称。

materials : Object
Scene/Material.js 280

将子材质名称映射到材质对象.
Default Value: undefined

shaderSource : String
Scene/Material.js 273

该材质的glsl着色器代码
Default Value: undefined

translucent : Boolean|function
Scene/Material.js 295

当true时，几何图形将显示为半透明。
Default Value: undefined

type : String
Scene/Material.js 266

材质类型。可以是现有类型，也可以是新类型。如果在fabric中没有指定类型，则类型为GUID。
Default Value: undefined

uniforms : Object
Scene/Material.js 287

将uniform名称映射到它们的值。
Default Value: undefined

Methods

staticCesium.Material.fromType(type, uniforms) → Material
Scene/Material.js 344

使用现有材质类型创建材质。

Shorthand for: new Material({fabric : {type : type}});
Name Type Description
type String 基本材质类型。
uniforms Object optional 重写默认的uniforms.
Returns:
创建的材质对象
Throws:
Example:
var material = Cesium.Material.fromType('Color', {
    color : new Cesium.Color(1.0, 0.0, 0.0, 1.0)
});

destroy()
Scene/Material.js 506

销毁此集合中所有图元持有的WebGL资源。
Throws:
Example:
material = material && material.destroy();
See:

isDestroyed() → Boolean
Scene/Material.js 492

如果该对象没被销毁，返回false。

如果该对象已经被销毁，使用isDestroyed 会触发 DeveloperError 异常。
Returns:
如果该对象没被销毁，返回false。
See:

isTranslucent() → Boolean
Scene/Material.js 372

获取此材质是否为半透明。
Returns:
如果是半透明返回true。