Interface Look2D

A Look2D represents the position of an OrthographicCamera in a projected (grid) or cartesian reference (aka a '2D' reference). It allows you to reason about the map's camera in a 2D space, rather than a 3D space. It also allows you to easily perform zooming and rotation around an arbitrary view point.

A Look2D is defined by the following properties:

• worldOrigin: The 2D world point at viewOrigin.
• viewOrigin: The pixel point at which worldOrigin is in the viewport
• scaleX: The scale, in pixels / world unit, along the X (horizontal) direction of the camera's viewport.
• scaleY: The scale, in pixels / world unit, along the Y (vertical) direction of the camera's viewport.
• rotation: The rotation of the camera, in degrees. Positive is counter-clockwise in the view. 0 = no rotation.
• reference: The reference in which worldOrigin is defined. The 'world units' from scaleX / scaleY also refer to this reference.

Rotation and scaling (zooming) happen with viewOrigin / worldOrigin as the center.

Imagine pushing a pin through the pixel at viewOrigin, and sticking it to worldOrigin on the 2D map. Moving the pin pans the map. Rotation (rotation) and zooming (scaleX and scaleY) happen around the pin.

Note that a Look2D can not be used with a geocentric (3D) reference.

// zoom in by a factor of 2, towards a mouse location (pixel 50, 50)
var mouseLocation = {x: 50, y: 50, z: 0};
var look2D = map.camera.asLook2D();
look2D.viewOrigin = mouseLocation;
look2D.worldOrigin = map.camera.toWorld(mouseLocation);
look2D.scaleX *= 2;
look2D.scaleY *= 2;
map.camera = map.camera.look2D(look2D);
Copy