LuciadCPillar C# 2024.0.05
|
A camera that uses an orthographic (or parallel) projection. More...
Classes | |
class | Builder |
Factory object that can create new OrthographicCamera instances. More... | |
Public Member Functions | |
Luciad.Cameras.OrthographicCamera.Builder | AsBuilder () |
Returns a Builder that can build cameras identical to this camera. More... | |
Luciad.Cameras.Camera.Look2D | AsLook2D () |
Returns a description of the camera location targeted towards a 2D top-down view of the map. More... | |
Public Member Functions inherited from Luciad.Cameras.Camera | |
void | Dispose () |
virtual Luciad.Cartesian.Coordinate | MapToView (Luciad.Cartesian.Coordinate mapPoint) |
Transforms a point in map coordinates to view coordinates. More... | |
virtual Luciad.Cartesian.Coordinate | ViewToMap (Luciad.Cartesian.Coordinate viewPoint) |
Transforms a view point to map coordinates . More... | |
Additional Inherited Members | |
Properties inherited from Luciad.Cameras.Camera | |
Luciad.Cartesian.Coordinate | Eye [get] |
The current location of the camera in map coordinates . More... | |
double | Far [get] |
The distance from the eye to the far clipping plane. More... | |
Luciad.Cartesian.Coordinate | Forward [get] |
The (normalized) direction corresponding to the forward direction of the view. More... | |
double | Height [get] |
The height in device independent pixels of the viewport of this camera. More... | |
double | Near [get] |
The distance from the eye to the near clipping plane. More... | |
Luciad.Cartesian.Coordinate | Up [get] |
The (normalized) direction corresponding to the upward direction of the view. More... | |
double | Width [get] |
The width in device independent pixels of the viewport of this camera. More... | |
A camera that uses an orthographic (or parallel) projection.
That the Camera
API is a low-level API. For simple map navigation use cases, it's recommended to use the higher-level API. The MapNavigator
API works in both 2D and 3D, on all map references. If you use the low-level Camera
API, keep in mind that the same camera manipulation implementation might not work for other types of cameras (OrthographicCamera
vs PerspectiveCamera
) or other (types of) map references (projected vs. geocentric).
A camera transforms points from the map reference
to the view (device independent pixel coordinates).
Cameras in LuciadCPillar are immutable. You can manipulate the map's camera by creating a modified copy using the builder
. The new camera can then be set
on the map.
Currently, the OrthographicCamera
is only used in combination with projected (grid) references (aka 2D maps). For now, you cannot use this camera if the map has a geocentric (3D) reference.
For projected (grid) references, the camera should be positioned along the positive Z axis, facing the negative Z direction. This way, the camera is positioned facing the XY-plane, where the map is rendered in.
To manipulate an orthographic camera on a projected (grid) or cartesian reference, we recommend using look2D. This allows you to reason about the camera in 2D space, instead of a 3D space. It also allows you to easily rotate and zoom the camera around any arbitrary view / map point.
Map
navigation constraints configured on MapNavigator
are not enforced when this camera is updated on the map. Constraints are only respected when using MapNavigator
.
|
inline |
Returns a Builder that can build cameras identical to this camera.
|
inline |
Returns a description of the camera location targeted towards a 2D top-down view of the map.