Cesium3DTileset
.
Evaluates an expression defined using the 3D Tiles Styling language.
Name | Type | Description |
---|---|---|
style |
Resource | String | Object | optional The url of a style or an object defining a style. |
Examples:
tileset.style = new Cesium.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 Cesium.Cesium3DTileStyle({
color : 'vec4(${Temperature})',
pointSize : '${Temperature} * 2.0'
});
See:
Members
-
anchorLineColor : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sanchorLineColor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override anchorLineColor expression with a string style.anchorLineColor = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override anchorLineColor expression with a condition style.anchorLineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
anchorLineEnabled : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sanchorLineEnabled
property. Alternatively a string or object defining a boolean style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Boolean
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override anchorLineEnabled expression with a string style.anchorLineEnabled = 'true';
var style = new Cesium.Cesium3DTileStyle(); // Override anchorLineEnabled expression with a condition style.anchorLineEnabled = { conditions : [ ['${height} > 2', 'true'], ['true', 'false'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
backgroundColor : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sbackgroundColor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override backgroundColor expression with a string style.backgroundColor = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override backgroundColor expression with a condition style.backgroundColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
backgroundEnabled : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sbackgroundEnabled
property. Alternatively a string or object defining a boolean style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Boolean
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override backgroundEnabled expression with a string style.backgroundEnabled = 'true';
var style = new Cesium.Cesium3DTileStyle(); // Override backgroundEnabled expression with a condition style.backgroundEnabled = { conditions : [ ['${height} > 2', 'true'], ['true', 'false'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
backgroundPadding : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sbackgroundPadding
property. Alternatively a string or object defining a vec2 style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Cartesian2
.Example:
var style = new Cesium.Cesium3DTileStyle(); // Override backgroundPadding expression with a string style.backgroundPadding = 'vec2(5.0, 7.0)'; style.backgroundPadding.evaluate(frameState, feature); // returns a Cartesian2
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
Gets or sets the
StyleExpression
object used to evaluate the style'scolor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium3DTileStyle({ color : '(${Temperature} > 90) ? color("red") : color("white")' }); style.color.evaluateColor(frameState, feature, result); // returns a Cesium.Color object
var style = new Cesium.Cesium3DTileStyle(); // Override color expression with a custom function style.color = { evaluateColor : function(frameState, feature, result) { return Cesium.Color.clone(Cesium.Color.WHITE, result); } };
var style = new Cesium.Cesium3DTileStyle(); // Override color expression with a string style.color = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override color expression with a condition style.color = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
-
disableDepthTestDistance : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sdisableDepthTestDistance
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Number
.Example:
var style = new Cesium.Cesium3DTileStyle(); // Override disableDepthTestDistance expression with a string style.disableDepthTestDistance = '1000.0'; style.disableDepthTestDistance.evaluate(frameState, feature); // returns a Number
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
distanceDisplayCondition : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sdistanceDisplayCondition
property. Alternatively a string or object defining a vec2 style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Cartesian2
.Example:
var style = new Cesium.Cesium3DTileStyle(); // Override distanceDisplayCondition expression with a string style.distanceDisplayCondition = 'vec2(0.0, 5.5e6)'; style.distanceDisplayCondition.evaluate(frameState, feature); // returns a Cartesian2
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
Gets or sets the
StyleExpression
object used to evaluate the style'sfont
property. Alternatively a string or object defining a string style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
String
.Examples:
var style = new Cesium3DTileStyle({ font : '(${Temperature} > 90) ? "30px Helvetica" : "24px Helvetica"' }); style.font.evaluate(frameState, feature); // returns a String
var style = new Cesium.Cesium3DTileStyle(); // Override font expression with a custom function style.font = { evaluate : function(frameState, feature) { return '24px Helvetica'; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
heightOffset : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sheightOffset
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Number
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override heightOffset expression with a string style.heightOffset = '2.0';
var style = new Cesium.Cesium3DTileStyle(); // Override heightOffset expression with a condition style.heightOffset = { conditions : [ ['${height} > 2', '4.0'], ['true', '2.0'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
horizontalOrigin : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'shorizontalOrigin
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
HorizontalOrigin
.Examples:
var style = new Cesium3DTileStyle({ horizontalOrigin : HorizontalOrigin.LEFT }); style.horizontalOrigin.evaluate(frameState, feature); // returns a HorizontalOrigin
var style = new Cesium.Cesium3DTileStyle(); // Override horizontalOrigin expression with a custom function style.horizontalOrigin = { evaluate : function(frameState, feature) { return HorizontalOrigin.CENTER; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
Gets or sets the
StyleExpression
object used to evaluate the style'simage
property. Alternatively a string or object defining a string style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
String
.Examples:
var style = new Cesium3DTileStyle({ image : '(${Temperature} > 90) ? "/url/to/image1" : "/url/to/image2"' }); style.image.evaluate(frameState, feature); // returns a String
var style = new Cesium.Cesium3DTileStyle(); // Override image expression with a custom function style.image = { evaluate : function(frameState, feature) { return '/url/to/image'; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelColor : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelColor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override labelColor expression with a string style.labelColor = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override labelColor expression with a condition style.labelColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelHorizontalOrigin : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelHorizontalOrigin
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
HorizontalOrigin
.Examples:
var style = new Cesium3DTileStyle({ labelHorizontalOrigin : HorizontalOrigin.LEFT }); style.labelHorizontalOrigin.evaluate(frameState, feature); // returns a HorizontalOrigin
var style = new Cesium.Cesium3DTileStyle(); // Override labelHorizontalOrigin expression with a custom function style.labelHorizontalOrigin = { evaluate : function(frameState, feature) { return HorizontalOrigin.CENTER; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelOutlineColor : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelOutlineColor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineColor expression with a string style.labelOutlineColor = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineColor expression with a condition style.labelOutlineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelOutlineWidth : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelOutlineWidth
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Number
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineWidth expression with a string style.labelOutlineWidth = '5';
var style = new Cesium.Cesium3DTileStyle(); // Override labelOutlineWidth expression with a condition style.labelOutlineWidth = { conditions : [ ['${height} > 2', '5'], ['true', '0'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelStyle : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabel style
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
LabelStyle
.Examples:
var style = new Cesium3DTileStyle({ labelStyle : '(${Temperature} > 90) ? ' + LabelStyle.FILL_AND_OUTLINE + ' : ' + LabelStyle.FILL }); style.labelStyle.evaluate(frameState, feature); // returns a LabelStyle
var style = new Cesium.Cesium3DTileStyle(); // Override labelStyle expression with a custom function style.labelStyle = { evaluate : function(frameState, feature) { return LabelStyle.FILL; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelText : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelText
property. Alternatively a string or object defining a string style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
String
.Examples:
var style = new Cesium3DTileStyle({ labelText : '(${Temperature} > 90) ? ">90" : "<=90"' }); style.labelText.evaluate(frameState, feature); // returns a String
var style = new Cesium.Cesium3DTileStyle(); // Override labelText expression with a custom function style.labelText = { evaluate : function(frameState, feature) { return 'Example label text'; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
labelVerticalOrigin : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'slabelVerticalOrigin
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
VerticalOrigin
.Examples:
var style = new Cesium3DTileStyle({ labelVerticalOrigin : VerticalOrigin.TOP }); style.labelVerticalOrigin.evaluate(frameState, feature); // returns a VerticalOrigin
var style = new Cesium.Cesium3DTileStyle(); // Override labelVerticalOrigin expression with a custom function style.labelVerticalOrigin = { evaluate : function(frameState, feature) { return VerticalOrigin.CENTER; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
Gets or sets the object containing application-specific expression that can be explicitly evaluated, e.g., for display in a UI.
Example:
var style = new Cesium3DTileStyle({ meta : { description : '"Building id ${id} has height ${Height}."' } }); style.meta.description.evaluate(frameState, feature); // returns a String with the substituted variables
-
pointOutlineColor : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'spointOutlineColor
property. Alternatively a string or object defining a color style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Color
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineColor expression with a string style.pointOutlineColor = 'color("blue")';
var style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineColor expression with a condition style.pointOutlineColor = { conditions : [ ['${height} > 2', 'color("cyan")'], ['true', 'color("blue")'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
pointOutlineWidth : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'spointOutlineWidth
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Number
.Examples:
var style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineWidth expression with a string style.pointOutlineWidth = '5';
var style = new Cesium.Cesium3DTileStyle(); // Override pointOutlineWidth expression with a condition style.pointOutlineWidth = { conditions : [ ['${height} > 2', '5'], ['true', '0'] ] };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
pointSize : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'spointSize
property. Alternatively a string or object defining a point size style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Number
.Examples:
var style = new Cesium3DTileStyle({ pointSize : '(${Temperature} > 90) ? 2.0 : 1.0' }); style.pointSize.evaluate(frameState, feature); // returns a Number
var style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a custom function style.pointSize = { evaluate : function(frameState, feature) { return 1.0; } };
var style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a number style.pointSize = 1.0;
var style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a string style.pointSize = '${height} / 10';
var style = new Cesium.Cesium3DTileStyle(); // Override pointSize expression with a condition style.pointSize = { conditions : [ ['${height} > 2', '1.0'], ['true', '2.0'] ] };
-
When
true
, the style is ready and its expressions can be evaluated. When a style is constructed with an object, as opposed to a url, this istrue
immediately.-
Default Value:
false
-
readonlyreadyPromise : Promise.<Cesium3DTileStyle>
-
Gets the promise that will be resolved when the the style is ready and its expressions can be evaluated.
-
scaleByDistance : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sscaleByDistance
property. Alternatively a string or object defining a vec4 style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Cartesian4
.Example:
var style = new Cesium.Cesium3DTileStyle(); // Override scaleByDistance expression with a string style.scaleByDistance = 'vec4(1.5e2, 2.0, 1.5e7, 0.5)'; style.scaleByDistance.evaluate(frameState, feature); // returns a Cartesian4
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
Gets or sets the
StyleExpression
object used to evaluate the style'sshow
property. Alternatively a boolean, string, or object defining a show style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return or convert to a
Boolean
.Examples:
var style = new Cesium3DTileStyle({ show : '(regExp("^Chest").test(${County})) && (${YearBuilt} >= 1970)' }); style.show.evaluate(frameState, feature); // returns true or false depending on the feature's properties
var style = new Cesium.Cesium3DTileStyle(); // Override show expression with a custom function style.show = { evaluate : function(frameState, feature) { return true; } };
var style = new Cesium.Cesium3DTileStyle(); // Override show expression with a boolean style.show = true; };
var style = new Cesium.Cesium3DTileStyle(); // Override show expression with a string style.show = '${Height} > 0'; };
var style = new Cesium.Cesium3DTileStyle(); // Override show expression with a condition style.show = { conditions: [ ['${height} > 2', 'false'], ['true', 'true'] ]; };
-
Gets the object defining the style using the 3D Tiles Styling language.
-
Default Value:
undefined
-
translucencyByDistance : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'stranslucencyByDistance
property. Alternatively a string or object defining a vec4 style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
Cartesian4
.Example:
var style = new Cesium.Cesium3DTileStyle(); // Override translucencyByDistance expression with a string style.translucencyByDistance = 'vec4(1.5e2, 1.0, 1.5e7, 0.2)'; style.translucencyByDistance.evaluate(frameState, feature); // returns a Cartesian4
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
-
verticalOrigin : StyleExpression
-
Gets or sets the
StyleExpression
object used to evaluate the style'sverticalOrigin
property. Alternatively a string or object defining a number style can be used. The getter will return the internalExpression
orConditionsExpression
, which may differ from the value provided to the setter.The expression must return a
VerticalOrigin
.Examples:
var style = new Cesium3DTileStyle({ verticalOrigin : VerticalOrigin.TOP }); style.verticalOrigin.evaluate(frameState, feature); // returns a VerticalOrigin
var style = new Cesium.Cesium3DTileStyle(); // Override verticalOrigin expression with a custom function style.verticalOrigin = { evaluate : function(frameState, feature) { return VerticalOrigin.CENTER; } };
Experimental
This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.