1 /*
2  *    GeoAPI - Java interfaces for OGC/ISO standards
3  *    http://www.geoapi.org
4  *
5  *    Copyright (C) 2004-2011 Open Geospatial Consortium, Inc.
6  *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal
7  *
8  *    Permission to use, copy, and modify this software and its documentation, with
9  *    or without modification, for any purpose and without fee or royalty is hereby
10  *    granted, provided that you include the following on ALL copies of the software
11  *    and documentation or portions thereof, including modifications, that you make:
12  *
13  *    1. The full text of this NOTICE in a location viewable to users of the
14  *       redistributed or derivative work.
15  *    2. Notice of any changes or modifications to the OGC files, including the
16  *       date changes were made.
17  *
18  *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
19  *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
20  *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
21  *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
22  *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
23  *
24  *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
25  *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
26  *
27  *    The name and trademarks of copyright holders may NOT be used in advertising or
28  *    publicity pertaining to the software without specific, written prior permission.
29  *    Title to copyright in this software and any associated documentation will at all
30  *    times remain with copyright holders.
31  */
32 package org.opengis.referencing.crs;
33 
34 import org.opengis.referencing.cs.AffineCS;
35 import org.opengis.referencing.cs.CartesianCS;
36 import org.opengis.referencing.datum.ImageDatum;
37 import org.opengis.annotation.UML;
38 
39 import static org.opengis.annotation.Obligation.*;
40 import static org.opengis.annotation.Specification.*;
41 
42 
43 /**
44  * An engineering coordinate reference system applied to locations in images. Image coordinate
45  * reference systems are treated as a separate sub-type because a separate user community exists
46  * for images with its own terms of reference.
47  *
48  * <TABLE CELLPADDING='6' BORDER='1'>
49  * <TR BGCOLOR="#EEEEFF"><TH NOWRAP>Used with CS type(s)</TH></TR>
50  * <TR><TD>
51  *   {@link org.opengis.referencing.cs.CartesianCS Cartesian},
52  *   {@link org.opengis.referencing.cs.AffineCS    Affine}
53  * </TD></TR></TABLE>
54  *
55  * @author  Martin Desruisseaux (IRD)
56  * @version 3.0
57  * @since   1.0
58  *
59  * @navassoc 1 - - ImageDatum
60  * @navassoc 1 - - AffineCS
61  */
62 @UML(identifier="SC_ImageCRS", specification=ISO_19111)
63 public interface ImageCRS extends SingleCRS {
64     /**
65      * Returns the cartesian coordinate system.
66      */
67     @UML(identifier="coordinateSystem", obligation=MANDATORY, specification=ISO_19111)
getCoordinateSystem()68     AffineCS getCoordinateSystem();
69 
70     /**
71      * Returns the datum, which must be an image one.
72      */
73     @UML(identifier="datum", obligation=MANDATORY, specification=ISO_19111)
getDatum()74     ImageDatum getDatum();
75 }
76