jview
Interface FormattedTransforming

All Superinterfaces:
CoordinateTransforming
All Known Implementing Classes:
AbstractFormattingTransform, BasicTransform, CylindricalEqualAreaProjection, CylindricalEquidistantProjection, CylindricalProjection, JFitsCanvas.PixelCoordinate, MercatorProjection, OrthographicTransformation, SelectTransform

public interface FormattedTransforming
extends CoordinateTransforming

Allows the retrieval of formatted description of the user space coordinates. This is useful for adding labels to drawings. In most cases, this will only work for two-dimensional user spaces with a more or less direct mapping of screen coordinates to user space coordinates.


Method Summary
 Format estimateX(double sx)
          From the step-size in user space, estimate a format.
 Format estimateY(double sy)
          From the step-size in user space, estimate a format.
 List formatUserCoordinates(Point2D norm)
          Formats all user-space coordinates and returns them as a list.
 String formatUserSpaceX(Point2D norm)
          Formats the x-coordinate in user space given a pixel in normalized screen coordinates.
 String formatUserSpaceY(Point2D norm)
          Formats the y-coordinate in user space given a pixel in normalized screen coordinates.
 Format getFormatUserX()
          For direct access this method retrieves the formatting instance used to fromat the user-space x coordinate.
 Format getFormatUserY()
          For direct access this method retrieves the formatting instance used to fromat the user-space x coordinate.
 void useEstimatedFormats(Rectangle2D view, int nx, int ny)
          Asks the transform to recalculate its x/y axis formatter for user space, giving the new view and the number of points in the axis.
 
Methods inherited from interface jview.CoordinateTransforming
toNormalizedSpace, toUserSpace
 

Method Detail

formatUserSpaceX

String formatUserSpaceX(Point2D norm)
Formats the x-coordinate in user space given a pixel in normalized screen coordinates.

Parameters:
norm - The screen coordinate in normalized form.
Returns:
A string description of the user-space x-coordinate.

formatUserSpaceY

String formatUserSpaceY(Point2D norm)
Formats the y-coordinate in user space given a pixel in normalized screen coordinates.

Parameters:
norm - The screen coordinate in normalized form.
Returns:
A string description of the user-space y-coordinate.

formatUserCoordinates

List formatUserCoordinates(Point2D norm)
Formats all user-space coordinates and returns them as a list.

Parameters:
norm - The screen coordinate in normalized form.
Returns:
A List of strings description of the user-space coordinates.

getFormatUserX

Format getFormatUserX()
For direct access this method retrieves the formatting instance used to fromat the user-space x coordinate.


getFormatUserY

Format getFormatUserY()
For direct access this method retrieves the formatting instance used to fromat the user-space x coordinate.


estimateX

Format estimateX(double sx)
From the step-size in user space, estimate a format.


estimateY

Format estimateY(double sy)
From the step-size in user space, estimate a format.


useEstimatedFormats

void useEstimatedFormats(Rectangle2D view,
                         int nx,
                         int ny)
Asks the transform to recalculate its x/y axis formatter for user space, giving the new view and the number of points in the axis.