Camera

攝像機(jī)由位置，方向和視錐臺(tái)定義。

方向與視圖形成正交基礎(chǔ)，上和右=視圖x上單位矢量。

視錐由6個(gè)平面定義。每個(gè)平面都由Cartesian4對(duì)象表示，其中x，y和z分量定義垂直于該平面的單位矢量，而w分量是該平面與原點(diǎn)/相機(jī)位置的距離。

new Camera(scene)

Parameters:

scene (Scene) 現(xiàn)場(chǎng)。

Example

// Create a camera looking down the negative z-axis, positioned at the origin,
// with a field of view of 60 degrees, and 1:1 aspect ratio.
var camera = new bmgl.Camera(scene);
camera.position = new bmgl.Cartesian3();
camera.direction = bmgl.Cartesian3.negate(bmgl.Cartesian3.UNIT_Z, new bmgl.Cartesian3());
camera.up = bmgl.Cartesian3.clone(bmgl.Cartesian3.UNIT_Y);
camera.frustum.fov = bmgl.Math.PI_OVER_THREE;
camera.frustum.near = 1.0;
camera.frustum.far = 2.0;

Members

(static) DEFAULT_OFFSET : HeadingPitchRange

當(dāng)相機(jī)飛到包含邊界球體的位置時(shí)使用的默認(rèn)方向/間距/范圍。

(static) DEFAULT_VIEW_FACTOR : Number

要乘以相機(jī)位置并在設(shè)置相機(jī)以查看矩形后將其添加回的標(biāo)量。值為零表示相機(jī)將查看整個(gè)Camera#DEFAULT_VIEW_RECTANGLE，大于零的值將使其遠(yuǎn)離范圍，小于零的值將使其靠近范圍。

(static) DEFAULT_VIEW_RECTANGLE : Rectangle

創(chuàng)建時(shí)相機(jī)將查看的默認(rèn)矩形。

(readonly) changed : Event

獲取照相機(jī)更改percentageChanged時(shí)將引發(fā)的事件。

constrainedAxis : Cartesian3

如果設(shè)置，相機(jī)將無法在任何方向上旋轉(zhuǎn)超過此軸。

Default Value: undefined

defaultLookAmount : Number

當(dāng)沒有為L(zhǎng)ook方法提供參數(shù)時(shí)旋轉(zhuǎn)相機(jī)的默認(rèn)值。

Default Value: Math.PI / 60.0

defaultMoveAmount : Number

移動(dòng)方法未提供參數(shù)時(shí)移動(dòng)相機(jī)的默認(rèn)值。

Default Value: 100000.0;

defaultRotateAmount : Number

當(dāng)沒有為Rotate方法提供參數(shù)時(shí)旋轉(zhuǎn)相機(jī)的默認(rèn)量。

Default Value: Math.PI / 3600.0

defaultZoomAmount : Number

當(dāng)沒有為縮放方法提供參數(shù)時(shí)移動(dòng)相機(jī)的默認(rèn)量。

Default Value: 100000.0;

direction : Cartesian3

相機(jī)的視圖方向。

(readonly) directionWC : Cartesian3

獲取攝像機(jī)在世界坐標(biāo)中的視圖方向。

frustum : Frustum

視野中的空間區(qū)域。

Default Value: PerspectiveFrustum()

See:

(readonly) heading : Number

獲取以弧度表示的相機(jī)標(biāo)題。

(readonly) inverseTransform : Matrix4

獲取逆相機(jī)轉(zhuǎn)換。

Default Value: Matrix4.IDENTITY

(readonly) inverseViewMatrix : Matrix4

獲取逆視圖矩陣。

See:

Camera#viewMatrix

maximumZoomFactor : Number

乘以從表面縮小時(shí)用于確定在何處夾住相機(jī)位置的地圖大小的系數(shù)。默認(rèn)值為1.5。僅對(duì)二維有效，地圖可旋轉(zhuǎn)。

Default Value: 1.5

(readonly) moveEnd : Event

獲取相機(jī)停止移動(dòng)時(shí)將引發(fā)的事件。

(readonly) moveStart : Event

獲取攝像機(jī)開始移動(dòng)時(shí)將引發(fā)的事件。

percentageChanged : number

