new Cesium3DTileStyle(style)
应用于 Cesium3DTileset 的样式。
计算使用3D Tiles Styling language定义的表达式。
| Name | Type | Description |
|---|---|---|
style |
String | Object |
可选
样式或定义样式的对象的 url。 |
Examples
tileset.style = new SuperMap3D.Cesium3DTileStyle({
color : {
conditions : [
['${Height} >= 100', 'color("purple", 0.5)'],
['${Height} >= 50', 'color("red")'],
['true', 'color("blue")']
]
},
show : '${Height} > 0',
meta : {
description : '"Building id ${id} has height ${Height}."'
}
});
tileset.style = new SuperMap3D.Cesium3DTileStyle({
color : 'vec4(${Temperature})',
pointSize : '${Temperature} * 2.0'
});
Members
-
anchorLineColorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sanchorLineColorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override anchorLineColor expression with a string style.anchorLineColor = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override anchorLineColor expression with a condition style.anchorLineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
anchorLineEnabledStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sanchorLineEnabledproperty. Alternatively a string or object defining a boolean style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Boolean.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override anchorLineEnabled expression with a string style.anchorLineEnabled = 'true';const style = new Cesium.Cesium3DTileStyle(); // Override anchorLineEnabled expression with a condition style.anchorLineEnabled = { conditions : [ ['${height} > 2', 'true'], ['true', 'false'] ] }; -
backgroundColorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sbackgroundColorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override backgroundColor expression with a string style.backgroundColor = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override backgroundColor expression with a condition style.backgroundColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
backgroundEnabledStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sbackgroundEnabledproperty. Alternatively a string or object defining a boolean style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Boolean.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override backgroundEnabled expression with a string style.backgroundEnabled = 'true';const style = new Cesium.Cesium3DTileStyle(); // Override backgroundEnabled expression with a condition style.backgroundEnabled = { conditions : [ ['${height} > 2', 'true'], ['true', 'false'] ] }; -
backgroundPaddingStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sbackgroundPaddingproperty. Alternatively a string or object defining a vec2 style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Cartesian2.This expression is only applicable to point features in a Vector tile.
Example
const style = new Cesium.Cesium3DTileStyle(); // Override backgroundPadding expression with a string style.backgroundPadding = 'vec2(5.0, 7.0)'; style.backgroundPadding.evaluate(feature); // returns a Cartesian2 -
colorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'scolorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is applicable to all tile formats.
Examples
const style = new Cesium3DTileStyle({ color : '(${Temperature} > 90) ? color("red") : color("white")' }); style.color.evaluateColor(feature, result); // returns a Cesium.Color objectconst style = new Cesium.Cesium3DTileStyle(); // Override color expression with a custom function style.color = { evaluateColor : function(feature, result) { return Cesium.Color.clone(Cesium.Color.WHITE, result); } };const style = new Cesium.Cesium3DTileStyle(); // Override color expression with a string style.color = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override color expression with a condition style.color = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
disableDepthTestDistanceStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sdisableDepthTestDistanceproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Number.This expression is only applicable to point features in a Vector tile.
Example
const style = new Cesium.Cesium3DTileStyle(); // Override disableDepthTestDistance expression with a string style.disableDepthTestDistance = '1000.0'; style.disableDepthTestDistance.evaluate(feature); // returns a Number -
distanceDisplayConditionStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sdistanceDisplayConditionproperty. Alternatively a string or object defining a vec2 style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Cartesian2.This expression is only applicable to point features in a Vector tile.
Example
const style = new Cesium.Cesium3DTileStyle(); // Override distanceDisplayCondition expression with a string style.distanceDisplayCondition = 'vec2(0.0, 5.5e6)'; style.distanceDisplayCondition.evaluate(feature); // returns a Cartesian2 -
fontStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sfontproperty. Alternatively a string or object defining a string style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
String.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ font : '(${Temperature} > 90) ? "30px Helvetica" : "24px Helvetica"' }); style.font.evaluate(feature); // returns a Stringconst style = new Cesium.Cesium3DTileStyle(); // Override font expression with a custom function style.font = { evaluate : function(feature) { return '24px Helvetica'; } }; -
heightOffsetStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sheightOffsetproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Number.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override heightOffset expression with a string style.heightOffset = '2.0';const style = new Cesium.Cesium3DTileStyle(); // Override heightOffset expression with a condition style.heightOffset = { conditions : [ ['${height} > 2', '4.0'], ['true', '2.0'] ] }; -
horizontalOriginStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'shorizontalOriginproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
HorizontalOrigin.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ horizontalOrigin : HorizontalOrigin.LEFT }); style.horizontalOrigin.evaluate(feature); // returns a HorizontalOriginconst style = new Cesium.Cesium3DTileStyle(); // Override horizontalOrigin expression with a custom function style.horizontalOrigin = { evaluate : function(feature) { return HorizontalOrigin.CENTER; } }; -
imageStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'simageproperty. Alternatively a string or object defining a string style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
String.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ image : '(${Temperature} > 90) ? "/url/to/image1" : "/url/to/image2"' }); style.image.evaluate(feature); // returns a Stringconst style = new Cesium.Cesium3DTileStyle(); // Override image expression with a custom function style.image = { evaluate : function(feature) { return '/url/to/image'; } }; -
labelColorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelColorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override labelColor expression with a string style.labelColor = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override labelColor expression with a condition style.labelColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
labelHorizontalOriginStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelHorizontalOriginproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
HorizontalOrigin.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ labelHorizontalOrigin : HorizontalOrigin.LEFT }); style.labelHorizontalOrigin.evaluate(feature); // returns a HorizontalOriginconst style = new Cesium.Cesium3DTileStyle(); // Override labelHorizontalOrigin expression with a custom function style.labelHorizontalOrigin = { evaluate : function(feature) { return HorizontalOrigin.CENTER; } }; -
labelOutlineColorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelOutlineColorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineColor expression with a string style.labelOutlineColor = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineColor expression with a condition style.labelOutlineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
labelOutlineWidthStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelOutlineWidthproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Number.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineWidth expression with a string style.labelOutlineWidth = '5';const style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineWidth expression with a condition style.labelOutlineWidth = { conditions : [ ['${height} > 2', '5'], ['true', '0'] ] }; -
labelStyleStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabel styleproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
LabelStyle.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ labelStyle : `(\${Temperature} > 90) ? ${LabelStyle.FILL_AND_OUTLINE} : ${LabelStyle.FILL}` }); style.labelStyle.evaluate(feature); // returns a LabelStyleconst style = new Cesium.Cesium3DTileStyle(); // Override labelStyle expression with a custom function style.labelStyle = { evaluate : function(feature) { return LabelStyle.FILL; } }; -
labelTextStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelTextproperty. Alternatively a string or object defining a string style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
String.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ labelText : '(${Temperature} > 90) ? ">90" : "<=90"' }); style.labelText.evaluate(feature); // returns a Stringconst style = new Cesium.Cesium3DTileStyle(); // Override labelText expression with a custom function style.labelText = { evaluate : function(feature) { return 'Example label text'; } }; -
labelVerticalOriginStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'slabelVerticalOriginproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
VerticalOrigin.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({ labelVerticalOrigin : VerticalOrigin.TOP }); style.labelVerticalOrigin.evaluate(feature); // returns a VerticalOriginconst style = new Cesium.Cesium3DTileStyle(); // Override labelVerticalOrigin expression with a custom function style.labelVerticalOrigin = { evaluate : function(feature) { return VerticalOrigin.CENTER; } }; -
metaStyleExpression
-
Gets or sets the object containing application-specific expression that can be explicitly evaluated, e.g., for display in a UI.
Example
const style = new Cesium3DTileStyle({ meta : { description : '"Building id ${id} has height ${Height}."' } }); style.meta.description.evaluate(feature); // returns a String with the substituted variables -
pointOutlineColorStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'spointOutlineColorproperty. Alternatively a string or object defining a color style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Color.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineColor expression with a string style.pointOutlineColor = 'color("blue")';const style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineColor expression with a condition style.pointOutlineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] }; -
pointOutlineWidthStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'spointOutlineWidthproperty. Alternatively a string or object defining a number style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Number.This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineWidth expression with a string style.pointOutlineWidth = '5';const style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineWidth expression with a condition style.pointOutlineWidth = { conditions : [ ['${height} > 2', '5'], ['true', '0'] ] }; -
pointSizeStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'spointSizeproperty. Alternatively a string or object defining a point size style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Number.This expression is only applicable to point features in a Vector tile or a Point Cloud tile.
Examples
const style = new Cesium3DTileStyle({ pointSize : '(${Temperature} > 90) ? 2.0 : 1.0' }); style.pointSize.evaluate(feature); // returns a Numberconst style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a custom function style.pointSize = { evaluate : function(feature) { return 1.0; } };const style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a number style.pointSize = 1.0;const style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a string style.pointSize = '${height} / 10';const style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a condition style.pointSize = { conditions : [ ['${height} > 2', '1.0'], ['true', '2.0'] ] }; -
scaleByDistanceStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sscaleByDistanceproperty. Alternatively a string or object defining a vec4 style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return a
Cartesian4.This expression is only applicable to point features in a Vector tile.
Example
const style = new Cesium.Cesium3DTileStyle(); // Override scaleByDistance expression with a string style.scaleByDistance = 'vec4(1.5e2, 2.0, 1.5e7, 0.5)'; style.scaleByDistance.evaluate(feature); // returns a Cartesian4 -
showStyleExpression
-
Gets or sets the
StyleExpressionobject used to evaluate the style'sshowproperty. Alternatively a boolean, string, or object defining a show style can be used. The getter will return the internalExpressionorConditionsExpression, which may differ from the value provided to the setter.The expression must return or convert to a
Boolean.This expression is applicable to all tile formats.
Examples
const style = new Cesium3DTileStyle({ show : '(regExp("^Chest").test(${County})) && (${YearBuilt} >= 1970)' }); style.show.evaluate(feature); // returns true or false depending on the feature's propertiesconst style = new Cesium.Cesium3DTileStyle(); // Override show expression with a custom function style.show = { evaluate : function(feature) { return true; } };const style = new Cesium.Cesium3DTileStyle(); // Override show expression with a boolean style.show = true; };const style = new Cesium.Cesium3DTileStyle(); // Override show expression with a string style.show = '${Height} > 0'; };const style = new Cesium.Cesium3DTileStyle(); // Override show expression with a condition style.show = { conditions: [ ['${height} > 2', 'false'], ['true', 'true'] ]; }; -
readonly styleObject
-
- Default Value: undefined
translucencyByDistanceStyleExpression
Gets or sets the StyleExpression object used to evaluate the style's translucencyByDistance property. Alternatively a string or object defining a vec4 style can be used.
The getter will return the internal Expression or ConditionsExpression, which may differ from the value provided to the setter.
The expression must return a Cartesian4.
This expression is only applicable to point features in a Vector tile.
Example
const style = new Cesium.Cesium3DTileStyle();
// Override translucencyByDistance expression with a string
style.translucencyByDistance = 'vec4(1.5e2, 1.0, 1.5e7, 0.2)';
style.translucencyByDistance.evaluate(feature); // returns a Cartesian4
verticalOriginStyleExpression
Gets or sets the StyleExpression object used to evaluate the style's verticalOrigin property. Alternatively a string or object defining a number style can be used.
The getter will return the internal Expression or ConditionsExpression, which may differ from the value provided to the setter.
The expression must return a VerticalOrigin.
This expression is only applicable to point features in a Vector tile.
Examples
const style = new Cesium3DTileStyle({
verticalOrigin : VerticalOrigin.TOP
});
style.verticalOrigin.evaluate(feature); // returns a VerticalOrigin
const style = new Cesium.Cesium3DTileStyle();
// Override verticalOrigin expression with a custom function
style.verticalOrigin = {
evaluate : function(feature) {
return VerticalOrigin.CENTER;
}
};