/*
 * 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: PDFGState.java 1758773 2016-09-01 13:02:29Z ssteiner $ */

package org.apache.fop.pdf;

import java.util.Map;
import java.util.Set;

Class representing a /ExtGState object.
/** * Class representing a /ExtGState object. */
public class PDFGState extends PDFObject {
Line width (LW)
/** Line width (LW) */
public static final String GSTATE_LINE_WIDTH = "LW";
Line cap (LC)
/** Line cap (LC) */
public static final String GSTATE_LINE_CAP = "LC";
Line join (LJ)
/** Line join (LJ) */
public static final String GSTATE_LINE_JOIN = "LJ";
Miter limit (ML)
/** Miter limit (ML) */
public static final String GSTATE_MITER_LIMIT = "ML";
Dash pattern (D)
/** Dash pattern (D) */
public static final String GSTATE_DASH_PATTERN = "D";
Rendering intent (RI)
/** Rendering intent (RI) */
public static final String GSTATE_RENDERING_INTENT = "RI";
Overprint for stroke (OP)
/** Overprint for stroke (OP) */
public static final String GSTATE_OVERPRINT_STROKE = "OP";
Overprint for fill (op)
/** Overprint for fill (op) */
public static final String GSTATE_OVERPRINT_FILL = "op";
Overprint mode (OPM)
/** Overprint mode (OPM) */
public static final String GSTATE_OVERPRINT_MODE = "OPM";
Font (Font)
/** Font (Font) */
public static final String GSTATE_FONT = "Font";
Black generation (BG)
/** Black generation (BG) */
public static final String GSTATE_BLACK_GENERATION = "BG";
Black generation with default (BG2)
/** Black generation with default (BG2) */
public static final String GSTATE_BLACK_GENERATION2 = "BG2";
Undercolor removal function (UCR)
/** Undercolor removal function (UCR) */
public static final String GSTATE_UNDERCOLOR_REMOVAL = "UCR";
Undercolor removal function with default (UCR2)
/** Undercolor removal function with default (UCR2) */
public static final String GSTATE_UNDERCOLOR_REMOVAL2 = "UCR2";
Transfer function (TR)
/** Transfer function (TR) */
public static final String GSTATE_TRANSFER_FUNCTION = "TR";
Transfer function with default (TR2)
/** Transfer function with default (TR2) */
public static final String GSTATE_TRANSFER_FUNCTION2 = "TR2";
Halftone dictionary or stream (HT)
/** Halftone dictionary or stream (HT) */
public static final String GSTATE_HALFTONE_DICT = "HT";
Halftone phase (HTP, does not show up anymore in PDF 1.4)
/** Halftone phase (HTP, does not show up anymore in PDF 1.4)*/
public static final String GSTATE_HALFTONE_PHASE = "HTP";
Flatness (FL)
/** Flatness (FL) */
public static final String GSTATE_FLATNESS = "FL";
Smoothness (SM)
/** Smoothness (SM) */
public static final String GSTATE_SMOOTHNESS = "SM";
Strike adjustment (SA)
/** Strike adjustment (SA) */
public static final String GSTATE_STRIKE_ADJ = "SA";
Blend mode (BM, PDF 1.4)
/** Blend mode (BM, PDF 1.4) */
public static final String GSTATE_BLEND_MODE = "BM";
Soft mask (SMask, PDF 1.4)
/** Soft mask (SMask, PDF 1.4) */
public static final String GSTATE_SOFT_MASK = "SMask";
Stroking Alpha (CA, PDF 1.4)
/** Stroking Alpha (CA, PDF 1.4) */
public static final String GSTATE_ALPHA_STROKE = "CA";
Nonstroking Alpha (ca, PDF 1.4)
/** Nonstroking Alpha (ca, PDF 1.4) */
public static final String GSTATE_ALPHA_NONSTROKE = "ca";
Alpha Source Flag (AIS, PDF 1.4)
/** Alpha Source Flag (AIS, PDF 1.4) */
public static final String GSTATE_ALPHA_SOURCE_FLAG = "AIS";
Text Knockout Flag (TK, PDF 1.4)
/** Text Knockout Flag (TK, PDF 1.4) */
public static final String GSTATE_TEXT_KNOCKOUT = "TK";
Default GState object
/** Default GState object */
public static final PDFGState DEFAULT; static { DEFAULT = new PDFGState(); Map vals = DEFAULT.values; /*vals.put(LW, new Float(1.0)); vals.put(LC, Integer.valueOf(0)); vals.put(LJ, Integer.valueOf(0)); vals.put(ML, new Float(10.0)); vals.put(D, "0 []"); vals.put(RI, "RelativeColorimetric"); vals.put(OP, Boolean.FALSE); vals.put(op, Boolean.FALSE); vals.put(OPM, Integer.valueOf(1)); vals.put(Font, "");*/ vals.put(GSTATE_ALPHA_STROKE, 1.0f); vals.put(GSTATE_ALPHA_NONSTROKE, 1.0f); } private Map values = new java.util.HashMap(); private int objNum;
Returns the name of this object
Returns:the name
/** * Returns the name of this object * @return the name */
public String getName() { if (objNum == 0) { objNum = ++getDocument().gStateObjectCount; } return "GS" + objNum; }
Sets the alpha value.
Params:
  • val – alpha value (0.0 - 1.0)
  • fill – True if alpha should be set for non-stroking operations, False if for stroking operations
/** * Sets the alpha value. * @param val alpha value (0.0 - 1.0) * @param fill True if alpha should be set for non-stroking operations, * False if for stroking operations */
public void setAlpha(float val, boolean fill) { if (fill) { values.put(GSTATE_ALPHA_NONSTROKE, val); } else { values.put(GSTATE_ALPHA_STROKE, val); } }
Adds all values from another GState object to this one.
Params:
  • state – source object to copy from
/** * Adds all values from another GState object to this one. * @param state source object to copy from */
public void addValues(PDFGState state) { values.putAll(state.values); }
Adds all values from a Map to this object.
Params:
  • vals – source object to copy from
/** * Adds all values from a Map to this object. * @param vals source object to copy from */
public void addValues(Map vals) { values.putAll(vals); }
{@inheritDoc}
/** * {@inheritDoc} */
public String toPDFString() { StringBuffer sb = new StringBuffer(64); sb.append("<<\n/Type /ExtGState\n"); appendVal(sb, GSTATE_ALPHA_NONSTROKE); appendVal(sb, GSTATE_ALPHA_STROKE); sb.append(">>"); return sb.toString(); } private void appendVal(StringBuffer sb, String name) { Object val = values.get(name); if (val != null) { sb.append("/" + name + " " + val + "\n"); } } /* * example * 29 0 obj * << * /Type /ExtGState * /ca 0.5 * >> * endobj */
{@inheritDoc}
/** {@inheritDoc} */
protected boolean contentEquals(PDFObject obj) { if (obj == this) { return true; } if (!(obj instanceof PDFGState)) { return false; } Map vals1 = values; Map vals2 = ((PDFGState)obj).values; if (vals1.size() != vals2.size()) { return false; } for (Map.Entry<Object, Object> e : (Set<Map.Entry<Object, Object>>) vals2.entrySet()) { Object str = e.getKey(); Object obj1 = vals1.get(str); if (!obj1.equals(e.getValue())) { return false; } } return true; } }