Cesium Billboard 广告牌的设置

Billboard

new Cesium.Billboard()

Scene/Billboard.js 76

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 calling BillboardCollection#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

演示:

• 铯沙塔广告牌演示

看到的:

• BillboardCollection
• BillboardCollection #添加
• 标签

成员

alignedAxis:Cartesian3

现场/广告牌。 js 655

获取或设置在世界空间轴对齐。 对齐的轴的单位向量向量指向广告牌。 缺省值是零向量,这意味着广告牌向量对齐到屏幕上。

例子:

// 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;

颜色:颜色

现场/广告牌。 js 592

获取或设置颜色乘以广告牌的纹理。 这有两个常见的用例。 首先, 相同的白色纹理可能使用许多不同的广告牌,每一个都有不同的颜色,去创造 彩色的广告牌。 第二,颜色的α组件可以用来制造广告牌半透明如下所示。 的α 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

现场/广告牌。 js 733

获取或设置条件指定在什么距离相机这个广告牌将显示出来。

默认值:  undefined

eyeOffset:Cartesian3

现场/广告牌。 js 450

获取或设置三维笛卡尔抵消应用这个广告牌的眼睛坐标。 眼睛坐标是一个左撇子 坐标系统, x 指向观众是正确的, y 分了, z 点到屏幕上。 眼睛坐标作为世界和模型坐标,使用相同的尺度 这是典型的米。

眼睛抵消通常用于安排多个广告牌或对象在同一位置,如 , 安排一个广告牌高于其相应的三维模型。

下面,这个广告牌被定位在地球的中心,但眼睛抵消使它总是 出现在地球上无论观众或地球的方向。

b.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);

高度数量:

现场/广告牌。 js 696

获取或设置一个高的广告牌。 如果未定义,将使用图像的高度。

heightReference:HeightReference

现场/广告牌。 js 249

获取或设置高度引用的广告牌。

默认值:  HeightReference.NONE

horizontalOrigin:HorizontalOrigin

现场/广告牌。 js 483

获取或设置水平的起源这个广告牌,这决定了如果广告牌 向左、中心或正确的位置。

例子:

// Use a bottom, left origin
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;

id:对象

现场/广告牌。 js 755

返回或者设置广告牌时选择了返回的用户定义的对象。

图像:字符串

现场/广告牌。 js 804

获取或设置图像用于这个广告牌。 如果一个纹理已经创建 给定的图像,使用现有的纹理。

这个属性可以设置为一个加载图片,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

现场/广告牌。 js 285

获取或设置屏幕空间的像素偏移的起源这个广告牌。 这是常用的 对齐多个广告牌和标签在同一位置,如 图像和文本。 的 屏幕空间的起源是,左角落的画布; x 增加从 从左到右 y 增加从上到下。

default

b.pixeloffset = new Cartesian2(50, 25);

广告牌的起源是由黄点表示。

pixelOffsetScaleByDistance:NearFarScalar

现场/广告牌。 js 409

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

现场/广告牌。 js 221

获取或设置笛卡儿这个广告牌的位置。

只读的Ready:Boolean

现场/广告牌。 js 837

当 true ,这个广告牌是准备渲染,即。 ,图像 已经被下载和WebGL资源创建。

默认值:  false

旋转数量:

现场/广告牌。 js 616

获取或设置旋转角的弧度。

规模数量:

现场/广告牌。 js 547

获取或设置统一的比例乘以广告牌的图像大小(以像素为单位)。 一个规模 1.0 不会改变大小的广告牌;规模大于 1.0 扩大广告牌;积极的规模不到 1.0 收缩 的广告牌。

上图从左到右,鳞片 0.5 , 1.0 , 和 2.0 。

scaleByDistance:NearFarScalar

现场/广告牌。 js 326

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;

显示:布尔

现场/广告牌。 js 198

决定如果这广告牌将显示。 用它来隐藏或显示一个广告牌,代替 删除它和re-adding集合。

sizeInMeters:布尔

现场/广告牌。 js 715

返回或者设置如果广告牌尺寸是米或像素。 true 在米大小的广告牌; 否则,像素的大小。

默认值:  false

translucencyByDistance:NearFarScalar

现场/广告牌。 js 367

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

现场/广告牌。 js 515

获取或设置垂直的起源这个广告牌,这决定了如果广告牌 上面,下面,或者在它的中心位置。

例子:

// Use a bottom, left origin
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;

宽度数量:

现场/广告牌。 js 679

返回或者设置宽度的广告牌。 如果未定义,将使用图像的宽度。

方法

computeScreenSpacePosition(场景,结果)→Cartesian2

现场/广告牌。 js 1178

计算的空间位置广告牌的起源、考虑到眼睛和像素偏移量。 屏幕空间的起源是,左角落的画布; x 增加从 从左到右 y 增加从上到下。

名字	类型	描述
scene	场景	现场。
result	Cartesian2	可选存储结果的对象上。

返回:

空间位置的广告牌。

抛出:

• DeveloperError :广告牌必须在一个集合中。

例子:

console.log(b.computeScreenSpacePosition(scene).toString());

看到的:

• 广告牌# eyeOffset
• 广告牌# pixelOffset

=(其他)→布尔

现场/广告牌。 js 1255

决定了如果这个广告牌等于另一个广告牌。 广告牌是相等的,如果所有的属性 是相等的。 在不同的集合可以平等的广告牌。

的名字	类型	描述
other	广告牌	的广告牌比较平等。

返回:

true 如果广告牌是相等的;否则, false 。

setImage(id、图片)

现场/广告牌。 js 1039

集图像用于这个广告牌。 如果一个纹理已经创建 鉴于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、次区域)

现场/广告牌。 js 1072

使用一个次区域的图像与给定id作为图像的广告牌, 以像素从左下角。

的名字	类型	描述
id	字符串	要使用的id映像。
subRegion	BoundingRectangle	次区域的形象。

抛出:

• RuntimeError :图像与id必须在阿特拉斯

类型定义

CreateImageCallback(id)→图像画布| |承诺。<(图片|画布)>

现场/广告牌。 js 1293

一个函数创建一个图像。

的名字	类型	描述
id	字符串	加载图片的标识符。

返回:

形象,或承诺,将解决一个图像。