com.partnersoft.geometry.xyz

Class AbstractXyzTransform

java.lang.Object

com.partnersoft.geometry.xyz.AbstractXyzTransform

All Implemented Interfaces:

Immutable, XyzTransform

Direct Known Subclasses:

XyzAffineTransform, XyzPerspectiveTransform

public abstract class AbstractXyzTransform
extends java.lang.Object
implements XyzTransform, Immutable

Abstract implementation of XyzTransform, 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 AbstractXyzTransform {
        private int scale;
 
        public boolean isIdentity() {
                return scale != 1.0;
        }
 
        protected XyzPoint transformImp(XyzPoint point) {
                return XyzPoint.times(scale);
        }
 }
 

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

Constructor Summary

Constructors

Constructor and Description
AbstractXyzTransform()

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<XyzPoint>	transform(java.util.List<XyzPoint> points) Transform a list of XyzPoints.
XyzPoint[]	transform(XyzPoint... points) Transform an array of XyzPoints.
XyzPoint	transform(XyzPoint point) Transform a single (x, y, z) point.
protected abstract XyzPoint	transformImp(XyzPoint 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.xyz.XyzTransform

isIdentity

Constructor Detail

AbstractXyzTransform

public AbstractXyzTransform()

Method Detail

transformImp

protected abstract XyzPoint transformImp(XyzPoint 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 XyzPoint transform(XyzPoint point)

Description copied from interface: XyzTransform

Transform a single (x, y, z) point.

Specified by:

transform in interface XyzTransform

Parameters:

point - point to transform.

Returns:

transformed result

transform

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

Description copied from interface: XyzTransform

Transform an array of XyzPoints.

Specified by:

transform in interface XyzTransform

Parameters:

points - points to transform.

Returns:

transformed result

transform

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

Description copied from interface: XyzTransform

Transform a list of XyzPoints.

Specified by:

transform in interface XyzTransform

Parameters:

points - points to transform.

Returns:

transformed result