Camera

攝像機由位置，方向和視錐臺定義。

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

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

new Camera(scene)

Parameters:

scene (Scene) 現場。

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

當相機飛到包含邊界球體的位置時使用的默認方向/間距/范圍。

(static) DEFAULT_VIEW_FACTOR : Number

要乘以相機位置并在設置相機以查看矩形后將其添加回的標量。值為零表示相機將查看整個Camera#DEFAULT_VIEW_RECTANGLE，大于零的值將使其遠離范圍，小于零的值將使其靠近范圍。

(static) DEFAULT_VIEW_RECTANGLE : Rectangle

創建時相機將查看的默認矩形。

(readonly) changed : Event

獲取照相機更改percentageChanged時將引發的事件。

constrainedAxis : Cartesian3

如果設置，相機將無法在任何方向上旋轉超過此軸。

Default Value: undefined

defaultLookAmount : Number

當沒有為Look方法提供參數時旋轉相機的默認值。

Default Value: Math.PI / 60.0

defaultMoveAmount : Number

移動方法未提供參數時移動相機的默認值。

Default Value: 100000.0;

defaultRotateAmount : Number

當沒有為Rotate方法提供參數時旋轉相機的默認量。

Default Value: Math.PI / 3600.0

defaultZoomAmount : Number

當沒有為縮放方法提供參數時移動相機的默認量。

Default Value: 100000.0;

direction : Cartesian3

相機的視圖方向。

(readonly) directionWC : Cartesian3

獲取攝像機在世界坐標中的視圖方向。

frustum : Frustum

視野中的空間區域。

Default Value: PerspectiveFrustum()

See:

(readonly) heading : Number

獲取以弧度表示的相機標題。

(readonly) inverseTransform : Matrix4

獲取逆相機轉換。

Default Value: Matrix4.IDENTITY

(readonly) inverseViewMatrix : Matrix4

獲取逆視圖矩陣。

See:

Camera#viewMatrix

maximumZoomFactor : Number

乘以從表面縮小時用于確定在何處夾住相機位置的地圖大小的系數。默認值為1.5。僅對二維有效，地圖可旋轉。

Default Value: 1.5

(readonly) moveEnd : Event

獲取相機停止移動時將引發的事件。

(readonly) moveStart : Event

獲取攝像機開始移動時將引發的事件。

percentageChanged : number

在changed事件發生之前，相機必須更改的數量。該值是[0，1]范圍內的百分比。

Default Value: 0.5

(readonly) pitch : Number

獲取以弧度表示的相機間距。

position : Cartesian3

相機的位置。

(readonly) positionCartographic : Cartographic

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

(readonly) positionWC : Cartesian3

獲取攝像機在世界坐標中的位置。

(readonly) rightWC : Cartesian3

獲取攝像機在世界坐標中的正確方向。

(readonly) roll : Number

使相機以弧度滾動。

(readonly) transform : Matrix4

獲取相機的參考幀。這個轉換的逆矩陣被附加到視圖矩陣中。

Default Value: Matrix4.IDENTITY

(readonly) upWC : Cartesian3

獲取攝像機在世界坐標中的向上方向。

(readonly) viewMatrix : Matrix4

獲取視圖矩陣。

See:

Camera#inverseViewMatrix

Methods

cameraToWorldCoordinates(cartesian, result) → {Cartesian4}

將相機參考幀中的向量或點轉換為世界坐標。

Parameters:

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

result (Cartesian4) 存儲結果的對象。

cameraToWorldCoordinatesPoint(cartesian, result) → {Cartesian3}

將點從相機的參考幀轉換為世界坐標。

Parameters:

cartesian (Cartesian3) 要轉換的點。

result (Cartesian3) 存儲結果的對象。

cameraToWorldCoordinatesVector(cartesian, result) → {Cartesian3}

將矢量從相機的參考幀轉換為世界坐標。

Parameters:

cartesian (Cartesian3) 要轉換的向量。

result (Cartesian3) 存儲結果的對象。

cancelFlight()

如果正在進行，取消當前的相機飛行。相機留在當前位置。

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

