/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/* $Id: Trait.java 1790795 2017-04-10 10:03:35Z cbowditch $ */

package org.apache.fop.area;

import java.awt.Color;
import java.io.Serializable;

import org.apache.xmlgraphics.image.loader.ImageInfo;

import org.apache.fop.fonts.FontTriplet;
import org.apache.fop.traits.BorderProps;
import org.apache.fop.traits.Direction;
import org.apache.fop.traits.Visibility;
import org.apache.fop.traits.WritingMode;
import org.apache.fop.util.ColorUtil;

import static org.apache.fop.fo.Constants.EN_NOREPEAT;
import static org.apache.fop.fo.Constants.EN_REPEAT;
import static org.apache.fop.fo.Constants.EN_REPEATX;
import static org.apache.fop.fo.Constants.EN_REPEATY;

// properties should be serialized by the holder
Area traits used for rendering. This class represents an area trait that specifies a value for rendering.
/** * Area traits used for rendering. * This class represents an area trait that specifies a value for rendering. */
public final class Trait implements Serializable { private static final long serialVersionUID = 3234280285391611437L; private Trait() { } /** Id reference line, not resolved. (not sure if this is needed.) */ //public static final Integer ID_LINK = Integer.valueOf(0);
Internal link trait. Contains the PageViewport key and the PROD_ID of the target area
/** * Internal link trait. * Contains the PageViewport key and the PROD_ID of the target area */
public static final Integer INTERNAL_LINK = 1;
* External link. A URL link to an external resource.
/** * External link. A URL link to an external resource. */
public static final Integer EXTERNAL_LINK = 2;
The font triplet for the current font.
/** The font triplet for the current font. */
public static final Integer FONT = 3;
Font size for the current font.
/** Font size for the current font. */
public static final Integer FONT_SIZE = 4;
The current color.
/** The current color. */
public static final Integer COLOR = 7;
The ID of the FO that produced an area.
/** The ID of the FO that produced an area. */
public static final Integer PROD_ID = 8;
Background trait for an area.
/** Background trait for an area. */
public static final Integer BACKGROUND = 9;
Underline trait used when rendering inline parent.
/** Underline trait used when rendering inline parent. */
public static final Integer UNDERLINE = 10;
Overline trait used when rendering inline parent.
/** Overline trait used when rendering inline parent. */
public static final Integer OVERLINE = 11;
Linethrough trait used when rendering inline parent.
/** Linethrough trait used when rendering inline parent. */
public static final Integer LINETHROUGH = 12; /** Shadow offset. */ //public static final Integer OFFSET = Integer.valueOf(13); /** The shadow for text. */ //public static final Integer SHADOW = Integer.valueOf(14);
The border start.
/** The border start. */
public static final Integer BORDER_START = 15;
The border end.
/** The border end. */
public static final Integer BORDER_END = 16;
The border before.
/** The border before. */
public static final Integer BORDER_BEFORE = 17;
The border after.
/** The border after. */
public static final Integer BORDER_AFTER = 18;
The padding start.
/** The padding start. */
public static final Integer PADDING_START = 19;
The padding end.
/** The padding end. */
public static final Integer PADDING_END = 20;
The padding before.
/** The padding before. */
public static final Integer PADDING_BEFORE = 21;
The padding after.
/** The padding after. */
public static final Integer PADDING_AFTER = 22;
The space start.
/** The space start. */
public static final Integer SPACE_START = 23;
The space end.
/** The space end. */
public static final Integer SPACE_END = 24; /** break before */ //public static final Integer BREAK_BEFORE = Integer.valueOf(25); /** break after */ //public static final Integer BREAK_AFTER = Integer.valueOf(26);
The start-indent trait.
/** The start-indent trait. */
public static final Integer START_INDENT = 27;
The end-indent trait.
/** The end-indent trait. */
public static final Integer END_INDENT = 28;
The space-before trait.
/** The space-before trait. */
public static final Integer SPACE_BEFORE = 29;
The space-after trait.
/** The space-after trait. */
public static final Integer SPACE_AFTER = 30;
The is-reference-area trait.
/** The is-reference-area trait. */
public static final Integer IS_REFERENCE_AREA = 31;
The is-viewport-area trait.
/** The is-viewport-area trait. */
public static final Integer IS_VIEWPORT_AREA = 32;
Blinking trait used when rendering inline parent.
/** Blinking trait used when rendering inline parent. */
public static final Integer BLINK = 33;
Trait for color of underline decorations when rendering inline parent.
/** Trait for color of underline decorations when rendering inline parent. */
public static final Integer UNDERLINE_COLOR = 34;
Trait for color of overline decorations when rendering inline parent.
/** Trait for color of overline decorations when rendering inline parent. */
public static final Integer OVERLINE_COLOR = 35;
Trait for color of linethrough decorations when rendering inline parent.
/** Trait for color of linethrough decorations when rendering inline parent. */
public static final Integer LINETHROUGH_COLOR = 36;
For navigation in the document structure.
/** For navigation in the document structure. */
public static final Integer STRUCTURE_TREE_ELEMENT = 37;
writing mode trait
/** writing mode trait */
public static final Integer WRITING_MODE = 38;
inline progression direction trait
/** inline progression direction trait */
public static final Integer INLINE_PROGRESSION_DIRECTION = 39;
block progression direction trait
/** block progression direction trait */
public static final Integer BLOCK_PROGRESSION_DIRECTION = 40;
column progression direction trait
/** column progression direction trait */
public static final Integer COLUMN_PROGRESSION_DIRECTION = 41;
shift direction trait
/** shift direction trait */
public static final Integer SHIFT_DIRECTION = 42;
For optional content groups.
/** For optional content groups. */
public static final Integer LAYER = 43;
Used to disable the rendering of a Block http://www.w3.org/TR/xsl/#rend-vis
/** Used to disable the rendering of a Block http://www.w3.org/TR/xsl/#rend-vis */
public static final Integer VISIBILITY = 44;
Maximum value used by trait keys
/** Maximum value used by trait keys */
public static final int MAX_TRAIT_KEY = 44; private static final TraitInfo[] TRAIT_INFO = new TraitInfo[MAX_TRAIT_KEY + 1]; private static class TraitInfo { private String name; private Class clazz; // Class of trait data public TraitInfo(String name, Class clazz) { this.name = name; this.clazz = clazz; } public String getName() { return this.name; } public Class getClazz() { return this.clazz; } } private static void put(Integer key, TraitInfo info) { TRAIT_INFO[key] = info; } static { // Create a hashmap mapping trait code to name for external representation //put(ID_LINK, new TraitInfo("id-link", String.class)); put(STRUCTURE_TREE_ELEMENT, new TraitInfo("structure-tree-element", String.class)); put(INTERNAL_LINK, new TraitInfo("internal-link", InternalLink.class)); put(EXTERNAL_LINK, new TraitInfo("external-link", ExternalLink.class)); put(FONT, new TraitInfo("font", FontTriplet.class)); put(FONT_SIZE, new TraitInfo("font-size", Integer.class)); put(COLOR, new TraitInfo("color", Color.class)); put(PROD_ID, new TraitInfo("prod-id", String.class)); put(BACKGROUND, new TraitInfo("background", Background.class)); put(UNDERLINE, new TraitInfo("underline-score", Boolean.class)); put(UNDERLINE_COLOR, new TraitInfo("underline-score-color", Color.class)); put(OVERLINE, new TraitInfo("overline-score", Boolean.class)); put(OVERLINE_COLOR, new TraitInfo("overline-score-color", Color.class)); put(LINETHROUGH, new TraitInfo("through-score", Boolean.class)); put(LINETHROUGH_COLOR, new TraitInfo("through-score-color", Color.class)); put(BLINK, new TraitInfo("blink", Boolean.class)); //put(OFFSET, new TraitInfo("offset", Integer.class)); //put(SHADOW, new TraitInfo("shadow", Integer.class)); put(BORDER_START, new TraitInfo("border-start", BorderProps.class)); put(BORDER_END, new TraitInfo("border-end", BorderProps.class)); put(BORDER_BEFORE, new TraitInfo("border-before", BorderProps.class)); put(BORDER_AFTER, new TraitInfo("border-after", BorderProps.class)); put(PADDING_START, new TraitInfo("padding-start", Integer.class)); put(PADDING_END, new TraitInfo("padding-end", Integer.class)); put(PADDING_BEFORE, new TraitInfo("padding-before", Integer.class)); put(PADDING_AFTER, new TraitInfo("padding-after", Integer.class)); put(SPACE_START, new TraitInfo("space-start", Integer.class)); put(SPACE_END, new TraitInfo("space-end", Integer.class)); //put(BREAK_BEFORE, new TraitInfo("break-before", Integer.class)); //put(BREAK_AFTER, new TraitInfo("break-after", Integer.class)); put(START_INDENT, new TraitInfo("start-indent", Integer.class)); put(END_INDENT, new TraitInfo("end-indent", Integer.class)); put(SPACE_BEFORE, new TraitInfo("space-before", Integer.class)); put(SPACE_AFTER, new TraitInfo("space-after", Integer.class)); put(IS_REFERENCE_AREA, new TraitInfo("is-reference-area", Boolean.class)); put(IS_VIEWPORT_AREA, new TraitInfo("is-viewport-area", Boolean.class)); put(WRITING_MODE, new TraitInfo("writing-mode", WritingMode.class)); put(INLINE_PROGRESSION_DIRECTION, new TraitInfo("inline-progression-direction", Direction.class)); put(BLOCK_PROGRESSION_DIRECTION, new TraitInfo("block-progression-direction", Direction.class)); put(SHIFT_DIRECTION, new TraitInfo("shift-direction", Direction.class)); put(LAYER, new TraitInfo("layer", String.class)); put(VISIBILITY, new TraitInfo("visibility", Visibility.class)); }
Get the trait name for a trait code.
Params:
  • traitCode – the trait code to get the name for
Returns:the trait name
/** * Get the trait name for a trait code. * * @param traitCode the trait code to get the name for * @return the trait name */
public static String getTraitName(Object traitCode) { return TRAIT_INFO[(Integer)traitCode].getName(); }
Get the data storage class for the trait.
Params:
  • traitCode – the trait code to lookup
Returns:the class type for the trait
/** * Get the data storage class for the trait. * * @param traitCode the trait code to lookup * @return the class type for the trait */
public static Class getTraitClass(Object traitCode) { return TRAIT_INFO[(Integer)traitCode].getClazz(); }
Class for internal link traits. Stores PageViewport key and producer ID
/** * Class for internal link traits. * Stores PageViewport key and producer ID */
public static class InternalLink implements Serializable { private static final long serialVersionUID = -8993505060996723039L;
The unique key of the PageViewport.
/** The unique key of the PageViewport. */
private String pvKey;
The PROD_ID of the link target
/** The PROD_ID of the link target */
private String idRef;
Create an InternalLink to the given PageViewport and target ID
Params:
  • pvKey – the PageViewport key
  • idRef – the target ID
/** * Create an InternalLink to the given PageViewport and target ID * * @param pvKey the PageViewport key * @param idRef the target ID */
public InternalLink(String pvKey, String idRef) { setPVKey(pvKey); setIDRef(idRef); }
Create an InternalLink based on the given XML attribute value. This is typically called when data are read from an XML area tree.
Params:
  • attrValue – attribute value to be parsed by InternalLink.parseXMLAttribute
/** * Create an InternalLink based on the given XML attribute value. * This is typically called when data are read from an XML area tree. * * @param attrValue attribute value to be parsed by InternalLink.parseXMLAttribute */
public InternalLink(String attrValue) { String[] values = parseXMLAttribute(attrValue); setPVKey(values[0]); setIDRef(values[1]); }
Sets the key of the targeted PageViewport.
Params:
  • pvKey – the PageViewport key
/** * Sets the key of the targeted PageViewport. * * @param pvKey the PageViewport key */
public void setPVKey(String pvKey) { this.pvKey = pvKey; }
Returns the key of the targeted PageViewport.
Returns:the PageViewport key
/** * Returns the key of the targeted PageViewport. * * @return the PageViewport key */
public String getPVKey() { return pvKey; }
Sets the target ID.
Params:
  • idRef – the target ID
/** * Sets the target ID. * * @param idRef the target ID */
public void setIDRef(String idRef) { this.idRef = idRef; }
Returns the target ID.
Returns:the target ID
/** * Returns the target ID. * * @return the target ID */
public String getIDRef() { return idRef; }
Returns the attribute value for this object as used in the area tree XML.
Returns:a string of the type "(thisPVKey,thisIDRef)"
/** * Returns the attribute value for this object as * used in the area tree XML. * * @return a string of the type "(thisPVKey,thisIDRef)" */
public String xmlAttribute() { return makeXMLAttribute(pvKey, idRef); }
Returns the XML attribute value for the given PV key and ID ref. This value is used in the area tree XML.
Params:
  • pvKey – the PageViewport key of the link target
  • idRef – the ID of the link target
Returns:a string of the type "(thisPVKey,thisIDRef)"
/** * Returns the XML attribute value for the given PV key and ID ref. * This value is used in the area tree XML. * * @param pvKey the PageViewport key of the link target * @param idRef the ID of the link target * @return a string of the type "(thisPVKey,thisIDRef)" */
public static String makeXMLAttribute(String pvKey, String idRef) { return "(" + (pvKey == null ? "" : pvKey) + "," + (idRef == null ? "" : idRef) + ")"; }
Parses XML attribute value from the area tree into PageViewport key + IDRef strings. If the attribute value is formatted like "(s1,s2)", then s1 and s2 are considered to be the PV key and the IDRef, respectively. Otherwise, the entire string is the PV key and the IDRef is null.
Params:
  • attrValue – the atribute value (PV key and possibly IDRef)
Returns:a 2-String array containing the PV key and the IDRef. Both may be null.
/** * Parses XML attribute value from the area tree into * PageViewport key + IDRef strings. If the attribute value is * formatted like "(s1,s2)", then s1 and s2 are considered to be * the PV key and the IDRef, respectively. * Otherwise, the entire string is the PV key and the IDRef is null. * * @param attrValue the atribute value (PV key and possibly IDRef) * @return a 2-String array containing the PV key and the IDRef. * Both may be null. */
public static String[] parseXMLAttribute(String attrValue) { String[] result = {null, null}; if (attrValue != null) { int len = attrValue.length(); if (len >= 2 && attrValue.charAt(0) == '(' && attrValue.charAt(len - 1) == ')' && attrValue.indexOf(',') != -1) { String value = attrValue.substring(1, len - 1); // remove brackets int delimIndex = value.indexOf(','); result[0] = value.substring(0, delimIndex).trim(); // PV key result[1] = value.substring(delimIndex + 1, value.length()).trim(); // IDRef } else { // PV key only, e.g. from old area tree XML: result[0] = attrValue; } } return result; }
Return the human-friendly string for debugging. {@inheritDoc}
/** * Return the human-friendly string for debugging. * {@inheritDoc} */
@Override public String toString() { StringBuffer sb = new StringBuffer(); sb.append("pvKey=").append(pvKey); sb.append(",idRef=").append(idRef); return sb.toString(); } }
External Link trait structure
/** * External Link trait structure */
public static class ExternalLink implements Serializable { private static final long serialVersionUID = -3720707599232620946L; private String destination; private boolean newWindow;
Constructs an ExternalLink object with the given destination
Params:
  • destination – target of the link
  • newWindow – true if the target should be opened in a new window
/** * Constructs an ExternalLink object with the given destination * * @param destination target of the link * @param newWindow true if the target should be opened in a new window */
public ExternalLink(String destination, boolean newWindow) { this.destination = destination; this.newWindow = newWindow; }
Create an ExternalLink from a trait value/attribute value in the area tree
Params:
  • traitValue – the value to use (should match the result of toString()
Returns:an ExternalLink instance corresponding to the given value
/** * Create an <code>ExternalLink</code> from a trait value/attribute value in the * area tree * @param traitValue the value to use (should match the result of {@link #toString()} * @return an <code>ExternalLink</code> instance corresponding to the given value */
protected static ExternalLink makeFromTraitValue(String traitValue) { String dest = null; boolean newWindow = false; String[] values = traitValue.split(","); for (String v : values) { if (v.startsWith("dest=")) { dest = v.substring(5); } else if (v.startsWith("newWindow=")) { newWindow = Boolean.valueOf(v.substring(10)); } else { throw new IllegalArgumentException( "Malformed trait value for Trait.ExternalLink: " + traitValue); } } return new ExternalLink(dest, newWindow); }
Get the target/destination of the link
Returns: the destination of the link
/** * Get the target/destination of the link * @return the destination of the link */
public String getDestination() { return this.destination; }
Check if the target has to be displayed in a new window
Returns: true if the target has to be displayed in a new window
/** * Check if the target has to be displayed in a new window * @return <code>true</code> if the target has to be displayed in a new window */
public boolean newWindow() { return this.newWindow; }
Return a String representation of the object.
Returns: a String of the form "org.apache.fop.area.Trait.ExternalLink[dest=someURL,newWindow=false]"
/** * Return a String representation of the object. * @return a <code>String</code> of the form * "org.apache.fop.area.Trait.ExternalLink[dest=someURL,newWindow=false]" */
@Override public String toString() { StringBuffer sb = new StringBuffer(64); sb.append("newWindow=").append(newWindow); sb.append(",dest=").append(this.destination); return sb.toString(); } }
Background trait structure. Used for storing back trait information which are related.
/** * Background trait structure. * Used for storing back trait information which are related. */
public static class Background implements Serializable { private static final long serialVersionUID = 8452078676273242870L;
The background color if any.
/** The background color if any. */
private Color color;
The background image url if any.
/** The background image url if any. */
private String url;
The background image if any.
/** The background image if any. */
private ImageInfo imageInfo;
Background repeat enum for images.
/** Background repeat enum for images. */
private int repeat;
Background horizontal offset for images.
/** Background horizontal offset for images. */
private int horiz;
Background vertical offset for images.
/** Background vertical offset for images. */
private int vertical; private int imageTargetWidth; private int imageTargetHeight;
Returns the background color.
Returns:background color, null if n/a
/** * Returns the background color. * @return background color, null if n/a */
public Color getColor() { return color; }
Returns the horizontal offset for images.
Returns:the horizontal offset
/** * Returns the horizontal offset for images. * @return the horizontal offset */
public int getHoriz() { return horiz; }
Returns the image repetition behaviour for images.
Returns:the image repetition behaviour
/** * Returns the image repetition behaviour for images. * @return the image repetition behaviour */
public int getRepeat() { return repeat; }
Returns the URL to the background image
Returns:URL to the background image, null if n/a
/** * Returns the URL to the background image * @return URL to the background image, null if n/a */
public String getURL() { return url; }
Returns the ImageInfo object representing the background image
Returns:the background image, null if n/a
/** * Returns the ImageInfo object representing the background image * @return the background image, null if n/a */
public ImageInfo getImageInfo() { return imageInfo; }
Returns the vertical offset for images.
Returns:the vertical offset
/** * Returns the vertical offset for images. * @return the vertical offset */
public int getVertical() { return vertical; }
Sets the color.
Params:
  • color – The color to set
/** * Sets the color. * @param color The color to set */
public void setColor(Color color) { this.color = color; }
Sets the horizontal offset.
Params:
  • horiz – The horizontal offset to set
/** * Sets the horizontal offset. * @param horiz The horizontal offset to set */
public void setHoriz(int horiz) { this.horiz = horiz; }
Sets the image repetition behaviour for images.
Params:
  • repeat – The image repetition behaviour to set
/** * Sets the image repetition behaviour for images. * @param repeat The image repetition behaviour to set */
public void setRepeat(int repeat) { this.repeat = repeat; }
Sets the image repetition behaviour for images.
Params:
  • repeat – The image repetition behaviour to set
/** * Sets the image repetition behaviour for images. * @param repeat The image repetition behaviour to set */
public void setRepeat(String repeat) { setRepeat(getConstantForRepeat(repeat)); }
Sets the URL to the background image.
Params:
  • url – The URL to set
/** * Sets the URL to the background image. * @param url The URL to set */
public void setURL(String url) { this.url = url; }
Sets the ImageInfo of the image to use as the background image.
Params:
  • info – The background image's info object
/** * Sets the ImageInfo of the image to use as the background image. * @param info The background image's info object */
public void setImageInfo(ImageInfo info) { this.imageInfo = info; }
Sets the vertical offset for images.
Params:
  • vertical – The vertical offset to set
/** * Sets the vertical offset for images. * @param vertical The vertical offset to set */
public void setVertical(int vertical) { this.vertical = vertical; } private String getRepeatString() { switch (getRepeat()) { case EN_REPEAT: return "repeat"; case EN_REPEATX: return "repeat-x"; case EN_REPEATY: return "repeat-y"; case EN_NOREPEAT: return "no-repeat"; default: throw new IllegalStateException("Illegal repeat style: " + getRepeat()); } } private static int getConstantForRepeat(String repeat) { if ("repeat".equalsIgnoreCase(repeat)) { return EN_REPEAT; } else if ("repeat-x".equalsIgnoreCase(repeat)) { return EN_REPEATX; } else if ("repeat-y".equalsIgnoreCase(repeat)) { return EN_REPEATY; } else if ("no-repeat".equalsIgnoreCase(repeat)) { return EN_NOREPEAT; } else { throw new IllegalStateException("Illegal repeat style: " + repeat); } }
Return the string for debugging. {@inheritDoc}
/** * Return the string for debugging. * {@inheritDoc} */
@Override public String toString() { StringBuffer sb = new StringBuffer(); if (color != null) { sb.append("color=").append(ColorUtil.colorToString(color)); } if (url != null) { if (color != null) { sb.append(","); } sb.append("url=").append(url); sb.append(",repeat=").append(getRepeatString()); sb.append(",horiz=").append(horiz); sb.append(",vertical=").append(vertical); } if (imageTargetWidth != 0) { sb.append(",target-width=").append(Integer.toString(imageTargetWidth)); } if (imageTargetHeight != 0) { sb.append(",target-height=").append(Integer.toString(imageTargetHeight)); } return sb.toString(); } public void setImageTargetWidth(int value) { imageTargetWidth = value; } public int getImageTargetWidth() { return imageTargetWidth; } public void setImageTargetHeight(int value) { imageTargetHeight = value; } public int getImageTargetHeight() { return imageTargetHeight; } } }