001// License: GPL. For details, see LICENSE file.
002package org.openstreetmap.josm.data.osm.visitor;
003
004import java.util.Collection;
005
006import org.openstreetmap.josm.Main;
007import org.openstreetmap.josm.data.Bounds;
008import org.openstreetmap.josm.data.ProjectionBounds;
009import org.openstreetmap.josm.data.coor.CachedLatLon;
010import org.openstreetmap.josm.data.coor.EastNorth;
011import org.openstreetmap.josm.data.coor.LatLon;
012import org.openstreetmap.josm.data.osm.Node;
013import org.openstreetmap.josm.data.osm.OsmPrimitive;
014import org.openstreetmap.josm.data.osm.Relation;
015import org.openstreetmap.josm.data.osm.RelationMember;
016import org.openstreetmap.josm.data.osm.Way;
017
018/**
019 * Calculates the total bounding rectangle of a series of {@link OsmPrimitive} objects, using the
020 * EastNorth values as reference.
021 * @author imi
022 */
023public class BoundingXYVisitor extends AbstractVisitor {
024
025    private ProjectionBounds bounds = null;
026
027    @Override
028    public void visit(Node n) {
029        visit(n.getEastNorth());
030    }
031
032    @Override
033    public void visit(Way w) {
034        if (w.isIncomplete()) return;
035        for (Node n : w.getNodes()) {
036            visit(n);
037        }
038    }
039
040    @Override
041    public void visit(Relation e) {
042        // only use direct members
043        for (RelationMember m : e.getMembers()) {
044            if (!m.isRelation()) {
045                m.getMember().accept(this);
046            }
047        }
048    }
049
050    public void visit(Bounds b) {
051        if(b != null)
052        {
053            visit(b.getMin());
054            visit(b.getMax());
055        }
056    }
057
058    public void visit(ProjectionBounds b) {
059        if(b != null)
060        {
061            visit(b.getMin());
062            visit(b.getMax());
063        }
064    }
065
066    public void visit(LatLon latlon) {
067        if(latlon != null)
068        {
069            if(latlon instanceof CachedLatLon) {
070                visit(((CachedLatLon)latlon).getEastNorth());
071            } else {
072                visit(Main.getProjection().latlon2eastNorth(latlon));
073            }
074        }
075    }
076
077    public void visit(EastNorth eastNorth) {
078        if (eastNorth != null) {
079            if (bounds == null) {
080                bounds = new ProjectionBounds(eastNorth);
081            } else {
082                bounds.extend(eastNorth);
083            }
084        }
085    }
086
087    public boolean hasExtend() {
088        return bounds != null && bounds.hasExtend();
089    }
090
091    /**
092     * @return The bounding box or <code>null</code> if no coordinates have passed
093     */
094    public ProjectionBounds getBounds() {
095        return bounds;
096    }
097
098    /**
099     * Enlarges the calculated bounding box by 0.002 degrees.
100     * If the bounding box has not been set (<code>min</code> or <code>max</code>
101     * equal <code>null</code>) this method does not do anything.
102     */
103    public void enlargeBoundingBox() {
104        enlargeBoundingBox(Main.pref.getDouble("edit.zoom-enlarge-bbox", 0.002));
105    }
106
107    /**
108     * Enlarges the calculated bounding box by the specified number of degrees.
109     * If the bounding box has not been set (<code>min</code> or <code>max</code>
110     * equal <code>null</code>) this method does not do anything.
111     *
112     * @param enlargeDegree
113     */
114    public void enlargeBoundingBox(double enlargeDegree) {
115        if (bounds == null)
116            return;
117        LatLon minLatlon = Main.getProjection().eastNorth2latlon(bounds.getMin());
118        LatLon maxLatlon = Main.getProjection().eastNorth2latlon(bounds.getMax());
119        bounds = new ProjectionBounds(
120                Main.getProjection().latlon2eastNorth(new LatLon(minLatlon.lat() - enlargeDegree, minLatlon.lon() - enlargeDegree)),
121                Main.getProjection().latlon2eastNorth(new LatLon(maxLatlon.lat() + enlargeDegree, maxLatlon.lon() + enlargeDegree)));
122    }
123
124    /**
125     * Enlarges the bounding box up to <code>maxEnlargePercent</code>, depending on
126     * its size. If the bounding box is small, it will be enlarged more in relation
127     * to its beginning size. The larger the bounding box, the smaller the change,
128     * down to the minimum of 1% enlargement.
129     *
130     * Warning: if the bounding box only contains a single node, no expansion takes
131     * place because a node has no width/height. Use <code>enlargeToMinDegrees</code>
132     * instead.
133     *
134     * Example: You specify enlargement to be up to 100%.
135     *
136     *          Bounding box is a small house: enlargement will be 95–100%, i.e.
137     *          making enough space so that the house fits twice on the screen in
138     *          each direction.
139     *
140     *          Bounding box is a large landuse, like a forest: Enlargement will
141     *          be 1–10%, i.e. just add a little border around the landuse.
142     *
143     * If the bounding box has not been set (<code>min</code> or <code>max</code>
144     * equal <code>null</code>) this method does not do anything.
145     *
146     * @param maxEnlargePercent
147     */
148    public void enlargeBoundingBoxLogarithmically(double maxEnlargePercent) {
149        if (bounds == null)
150            return;
151
152        double diffEast = bounds.getMax().east() - bounds.getMin().east();
153        double diffNorth = bounds.getMax().north() - bounds.getMin().north();
154
155        double enlargeEast = Math.min(maxEnlargePercent - 10*Math.log(diffEast), 1)/100;
156        double enlargeNorth = Math.min(maxEnlargePercent - 10*Math.log(diffNorth), 1)/100;
157
158        visit(bounds.getMin().add(-enlargeEast/2, -enlargeNorth/2));
159        visit(bounds.getMax().add(+enlargeEast/2, +enlargeNorth/2));
160    }
161
162    /**
163     * Specify a degree larger than 0 in order to make the bounding box at least
164     * the specified size in width and height. The value is ignored if the
165     * bounding box is already larger than the specified amount.
166     *
167     * If the bounding box has not been set (<code>min</code> or <code>max</code>
168     * equal <code>null</code>) this method does not do anything.
169     *
170     * If the bounding box contains objects and is to be enlarged, the objects
171     * will be centered within the new bounding box.
172     *
173     * @param size minimum width and height in meter
174     */
175    public void enlargeToMinSize(double size) {
176        if (bounds == null)
177            return;
178        // convert size from meters to east/north units
179        double en_size = size * Main.map.mapView.getScale() / Main.map.mapView.getDist100Pixel() * 100;
180        visit(bounds.getMin().add(-en_size/2, -en_size/2));
181        visit(bounds.getMax().add(+en_size/2, +en_size/2));
182    }
183
184
185    @Override public String toString() {
186        return "BoundingXYVisitor["+bounds+"]";
187    }
188
189    public void computeBoundingBox(Collection<? extends OsmPrimitive> primitives) {
190        if (primitives == null) return;
191        for (OsmPrimitive p: primitives) {
192            if (p == null) {
193                continue;
194            }
195            p.accept(this);
196        }
197    }
198}