1 /*
2 * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package com.sun.marlin;
27
28 import java.security.AccessController;
29 import static com.sun.marlin.MarlinUtils.logInfo;
30 import java.security.PrivilegedAction;
31
32 public final class MarlinProperties {
33
34 private MarlinProperties() {
35 // no-op
36 }
37
38 // marlin system properties
39
40 public static boolean isUseThreadLocal() {
41 return getBoolean("prism.marlin.useThreadLocal", "true");
42 }
43
44 /**
45 * Return the initial edge capacity used to define initial arrays
46 * (edges, polystack, crossings)
47 *
48 * @return 256 < initial edges < 65536 (4096 by default)
49 */
50 public static int getInitialEdges() {
51 return align(
52 getInteger("prism.marlin.edges", 4096, 64, 64 * 1024),
53 64);
54 }
55
56 /**
57 * Return the initial pixel size used to define initial arrays
58 * (tile AA chunk, alpha line, buckets)
59 *
60 * @return 64 < initial pixel size < 32768 (2048 by default)
61 */
62 public static int getInitialImageSize() {
63 return align(
64 getInteger("prism.marlin.pixelsize", 2048, 64, 32 * 1024),
65 64);
66 }
67
68 /**
69 * Return the log(2) corresponding to subpixel on x-axis (
70 *
71 * @return 0 (1 subpixels) < initial pixel size < 8 (256 subpixels)
72 * (3 by default ie 8 subpixels)
73 */
74 public static int getSubPixel_Log2_X() {
75 return getInteger("prism.marlin.subPixel_log2_X", 3, 0, 8);
76 }
77
78 /**
79 * Return the log(2) corresponding to subpixel on y-axis (
80 *
81 * @return 0 (1 subpixels) < initial pixel size < 8 (256 subpixels)
82 * (3 by default ie 8 subpixels)
83 */
84 public static int getSubPixel_Log2_Y() {
85 return getInteger("prism.marlin.subPixel_log2_Y", 3, 0, 8);
86 }
87
88 /**
89 * Return the log(2) corresponding to the block size in pixels
90 *
91 * @return 3 (8 pixels) < block size < 8 (256 pixels)
92 * (5 by default ie 32 pixels)
93 */
94 public static int getBlockSize_Log2() {
95 return getInteger("prism.marlin.blockSize_log2", 5, 3, 8);
96 }
97
98 // RLE / blockFlags settings
99
100 public static boolean isForceRLE() {
101 return getBoolean("prism.marlin.forceRLE", "false");
102 }
103
104 public static boolean isForceNoRLE() {
105 return getBoolean("prism.marlin.forceNoRLE", "false");
106 }
107
108 public static boolean isUseTileFlags() {
109 return getBoolean("prism.marlin.useTileFlags", "true");
110 }
111
112 public static boolean isUseTileFlagsWithHeuristics() {
113 return isUseTileFlags()
114 && getBoolean("prism.marlin.useTileFlags.useHeuristics", "true");
115 }
116
117 public static int getRLEMinWidth() {
118 return getInteger("prism.marlin.rleMinWidth", 64, 0, Integer.MAX_VALUE);
119 }
120
121 // optimisation parameters
122
123 public static boolean isUseSimplifier() {
124 return getBoolean("prism.marlin.useSimplifier", "false");
125 }
126
127 public static boolean isDoClip() {
128 return getBoolean("prism.marlin.clip", "true");
129 }
130
131 public static boolean isDoClipRuntimeFlag() {
132 return getBoolean("prism.marlin.clip.runtime.enable", "false");
133 }
134
135 public static boolean isDoClipAtRuntime() {
136 return getBoolean("prism.marlin.clip.runtime", "true");
137 }
138
139 // debugging parameters
140
141 public static boolean isDoStats() {
142 return getBoolean("prism.marlin.doStats", "false");
143 }
144
145 public static boolean isDoMonitors() {
146 return getBoolean("prism.marlin.doMonitors", "false");
147 }
148
149 public static boolean isDoChecks() {
150 return getBoolean("prism.marlin.doChecks", "false");
151 }
152
153 // logging parameters
154
155 public static boolean isLoggingEnabled() {
156 return getBoolean("prism.marlin.log", "false");
157 }
158
159 public static boolean isUseLogger() {
160 return getBoolean("prism.marlin.useLogger", "false");
161 }
162
163 public static boolean isLogCreateContext() {
164 return getBoolean("prism.marlin.logCreateContext", "false");
165 }
166
167 public static boolean isLogUnsafeMalloc() {
168 return getBoolean("prism.marlin.logUnsafeMalloc", "false");
169 }
170
171 // quality settings
172
173 public static float getCubicDecD2() {
174 return getFloat("prism.marlin.cubic_dec_d2", 1.0f, 0.01f, 4.0f);
175 }
176
177 public static float getCubicIncD1() {
178 return getFloat("prism.marlin.cubic_inc_d1", 0.4f, 0.01f, 2.0f);
179 }
180
181 public static float getQuadDecD2() {
182 return getFloat("prism.marlin.quad_dec_d2", 0.5f, 0.01f, 4.0f);
183 }
184
185 // system property utilities
186 static boolean getBoolean(final String key, final String def) {
187 return Boolean.valueOf(AccessController.doPrivileged(
188 (PrivilegedAction<String>) () -> {
189 String value = System.getProperty(key);
190 return (value == null) ? def : value;
191 }));
192 }
193
194 static int getInteger(final String key, final int def,
195 final int min, final int max)
196 {
197 final String property = AccessController.doPrivileged(
198 (PrivilegedAction<String>) () -> System.getProperty(key));
199
200 int value = def;
201 if (property != null) {
202 try {
203 value = Integer.decode(property);
204 } catch (NumberFormatException e) {
205 logInfo("Invalid integer value for " + key + " = " + property);
206 }
207 }
208
209 // check for invalid values
210 if ((value < min) || (value > max)) {
211 logInfo("Invalid value for " + key + " = " + value
212 + "; expected value in range[" + min + ", " + max + "] !");
213 value = def;
214 }
215 return value;
216 }
217
218 static int align(final int val, final int norm) {
219 final int ceil = FloatMath.ceil_int( ((float) val) / norm);
220 return ceil * norm;
221 }
222
223 public static double getDouble(final String key, final double def,
224 final double min, final double max)
225 {
226 double value = def;
227 final String property = AccessController.doPrivileged(
228 (PrivilegedAction<String>) () -> System.getProperty(key));
229
230 if (property != null) {
231 try {
232 value = Double.parseDouble(property);
233 } catch (NumberFormatException nfe) {
234 logInfo("Invalid value for " + key + " = " + property + " !");
235 }
236 }
237 // check for invalid values
238 if (value < min || value > max) {
239 logInfo("Invalid value for " + key + " = " + value
240 + "; expect value in range[" + min + ", " + max + "] !");
241 value = def;
242 }
243 return value;
244 }
245
246 public static float getFloat(final String key, final float def,
247 final float min, final float max)
248 {
249 return (float)getDouble(key, def, min, max);
250 }
251 }