在changed事件發(fā)生之前，相機(jī)必須更改的數(shù)量。該值是[0，1]范圍內(nèi)的百分比。

Default Value: 0.5

(readonly) pitch : Number

獲取以弧度表示的相機(jī)間距。

position : Cartesian3

相機(jī)的位置。

(readonly) positionCartographic : Cartographic

獲取相機(jī)的Cartographic位置，經(jīng)度和緯度以弧度表示，高度以米為單位。在二維和哥倫布視圖中，當(dāng)相機(jī)位于地圖之外時(shí)，返回的經(jīng)度和緯度可能超出有效經(jīng)度和緯度的范圍。

(readonly) positionWC : Cartesian3

獲取攝像機(jī)在世界坐標(biāo)中的位置。

(readonly) rightWC : Cartesian3

獲取攝像機(jī)在世界坐標(biāo)中的正確方向。

(readonly) roll : Number

使相機(jī)以弧度滾動(dòng)。

(readonly) transform : Matrix4

獲取相機(jī)的參考幀。這個(gè)轉(zhuǎn)換的逆矩陣被附加到視圖矩陣中。

Default Value: Matrix4.IDENTITY

(readonly) upWC : Cartesian3

獲取攝像機(jī)在世界坐標(biāo)中的向上方向。

(readonly) viewMatrix : Matrix4

獲取視圖矩陣。

See:

Camera#inverseViewMatrix

Methods

cameraToWorldCoordinates(cartesian, result) → {Cartesian4}

將相機(jī)參考幀中的向量或點(diǎn)轉(zhuǎn)換為世界坐標(biāo)。

Parameters:

cartesian (Cartesian4) 要變換的向量或點(diǎn)。

result (Cartesian4) 存儲(chǔ)結(jié)果的對(duì)象。

cameraToWorldCoordinatesPoint(cartesian, result) → {Cartesian3}

將點(diǎn)從相機(jī)的參考幀轉(zhuǎn)換為世界坐標(biāo)。

Parameters:

cartesian (Cartesian3) 要轉(zhuǎn)換的點(diǎn)。

result (Cartesian3) 存儲(chǔ)結(jié)果的對(duì)象。

cameraToWorldCoordinatesVector(cartesian, result) → {Cartesian3}

將矢量從相機(jī)的參考幀轉(zhuǎn)換為世界坐標(biāo)。

Parameters:

cartesian (Cartesian3) 要轉(zhuǎn)換的向量。

result (Cartesian3) 存儲(chǔ)結(jié)果的對(duì)象。

cancelFlight()

如果正在進(jìn)行，取消當(dāng)前的相機(jī)飛行。相機(jī)留在當(dāng)前位置。

computeViewRectangle(ellipsoid, result) → {Rectangle|undefined}

計(jì)算橢圓體上的近似可見矩形。

Parameters:

ellipsoid (Ellipsoid) (default Ellipsoid.WGS84) 要知道可見區(qū)域的橢球體。

result (Rectangle) 存儲(chǔ)結(jié)果的矩形

distanceToBoundingSphere(boundingSphere) → {Number}

返回從相機(jī)到邊界球前面的距離。

Parameters:

boundingSphere (BoundingSphere) 世界坐標(biāo)系中的邊界球。

flyHome(duration)

將相機(jī)轉(zhuǎn)到主視圖。使用Camera#.DEFAULT_VIEW_RECTANGLE設(shè)置三維場(chǎng)景的默認(rèn)視圖。二維和哥倫布視圖的主視圖顯示整個(gè)地圖。

Parameters:

duration (Number) 以秒為單位的飛行時(shí)間。如果忽略，bigemap-gl將根據(jù)航班要行駛的距離計(jì)算理想持續(xù)時(shí)間。見Camera#flyTo

flyTo(options)

將相機(jī)從當(dāng)前位置飛到新位置。

Parameters:

options (Object)

