static int TILE_FLAG = 0x00000020;
static int FONT_CHANGED_FLAG = 0x00000040; // set when font changes, cleared during repack
static int ISROOT_FLAG = 0x00000080;
+ static int NOCLIP_FLAG = 0x00000100;
// Geometry ////////////////////////////////////////////////////////////////////////////
//#define MIN_LENGTH Integer.MIN_VALUE
// always correct (set directly by user)
- LENGTH minwidth = 0;
- LENGTH minheight = 0;
- LENGTH maxwidth = MAX_LENGTH;
- LENGTH maxheight = MAX_LENGTH;
+ public LENGTH minwidth = 0;
+ public LENGTH minheight = 0;
+ public LENGTH maxwidth = MAX_LENGTH;
+ public LENGTH maxheight = MAX_LENGTH;
private LENGTH hpad = 0;
private LENGTH vpad = 0;
private String text = null;
// Rendering Properties ///////////////////////////////////////////////////////////
- //private SVG.VP path = null;
- //private SVG.Paint fill = null;
- //private SVG.Paint stroke = null;
+ private VectorGraphics.VectorPath path = null;
+ private VectorGraphics.Affine transform = null;
+ //private VectorGraphics.Paint fill = null;
+ //private VectorGraphics.Paint stroke = null;
+ int strokewidth = 1;
- private Picture image; // will disappear
- private int fillcolor = 0x00000000; // will become SVG.Paint
- private int strokecolor = 0xFF000000; // will become SVG.Paint
+ public Picture image; // will disappear
+ private int fillcolor = 0x00000000; // will become VectorGraphics.Paint
+ private int strokecolor = 0xFF000000; // will become VectorGraphics.Paint
+ private int textcolor = 0xFF000000; // will become VectorGraphics.Paint
private String cursor = null; // the cursor for this box
// Instance Methods /////////////////////////////////////////////////////////////////////
/** Adds the intersection of (x,y,w,h) and the node's current actual geometry to the Surface's dirty list */
- public final void dirty() { dirty(0, 0, width, height); }
+ public final void dirty() {
+ if ((flags & NOCLIP_FLAG) != 0 && parent != null) parent.dirty();
+ else dirty(0, 0, width, height);
+ }
public final void dirty(int x, int y, int w, int h) {
for(Box cur = this; cur != null; cur = cur.parent) {
- w = min(x + w, cur.width) - max(x, 0);
- h = min(y + h, cur.height) - max(y, 0);
- x = max(x, 0);
- y = max(y, 0);
+ if ((flags & NOCLIP_FLAG) == 0) {
+ w = min(x + w, cur.width) - max(x, 0);
+ h = min(y + h, cur.height) - max(y, 0);
+ x = max(x, 0);
+ y = max(y, 0);
+ }
if (w <= 0 || h <= 0) return;
if (cur.parent == null && cur.surface != null) cur.surface.dirty(x, y, w, h);
x += cur.x;
// Reflow ////////////////////////////////////////////////////////////////////////////////////////
- void reflow() {
+ void reflow() { reflow(width, height); }
+ void reflow(int new_width, int new_height) {
repack();
if (Surface.abort) return;
- resize(x, y, width, height);
+ resize(x, y, new_width, new_height);
}
/** Checks if the Box's size has changed, dirties it if necessary, and makes sure childrens' sizes are up to date */
if (numChildren() == 0) {
contentwidth = max(textwidth + 2 * hpad, minwidth);
contentheight = max(textheight + 2 * vpad, minheight);
+ if (path != null) {
+ contentwidth = max(contentwidth, path.boundingBoxWidth());
+ contentheight = max(contentheight, path.boundingBoxHeight());
+ }
return;
}
for(int col=0; col<numCols; col++) contentwidth += colWidth[col];
contentwidth = max(textwidth + 2 * hpad, contentwidth);
contentwidth = bound(minwidth, contentwidth, maxwidth);
+ if (path != null) {
+ contentwidth = max(contentwidth, path.boundingBoxWidth());
+ contentheight = max(contentheight, path.boundingBoxHeight());
+ }
//#end
}
- void resize(LENGTH x, LENGTH y, LENGTH width, LENGTH height) {
-
+ private void resize(LENGTH x, LENGTH y, LENGTH width, LENGTH height) {
+
// --- Phase 1 ----------------------------------------------------------------------
// run PosChange/SizeChange, dirty as needed
if (x != this.x || y != this.y || width != this.width || height != this.height) {
if (Log.on) Log.logJS(this, "Warning, more than 500 SizeChange/PosChange traps triggered since last complete render");
} else {
sizePosChangesSinceLastRender++;
- if (sizechange) put("SizeChange", Boolean.TRUE);
- if (poschange) put("PosChange", Boolean.TRUE);
+ try { if (sizechange) put("SizeChange", Boolean.TRUE); } catch (Exception e) { Log.log(this, e); }
+ try { if (poschange) put("PosChange", Boolean.TRUE); } catch (Exception e) { Log.log(this, e); }
Surface.abort = true;
return;
}
// Rendering Pipeline /////////////////////////////////////////////////////////////////////
/** Renders self and children within the specified region. All rendering operations are clipped to xIn,yIn,wIn,hIn */
- void render(int parentx, int parenty, int clipx, int clipy, int clipw, int cliph, PixelBuffer buf) {
+ void render(int parentx, int parenty, int clipx, int clipy, int clipw, int cliph, PixelBuffer buf, VectorGraphics.Affine a) {
if (Surface.abort || (flags & INVISIBLE_FLAG) != 0) return;
int globalx = parentx + (parent == null ? 0 : x);
int globaly = parenty + (parent == null ? 0 : y);
// intersect the x,y,w,h rendering window with ourselves; quit if it's empty
- clipw = min(max(clipx, parent == null ? 0 : globalx) + clipw,
- (parent == null ? 0 : globalx) + width) - globalx;
- cliph = min(max(clipy, parent == null ? 0 : globaly) + cliph,
- (parent == null ? 0 : globaly) + height) - globaly;
- clipx = max(clipx, parent == null ? 0 : globalx);
- clipy = max(clipy, parent == null ? 0 : globaly);
+ if ((flags & NOCLIP_FLAG) == 0) {
+ clipw = min(max(clipx, parent == null ? 0 : globalx) + clipw, (parent == null ? 0 : globalx) + width) - globalx;
+ cliph = min(max(clipy, parent == null ? 0 : globaly) + cliph, (parent == null ? 0 : globaly) + height) - globaly;
+ clipx = max(clipx, parent == null ? 0 : globalx);
+ clipy = max(clipy, parent == null ? 0 : globaly);
+ }
if (clipw <= 0 || cliph <= 0) return;
- if ((fillcolor & 0xFF000000) != 0x00000000 || parent == null)
- buf.fillRect(clipx, clipy, clipx + clipw, clipy + cliph,
- (fillcolor & 0xFF000000) != 0 ? fillcolor : 0xFF777777);
+ if ((fillcolor & 0xFF000000) != 0x00000000)
+ buf.fillTrapezoid(clipx, clipx + clipw, clipy, clipx, clipx + clipw, clipy + cliph, fillcolor);
if (image != null)
if ((flags & TILE_FLAG) != 0) renderTiledImage(globalx, globaly, clipx, clipy, clipw, cliph, buf);
if (text != null && !text.equals(""))
renderText(globalx, globaly, clipx, clipy, clipw, cliph, buf);
+ if (path != null) {
+ VectorGraphics.RasterPath rp = path.realize(a);
+ if ((strokecolor & 0xff000000) != 0) rp.stroke(buf, 1, strokecolor);
+ if ((fillcolor & 0xff000000) != 0) rp.fill(buf, new VectorGraphics.SingleColorPaint(fillcolor));
+ }
+
// now subtract the pad region from the clip region before proceeding
- clipw = min(max(clipx, globalx + hpad) + clipw, globalx + width - hpad) - clipx;
- cliph = min(max(clipy, globaly + vpad) + cliph, globaly + height - vpad) - clipy;
- clipx = max(clipx, globalx + hpad);
- clipy = max(clipy, globaly + vpad);
+ if ((flags & NOCLIP_FLAG) == 0) {
+ clipw = min(max(clipx, globalx + hpad) + clipw, globalx + width - hpad) - clipx;
+ cliph = min(max(clipy, globaly + vpad) + cliph, globaly + height - vpad) - clipy;
+ clipx = max(clipx, globalx + hpad);
+ clipy = max(clipy, globaly + vpad);
+ }
- for(Box b = getChild(0); b != null; b = b.nextSibling())
- b.render(globalx, globaly, clipx, clipy, clipw, cliph, buf);
+ for(Box b = getChild(0); b != null; b = b.nextSibling()) {
+ a.translate(b.x, b.y);
+ b.render(globalx, globaly, clipx, clipy, clipw, cliph, buf, a);
+ a.translate(-1 * b.x, -1 * b.y);
+ }
}
void renderStretchedImage(int globalx, int globaly, int clipx, int clipy, int clipw, int cliph, PixelBuffer buf) {
// FIXME: clipping
char c = text.charAt(i);
Glyph g = Glyph.getGlyph(font, fontsize, c);
- buf.drawPicture(g.p,
- x + hpad,
- y + vpad + g.max_ascent - g.baseline,
- x + hpad + g.p.getWidth(),
- y + vpad + g.max_ascent - g.baseline + g.p.getHeight(),
- 0, 0,
- g.p.getWidth(), g.p.getHeight());
+ buf.drawPictureAlphaOnly(g.p,
+ x + hpad,
+ y + vpad + g.max_ascent - g.baseline,
+ x + hpad + g.p.getWidth(),
+ y + vpad + g.max_ascent - g.baseline + g.p.getHeight(),
+ 0, 0,
+ g.p.getWidth(), g.p.getHeight(),
+ textcolor);
x += g.advance;
}
}
return redirect.callMethod(method, args, checkOnly);
}
return new Integer(b.getIndexInParent());
-
- } else if ("apply".equals(method)) {
- if (checkOnly) return Boolean.TRUE;
- if (args.elementAt(0) instanceof Res) {
- Res res = (Res)args.elementAt(0);
- // res = res.addExtension(".xwt");
- Template t = Template.getTemplate(res);
- if (ThreadMessage.suspendThread()) try {
- JS.Callable callback = args.length() < 2 ? null : (Callable)args.elementAt(1);
-
- // FIXME!!! needs to be xwt.apply(template, box)
- t.apply(this, callback, 0, t.numUnits(), null);
- } finally {
- ThreadMessage.resumeThread();
- }
- } else if (args.elementAt(0) instanceof String) {
- String templatename = (String)args.elementAt(0);
- // FIXME
- Template t = Template.getTemplate(null);
- if (t == null) {
- if (Log.on) Log.logJS(this, "template " + templatename + " not found");
- } else {
- if (ThreadMessage.suspendThread()) try {
- JS.Callable callback = args.length() < 2 ? null : (Callable)args.elementAt(1);
- // FIXME!!! needs to be xwt.apply(template, box)
- t.apply(this, callback, 0, t.numUnits(), null);
- } finally {
- ThreadMessage.resumeThread();
- }
- }
- } else if (args.elementAt(0) instanceof JS && !(args.elementAt(0) instanceof Box)) {
- JS s = (JS)args.elementAt(0);
- Object[] keys = s.keys();
- for(int j=0; j<keys.length; j++) put(keys[j].toString(), s.get(keys[j]));
- }
- return this;
}
return null;
}
if (Log.on) Log.logJS(this, "attempt to set a numerical property on a box to anything other than a box");
} else if (redirect == null) {
if (Log.on) Log.logJS(this, "attempt to add/remove children to/from a node with a null redirect");
+ put("0", (Box)value);
} else if (redirect != this) {
Box b = value == null ? (Box)redirect.get(i) : (Box)value;
redirect.put(i, value);
void put(String name, Box b, Object value) { put(b, value); }
static {
- //#repeat fillcolor/strokecolor
- specialBoxProperties.put("fillcolor", new SpecialBoxProperty() {
- public Object get(Box b) {
- if ((b.fillcolor & 0xFF000000) == 0) return null;
- String red = Integer.toHexString((b.fillcolor & 0x00FF0000) >> 16);
- String green = Integer.toHexString((b.fillcolor & 0x0000FF00) >> 8);
- String blue = Integer.toHexString(b.fillcolor & 0x000000FF);
- if (red.length() < 2) red = "0" + red;
- if (blue.length() < 2) blue = "0" + blue;
- if (green.length() < 2) green = "0" + green;
- return "#" + red + green + blue;
- }
- public void put(Box b, Object value) {
- int newcolor = b.fillcolor;
- String s = value == null ? null : value.toString();
- if (value == null) newcolor = 0x00000000;
- else if (s.length() > 0 && s.charAt(0) == '#')
- try {
- newcolor = 0xFF000000 |
- (Integer.parseInt(s.substring(1, 3), 16) << 16) |
- (Integer.parseInt(s.substring(3, 5), 16) << 8) |
- Integer.parseInt(s.substring(5, 7), 16);
- } catch (NumberFormatException e) {
- Log.log(this, "invalid color " + s);
- return;
- }
- else if (org.xwt.translators.SVG.colors.get(s) != null)
- newcolor = 0xFF000000 | ((Integer)org.xwt.translators.SVG.colors.get(s)).intValue();
- if (newcolor == b.fillcolor) return;
- b.fillcolor = newcolor;
- b.dirty();
- }
+ specialBoxProperties.put("fill", new ColorBoxProperty() {
+ public int getColor(Box b) { return b.fillcolor; }
+ public void putColor(Box b, int argb) { b.fillcolor = argb; }
});
- //#end
-
- specialBoxProperties.put("color", new SpecialBoxProperty() {
- public Object get(Box b) { return b.get("fillcolor"); }
- public void put(Box b, Object value) { b.put("fillcolor", value); }
+ specialBoxProperties.put("textcolor", new ColorBoxProperty() {
+ public int getColor(Box b) { return b.textcolor; }
+ public void putColor(Box b, int argb) { b.textcolor = argb; }
});
-
- specialBoxProperties.put("textcolor", new SpecialBoxProperty() {
- public Object get(Box b) { return b.get("strokecolor"); }
- public void put(Box b, Object value) { b.put("strokecolor", value); }
+ specialBoxProperties.put("strokecolor", new ColorBoxProperty() {
+ public int getColor(Box b) { return b.strokecolor; }
+ public void putColor(Box b, int argb) { b.strokecolor = argb; }
});
specialBoxProperties.put("text", new SpecialBoxProperty() {
b.dirty();
} });
+ specialBoxProperties.put("path", new SpecialBoxProperty() {
+ public Object get(Box b) { throw new JS.Exn("cannot read from the path property"); }
+ public void put(Box b, Object value) {
+ String t = value == null ? "null" : value.toString();
+ b.path = value == null ? null : VectorGraphics.parseVectorPath(value.toString());
+ MARK_FOR_REFLOW_b;
+ b.dirty();
+ } });
+
+ specialBoxProperties.put("transform", new SpecialBoxProperty() {
+ public void put(Box b, Object value) {
+ String t = value.toString().trim();
+ b.transform = VectorGraphics.Affine.identity();
+ while (t.length() > 0) {
+ if (t.startsWith("skewX(")) {
+ // FIXME
+
+ } else if (t.startsWith("shear(")) {
+ // FIXME: nonstandard; remove this
+ b.transform.multiply(VectorGraphics.Affine.shear(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(')')))));
+
+ } else if (t.startsWith("skewY(")) {
+ // FIXME
+
+ } else if (t.startsWith("rotate(")) {
+ String sub = t.substring(t.indexOf('(') + 1, t.indexOf(')'));
+ if (sub.indexOf(',') != -1) {
+ float angle = Float.parseFloat(sub.substring(0, sub.indexOf(',')));
+ sub = sub.substring(sub.indexOf(',') + 1);
+ float cx = Float.parseFloat(sub.substring(0, sub.indexOf(',')));
+ sub = sub.substring(sub.indexOf(',') + 1);
+ float cy = Float.parseFloat(sub);
+ b.transform.multiply(VectorGraphics.Affine.translate(cx, cy));
+ b.transform.multiply(VectorGraphics.Affine.rotate(angle));
+ b.transform.multiply(VectorGraphics.Affine.translate(-1 * cx, -1 * cy));
+ } else {
+ b.transform.multiply(VectorGraphics.Affine.rotate(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(')')))));
+ }
+
+ } else if (t.startsWith("translate(")) {
+ String sub = t.substring(t.indexOf('(') + 1, t.indexOf(')'));
+ if (sub.indexOf(',') > -1) {
+ b.transform.multiply(VectorGraphics.Affine.translate(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(','))),
+ Float.parseFloat(t.substring(t.indexOf(',') + 1, t.indexOf(')')))));
+ } else {
+ b.transform.multiply(VectorGraphics.Affine.translate(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(','))), 0));
+ }
+
+ } else if (t.startsWith("flip(")) {
+ String which = t.substring(t.indexOf('(') + 1, t.indexOf(')'));
+ b.transform.multiply(VectorGraphics.Affine.flip(which.equals("horizontal"), which.equals("vertical")));
+
+ } else if (t.startsWith("scale(")) {
+ String sub = t.substring(t.indexOf('(') + 1, t.indexOf(')'));
+ if (sub.indexOf(',') > -1) {
+ b.transform.multiply(VectorGraphics.Affine.scale(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(','))),
+ Float.parseFloat(t.substring(t.indexOf(',') + 1, t.indexOf(')')))));
+ } else {
+ b.transform.multiply(VectorGraphics.Affine.scale(Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(','))),
+ Float.parseFloat(t.substring(t.indexOf('(') + 1, t.indexOf(',')))));
+ }
+
+ } else if (t.startsWith("matrix(")) {
+ // FIXME: is this mapped right?
+ float d[] = new float[6];
+ StringTokenizer st = new StringTokenizer(t, ",", false);
+ for(int i=0; i<6; i++)
+ d[i] = Float.parseFloat(st.nextToken());
+ b.transform.multiply(new VectorGraphics.Affine(d[0], d[1], d[2], d[3], d[4], d[5]));
+ }
+ t = t.substring(t.indexOf(')') + 1).trim();
+ }
+ b.dirty();
+ }
+ public Object get(Box b) { return b.transform.toString(); }
+ });
+
specialBoxProperties.put("font", new SpecialBoxProperty() {
public Object get(Box b) { return b.font; }
public void put(Box b, Object value) {
b.dirty();
} });
+ specialBoxProperties.put("strokewidth", new SpecialBoxProperty() {
+ public Object get(Box b) { return new Integer(b.strokewidth); }
+ public void put(Box b, Object value) {
+ if (b.strokewidth == stoi(value)) return;
+ b.strokewidth = stoi(value);
+ b.dirty();
+ } });
+
specialBoxProperties.put("thisbox", new SpecialBoxProperty() {
public Object get(Box b) { return b; }
public void put(Box b, Object value) {
MARK_FOR_REFLOW_b;
} });
- //FIXME
- specialBoxProperties.put("static", new SpecialBoxProperty() {
- });
-
specialBoxProperties.put("shrink", new SpecialBoxProperty() {
public Object get(Box b) { return (((b.flags & HSHRINK_FLAG) != 0) || ((b.flags & VSHRINK_FLAG) != 0)) ? Boolean.TRUE : Boolean.FALSE; }
public void put(Box b, Object value) { b.put("hshrink", value); b.put("vshrink", value); }
b.dirty();
} });
- specialBoxProperties.put("invisible", new SpecialBoxProperty() {
+ specialBoxProperties.put("noclip", new SpecialBoxProperty() {
+ public Object get(Box b) { return ((b.flags & NOCLIP_FLAG) != 0) ? Boolean.TRUE : Boolean.FALSE; }
+ public void put(Box b, Object value) {
+ if (((b.flags & NOCLIP_FLAG) != 0) == stob(value)) return;
+ if (stob(value)) b.flags |= NOCLIP_FLAG; else b.flags &= ~NOCLIP_FLAG;
+ MARK_FOR_REFLOW_b;
+ b.dirty();
+ } });
+
+ specialBoxProperties.put("visible", new SpecialBoxProperty() {
public Object get(Box b) {
for (Box cur = b; cur != null; cur = cur.parent) {
- if ((cur.flags & INVISIBLE_FLAG) != 0) return Boolean.TRUE; }
- return Boolean.FALSE;
+ if ((cur.flags & INVISIBLE_FLAG) != 0) return Boolean.FALSE; }
+ return Boolean.TRUE;
}
public void put(Box b, Object value) {
- if (stob(value) == ((b.flags & INVISIBLE_FLAG) != 0)) return;
- if (stob(value)) b.flags |= INVISIBLE_FLAG; else b.flags &= ~INVISIBLE_FLAG;
+ if (!stob(value) == ((b.flags & INVISIBLE_FLAG) != 0)) return;
+ if (!stob(value)) b.flags |= INVISIBLE_FLAG; else b.flags &= ~INVISIBLE_FLAG;
if (b.parent == null) {
if (b.surface != null) b.surface.setInvisible((b.flags & INVISIBLE_FLAG) != 0);
} else {
public Object get(Box b) { return b.image == null ? null : ImageDecoder.imageToNameMap.get(b.image); }
*/
public void put(Box b, Object value) {
+ //if (image != null) System.out.println("hit");
if (value == null) {
b.image = null;
} else if (value instanceof Res) {
} else {
// FIXME
}
- b.minwidth = b.image == null ? 0 : b.image.getWidth();
- b.minheight = b.image == null ? 0 : b.image.getHeight();
+ b.minwidth = min(b.maxwidth, max(b.minwidth, b.image == null ? 0 : b.image.getWidth()));
+ b.minheight = min(b.maxheight, max(b.minheight, b.image == null ? 0 : b.image.getHeight()));
MARK_FOR_REFLOW_b;
b.dirty();
}
});
//#end
- specialBoxProperties.put("xwt", new SpecialBoxProperty() {
- public Object get(Box b) { return XWT.singleton; }
- });
-
specialBoxProperties.put("mouseinside", new SpecialBoxProperty() {
public Object get(Box b) {
return ((b.flags & MOUSEINSIDE_FLAG) != 0) ? Boolean.TRUE : Boolean.FALSE; }
//#end
specialBoxProperties.put("redirect", new SpecialBoxProperty() {
- public void put(Box b, Object value) { }
+ public void put(Box b, Object value) {
+ if (b.redirect != b) Log.log(this, "cannot change the redirect of a box once it is set");
+ else if (value == null) b.redirect = null;
+ else {
+ Box b2 = (Box)value;
+ while(b2 != b && b2 != null) b2 = b2.parent;
+ if (b2 == null) Log.log(this, "a box's redirect must be one of its descendants");
+ b.redirect = (Box)value;
+ }
+ }
public Object get(Box b) {
if (b.redirect == null) return null;
if (b.redirect == b) return Boolean.TRUE;
*/
});
}
+
+ private static abstract class ColorBoxProperty extends SpecialBoxProperty {
+ public abstract int getColor(Box b);
+ public abstract void putColor(Box b, int argb);
+ public Object get(Box b) {
+ if ((getColor(b) & 0xFF000000) == 0) return null;
+ String red = Integer.toHexString((getColor(b) & 0x00FF0000) >> 16);
+ String green = Integer.toHexString((getColor(b) & 0x0000FF00) >> 8);
+ String blue = Integer.toHexString(getColor(b) & 0x000000FF);
+ if (red.length() < 2) red = "0" + red;
+ if (blue.length() < 2) blue = "0" + blue;
+ if (green.length() < 2) green = "0" + green;
+ return "#" + red + green + blue;
+ }
+ public void put(Box b, Object value) {
+ int newcolor = getColor(b);
+ String s = value == null ? null : value.toString();
+ if (value == null) newcolor = 0x00000000;
+ else if (s.length() > 0 && s.charAt(0) == '#')
+ try {
+ newcolor = 0xFF000000 |
+ (Integer.parseInt(s.substring(1, 3), 16) << 16) |
+ (Integer.parseInt(s.substring(3, 5), 16) << 8) |
+ Integer.parseInt(s.substring(5, 7), 16);
+ } catch (NumberFormatException e) {
+ Log.log(this, "invalid color " + s);
+ return;
+ }
+ else if (org.xwt.translators.SVG.colors.get(s) != null)
+ newcolor = 0xFF000000 | ((Integer)org.xwt.translators.SVG.colors.get(s)).intValue();
+ if (newcolor == getColor(b)) return;
+ putColor(b, newcolor);
+ b.dirty();
+ }
+ }
}
/** helper that converts a String to a boolean according to JavaScript coercion rules */