gov/nasa/worldwind/DrawContext.java

   1 /*
   2 Copyright (C) 2001, 2006 United States Government
   3 as represented by the Administrator of the
   4 National Aeronautics and Space Administration.
   5 All Rights Reserved.
   6 */
   7 package gov.nasa.worldwind;
   8
   9 import com.sun.opengl.util.texture.*;
  10 import gov.nasa.worldwind.geom.*;
  11
  12 /**
  13  * @author Tom Gaskins
  14  * @version $Id: DrawContext.java 1994 2007-06-11 16:33:33Z dcollins $
  15  */
  16 public interface DrawContext extends WWObject
  17 {
  18     /**
  19      * Assigns this <code>DrawContext</code> a new </code>javax.media.opengl.GLContext</code>. May throw a
  20      * <code>NullPointerException</code> if <code>glContext</code> is null.
  21      *
  22      * @param glContext the new <code>javax.media.opengl.GLContext</code>
  23      * @throws NullPointerException if glContext is null
  24      * @since 1.5
  25      */
  26     void setGLContext(javax.media.opengl.GLContext glContext);
  27
  28     /**
  29      * Retrieves this <code>DrawContext</code>s </code>javax.media.opengl.GLContext</code>. If this method returns null,
  30      * then there are potentially no active <code>GLContext</code>s and rendering should be aborted.
  31      *
  32      * @return this <code>DrawContext</code>s </code>javax.media.opengl.GLContext</code>.
  33      * @since 1.5
  34      */
  35     javax.media.opengl.GLContext getGLContext();
  36
  37     /**
  38      * Retrieves the current <code>javax.media.opengl.GL</code>. A <code>GL</code> or <code>GLU</code> is required for
  39      * all graphical rendering in World Wind Raptor.
  40      *
  41      * @return the current <code>GL</code> if available, null otherwise
  42      * @since 1.5
  43      */
  44     javax.media.opengl.GL getGL();
  45
  46     /**
  47      * Retrieves the current <code>javax.media.opengl.glu.GLU</code>. A <code>GLU</code> or <code>GL</code> is required
  48      * for all graphical rendering in World Wind Raptor.
  49      *
  50      * @return the current <code>GLU</code> if available, null otherwise
  51      * @since 1.5
  52      */
  53     javax.media.opengl.glu.GLU getGLU();
  54
  55     /**
  56      * Retrieves the current<code>javax.media.opengl.GLDrawable</code>. A <code>GLDrawable</code> can be used to create
  57      * a <code>GLContext</code>, which can then be used for rendering.
  58      *
  59      * @return the current <code>GLDrawable</code>, null if none available
  60      * @since 1.5
  61      */
  62     javax.media.opengl.GLDrawable getGLDrawable();
  63
  64     /**
  65      * Retrieves the drawable width of this <code>DrawContext</code>.
  66      *
  67      * @return the drawable width of this <code>DrawCOntext</code>
  68      * @since 1.5
  69      */
  70     int getDrawableWidth();
  71
  72     /**
  73      * Retrieves the drawable height of this <code>DrawContext</code>.
  74      *
  75      * @return the drawable height of this <code>DrawCOntext</code>
  76      * @since 1.5
  77      */
  78     int getDrawableHeight();
  79
  80     /**
  81      * Initializes this <code>DrawContext</code>. This method should be called at the beginning of each frame to prepare
  82      * the <code>DrawContext</code> for the coming render pass.
  83      *
  84      * @param glContext the <code>javax.media.opengl.GLContext</code> to use for this render pass
  85      * @since 1.5
  86      */
  87     void initialize(javax.media.opengl.GLContext glContext);
  88
  89     /**
  90      * Assigns a new <code>View</code>. Some layers cannot function properly with a null <code>View</code>. It is
  91      * recommended that the <code>View</code> is never set to null during a normal render pass.
  92      *
  93      * @param view the enw <code>View</code>
  94      * @since 1.5
  95      */
  96     void setView(View view);
  97
  98     /**
  99      * Retrieves the current <code>View</code>, which may be null.
 100      *
 101      * @return the current <code>View</code>, which may be null
 102      * @since 1.5
 103      */
 104     View getView();
 105
 106     /**
 107      * Assign a new <code>Model</code>. Some layers cannot function properly with a null <code>Model</code>. It is
 108      * recommended that the <code>Model</code> is never set to null during a normal render pass.
 109      *
 110      * @param model the new <code>Model</code>
 111      * @since 1.5
 112      */
 113     void setModel(Model model);
 114
 115     /**
 116      * Retrieves the current <code>Model</code>, which may be null.
 117      *
 118      * @return the current <code>Model</code>, which may be null
 119      * @since 1.5
 120      */
 121     Model getModel();
 122
 123     /**
 124      * Retrieves the current <code>Globe</code>, which may be null.
 125      *
 126      * @return the current <code>Globe</code>, which may be null
 127      * @since 1.5
 128      */
 129     Globe getGlobe();
 130
 131     /**
 132      * Retrieves a list containing all the current layers. No guarantee is made about the order of the layers.
 133      *
 134      * @return a <code>LayerList</code> containing all the current layers
 135      * @since 1.5
 136      */
 137     LayerList getLayers();
 138
 139     /**
 140      * Retrieves a <code>Sector</code> which is at least as large as the current visible sector. The value returned is
 141      * the value passed to <code>SetVisibleSector</code>. This method may return null.
 142      *
 143      * @return a <code>Sector</code> at least the size of the curernt visible sector, null if unavailable
 144      * @since 1.5
 145      */
 146     gov.nasa.worldwind.geom.Sector getVisibleSector();
 147
 148     /**
 149      * Sets the visible <code>Sector</code>. The new visible sector must completely encompass the Sector which is
 150      * visible on the display.
 151      *
 152      * @param s the new visible <code>Sector</code>
 153      * @since 1.5
 154      */
 155     void setVisibleSector(gov.nasa.worldwind.geom.Sector s);
 156
 157     /**
 158      * Sets the vertical exaggeration. Vertical exaggeration affects the appearance of areas with varied elevation. A
 159      * vertical exaggeration of zero creates a surface which exactly fits the shape of the underlying
 160      * <code>Globe</code>. A vertical exaggeration of 3 will create mountains and valleys which are three times as
 161      * high/deep as they really are.
 162      *
 163      * @param verticalExaggeration the new vertical exaggeration.
 164      * @since 1.5
 165      */
 166     void setVerticalExaggeration(double verticalExaggeration);
 167
 168     /**
 169      * Retrieves the current vertical exaggeration. Vertical exaggeration affects the appearance of areas with varied
 170      * elevation. A vertical exaggeration of zero creates a surface which exactly fits the shape of the underlying
 171      * <code>Globe</code>. A vertical exaggeration of 3 will create mountains and valleys which are three times as
 172      * high/deep as they really are.
 173      *
 174      * @return the current vertical exaggeration
 175      * @since 1.5
 176      */
 177     double getVerticalExaggeration();
 178
 179     // not used (12th January 2007)
 180     final static String HIGH_PRIORITY = "gov.nasa.worldwind.DrawContext.HighPriority";
 181     final static String LOW_PRIORITY = "gov.nasa.worldwind.DrawContext.LowPriority";
 182
 183     /**
 184      * Retrieves a list of all the sectors rendered so far this frame.
 185      *
 186      * @return a <code>SectorGeometryList</code> containing every <code>SectorGeometry</code> rendered so far this
 187      *         render pass.
 188      * @since 1.5
 189      */
 190     SectorGeometryList getSurfaceGeometry();
 191
 192     //
 193 //    /**
 194 //     * Sets the average render time per frame in milliseconds.
 195 //     *
 196 //     * @param timeMillis the new average time in milliseconds
 197 //     * @since 1.5
 198 //     */
 199 //    void setAverageRenderTimeMillis(double timeMillis);
 200 //
 201 //    /**
 202 //     * Retrieves the current average render time for a frame. The average render time can be used to calculate the
 203 //     * framerate.
 204 //     *
 205 //     * @return the current average render time for a frame
 206 //     * @since 1.5
 207 //     */
 208 //    double getAverageRenderTimeMillis();
 209
 210     /**
 211      * Returns the list of objects picked during the most recent pick traversal.
 212      *
 213      * @return the list of picked objects
 214      */
 215     gov.nasa.worldwind.PickedObjectList getPickedObjects();
 216
 217     /**
 218      * Adds a collection of picked objects to the current picked-object list
 219      *
 220      * @param pickedObjects the objects to add
 221      */
 222     void addPickedObjects(PickedObjectList pickedObjects);
 223
 224     /**
 225      * Adds a single insatnce of the picked object to the current picked-object list
 226      *
 227      * @param pickedObject the object to add
 228      */
 229     void addPickedObject(PickedObject pickedObject);
 230
 231     /**
 232      * Returns a unique color to serve as a pick identifier during picking.
 233      *
 234      * @return a unique pick color
 235      */
 236     java.awt.Color getUniquePickColor();
 237
 238     java.awt.Color getClearColor();
 239
 240     /**
 241      * Enables color picking mode
 242      */
 243     void enablePickingMode();
 244
 245     /**
 246      * Returns true if the Picking mode is active, otherwise return false
 247      *
 248      * @return true for Picking mode, otherwise false
 249      */
 250     boolean isPickingMode();
 251
 252     /**
 253      * Disables color picking mode
 254      */
 255     void disablePickingMode();
 256
 257     void addOrderedRenderable(OrderedRenderable orderedRenderable);
 258
 259     java.util.Queue<OrderedRenderable> getOrderedRenderables();
 260
 261     void drawUnitQuad();
 262
 263     void drawUnitQuad(TextureCoords texCoords);
 264
 265     int getNumTextureUnits();
 266
 267     void setNumTextureUnits(int numTextureUnits);
 268
 269     void setSurfaceGeometry(SectorGeometryList surfaceGeometry);
 270
 271     Vec4 getPointOnGlobe(Angle latitude, Angle longitude);
 272
 273     SurfaceTileRenderer getSurfaceTileRenderer();
 274 }