| /* |
| * 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$ */ |
| |
| 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. |
| */ |
| 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 |
| */ |
| public static final Integer INTERNAL_LINK = 1; |
| |
| /** * External link. A URL link to an external resource. */ |
| public static final Integer EXTERNAL_LINK = 2; |
| |
| /** The font triplet for the current font. */ |
| public static final Integer FONT = 3; |
| |
| /** Font size for the current font. */ |
| public static final Integer FONT_SIZE = 4; |
| |
| /** The current color. */ |
| public static final Integer COLOR = 7; |
| |
| /** The ID of the FO that produced an area. */ |
| public static final Integer PROD_ID = 8; |
| |
| /** Background trait for an area. */ |
| public static final Integer BACKGROUND = 9; |
| |
| /** Underline trait used when rendering inline parent. */ |
| public static final Integer UNDERLINE = 10; |
| |
| /** Overline trait used when rendering inline parent. */ |
| public static final Integer OVERLINE = 11; |
| |
| /** 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. */ |
| public static final Integer BORDER_START = 15; |
| |
| /** The border end. */ |
| public static final Integer BORDER_END = 16; |
| |
| /** The border before. */ |
| public static final Integer BORDER_BEFORE = 17; |
| |
| /** The border after. */ |
| public static final Integer BORDER_AFTER = 18; |
| |
| /** The padding start. */ |
| public static final Integer PADDING_START = 19; |
| |
| /** The padding end. */ |
| public static final Integer PADDING_END = 20; |
| |
| /** The padding before. */ |
| public static final Integer PADDING_BEFORE = 21; |
| |
| /** The padding after. */ |
| public static final Integer PADDING_AFTER = 22; |
| |
| /** The space start. */ |
| public static final Integer SPACE_START = 23; |
| |
| /** 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. */ |
| public static final Integer START_INDENT = 27; |
| |
| /** The end-indent trait. */ |
| public static final Integer END_INDENT = 28; |
| |
| /** The space-before trait. */ |
| public static final Integer SPACE_BEFORE = 29; |
| |
| /** The space-after trait. */ |
| public static final Integer SPACE_AFTER = 30; |
| |
| /** The is-reference-area trait. */ |
| public static final Integer IS_REFERENCE_AREA = 31; |
| |
| /** The is-viewport-area trait. */ |
| public static final Integer IS_VIEWPORT_AREA = 32; |
| |
| /** Blinking trait used when rendering inline parent. */ |
| public static final Integer BLINK = 33; |
| |
| /** 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. */ |
| public static final Integer OVERLINE_COLOR = 35; |
| |
| /** Trait for color of linethrough decorations when rendering inline parent. */ |
| public static final Integer LINETHROUGH_COLOR = 36; |
| |
| /** For navigation in the document structure. */ |
| public static final Integer STRUCTURE_TREE_ELEMENT = 37; |
| |
| /** writing mode trait */ |
| public static final Integer WRITING_MODE = 38; |
| /** inline progression direction trait */ |
| public static final Integer INLINE_PROGRESSION_DIRECTION = 39; |
| /** block progression direction trait */ |
| public static final Integer BLOCK_PROGRESSION_DIRECTION = 40; |
| /** column progression direction trait */ |
| public static final Integer COLUMN_PROGRESSION_DIRECTION = 41; |
| /** shift direction trait */ |
| public static final Integer SHIFT_DIRECTION = 42; |
| |
| /** 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 */ |
| public static final Integer VISIBILITY = 44; |
| |
| /** 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. |
| * |
| * @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. |
| * |
| * @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 |
| */ |
| public static class InternalLink implements Serializable { |
| |
| private static final long serialVersionUID = -8993505060996723039L; |
| |
| /** The unique key of the PageViewport. */ |
| private String pvKey; |
| |
| /** The PROD_ID of the link target */ |
| private String idRef; |
| |
| /** |
| * 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. |
| * |
| * @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. |
| * |
| * @param pvKey the PageViewport key |
| */ |
| public void setPVKey(String pvKey) { |
| this.pvKey = pvKey; |
| } |
| |
| /** |
| * Returns the key of the targeted PageViewport. |
| * |
| * @return the PageViewport key |
| */ |
| public String getPVKey() { |
| return pvKey; |
| } |
| |
| /** |
| * Sets the target ID. |
| * |
| * @param idRef the target ID |
| */ |
| public void setIDRef(String idRef) { |
| this.idRef = idRef; |
| } |
| |
| /** |
| * 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. |
| * |
| * @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. |
| * |
| * @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. |
| * |
| * @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} |
| */ |
| @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 |
| */ |
| 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 |
| * |
| * @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 <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 |
| * @return the destination of the link |
| */ |
| public String getDestination() { |
| return this.destination; |
| } |
| |
| /** |
| * 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. |
| * @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. |
| */ |
| public static class Background implements Serializable { |
| |
| private static final long serialVersionUID = 8452078676273242870L; |
| |
| /** The background color if any. */ |
| private Color color; |
| |
| /** The background image url if any. */ |
| private String url; |
| |
| /** The background image if any. */ |
| private ImageInfo imageInfo; |
| |
| /** Background repeat enum for images. */ |
| private int repeat; |
| |
| /** Background horizontal offset for images. */ |
| private int horiz; |
| |
| /** Background vertical offset for images. */ |
| private int vertical; |
| |
| private int imageTargetWidth; |
| |
| private int imageTargetHeight; |
| |
| /** |
| * Returns the background color. |
| * @return background color, null if n/a |
| */ |
| public Color getColor() { |
| return color; |
| } |
| |
| /** |
| * Returns the horizontal offset for images. |
| * @return the horizontal offset |
| */ |
| public int getHoriz() { |
| return horiz; |
| } |
| |
| /** |
| * Returns the image repetition behaviour for images. |
| * @return the image repetition behaviour |
| */ |
| public int getRepeat() { |
| return repeat; |
| } |
| |
| /** |
| * 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 |
| * @return the background image, null if n/a |
| */ |
| public ImageInfo getImageInfo() { |
| return imageInfo; |
| } |
| |
| /** |
| * Returns the vertical offset for images. |
| * @return the vertical offset |
| */ |
| public int getVertical() { |
| return vertical; |
| } |
| |
| /** |
| * Sets the color. |
| * @param color The color to set |
| */ |
| public void setColor(Color color) { |
| this.color = color; |
| } |
| |
| /** |
| * 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. |
| * @param repeat The image repetition behaviour to set |
| */ |
| public void setRepeat(int repeat) { |
| this.repeat = repeat; |
| } |
| |
| /** |
| * 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. |
| * @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. |
| * @param info The background image's info object |
| */ |
| public void setImageInfo(ImageInfo info) { |
| this.imageInfo = info; |
| } |
| |
| /** |
| * 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} |
| */ |
| @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; |
| } |
| |
| } |
| } |
| |