com.partnersoft.geometry.xy

Class AbstractXyTransform

java.lang.Object

com.partnersoft.geometry.xy.AbstractXyTransform

All Implemented Interfaces:

Immutable, XyTransform

Direct Known Subclasses:

CoordinateSystemTransform, LinearUnitTransform, ProjectionTransform, ReverseProjectionTransform, XyAffineTransform

public abstract class AbstractXyTransform
extends java.lang.Object
implements XyTransform, Immutable

Abstract implementation of XyTransform, takes care of array and list cases. It uses the isIdentity() method to optimize when the transform will not actually change the input points.

Example:

 public class MyScalingTransform extends AbstractXyTransform {
        private int scale;
 
        public boolean isIdentity() {
                return scale != 1.0;
        }
 
        protected XyPoint transformImp(XyPoint point) {
                return XyPoint.times(scale);
        }
 }
 

 Copyright 2007 Partner Software, Inc.
 @author Paul Reavis
 @author Rich Stepanski
 @author Richard Fay
 @version $Id$

Constructor Summary

Constructors

Constructor and Description
AbstractXyTransform()

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<XyPoint>	transform(java.util.List<XyPoint> points) Transform a list of XyPoints.
XyPoint[]	transform(XyPoint... points) Transform an array of XyPoints.
XyPoint	transform(XyPoint point) Transform a single (x, y) point.
protected abstract XyPoint	transformImp(XyPoint point) Subclasses must implement this to do the actual work of transformation.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.partnersoft.geometry.xy.XyTransform

isIdentity

Constructor Detail

AbstractXyTransform

public AbstractXyTransform()

Method Detail

transformImp

protected abstract XyPoint transformImp(XyPoint point)

Subclasses must implement this to do the actual work of transformation. It behaves the same way as transform(XyPoint), except that you do NOT have to check for identity - that will be done automatically.

transform

public XyPoint transform(XyPoint point)

Description copied from interface: XyTransform

Transform a single (x, y) point.

Specified by:

transform in interface XyTransform

Parameters:

point - point to transform.

Returns:

transformed result

transform

public XyPoint[] transform(XyPoint... points)

Description copied from interface: XyTransform

Transform an array of XyPoints. Always returns a new array.

Specified by:

transform in interface XyTransform

Parameters:

points - points to transform.

Returns:

transformed result

transform

public java.util.List<XyPoint> transform(java.util.List<XyPoint> points)

Description copied from interface: XyTransform

Transform a list of XyPoints. Always returns a new, mutable list.

Specified by:

transform in interface XyTransform

Parameters:

points - points to transform.

Returns:

transformed result