Cesium Billboard 广告牌的设置

时间：2022-02-28 04:20:39

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 callingBillboardCollection#add. 
viewport-aligned形象定位在3 d场景,创建 并呈现使用BillboardCollection。 和最初创建一个广告牌 通过调用属性集BillboardCollection#add。

Cesium Billboard 广告牌的设置
例子的广告牌
性能:

阅读一个属性,例如,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现场/广告牌。 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
Cesium Billboard 广告牌的设置 		alpha : 0.5
Cesium Billboard 广告牌的设置

红、绿、蓝,α值表示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点到屏幕上。 眼睛坐标作为世界和模型坐标,使用相同的尺度 这是典型的米。

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

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

Cesium Billboard 广告牌的设置 Cesium Billboard 广告牌的设置
b.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);

高度数量:现场/广告牌。 js 696

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

heightReference:HeightReference现场/广告牌。 js 249

获取或设置高度引用的广告牌。
默认值:  HeightReference.NONE

horizontalOrigin:HorizontalOrigin现场/广告牌。 js 483

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

Cesium Billboard 广告牌的设置
例子:
// 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
Cesium Billboard 广告牌的设置 		b.pixeloffset = new Cartesian2(50, 25);
Cesium Billboard 广告牌的设置
广告牌的起源是由黄点表示。

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收缩 的广告牌。

Cesium Billboard 广告牌的设置
上图从左到右,鳞片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

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

Cesium Billboard 广告牌的设置
例子:
// 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 可选存储结果的对象上。
返回:
空间位置的广告牌。
抛出:
例子:
console.log(b.computeScreenSpacePosition(scene).toString());
看到的:

=(其他)→布尔现场/广告牌。 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 次区域的形象。
抛出:

类型定义

CreateImageCallback(id)→图像画布| |承诺。<(图片|画布)>现场/广告牌。 js 1293

一个函数创建一个图像。
的名字 类型 描述
id 字符串 加载图片的标识符。
返回:
形象,或承诺,将解决一个图像。

标签：

相关文章