Billboard
new Cesium.Billboard()
A viewport-aligned image positioned in the 3D scene, that is created and rendered using a BillboardCollection
. A billboard is created and its initial properties are set by callingBillboardCollection#add
.
viewport-aligned形象定位在3 d场景,创建 并呈现使用BillboardCollection
。 和最初创建一个广告牌 通过调用属性集BillboardCollection#add
。
例子的广告牌
性能:
阅读一个属性,例如,Billboard#show
是恒定的。 财产分配是常数时间但结果 当CPU与GPU流量BillboardCollection#update
被称为。 per-billboard交通是 是一样的,不管你有多少属性更新。 如果大多数广告牌需要集合 更新,它可能是更有效的清除集合BillboardCollection#removeAll
添加新的广告牌而不是修改每一个。
抛出:
-
DeveloperError:scaleByDistance。 必须大于scaleByDistance.near
-
DeveloperError:translucencyByDistance。 必须大于translucencyByDistance.near
-
DeveloperError:pixelOffsetScaleByDistance。 必须大于pixelOffsetScaleByDistance.near
-
DeveloperError:distanceDisplayCondition。 必须大于distanceDisplayCondition.near
演示:
看到的:
成员
alignedAxis:Cartesian3
获取或设置在世界空间轴对齐。 对齐的轴的单位向量向量指向广告牌。 缺省值是零向量,这意味着广告牌向量对齐到屏幕上。
例子:
-
// Example 1.
-
// Have the billboard up vector point north
-
billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z;
-
// Example 2.
-
// Have the billboard point east.
-
billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z;
-
billboard.rotation = -Cesium.Math.PI_OVER_TWO;
-
// Example 3.
-
// Reset the aligned axis
-
billboard.alignedAxis = Cesium.Cartesian3.ZERO;
颜色:颜色
获取或设置颜色乘以广告牌的纹理。 这有两个常见的用例。 首先, 相同的白色纹理可能使用许多不同的广告牌,每一个都有不同的颜色,去创造 彩色的广告牌。 第二,颜色的α组件可以用来制造广告牌半透明如下所示。 的α0.0
使广告牌透明,1.0
使广告牌不透明。
default ![]() | alpha : 0.5 ![]() |
红、绿、蓝,α值表示value
的red
,green
,blue
,alpha
属性,如例1所示。 这些组件包括0.0
(没有强度)1.0
(完整的强度)。
例子:
-
// Example 1. Assign yellow.
-
b.color = Cesium.Color.YELLOW;
-
// Example 2. Make a billboard 50% translucent.
-
b.color = new Cesium.Color(1.0, 1.0, 1.0, 0.5);
distanceDisplayCondition:DistanceDisplayCondition
获取或设置条件指定在什么距离相机这个广告牌将显示出来。
默认值: undefined
eyeOffset:Cartesian3
获取或设置三维笛卡尔抵消应用这个广告牌的眼睛坐标。 眼睛坐标是一个左撇子 坐标系统,x
指向观众是正确的,y
分了,z
点到屏幕上。 眼睛坐标作为世界和模型坐标,使用相同的尺度 这是典型的米。
眼睛抵消通常用于安排多个广告牌或对象在同一位置,如 , 安排一个广告牌高于其相应的三维模型。
下面,这个广告牌被定位在地球的中心,但眼睛抵消使它总是 出现在地球上无论观众或地球的方向。
![]() | ![]() |
b.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);
高度数量:
获取或设置一个高的广告牌。 如果未定义,将使用图像的高度。
heightReference:HeightReference
获取或设置高度引用的广告牌。
默认值: HeightReference.NONE
horizontalOrigin:HorizontalOrigin
获取或设置水平的起源这个广告牌,这决定了如果广告牌 向左、中心或正确的位置。
例子:
-
// Use a bottom, left origin
-
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
-
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;
id:对象
返回或者设置广告牌时选择了返回的用户定义的对象。
图像:字符串
获取或设置图像用于这个广告牌。 如果一个纹理已经创建 给定的图像,使用现有的纹理。
这个属性可以设置为一个加载图片,URL将作为图像自动加载, 一个画布,或另一个广告牌的图像属性(从相同的广告牌收集)。
例子:
-
// load an image from a URL
-
b.image = 'some/image/url.png';
-
// assuming b1 and b2 are billboards in the same billboard collection,
-
// use the same image for both billboards.
-
b2.image = b1.image;
pixelOffset:Cartesian2
获取或设置屏幕空间的像素偏移的起源这个广告牌。 这是常用的 对齐多个广告牌和标签在同一位置,如 图像和文本。 的 屏幕空间的起源是,左角落的画布;x
增加从 从左到右y
增加从上到下。
default ![]() | b.pixeloffset = new Cartesian2(50, 25); ![]() |
广告牌的起源是由黄点表示。
pixelOffsetScaleByDistance:NearFarScalar
get和set远近像素偏移广告牌的扩展属性根据广告牌的距离相机。 一个广告牌的像素偏移将之间的比例NearFarScalar#nearValue
和NearFarScalar#farValue
而相机距离属于上界和下界 指定的NearFarScalar#near
和NearFarScalar#far
。 这些范围以外的广告牌的像素偏移量表仍夹到最近的束缚。 如果未定义, pixelOffsetScaleByDistance将被禁用。
例子:
-
// Example 1.
-
// Set a billboard's pixel offset scale to 0.0 when the
-
// camera is 1500 meters from the billboard and scale pixel offset to 10.0 pixels
-
// in the y direction the camera distance approaches 8.0e6 meters.
-
b.pixelOffset = new Cesium.Cartesian2(0.0, 1.0);
-
b.pixelOffsetScaleByDistance = new Cesium.NearFarScalar(1.5e2, 0.0, 8.0e6, 10.0);
-
// Example 2.
-
// disable pixel offset by distance
-
b.pixelOffsetScaleByDistance = undefined;
位置:Cartesian3
获取或设置笛卡儿这个广告牌的位置。
只读的Ready:Boolean
当true
,这个广告牌是准备渲染,即。 ,图像 已经被下载和WebGL资源创建。
默认值: false
旋转数量:
获取或设置旋转角的弧度。
规模数量:
获取或设置统一的比例乘以广告牌的图像大小(以像素为单位)。 一个规模1.0
不会改变大小的广告牌;规模大于1.0
扩大广告牌;积极的规模不到1.0
收缩 的广告牌。
上图从左到右,鳞片0.5
,1.0
, 和2.0
。
scaleByDistance:NearFarScalar
get和set远近扩展属性的一个广告牌根据广告牌的距离相机。 一个广告牌的规模将之间的插入NearFarScalar#nearValue
和NearFarScalar#farValue
而相机距离属于上界和下界 指定的NearFarScalar#near
和NearFarScalar#far
。 这些范围之外的广告牌的规模依然夹到最近的绑定。 如果未定义, scaleByDistance将被禁用。
例子:
-
// Example 1.
-
// Set a billboard's scaleByDistance to scale by 1.5 when the
-
// camera is 1500 meters from the billboard and disappear as
-
// the camera distance approaches 8.0e6 meters.
-
b.scaleByDistance = new Cesium.NearFarScalar(1.5e2, 1.5, 8.0e6, 0.0);
-
// Example 2.
-
// disable scaling by distance
-
b.scaleByDistance = undefined;
显示:布尔
决定如果这广告牌将显示。 用它来隐藏或显示一个广告牌,代替 删除它和re-adding集合。
sizeInMeters:布尔
返回或者设置如果广告牌尺寸是米或像素。true
在米大小的广告牌; 否则,像素的大小。
默认值: false
translucencyByDistance:NearFarScalar
get和set远近广告牌的半透明属性根据广告牌的距离相机。 一个广告牌的半透明之间插入NearFarScalar#nearValue
和NearFarScalar#farValue
而相机距离属于上界和下界 指定的NearFarScalar#near
和NearFarScalar#far
。 这些范围之外的广告牌的半透明依然夹到最近的绑定。 如果未定义, translucencyByDistance将被禁用。
例子:
-
// Example 1.
-
// Set a billboard's translucency to 1.0 when the
-
// camera is 1500 meters from the billboard and disappear as
-
// the camera distance approaches 8.0e6 meters.
-
b.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);
-
// Example 2.
-
// disable translucency by distance
-
b.translucencyByDistance = undefined;
verticalOrigin:VerticalOrigin
获取或设置垂直的起源这个广告牌,这决定了如果广告牌 上面,下面,或者在它的中心位置。
例子:
-
// Use a bottom, left origin
-
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
-
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;
宽度数量:
返回或者设置宽度的广告牌。 如果未定义,将使用图像的宽度。
方法
computeScreenSpacePosition(场景,结果)→Cartesian2
计算的空间位置广告牌的起源、考虑到眼睛和像素偏移量。 屏幕空间的起源是,左角落的画布;x
增加从 从左到右y
增加从上到下。
名字 | 类型 | 描述 |
---|---|---|
scene | 场景 | 现场。 |
result | Cartesian2 | 可选存储结果的对象上。 |
返回:
空间位置的广告牌。
抛出:
-
DeveloperError:广告牌必须在一个集合中。
例子:
console.log(b.computeScreenSpacePosition(scene).toString());
看到的:
=(其他)→布尔
决定了如果这个广告牌等于另一个广告牌。 广告牌是相等的,如果所有的属性 是相等的。 在不同的集合可以平等的广告牌。
的名字 | 类型 | 描述 |
---|---|---|
other | 广告牌 | 的广告牌比较平等。 |
返回:
true
如果广告牌是相等的;否则,false
。
setImage(id、图片)
集图像用于这个广告牌。 如果一个纹理已经创建 鉴于id,使用现有的纹理。
这个函数是用于动态创建共享的纹理在许多广告牌。 只有第一个广告牌会调用该函数创建纹理,而随后 广告牌使用相同的id将简单地创建重用现有的纹理。
加载一个图像从一个URL设置Billboard#image
属性是更方便。
名字 | 类型 | 描述 |
---|---|---|
id | 字符串 | 图像的id。 这可以是任何字符串,唯一地标识图像。 |
image | 图像|帆布|字符串|广告牌~ CreateImageCallback | 图像加载。 这个参数 可以是一个加载图像或帆布,URL将作为图像自动加载, 或一个函数将调用来创建图像如果它还没有被加载了。 |
例子:
-
// create a billboard image dynamically
-
function drawImage(id) {
-
// create and draw an image using a canvas
-
var canvas = document.createElement('canvas');
-
var context2D = canvas.getContext('2d');
-
// ... draw image
-
return canvas;
-
}
-
// drawImage will be called to create the texture
-
b.setImage('myImage', drawImage);
-
// subsequent billboards created in the same collection using the same id will use the existing
-
// texture, without the need to create the canvas or draw the image
-
b2.setImage('myImage', drawImage);
setImageSubRegion(id、次区域)
使用一个次区域的图像与给定id作为图像的广告牌, 以像素从左下角。
的名字 | 类型 | 描述 |
---|---|---|
id | 字符串 | 要使用的id映像。 |
subRegion | BoundingRectangle | 次区域的形象。 |
抛出:
-
RuntimeError:图像与id必须在阿特拉斯
类型定义
CreateImageCallback(id)→图像画布| |承诺。<(图片|画布)>
一个函数创建一个图像。
的名字 | 类型 | 描述 |
---|---|---|
id | 字符串 | 加载图片的标识符。 |
返回:
形象,或承诺,将解决一个图像。
转自:https://blog.csdn.net/sinat_35954205/article/details/52869791