1 | // License: GPL. For details, see LICENSE file.
|
---|
2 | package org.openstreetmap.josm.gui.mappaint;
|
---|
3 |
|
---|
4 | import static org.junit.Assert.assertEquals;
|
---|
5 | import static org.junit.Assert.fail;
|
---|
6 |
|
---|
7 | import java.awt.Graphics2D;
|
---|
8 | import java.awt.GraphicsEnvironment;
|
---|
9 | import java.awt.Point;
|
---|
10 | import java.awt.RenderingHints;
|
---|
11 | import java.awt.image.BufferedImage;
|
---|
12 | import java.io.File;
|
---|
13 | import java.io.FileInputStream;
|
---|
14 | import java.io.FileNotFoundException;
|
---|
15 | import java.io.IOException;
|
---|
16 | import java.text.MessageFormat;
|
---|
17 | import java.util.ArrayList;
|
---|
18 | import java.util.Arrays;
|
---|
19 | import java.util.Collection;
|
---|
20 | import java.util.List;
|
---|
21 | import java.util.stream.Collectors;
|
---|
22 | import java.util.stream.Stream;
|
---|
23 |
|
---|
24 | import javax.imageio.ImageIO;
|
---|
25 |
|
---|
26 | import org.junit.Assume;
|
---|
27 | import org.junit.Before;
|
---|
28 | import org.junit.Rule;
|
---|
29 | import org.junit.Test;
|
---|
30 | import org.junit.runner.RunWith;
|
---|
31 | import org.junit.runners.Parameterized;
|
---|
32 | import org.junit.runners.Parameterized.Parameters;
|
---|
33 | import org.openstreetmap.josm.TestUtils;
|
---|
34 | import org.openstreetmap.josm.data.Bounds;
|
---|
35 | import org.openstreetmap.josm.data.osm.DataSet;
|
---|
36 | import org.openstreetmap.josm.data.osm.OsmPrimitive;
|
---|
37 | import org.openstreetmap.josm.data.osm.visitor.paint.StyledMapRenderer;
|
---|
38 | import org.openstreetmap.josm.gui.NavigatableComponent;
|
---|
39 | import org.openstreetmap.josm.gui.mappaint.mapcss.MapCSSStyleSource;
|
---|
40 | import org.openstreetmap.josm.gui.preferences.SourceEntry;
|
---|
41 | import org.openstreetmap.josm.io.IllegalDataException;
|
---|
42 | import org.openstreetmap.josm.io.OsmReader;
|
---|
43 | import org.openstreetmap.josm.testutils.JOSMTestRules;
|
---|
44 |
|
---|
45 | import edu.umd.cs.findbugs.annotations.SuppressFBWarnings;
|
---|
46 |
|
---|
47 | /**
|
---|
48 | * Test cases for {@link StyledMapRenderer} and the MapCSS classes.
|
---|
49 | * <p>
|
---|
50 | * This test uses the data and reference files stored in the test data directory {@value #TEST_DATA_BASE}
|
---|
51 | * @author Michael Zangl
|
---|
52 | */
|
---|
53 | @RunWith(Parameterized.class)
|
---|
54 | public class MapCSSRendererTest {
|
---|
55 | private static final String TEST_DATA_BASE = "/renderer/";
|
---|
56 | /**
|
---|
57 | * lat = 0..1, lon = 0..1
|
---|
58 | */
|
---|
59 | private static final Bounds AREA_DEFAULT = new Bounds(0, 0, 1, 1);
|
---|
60 | private static final int IMAGE_SIZE = 256;
|
---|
61 |
|
---|
62 | /**
|
---|
63 | * Minimal test rules required
|
---|
64 | */
|
---|
65 | @Rule
|
---|
66 | @SuppressFBWarnings(value = "URF_UNREAD_PUBLIC_OR_PROTECTED_FIELD")
|
---|
67 | public JOSMTestRules test = new JOSMTestRules().preferences().projection();
|
---|
68 |
|
---|
69 | private TestConfig testConfig;
|
---|
70 |
|
---|
71 | /**
|
---|
72 | * The different configurations of this test.
|
---|
73 | *
|
---|
74 | * @return The parameters.
|
---|
75 | */
|
---|
76 | @Parameters(name = "{1}")
|
---|
77 | public static Collection<Object[]> runs() {
|
---|
78 | return Stream.of(
|
---|
79 | /** Tests for StyledMapRenderer#drawNodeSymbol */
|
---|
80 | new TestConfig("node-shapes", AREA_DEFAULT),
|
---|
81 |
|
---|
82 | /** Text for nodes */
|
---|
83 | new TestConfig("node-text", AREA_DEFAULT).usesFont("DejaVu Sans"),
|
---|
84 |
|
---|
85 | /** Tests that StyledMapRenderer#drawWay respects width */
|
---|
86 | new TestConfig("way-width", AREA_DEFAULT),
|
---|
87 |
|
---|
88 | /** Tests the way color property, including alpha */
|
---|
89 | new TestConfig("way-color", AREA_DEFAULT),
|
---|
90 |
|
---|
91 | /** Tests dashed ways. */
|
---|
92 | new TestConfig("way-dashes", AREA_DEFAULT),
|
---|
93 |
|
---|
94 | /** Tests fill-color property */
|
---|
95 | new TestConfig("area-fill-color", AREA_DEFAULT),
|
---|
96 |
|
---|
97 | /** Tests the fill-image property. */
|
---|
98 | new TestConfig("area-fill-image", AREA_DEFAULT),
|
---|
99 |
|
---|
100 | /** Tests if all styles are sorted correctly. Tests {@link StyleRecord#compareTo(StyleRecord)} */
|
---|
101 | new TestConfig("order", AREA_DEFAULT)
|
---|
102 |
|
---|
103 | ).map(e -> new Object[] {e, e.testDirectory})
|
---|
104 | .collect(Collectors.toList());
|
---|
105 | }
|
---|
106 |
|
---|
107 | /**
|
---|
108 | * @param testConfig The config to use for this test.
|
---|
109 | * @param ignored The name to print it nicely
|
---|
110 | */
|
---|
111 | public MapCSSRendererTest(TestConfig testConfig, String ignored) {
|
---|
112 | this.testConfig = testConfig;
|
---|
113 | }
|
---|
114 |
|
---|
115 | /**
|
---|
116 | * This test only runs on OpenJDK.
|
---|
117 | * It is ignored for other Java versions since they differ slightly in their rendering engine.
|
---|
118 | * @since 11691
|
---|
119 | */
|
---|
120 | @Before
|
---|
121 | public void testForOpenJDK() {
|
---|
122 | String javaHome = System.getProperty("java.home");
|
---|
123 | Assume.assumeTrue("Test requires openJDK", javaHome != null && javaHome.contains("openjdk"));
|
---|
124 |
|
---|
125 | List<String> fonts = Arrays.asList(GraphicsEnvironment.getLocalGraphicsEnvironment().getAvailableFontFamilyNames());
|
---|
126 | for (String font : testConfig.fonts) {
|
---|
127 | Assume.assumeTrue("Test requires font: " + font, fonts.contains(font));
|
---|
128 | }
|
---|
129 | }
|
---|
130 |
|
---|
131 | /**
|
---|
132 | * Run the test using {@link #testConfig}
|
---|
133 | * @throws Exception if an error occurs
|
---|
134 | */
|
---|
135 | @Test
|
---|
136 | public void testRender() throws Exception {
|
---|
137 | // load the data
|
---|
138 | DataSet dataSet = testConfig.getOsmDataSet();
|
---|
139 |
|
---|
140 | // load the style
|
---|
141 | MapCSSStyleSource.STYLE_SOURCE_LOCK.writeLock().lock();
|
---|
142 | try {
|
---|
143 | MapPaintStyles.getStyles().clear();
|
---|
144 |
|
---|
145 | MapCSSStyleSource source = new MapCSSStyleSource(testConfig.getStyleSourceEntry());
|
---|
146 | source.loadStyleSource();
|
---|
147 | if (!source.getErrors().isEmpty()) {
|
---|
148 | fail("Failed to load style file. Errors: " + source.getErrors());
|
---|
149 | }
|
---|
150 | MapPaintStyles.getStyles().setStyleSources(Arrays.asList(source));
|
---|
151 | MapPaintStyles.fireMapPaintSylesUpdated();
|
---|
152 | MapPaintStyles.getStyles().clearCached();
|
---|
153 |
|
---|
154 | } finally {
|
---|
155 | MapCSSStyleSource.STYLE_SOURCE_LOCK.writeLock().unlock();
|
---|
156 | }
|
---|
157 |
|
---|
158 | // create the renderer
|
---|
159 | BufferedImage image = new BufferedImage(IMAGE_SIZE, IMAGE_SIZE, BufferedImage.TYPE_INT_ARGB);
|
---|
160 | NavigatableComponent nc = new NavigatableComponent() {
|
---|
161 | {
|
---|
162 | setBounds(0, 0, IMAGE_SIZE, IMAGE_SIZE);
|
---|
163 | updateLocationState();
|
---|
164 | }
|
---|
165 |
|
---|
166 | @Override
|
---|
167 | protected boolean isVisibleOnScreen() {
|
---|
168 | return true;
|
---|
169 | }
|
---|
170 |
|
---|
171 | @Override
|
---|
172 | public Point getLocationOnScreen() {
|
---|
173 | return new Point(0, 0);
|
---|
174 | }
|
---|
175 | };
|
---|
176 | nc.zoomTo(testConfig.testArea);
|
---|
177 | dataSet.allPrimitives().stream().forEach(this::loadPrimitiveStyle);
|
---|
178 | dataSet.setSelected(dataSet.allPrimitives().stream().filter(n -> n.isKeyTrue("selected")).collect(Collectors.toList()));
|
---|
179 |
|
---|
180 | Graphics2D g = image.createGraphics();
|
---|
181 | // Force all render hints to be defaults - do not use platform values
|
---|
182 | g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
|
---|
183 | g.setRenderingHint(RenderingHints.KEY_ALPHA_INTERPOLATION, RenderingHints.VALUE_ALPHA_INTERPOLATION_QUALITY);
|
---|
184 | g.setRenderingHint(RenderingHints.KEY_COLOR_RENDERING, RenderingHints.VALUE_COLOR_RENDER_QUALITY);
|
---|
185 | g.setRenderingHint(RenderingHints.KEY_DITHERING, RenderingHints.VALUE_DITHER_DISABLE);
|
---|
186 | g.setRenderingHint(RenderingHints.KEY_FRACTIONALMETRICS, RenderingHints.VALUE_FRACTIONALMETRICS_ON);
|
---|
187 | g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);
|
---|
188 | g.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
|
---|
189 | g.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, RenderingHints.VALUE_STROKE_NORMALIZE);
|
---|
190 | g.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON);
|
---|
191 | new StyledMapRenderer(g, nc, false).render(dataSet, false, testConfig.testArea);
|
---|
192 |
|
---|
193 | BufferedImage reference = testConfig.getReference();
|
---|
194 |
|
---|
195 | // now compute differences:
|
---|
196 | assertEquals(IMAGE_SIZE, reference.getWidth());
|
---|
197 | assertEquals(IMAGE_SIZE, reference.getHeight());
|
---|
198 |
|
---|
199 | StringBuilder differences = new StringBuilder();
|
---|
200 | ArrayList<Point> differencePoints = new ArrayList<>();
|
---|
201 |
|
---|
202 | for (int y = 0; y < reference.getHeight(); y++) {
|
---|
203 | for (int x = 0; x < reference.getWidth(); x++) {
|
---|
204 | int expected = reference.getRGB(x, y);
|
---|
205 | int result = image.getRGB(x, y);
|
---|
206 | if (!colorsAreSame(expected, result)) {
|
---|
207 | differencePoints.add(new Point(x, y));
|
---|
208 | if (differences.length() < 500) {
|
---|
209 | differences.append("\nDifference at ")
|
---|
210 | .append(x)
|
---|
211 | .append(",")
|
---|
212 | .append(y)
|
---|
213 | .append(": Expected ")
|
---|
214 | .append(Integer.toHexString(expected))
|
---|
215 | .append(" but got ")
|
---|
216 | .append(Integer.toHexString(result));
|
---|
217 | }
|
---|
218 | }
|
---|
219 | }
|
---|
220 | }
|
---|
221 |
|
---|
222 | if (differencePoints.size() > 0) {
|
---|
223 | // You can use this to debug:
|
---|
224 | ImageIO.write(image, "png", new File(testConfig.getTestDirectory() + "/test-output.png"));
|
---|
225 |
|
---|
226 | // Add a nice image that highlights the differences:
|
---|
227 | BufferedImage diffImage = new BufferedImage(IMAGE_SIZE, IMAGE_SIZE, BufferedImage.TYPE_INT_ARGB);
|
---|
228 | for (Point p : differencePoints) {
|
---|
229 | diffImage.setRGB(p.x, p.y, 0xffff0000);
|
---|
230 | }
|
---|
231 | ImageIO.write(diffImage, "png", new File(testConfig.getTestDirectory() + "/test-differences.png"));
|
---|
232 |
|
---|
233 | fail(MessageFormat.format("Images for test {0} differ at {1} points: {2}",
|
---|
234 | testConfig.testDirectory, differencePoints.size(), differences.toString()));
|
---|
235 | }
|
---|
236 | }
|
---|
237 |
|
---|
238 | private void loadPrimitiveStyle(OsmPrimitive n) {
|
---|
239 | n.setHighlighted(n.isKeyTrue("highlight"));
|
---|
240 | if (n.isKeyTrue("disabled")) {
|
---|
241 | n.setDisabledState(false);
|
---|
242 | }
|
---|
243 | }
|
---|
244 |
|
---|
245 | /**
|
---|
246 | * Check if two colors differ
|
---|
247 | * @param expected The expected color
|
---|
248 | * @param actual The actual color
|
---|
249 | * @return <code>true</code> if they differ.
|
---|
250 | */
|
---|
251 | private boolean colorsAreSame(int expected, int actual) {
|
---|
252 | int expectedAlpha = expected >> 24;
|
---|
253 | if (expectedAlpha == 0) {
|
---|
254 | return actual >> 24 == 0;
|
---|
255 | } else {
|
---|
256 | return expected == actual;
|
---|
257 | }
|
---|
258 | }
|
---|
259 |
|
---|
260 | private static class TestConfig {
|
---|
261 | private final String testDirectory;
|
---|
262 | private final Bounds testArea;
|
---|
263 | private final ArrayList<String> fonts = new ArrayList<>();
|
---|
264 |
|
---|
265 | TestConfig(String testDirectory, Bounds testArea) {
|
---|
266 | this.testDirectory = testDirectory;
|
---|
267 | this.testArea = testArea;
|
---|
268 | }
|
---|
269 |
|
---|
270 | public TestConfig usesFont(String string) {
|
---|
271 | this.fonts.add(string);
|
---|
272 | return this;
|
---|
273 | }
|
---|
274 |
|
---|
275 | public BufferedImage getReference() throws IOException {
|
---|
276 | return ImageIO.read(new File(getTestDirectory() + "/reference.png"));
|
---|
277 | }
|
---|
278 |
|
---|
279 | private String getTestDirectory() {
|
---|
280 | return TestUtils.getTestDataRoot() + TEST_DATA_BASE + testDirectory;
|
---|
281 | }
|
---|
282 |
|
---|
283 | public SourceEntry getStyleSourceEntry() {
|
---|
284 | return new SourceEntry(getTestDirectory() + "/style.mapcss",
|
---|
285 | "test style", "a test style", true // active
|
---|
286 | );
|
---|
287 | }
|
---|
288 |
|
---|
289 | public DataSet getOsmDataSet() throws FileNotFoundException, IllegalDataException {
|
---|
290 | return OsmReader.parseDataSet(new FileInputStream(getTestDirectory() + "/data.osm"), null);
|
---|
291 | }
|
---|
292 |
|
---|
293 | @Override
|
---|
294 | public String toString() {
|
---|
295 | return "TestConfig [testDirectory=" + testDirectory + ", testArea=" + testArea + ']';
|
---|
296 | }
|
---|
297 | }
|
---|
298 | }
|
---|