MapCamera class Maps & 3D Scene

Map camera class.

This class should not be instantiated directly. Instead, use the GemView.camera getter to obtain an instance.

Controls the map view camera. It lets clients save and restore the camera state, read the current orientation and position, and set position or orientation either directly (quaternion/3D position) or via higher‑level camera transforms (absolute camera placement, target‑centered or target‑relative setups).

It also provides helpers to compute a camera position and orientation for a given geographic target and heading/pitch/roll or distance parameters, returning a typed position+orientation result together with an operation status.

Common uses are persisting/ restoring view state, programmatically placing the camera around a point or object, and generating camera matrices for custom actors or animations.

Properties

cameraOrientation ← Point3d
Sets the camera orientation, with respect to the surface of the focused sphere and current camera position, using heading in degrees (0=N, 90=E, 180=S, 270=W).
no getter
cameraPosition ← Coordinates
Sets the camera's longitude, latitude position in degrees, with respect to the surface of the focused sphere, altitude in meters above the sphere (sea level), oriented toward the center of the sphere, north up.
no getter
cameraState ↔ Uint8List
Saves the current state of the camera into a binary format.
getter/setter pair
hashCode → int
The hash code for this object.
no setterinherited
mapId → int
no setter
orientation ↔ Point4d
Retrieves the current orientation of the camera.
getter/setter pair
pointerId → int
no setter
position ↔ Point3d
Retrieves the current position of the camera.
getter/setter pair
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

generatePositionAndOrientation(Coordinates targetCoords) → (GemError, PositionOrientation)
Generates a position at longitude, latitude in degrees, with respect to the surface of the focused sphere, altitude in meters above the sphere (sea level), oriented toward the center of the sphere, north up.
generatePositionAndOrientationHPR(Coordinates targetCoords, Point3d headingPitchRollDeg) → (GemError, PositionOrientation)
Generates a position at longitude, latitude in degrees, with respect to the surface of the focused sphere, altitude in meters above the sphere (sea level), oriented toward the specified heading, pitch, and roll.
generatePositionAndOrientationRelativeToCenteredTarget(Coordinates targetCoords, Point3d targetHeadingPitchRollDeg, Point3d cameraHeadingPitchDegDistanceMeters) → (GemError, PositionOrientation)
Generates a position and orientation relative to, and oriented toward/centered on, a target position which is relative to the focused sphere (orientation relative to target).
generatePositionAndOrientationRelativeToTarget(Coordinates targetCoords, Point3d targetHeadingPitchRollDeg, Point3d cameraHeadingPitchDegDistanceMeters, Point3d cameraHeadingPitchRollDeg) → (GemError, PositionOrientation)
Generates a position and orientation relative to a target position, looking in any direction relative to the direction toward the target, all in the coordinate system of the focused target.
generatePositionAndOrientationTargetCentered(Coordinates targetCoords, Point3d cameraHeadingPitchDegDistanceMeters) → (GemError, PositionOrientation)
Generates a position and orientation relative to, and oriented toward/centered on, a target position which is relative to the focused sphere (orientation relative to sphere).
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
setCameraRelativeToCenteredTarget(Coordinates targetCoords, Point3d targetHeadingPitchRollDeg, Point3d cameraHeadingPitchDegDistanceMeters) → void
Sets the camera to look toward a target position, all in the coordinate system of the focused target.
setCameraRelativeToTarget(Coordinates targetCoords, Point3d targetHeadingPitchRollDeg, Point3d cameraHeadingPitchDegDistanceMeters, Point3d cameraHeadingPitchRollDeg) → void
Sets the camera relative to a target position, looking in any direction relative to the direction toward the target, all in the coordinate system of the focused target.
setCameraTargetCentered(Coordinates coords, Point3d pos) → void
Sets the camera to look toward a target position, all in the coordinate system of the focused sphere.
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited