Interface Projection
-
- All Known Subinterfaces:
InvertibleProjection
- All Known Implementing Classes:
FlatProjection,GenericProjection,GeoReprojection,LatLonProjection,PolarProjection
public interface ProjectionProvides a mapping from a texture coordinate to the lower left corner of the polygon which it should be mapped onto. The mapping should provide values for at least one texture coordinate beyond the edge of the texture, since these define the top and right side of the polygons on the edge of the texture.- Author:
- ulman
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description intgetSizeX(int textureSizeX)Returns the number of quads in the x direction that the array of data (the texture) should be broken into.intgetSizeY(int textureSizeY)voidgetVertexXY(double dataFractionX, double dataFractionY, float[] resultXY)Given a position in a rectangular array of data (the texture), return the corresponding location in physical units.voidgetVertexXYZ(double dataFractionX, double dataFractionY, float[] resultXYZ)Given a position in a rectangular array of data (the texture), return the corresponding location in physical units.
-
-
-
Method Detail
-
getVertexXY
void getVertexXY(double dataFractionX, double dataFractionY, float[] resultXY)Given a position in a rectangular array of data (the texture), return the corresponding location in physical units. The position is given as relative coordinates, with 0.0 indicating the 0th data index and 1.0 indicating the last data index.This method computes the physical coordinate of the data at (textureFractionX, textureFractionY), and stores them in the resultXY output parameter.
- Parameters:
dataFractionX- a relative x index (from 0.0 to 1.0) into the data arraydataFractionY- a relative y index (from 0.0 to 1.0) into the data arrayresultXY- output parameter to be populated with physical coords of the data
-
getVertexXYZ
void getVertexXYZ(double dataFractionX, double dataFractionY, float[] resultXYZ)Given a position in a rectangular array of data (the texture), return the corresponding location in physical units. The position is given as relative coordinates, with 0.0 indicating the 0th data index and 1.0 indicating the last data index.This method computes the physical coordinate of the data at (textureFractionX, textureFractionY), and stores them in the resultXYZ output parameter.
Assigning z coordinates to vertices can be useful even for 2D graphics. For example, it can be used together with z-clipping to avoid rendering some facets.
- Parameters:
dataFractionX- a relative x index (from 0.0 to 1.0) into the data arraydataFractionY- a relative y index (from 0.0 to 1.0) into the data arrayresultXYZ- output parameter to be populated with physical coords of the data
-
getSizeX
int getSizeX(int textureSizeX)
Returns the number of quads in the x direction that the array of data (the texture) should be broken into. If the projection is linear in the x direction (for example, if the data/texture is simply being displayed on a rectangle) then only one quad is needed.For more complicated projections, the value returned essentially defines the granularity or resolution of the projection (since the projection will ultimately be approximated when displayed by drawing a set of small quads).
- Parameters:
textureSizeX- the length of the data array (the texture) in the x direction- Returns:
- the number of quads in the x direction to draw
-
getSizeY
int getSizeY(int textureSizeY)
- Parameters:
textureSizeY- the length of the data array (the texture) in the y direction- Returns:
- the number of quads in the y direction to draw
- See Also:
getSizeX( int )
-
-