de.gurkenlabs.litiengine.graphics

Interface ICamera

All Superinterfaces:

IUpdateable

All Known Implementing Classes:

Camera, FreeFlightCamera, PositionLockCamera

public interface ICamera
extends IUpdateable

The Interface ICamera defines methods that allow to determine where entities or tiles are rendered on the current screen.

Method Summary

Modifier and Type	Method and Description
java.awt.geom.Point2D	getFocus() Gets the map location that is focused by this camera.
java.awt.geom.Point2D	getMapLocation(java.awt.geom.Point2D point) Gets the map location.
double	getPixelOffsetX() Gets the pixel offset x.
double	getPixelOffsetY() Gets the pixel offset y.
float	getRenderScale()
java.awt.geom.Rectangle2D	getViewport() Gets the camera region.
java.awt.geom.Point2D	getViewportDimensionCenter(IEntity entity)
java.awt.geom.Point2D	getViewportLocation(double x, double y) Gets the render location.
java.awt.geom.Point2D	getViewportLocation(IEntity entity) This method calculates to location for the specified entity in relation to the focus map location of the camera.
java.awt.geom.Point2D	getViewportLocation(java.awt.geom.Point2D point) This method calculates to location for the specified point in relation to the focus map location of the camera.
float	getZoom()
boolean	isClampToMap()
void	onFocusChanged(java.util.function.Consumer<java.awt.geom.Point2D> focusCons)
void	onZoomChanged(java.util.function.DoubleConsumer zoomCons)
void	pan(double x, double y, int duration) Pans the camera over the specified duration (in frames) to the target location, after accounting for modifications such as clamping to the map.
void	pan(java.awt.geom.Point2D focus, int duration) Pans the camera over the specified duration (in frames) to the target location, after accounting for modifications such as clamping to the map.
void	setClampToMap(boolean clampToMap)
void	setFocus(double x, double y)
void	setFocus(java.awt.geom.Point2D focus)
void	setZoom(float zoom, int delay)
void	shake(double intensity, int delay, int duration)
void	updateFocus()

Methods inherited from interface de.gurkenlabs.litiengine.IUpdateable

update

Method Detail

getFocus

java.awt.geom.Point2D getFocus()

Gets the map location that is focused by this camera.

Returns:

the focus map location

getMapLocation

java.awt.geom.Point2D getMapLocation(java.awt.geom.Point2D point)

Gets the map location.

Parameters:

point - the point

Returns:

the map location

getPixelOffsetX

double getPixelOffsetX()

Gets the pixel offset x.

Returns:

the pixel offset x

getPixelOffsetY

double getPixelOffsetY()

Gets the pixel offset y.

Returns:

the pixel offset y

getViewport

java.awt.geom.Rectangle2D getViewport()

Gets the camera region.

Returns:

the camera region

getViewportDimensionCenter

java.awt.geom.Point2D getViewportDimensionCenter(IEntity entity)

getViewportLocation

java.awt.geom.Point2D getViewportLocation(double x,
                                          double y)

Gets the render location.

Parameters:

x - the x

y - the y

Returns:

the render location

getViewportLocation

java.awt.geom.Point2D getViewportLocation(IEntity entity)

This method calculates to location for the specified entity in relation to the focus map location of the camera.

Parameters:

entity - the entity

Returns:

the render location

getViewportLocation

java.awt.geom.Point2D getViewportLocation(java.awt.geom.Point2D point)

This method calculates to location for the specified point in relation to the focus map location of the camera.

Parameters:

point - the point

Returns:

the render location

getRenderScale

float getRenderScale()

getZoom

float getZoom()

onZoomChanged

void onZoomChanged(java.util.function.DoubleConsumer zoomCons)

onFocusChanged

void onFocusChanged(java.util.function.Consumer<java.awt.geom.Point2D> focusCons)

setFocus

void setFocus(java.awt.geom.Point2D focus)

setFocus

void setFocus(double x,
              double y)

pan

void pan(java.awt.geom.Point2D focus,
         int duration)

Pans the camera over the specified duration (in frames) to the target location, after accounting for modifications such as clamping to the map. Event listeners attached to this camera are notified when the pan completes.

Parameters:

focus - the new focus for the camera once the panning is complete

duration - the number of frames between this call and when the pan completes

pan

void pan(double x,
         double y,
         int duration)

Pans the camera over the specified duration (in frames) to the target location, after accounting for modifications such as clamping to the map. Event listeners attached to this camera are notified when the pan completes.

Parameters:

x - the new X position for the camera once the panning is complete

y - the new Y position for the camera once the panning is complete

duration - the number of frames between this call and when the pan completes

setZoom

void setZoom(float zoom,
             int delay)

isClampToMap

boolean isClampToMap()

setClampToMap

void setClampToMap(boolean clampToMap)

shake

void shake(double intensity,
           int delay,
           int duration)

updateFocus

void updateFocus()