Application: gvSIG desktop

                if (use_intersection_cond) {

                    Evaluator iee = SpatialEvaluatorsFactory.getInstance().intersects(

                            featureStore

                    );

                    if (feat_query == null) {

		// decide if the data must be drawn or not

		// Checks if the viewport envelope intersects with the data envelope

		// This condition may seem redundant, but sometimes the transformations may fail and cause false negatives.

			// The data is not visible in the current viewport, do nothing.

			return;

		}

            }

            Evaluator iee = SpatialEvaluatorsFactory.getInstance().intersects(

                    featureStore

            );

            featureQuery.addFilter(iee);

 * registered.

 * </ul>

 * </p>

 * @author Vicente Caballero Navarro

 */

public class ViewPort implements Persistent, Cloneable {

   * {@linkplain #getAdjustedExtent()} method which returns the extent that

   * contains this one but regarding the current view's aspect ratio.

   * </p>

   * @see #getExtent()

   * @see #setEnvelope(Envelope)

   */

   * <p>

   * Location and dimensions of the extent adjusted to the image size.

   * </p>

   * @see #getAdjustedExtent()

   */

  protected Rectangle2D adjustedExtent;

  /**

   * Draw version of the context. It's used for know when de componend has

   * changed any visualization property

   * @see getDrawVersion

   * @see updateDrawVersion

   */

   * <p>

   * History with the last extents of the view.

   * </p>

   * @see #setPreviousExtent()

   * @see #getExtents()

   */

   * {@link #dist3pixel dist3pixel}) .

   * </ul>

   * </p>

   * @see #getImageSize()

   * @see #getImageHeight()

   * @see #getImageWidth()

   * coordinates</i> to the image area in the screen, in <i>screen 2D

   * coordinates</i> (pixels).

   * </p>

   * @see AffineTransform

   * @see #getAffineTransform()

   * @see #setAffineTransform(AffineTransform)

   * <p>

   * Measurement unit used for measuring distances and displaying information.

   * </p>

   * @see #getDistanceUnits()

   * @see #setDistanceUnits(int)

   */

   * <p>

   * Measurement unit used for measuring areas and displaying information.

   * </p>

   * @see #getDistanceArea()

   * @see #setDistanceArea(int)

   */

   * <p>

   * Measurement unit used by this view port for the map.

   * </p>

   * @see #getMapUnits()

   * @see #setMapUnits(int)

   */

   * Array with the {@link ViewPortListener ViewPortListener}s registered to

   * this view port.

   * </p>

   * @see #addViewPortListener(ViewPortListener)

   * @see #removeViewPortListener(ViewPortListener)

   */

   * But in a <a href="http://www.gvsig.gva.es/">gvSIG</a>'s <i>Layout</i> it's

   * up to the place where the <code>FFrameView</code> is located.

   * </p>

   * @see #getOffset()

   * @see #setOffset(Point2D)

   */

   * <p>

   * Background color of this view.

   * </p>

   * @see #getBackColor()

   * @see #setBackColor(Color)

   */

   * <p>

   * Information about the map projection used in this view.

   * </p>

   * @see #getProjection()

   * @see #setProjection(IProjection)

   */

   * Represents the distance in <i>world coordinates</i> equivalent to 1 pixel

   * in the view with the current extent.

   * </p>

   * @see #getDist1pixel()

   * @see #setDist1pixel(double)

   */

   * Represents the distance in <i>world coordinates</i> equivalent to 3 pixels

   * in the view with the current extent.

   * </p>

   * @see #getDist3pixel()

   * @see #setDist3pixel(double)

   */

   * <p>

   * Ratio between the size of <code>imageSize</code> and <code>extent</code>: <br>

   * <i>

   * <pre>

   * min{(imageSize.getHeight()/extent.getHeight(), imageSize.getWidth()/extent.getWidth())}

   * </pre>

   * </i>

   * </p>

   */

   * <p>

   * Clipping area.

   * </p>

   * @see #setClipRect(Rectangle2D)

   */

  private Rectangle2D cliprect;

   * Y) coordinates of the <code>extent</code> and an area that will be an scale

   * of the image size. That area will have different height or width (not both)

   * of the extent according the least ratio (height or width) in

   * <pre>

   * image.size/extent.size"

   * </pre>.

   * <code>extent</code>.

   * </ul>

   * </p>

   * @see #setAdjustable(boolean)

   */

  private boolean adjustableExtent = true;

   * ViewPort resolution in <i>dots-per-inch</i>. Useful to calculate the

   * geographic scale of the view.

   * </p>

   * @see Toolkit#getScreenResolution()

   * @see MapContext#getScaleView()

   */

   * <li><i><code>offset</code></i> = <code>new Point2D.Double(0, 0);</code>

   * </ul>

   * </p>

   * @param proj information of the projection for this view port

   */

  public ViewPort(IProjection proj) {

   * original map in real coordinates. (Won't scale the image to adapt it to the

   * available rectangular area).

   * </p>

   * @param boolean the boolean to be set

   */

  public void setAdjustable(boolean adjustable) {

   * Appends the specified {@link ViewPortListener ViewPortListener} listener if

   * weren't.

   * </p>

   * @param arg0 the listener to add

   * @return <code>true</code> if has been added successfully

   * @see #removeViewPortListener(ViewPortListener)

   * Removes the specified {@link ViewPortListener ViewPortListener} listener,

   * if existed.

   * </p>

   * @param arg0 the listener to remove

   * @return <code>true</code> if the contained the specified listener.

   * @see #addViewPortListener(ViewPortListener)

   * with the transformation affine information in the {@link #trans #trans}

   * attribute.

   * </p>

   * @param d distance in <i>map coordinates</i>

   * @return distance equivalent in <i>screen coordinates</i>

   * @see #toMapDistance(int)

   * coordinates</i> to <i>screen coordinates</i> (pixels) using the affine

   * transformation in the {@link #trans #trans} attribute.

   * </p>

   * @param x the <code>x</code> <i>map coordinate</i> of a 2D point

   * @param y the <code>y</code> <i>map coordinate</i> of a 2D point

   * @return 2D point equivalent in <i>screen coordinates</i> (pixels)

   * coordinates</i> to <i>screen coordinates</i> (pixels) using the affine

   * transformation in the {@link #trans #trans} attribute.

   * </p>

   * @param point the 2D point in <i>map coordinates</i>

   * @return 2D point equivalent in <i>screen coordinates</i> (pixels)

   * @see #toMapPoint(Point2D)

   * coordinates</i> (pixels) to <i>map coordinates</i> using the affine

   * transformation in the {@link #trans #trans} attribute.

   * </p>

   * @param x the <code>x</code> <i>screen coordinate</i> of a 2D point

   * @param y the <code>y</code> <i>screen coordinate</i> of a 2D point

   * @return 2D point equivalent in <i>map coordinates</i>

   * <i>screen coordinates</i> (pixels) to <i>map coordinates</i> using

   * {@linkplain #toMapDistance(int)}, and {@linkplain #toMapPoint(int, int)}.

   * </p>

   * @param r the 2D rectangle in <i>screen coordinates</i> (pixels)

   * @return 2D rectangle equivalent in <i>map coordinates</i>

   * @see #fromMapRectangle(Rectangle2D)

   * coordinates</i> to <i>map coordinates</i> using the transformation affine

   * information in the {@link #trans #trans} attribute.

   * </p>

   * @param d distance in pixels

   * @return distance equivalent in <i>map coordinates</i>

   * @see #fromMapDistance(double)

   * coordinates</i> (pixels) to <i>map coordinates</i> using the inverse affine

   * transformation of the {@link #trans #trans} attribute.

   * </p>

   * @param pScreen the 2D point in <i>screen coordinates</i> (pixels)

   * @return 2D point equivalent in <i>map coordinates</i>

   * @see #toMapPoint(int, int)

   * <p>

   * If the projection of this view is UTM, considers the Earth curvature.

   * </p>

   * @param pt1 a 2D point in <i>map coordinates</i>

   * @param pt2 another 2D point in <i>map coordinates</i>

   * @return the distance in meters between the two points 2D

   * Sets as extent and adjusted extent of this view port, the previous.

   * Recalculating its parameters.

   * </p>

   * @see #getExtents()

   * @see #calculateAffineTransform()

   * @deprecated use {@link ViewPort#setPreviousEnvelope()}

   * Recalculating its parameters.

   * Stores the current extent in the next extents of the history.

   * </p>

   * @see #getExtents()

   * @see #calculateAffineTransform()

   */

  public void setPreviousEnvelope() {

    this.updateDrawVersion();

//    extentsHistory.putNext(extent);

//    extent = extentsHistory.removePrev();

    extent = extentsHistory.setPreviousExtent();

   * Recalculating its parameters.

   * Stores the current extent in the previous extents of the history.

   * </p>

   * @see #getExtents()

   * @see #calculateAffineTransform()

   */

  public void setNextEnvelope() {

    this.updateDrawVersion();

    extent = extentsHistory.setNextExtent();

    // Calcula la transformaci�n af�n

    calculateAffineTransform();

   * If you are looking for the complete extent currently shown, you must use

   * the {@linkplain #getAdjustedExtent()} method.

   * </p>

   * @return the current extent

   * @see #setEnvelope(Envelope)

   * @see #getAdjustedExtent()

   * If you are looking for the complete extent currently shown, you must use

   * the {@linkplain #getAdjustedEnvelope()} method.

   * </p>

   * @return the current envelope

   * @see #setEnvelope(Envelope)

   * @see #getAdjustedEnvelope()

   * <ul>

   * <li>Stores the previous extent.

   * <li>Calculates the new extent using <code>r</code>:

   * <pre>

   * extent = new Rectangle2D.Double(r.getMinX() - 0.1, r.getMinY() - 0.1,

   *     r.getWidth() + 0.2, r.getHeight() + 0.2);

   * the extent has changed.

   * </ul>

   * </p>

   * @param r the new extent

   * @see #getExtent()

   * @see #getExtents()

    // Calcula la transformaci�n af�n

    calculateAffineTransform();

    // Lanzamos los eventos de extent cambiado

    callExtentChanged(getAdjustedExtent());

  }

   * that the extent has changed.

   * </ul>

   * </p>

   * @see #setEnvelope(Envelope)

   * @see #calculateAffineTransform()

   */

   * scale that is the extent in <i>screen coordinates</i> from the image in

   * <i>map coordinates</i>.

   * </p>

   * @return the scale <i>extent / image size</i> projected by this view port

   * @deprecated since 07/09/07, use {@linkplain MapContext#getScaleView()}

   */

   * coordinates</i> (pixels), preserving the "straightness" and "parallelism"

   * of the lines.

   * </p>

   * @return the affine transformation

   * @see #setAffineTransform(AffineTransform)

   * @see #calculateAffineTransform()

   * <p>

   * Returns the size of the image projected.

   * </p>

   * @return the image size

   * @see #setImageSize(Dimension)

   * @see #getImageHeight()

   * Sets the size of the image projected, recalculating the parameters of this

   * view port.

   * </p>

   * @param imageSize the image size

   * @see #getImageSize()

   * @see #calculateAffineTransform()

   * Notifies to all view port listeners registered, that the adjusted extent of

   * this view port has changed.

   * </p>

   * @param newRect the new adjusted extend

   * @see #refreshExtent()

   * @see #setEnvelope(Envelope)

   * Notifies to all view port listeners registered, that the time of this view

   * port has changed.

   * </p>

   * @param newTime the new time

   * @see #refreshExtent()

   * @see #setTime(Time)

   * Notifies to all view port listeners registered, that the background color

   * of this view port has changed.

   * </p>

   * @param c the new background color

   * @see #setBackColor(Color)

   * @see ColorEvent

   * Notifies to all view port listeners registered, that the projection of this

   * view port has changed.

   * </p>

   * @param projection the new projection

   * @see #setProjection(IProjection)

   * @see ProjectionEvent

   * {@link #dist3pixel dist3pixel}) .

   * </ul>

   * </p>

   * @see #getAffineTransform()

   * @see #setAffineTransform(AffineTransform)

   * @see #refreshExtent()

   * <p>

   * The offset is the position where start drawing the map.

   * </p>

   * @param p 2D point that represents the offset in pixels

   * @see #getOffset()

   */

   * <p>

   * The offset is the position where start drawing the map.

   * </p>

   * @return 2D point that represents the offset in pixels

   * @see #setOffset(Point2D)

   */

   * <p>

   * Sets the background color.

   * </p>

   * @param c the new background color

   * @see #getBackColor()

   */

   * <p>

   * Gets the background color.

   * </p>

   * @return the background color of the view

   * @see #setBackColor(Color)

   */

   * Returns the extent currently covered by the view adjusted (scaled) to the

   * image size aspect.

   * </p>

   * @return extent of the view adjusted to the image size aspect

   * @see #setAdjustable(boolean)

   * @deprecated use {@link ViewPort#getAdjustedEnvelope()} instead

   * Returns the envelope currently covered by the view adjusted (scaled) to the

   * image size aspect.

   * </p>

   * @return envelope of the view adjusted to the image size aspect

   * @see #setAdjustable(boolean)

   */

    }

  /**

   * <p>

   * Returns the measurement unit of this view port used for measuring distances

   * and displaying information.

   * </p>

   * @return the measurement unit of this view used for measuring distances and

   *         displaying information

   * @see #setDistanceUnits(int)

   * Returns the measurement unit of this view port used for measuring areas and

   * displaying information.

   * </p>

   * @return the measurement unit of this view used for measuring areas and

   *         displaying information

   * @see #setDistanceUnits(int)

   * Sets the measurement unit of this view port used for measuring distances

   * and displaying information.

   * </p>

   * @param distanceUnits the measurement unit of this view used for measuring

   *          distances and displaying information

   * @see #getDistanceUnits()

   * Sets the measurement unit of this view port used for measuring areas and

   * displaying information.

   * </p>

   * @param distanceUnits the measurement unit of this view used for measuring

   *          areas and displaying information

   * @see #getDistanceUnits()

   * <p>

   * Gets the measurement unit used by this view port for the map.

   * </p>

   * @return Returns the current map measure unit

   * @see #setMapUnits(int)

   */

   * <p>

   * Sets the measurement unit used by this view port for the map.

   * </p>

   * @param mapUnits the new map measure unit

   * @see #getMapUnits()

   */

   * {@link #dist3pixel dist3pixel}) .

   * </ul>

   * </p>

   * @see #getImageHeight()

   * @see #getImageSize()

   * @see #setImageSize(Dimension)

   * {@link #dist3pixel dist3pixel}) .

   * </ul>

   * </p>

   * @see #getImageWidth()

   * @see #getImageSize()

   * @see #setImageSize(Dimension)

   * Gets the distance in <i>world coordinates</i> equivalent to 1 pixel in the

   * view with the current extent.

   * </p>

   * @return the distance

   * @see #setDist1pixel(double)

   */

   * Sets the distance in <i>world coordinates</i> equivalent to 1 pixel in the

   * view with the current extent.

   * </p>

   * @param dist1pixel the distance

   * @see #getDist1pixel()

   */

   * Gets the distance in <i>world coordinates</i> equivalent to 3 pixels in the

   * view with the current extent.

   * </p>

   * @return the distance

   * @see #setDist3pixel(double)

   */

   * Sets the distance in <i>world coordinates</i> equivalent to 3 pixels in the

   * view with the current extent.

   * </p>

   * @param dist3pixel the distance

   * @see #getDist3pixel()

   */

   * <p>

   * Returns the last previous extents of this view port.

   * </p>

   * @return the last previous extents of this view port

   * @see #setPreviousExtent()

   * @deprecated use {@link ViewPort#getEnvelopes()}

   * <p>

   * Returns the last previous extents of this view port.

   * </p>

   * @return the last previous extents of this view port

   * @see #setPreviousExtent()

   */

   * <p>

   * Gets the projection used in this view port.

   * </p>

   * @return projection used in this view port

   * @see #setProjection(IProjection)

   */

   * <p>

   * Sets the projection to this view port.

   * </p>

   * @param proj the new projection

   * @see #getProjection()

   */

   * <p>

   * <b><i>This method could be problematic!</i></b>

   * </p>

   * @param at the affine transform to set

   * @see #getAffineTransform()

   * @see #calculateAffineTransform()

   * <li>XML entity of the internal {@link ExtentHistory ExtentHistory} .

   * </ul>

   * </ul>

   * @return the XML entity

   * @see #createFromXML(XMLEntity)

   */

  /**

   * Clone the view port without clone the listeners nor the extent history.

   * @return the cloned view port

   */

  public Object clone() throws CloneNotSupportedException {

   * <code>{@linkplain #imageSize}</code>, <code>{@linkplain #scale}</code>, and

   * <code>{@linkplain #trans}</code>.

   * </p>

   * @return a <code>string</code> representation of the main values of this

   *         view port

   */

   * <p>

   * Sets the position and size of the clipping rectangle.

   * </p>

   * @param rectView the clipping rectangle to set

   */

  public void setClipRect(Rectangle2D rectView) {

   * transform</i> with the transformation affine information in the

   * {@link #trans #trans} attribute.

   * </p>

   * @param r the 2D rectangle in <i>map coordinates</i>

   * @return 2D rectangle equivalent in <i>screen coordinates</i> (pixels)

   * @see #toMapRectangle(Rectangle2D)

   * Recalculates the current <code>{@linkplain #extent}</code> using an scale.

   * It's necessary execute {@linkplain #refreshExtent()} after.

   * </p>

   * @param s the scale to set

   * @deprecated since 07/09/07, use {@linkplain MapContext#setScaleView(long)}

   */