Name	Description
options.destination `(Cartesian3 \| Rectangle)`	攝像機(jī)在WGS84（世界）坐標(biāo)中的最終位置，或從俯視圖可見的矩形。
options.orientation `Object`	包含方向和向上屬性或航向、縱搖和橫搖屬性的對(duì)象。默認(rèn)情況下，該方向?qū)⒅赶蛉S中的幀中心，并在Columbus視圖中指向負(fù)Z方向。在哥倫布視圖中，向上方向?qū)⒅赶蚓植勘比S方向和正Y方向。在無限滾動(dòng)模式下，方向不用于二維。
options.duration `Number`	以秒為單位的飛行時(shí)間。如果忽略，bigemap-gl將根據(jù)航班要行駛的距離計(jì)算理想持續(xù)時(shí)間。
options.complete `Camera~FlightCompleteCallback`	飛行完成后執(zhí)行的功能。
options.cancel `Camera~FlightCancelledCallback`	航班取消時(shí)執(zhí)行的功能。
options.endTransform `Matrix4`	轉(zhuǎn)換矩陣表示飛行完成后相機(jī)將處于的參考幀。
options.maximumHeight `Number`	飛行高峰期的最大高度。
options.pitchAdjustHeight `Number`	如果相機(jī)的飛行速度高于該值，請(qǐng)?jiān)陲w行過程中調(diào)整俯仰以向下看，并將地球保持在視區(qū)中。
options.flyOverLongitude `Number`	地球上兩點(diǎn)之間總是有兩種方式。這個(gè)選項(xiàng)強(qiáng)制相機(jī)選擇戰(zhàn)斗方向飛越經(jīng)度。
options.flyOverLongitudeWeight `Number`	只有在飛行長(zhǎng)度不超過飛行長(zhǎng)度的短距離乘以飛行長(zhǎng)度重量時(shí)，才能飛越飛行長(zhǎng)度指定的長(zhǎng)度。
options.convert `Boolean`	是否將目的地從世界坐標(biāo)轉(zhuǎn)換為場(chǎng)景坐標(biāo)（僅在不使用3D時(shí)相關(guān)）。默認(rèn)為`true`。
options.easingFunction `(EasingFunction \| EasingFunction~Callback)`	控制在飛行期間如何插入時(shí)間。

Example

// 1. Fly to a position with a top-down view
viewer.camera.flyTo({
    destination : bmgl.Cartesian3.fromDegrees(-117.16, 32.71, 15000.0)
});

// 2. Fly to a Rectangle with a top-down view
viewer.camera.flyTo({
    destination : bmgl.Rectangle.fromDegrees(west, south, east, north)
});

// 3. Fly to a position with an orientation using unit vectors.
viewer.camera.flyTo({
    destination : bmgl.Cartesian3.fromDegrees(-122.19, 46.25, 5000.0),
    orientation : {
        direction : new bmgl.Cartesian3(-0.04231243104240401, -0.20123236049443421, -0.97862924300734),
        up : new bmgl.Cartesian3(-0.47934589305293746, -0.8553216253114552, 0.1966022179118339)
    }
});

// 4. Fly to a position with an orientation using heading, pitch and roll.
viewer.camera.flyTo({
    destination : bmgl.Cartesian3.fromDegrees(-122.19, 46.25, 5000.0),
    orientation : {
        heading : bmgl.Math.toRadians(175.0),
        pitch : bmgl.Math.toRadians(-35.0),
        roll : 0.0
    }
});

Throws

DeveloperError : 如果給出方向或向上，則兩者都是必需的。

flyToBoundingSphere(boundingSphere, options)

將相機(jī)飛到當(dāng)前視圖包含提供的邊界球體的位置。

偏移量是以邊界球中心為中心的局部東北向上參考框中的航向/俯仰/范圍。航向和俯仰角在本地東北向上參考框架中定義。航向是從Y軸到X軸的角度。螺距是從xy平面開始的旋轉(zhuǎn)。正俯仰角在平面以下。負(fù)的螺距角在平面上方。范圍是距中心的距離。如果范圍為零，則計(jì)算范圍以使整個(gè)邊界球可見。

在二維和哥倫布視圖中，必須有一個(gè)自上而下的視圖。相機(jī)將放在目標(biāo)上方向下看。高于目標(biāo)的高度將是范圍。航向?qū)⑴c當(dāng)?shù)乇辈繉?duì)齊。

Parameters:

boundingSphere (BoundingSphere) 要查看的邊界球，在世界坐標(biāo)中。

options (Object)

