ilog.views.maps

Class IlvScaleController

java.lang.Object

ilog.views.maps.IlvScaleController

public class IlvScaleController
extends Object

This class provides the basic services to compute or set the scale of a view.

Since:

JViews 3.0

Method Summary

Modifier and Type	Method and Description
static void	FitTransformerToPoint(IlvManagerView view, double scale, IlvPoint point, boolean redraw) Centers the specified georeferenced view around the specified point and sets the scale of the view to the specified scale.
static void	FitTransformerToPoint(IlvManagerView view, IlvLinearUnit unit, double scale, IlvPoint point, boolean redraw) Centers the specified view around the specified point and sets the scale of the view to the specified scale.
static double	GetScale(IlvManagerView view) Returns the scale of a manager view whose manager is georeferenced because it owns an IlvCoordinateSystemProperty.
static double	GetScale(IlvManagerView view, IlvLinearUnit managerUnit) Returns the scale of a manager view.
static double	GetScreenPixelSizeMM() Returns the size in millimeters of a screen pixel.
static Dimension	GetScreenSizeMM() Returns the height of the screen used to compute the scales.
static double	GetZoomFactor(double scale, IlvLinearUnit managerUnit) Returns the zoom factor of a transformer that would show a map at the specified scale.
static void	SetScale(IlvManagerView view, double scale, boolean redraw) Sets the scale of the georeferenced view to the specified scale.
static void	SetScale(IlvManagerView view, IlvLinearUnit managerUnit, double scale, boolean redraw) Sets the scale of view to the specified scale.
static void	SetScreenSizeMM(Dimension sizemm) Specifies the height and the width of the display screen for a more accurate scale management.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

GetScale

public static double GetScale(IlvManagerView view,
                              IlvLinearUnit managerUnit)

Returns the scale of a manager view.

Parameters:

view - The manager view.

managerUnit - The unit of the manager. Specifies the equivalence between manager coordinates and meters.

Returns:

The scale of the view (for instance, 0.00001 for 1/100000).

Since:

JViews 5.0

GetScale

public static double GetScale(IlvManagerView view)

Returns the scale of a manager view whose manager is georeferenced because it owns an IlvCoordinateSystemProperty.

Parameters:

view - The manager view.

Returns:

The scale of the view (for instance, 0.00001 for 1/100000).

Throws:

IllegalArgumentException - if the manager of the view is not georeferenced (it doesn't own an IlvCoordinateSystemProperty).

SetScale

public static void SetScale(IlvManagerView view,
                            IlvLinearUnit managerUnit,
                            double scale,
                            boolean redraw)

Sets the scale of view to the specified scale.

Parameters:

view - The target view.

managerUnit - The unit of the manager. Specifies the equivalence between manager coordinates and meters.

scale - The specified scale (for instance, 0.00001 for 1/100000).

redraw - If true, the view is redrawn.

Since:

JViews 5.0

SetScale

public static void SetScale(IlvManagerView view,
                            double scale,
                            boolean redraw)

Sets the scale of the georeferenced view to the specified scale. Given that view is georeferenced, its manager must own an IlvCoordinateSystemProperty object.

Parameters:

view - The target view.

scale - The specified scale (for instance, 0.00001 for 1/100000).

redraw - If true, the view is redrawn.

Throws:

IllegalArgumentException - if the manager of the view is not georeferenced (it doesn't own an IlvCoordinateSystemProperty).

FitTransformerToPoint

public static void FitTransformerToPoint(IlvManagerView view,
                                         IlvLinearUnit unit,
                                         double scale,
                                         IlvPoint point,
                                         boolean redraw)

Centers the specified view around the specified point and sets the scale of the view to the specified scale.

Parameters:

view - The view.

unit - The linear unit to be used for scale computation.

scale - The scale.

point - The point to center.

redraw - If true, the view is redrawn.

Since:

JViews 5.5

FitTransformerToPoint

public static void FitTransformerToPoint(IlvManagerView view,
                                         double scale,
                                         IlvPoint point,
                                         boolean redraw)

Centers the specified georeferenced view around the specified point and sets the scale of the view to the specified scale.

Parameters:

view - The view.

scale - The scale.

point - The point to center.

redraw - If true, the view is redrawn.

Throws:

IllegalArgumentException - If the view is not georeferenced.

Since:

JViews 5.5

SetScreenSizeMM

public static void SetScreenSizeMM(Dimension sizemm)

Specifies the height and the width of the display screen for a more accurate scale management.

Parameters:

sizemm - The height and width of the screen, expressed in millimeters.

GetScreenSizeMM

public static Dimension GetScreenSizeMM()

Returns the height of the screen used to compute the scales.

GetZoomFactor

public static double GetZoomFactor(double scale,
                                   IlvLinearUnit managerUnit)

Returns the zoom factor of a transformer that would show a map at the specified scale.

Parameters:

scale - The specified scale.

managerUnit - The unit of the manager. Specifies the equivalence between manager coordinates and meters.

Since:

JViews 5.0

GetScreenPixelSizeMM

public static double GetScreenPixelSizeMM()

Returns the size in millimeters of a screen pixel.