edu.nps.moves.disutil.CoordinateTransformer Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of open-dis Show documentation

An open source implementation of the Distributed Interactive Simulation (DIS) IEEE-1278 protocol

There is a newer version: 5.8



package edu.nps.moves.disutil;

import edu.nps.moves.dis.Vector3Double;
import edu.nps.moves.dis.Vector3Float;

/**
 * Abstract superclass for doing global coordinate transforms. Given a Vector3Double
 * that specifies the location of an entity in the world, transforms it from a given
 * initial coordinate system (such as lat/lon/altitude, or x/y/altitude) to another
 * coordinate system, such as DIS earth-centered. This transformation is carried out
 * in the concrete subclass.
 *
 * Ideally you want to translate into DIS standard coordinates, but not everyone
 * actually uses that, so I'm agnostic about whether you want to follow the
 * standard. If you want to write a transform that puts lat/lon on the wire, that's
 * up to you.
 * 
 * @author DMcG
 */
public abstract class CoordinateTransformer
{
    /** Changes the coordinate system of the input coordinates to the target. 
     * 
     * @param source
     */
   public abstract void transformLocation(Vector3Double source);

   /**
    * Transforms the euler angles from the source to the destination coordinate
    * system.
    * @param source
    */
   public abstract void transformOrientation(Vector3Float source);

}