Name	Description
options.duration `Number`	以秒為單位的飛行時(shí)間。如果忽略，bigemap-gl將根據(jù)航班要行駛的距離計(jì)算理想持續(xù)時(shí)間。
options.offset `HeadingPitchRange`	在以目標(biāo)為中心的局部東北向上參考幀中距目標(biāo)的偏移。
options.complete `Camera~FlightCompleteCallback`	飛行完成后執(zhí)行的功能。
options.cancel `Camera~FlightCancelledCallback`	航班取消時(shí)執(zhí)行的功能。
options.endTransform `Matrix4`	轉(zhuǎn)換矩陣表示飛行完成后相機(jī)將處于的參考幀。
options.maximumHeight `Number`	飛行高峰期的最大高度。
options.pitchAdjustHeight `Number`	如果相機(jī)的飛行速度高于該值，請(qǐng)?jiān)陲w行過程中調(diào)整俯仰以向下看，并將地球保持在視區(qū)中。
options.flyOverLongitude `Number`	地球上兩點(diǎn)之間總是有兩種方式。這個(gè)選項(xiàng)強(qiáng)制相機(jī)選擇戰(zhàn)斗方向飛越經(jīng)度。
options.flyOverLongitudeWeight `Number`	只有在飛行長(zhǎng)度不超過飛行長(zhǎng)度的短距離乘以飛行長(zhǎng)度重量時(shí)，才能飛越飛行長(zhǎng)度指定的長(zhǎng)度。
options.easingFunction `(EasingFunction \| EasingFunction~Callback)`	控制在飛行期間如何插入時(shí)間。

getMagnitude() → {Number}

獲取相機(jī)位置的大小。在3D中，這是矢量大小。在二維和哥倫布視圖中，這是到地圖的距離。

getPickRay(windowPosition, result) → {Ray}

從相機(jī)位置通過世界坐標(biāo)中windowPosition處的像素創(chuàng)建光線。

Parameters:

windowPosition (Cartesian2) 像素的x和y坐標(biāo)。

result (Ray) 存儲(chǔ)結(jié)果的對(duì)象。

getPixelSize(boundingSphere, drawingBufferWidth, drawingBufferHeight) → {Number}

返回以米為單位的像素大小。

Parameters:

boundingSphere (BoundingSphere) 世界坐標(biāo)系中的邊界球。

drawingBufferWidth (Number) 繪圖緩沖區(qū)寬度。

drawingBufferHeight (Number) 繪圖緩沖區(qū)高度。

getRectangleCameraCoordinates(rectangle, result) → {Cartesian3}

獲取在橢球體或地圖上查看矩形所需的相機(jī)位置

Parameters:

rectangle (Rectangle) 要查看的矩形。

result (Cartesian3) 查看矩形所需的相機(jī)位置

look(axis, angle)

將相機(jī)的每個(gè)方向向量圍繞axis旋轉(zhuǎn)angle

Parameters:

axis (Cartesian3) 要旋轉(zhuǎn)的軸。

angle (Number) 以弧度表示的旋轉(zhuǎn)角度。默認(rèn)為defaultLookAmount。

See:

lookAt(target, offset)

使用目標(biāo)和偏移設(shè)置相機(jī)位置和方向。目標(biāo)必須以世界坐標(biāo)給出。偏移可以是笛卡爾坐標(biāo)系，也可以是以目標(biāo)為中心的東北向上局部參照系中的航向/俯仰/范圍。如果偏移量是笛卡爾坐標(biāo)系的，那么它是相對(duì)于由變換矩陣定義的參照系中心的偏移量。如果偏移量為航向/俯仰/范圍，則航向和俯仰角在變換矩陣定義的參考框中定義。航向是從Y軸到X軸的角度。螺距是從xy平面開始的旋轉(zhuǎn)。正俯仰角在平面以下。負(fù)的螺距角在平面上方。范圍是距中心的距離。在2d中，必須有一個(gè)自頂向下的視圖。相機(jī)將放在目標(biāo)上方向下看。目標(biāo)上方的高度將是偏移量的大小。航向?qū)⒏鶕?jù)偏移量確定。如果無法從偏移量確定航向，則航向?qū)楸薄?

Parameters:

target (Cartesian3) 世界坐標(biāo)中的目標(biāo)位置。