計算橢圓體上的近似可見矩形。

Parameters:

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

result (Rectangle) 存儲結果的矩形

distanceToBoundingSphere(boundingSphere) → {Number}

返回從相機到邊界球前面的距離。

Parameters:

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

flyHome(duration)

將相機轉到主視圖。使用Camera#.DEFAULT_VIEW_RECTANGLE設置三維場景的默認視圖。二維和哥倫布視圖的主視圖顯示整個地圖。

Parameters:

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

flyTo(options)

將相機從當前位置飛到新位置。

Parameters:

options (Object)

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

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)

將相機飛到當前視圖包含提供的邊界球體的位置。

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

在二維和哥倫布視圖中，必須有一個自上而下的視圖。相機將放在目標上方向下看。高于目標的高度將是范圍。航向將與當地北部對齊。

Parameters:

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

options (Object)

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

getMagnitude() → {Number}

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

getPickRay(windowPosition, result) → {Ray}

從相機位置通過世界坐標中windowPosition處的像素創建光線。

Parameters:

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

result (Ray) 存儲結果的對象。

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

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

Parameters:

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

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

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

getRectangleCameraCoordinates(rectangle, result) → {Cartesian3}

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

Parameters:

rectangle (Rectangle) 要查看的矩形。

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

look(axis, angle)

將相機的每個方向向量圍繞axis旋轉angle

Parameters:

axis (Cartesian3) 要旋轉的軸。

angle (Number) 以弧度表示的旋轉角度。默認為defaultLookAmount。

See:

lookAt(target, offset)

使用目標和偏移設置相機位置和方向。目標必須以世界坐標給出。偏移可以是笛卡爾坐標系，也可以是以目標為中心的東北向上局部參照系中的航向/俯仰/范圍。如果偏移量是笛卡爾坐標系的，那么它是相對于由變換矩陣定義的參照系中心的偏移量。如果偏移量為航向/俯仰/范圍，則航向和俯仰角在變換矩陣定義的參考框中定義。航向是從Y軸到X軸的角度。螺距是從xy平面開始的旋轉。正俯仰角在平面以下。負的螺距角在平面上方。范圍是距中心的距離。在2d中，必須有一個自頂向下的視圖。相機將放在目標上方向下看。目標上方的高度將是偏移量的大小。航向將根據偏移量確定。如果無法從偏移量確定航向，則航向將為北。

Parameters:

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

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

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 : 變形時不支持LookAt。

lookAtTransform(transform, offset)

使用目標和變換矩陣設置相機位置和方向。偏移量可以是笛卡爾或航向/俯仰/范圍。如果偏移量是笛卡爾坐標系的，那么它是相對于由變換矩陣定義的參照系中心的偏移量。如果偏移量為航向/俯仰/范圍，則航向和俯仰角在變換矩陣定義的參考框中定義。航向是從Y軸到X軸的角度。螺距是從xy平面開始的旋轉。正俯仰角在平面以下。負的螺距角在平面上方。范圍是距中心的距離。在2d中，必須有一個自頂向下的視圖。相機將放置在參考框架的中心上方。目標上方的高度將是偏移量的大小。航向將根據偏移量確定。如果無法從偏移量確定航向，則航向將為北。

Parameters:

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

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

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 : 變形時不支持LookAtTransform。

lookDown(amount)

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

Parameters:

amount (Number) 以弧度表示的旋轉量。默認為defaultLookAmount。

See:

Camera#lookUp

lookLeft(amount)

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

Parameters:

amount (Number) 以弧度表示的旋轉量。默認為defaultLookAmount。

See:

Camera#lookRight

lookRight(amount)

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

Parameters:

amount (Number) 以弧度表示的旋轉量。默認為defaultLookAmount。

See:

Camera#lookLeft

lookUp(amount)

如果不是在二維模式下，則將相機繞其右向量以弧度的數量沿其上方向旋轉。

Parameters:

amount (Number) 以弧度表示的旋轉量。默認為defaultLookAmount。

See:

Camera#lookDown

move(direction, amount)

將相機位置沿direction轉換amount。