offset ((Cartesian3 | HeadingPitchRange)) 在以目標(biāo)為中心的局部東北向上參考幀中距目標(biāo)的偏移。

Example

// 1. Using a cartesian offset
var center = bmgl.Cartesian3.fromDegrees(-98.0, 40.0);
viewer.camera.lookAt(center, new bmgl.Cartesian3(0.0, -4790000.0, 3930000.0));

// 2. Using a HeadingPitchRange offset
var center = bmgl.Cartesian3.fromDegrees(-72.0, 40.0);
var heading = bmgl.Math.toRadians(50.0);
var pitch = bmgl.Math.toRadians(-20.0);
var range = 5000.0;
viewer.camera.lookAt(center, new bmgl.HeadingPitchRange(heading, pitch, range));

Throws

DeveloperError : 變形時(shí)不支持LookAt。

lookAtTransform(transform, offset)

使用目標(biāo)和變換矩陣設(shè)置相機(jī)位置和方向。偏移量可以是笛卡爾或航向/俯仰/范圍。如果偏移量是笛卡爾坐標(biāo)系的，那么它是相對(duì)于由變換矩陣定義的參照系中心的偏移量。如果偏移量為航向/俯仰/范圍，則航向和俯仰角在變換矩陣定義的參考框中定義。航向是從Y軸到X軸的角度。螺距是從xy平面開始的旋轉(zhuǎn)。正俯仰角在平面以下。負(fù)的螺距角在平面上方。范圍是距中心的距離。在2d中，必須有一個(gè)自頂向下的視圖。相機(jī)將放置在參考框架的中心上方。目標(biāo)上方的高度將是偏移量的大小。航向?qū)⒏鶕?jù)偏移量確定。如果無法從偏移量確定航向，則航向?qū)楸薄?

Parameters:

transform (Matrix4) 定義參照系的變換矩陣。

offset ((Cartesian3 | HeadingPitchRange)) 在以目標(biāo)為中心的參考框中與目標(biāo)的偏移量。

Example

// 1. Using a cartesian offset
var transform = bmgl.Transforms.eastNorthUpToFixedFrame(bmgl.Cartesian3.fromDegrees(-98.0, 40.0));
viewer.camera.lookAtTransform(transform, new bmgl.Cartesian3(0.0, -4790000.0, 3930000.0));

// 2. Using a HeadingPitchRange offset
var transform = bmgl.Transforms.eastNorthUpToFixedFrame(bmgl.Cartesian3.fromDegrees(-72.0, 40.0));
var heading = bmgl.Math.toRadians(50.0);
var pitch = bmgl.Math.toRadians(-20.0);
var range = 5000.0;
viewer.camera.lookAtTransform(transform, new bmgl.HeadingPitchRange(heading, pitch, range));

Throws

DeveloperError : 變形時(shí)不支持LookAtTransform。

lookDown(amount)

如果不是在二維模式下，則沿其上方向向量的相反方向，以弧度圍繞其右向量旋轉(zhuǎn)相機(jī)。

Parameters:

amount (Number) 以弧度表示的旋轉(zhuǎn)量。默認(rèn)為defaultLookAmount。

See:

Camera#lookUp

lookLeft(amount)

如果不是在二維模式下，則沿其右向量的相反方向，以弧度為單位，圍繞其上方向向量旋轉(zhuǎn)相機(jī)。

Parameters:

amount (Number) 以弧度表示的旋轉(zhuǎn)量。默認(rèn)為defaultLookAmount。

See:

Camera#lookRight

lookRight(amount)

如果不是在二維模式下，則沿其右向量的方向，以弧度為單位，圍繞其上方向向量旋轉(zhuǎn)相機(jī)。

Parameters:

amount (Number) 以弧度表示的旋轉(zhuǎn)量。默認(rèn)為defaultLookAmount。

See:

Camera#lookLeft

lookUp(amount)

如果不是在二維模式下，則將相機(jī)繞其右向量以弧度的數(shù)量沿其上方向旋轉(zhuǎn)。

Parameters:

amount (Number) 以弧度表示的旋轉(zhuǎn)量。默認(rèn)為defaultLookAmount。

See:

Camera#lookDown

move(direction, amount)

將相機(jī)位置沿direction轉(zhuǎn)換amount。