001: /*
002: * Copyright (c) 2007, intarsys consulting GmbH
003: *
004: * Redistribution and use in source and binary forms, with or without
005: * modification, are permitted provided that the following conditions are met:
006: *
007: * - Redistributions of source code must retain the above copyright notice,
008: * this list of conditions and the following disclaimer.
009: *
010: * - Redistributions in binary form must reproduce the above copyright notice,
011: * this list of conditions and the following disclaimer in the documentation
012: * and/or other materials provided with the distribution.
013: *
014: * - Neither the name of intarsys nor the names of its contributors may be used
015: * to endorse or promote products derived from this software without specific
016: * prior written permission.
017: *
018: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
019: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
020: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
021: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
022: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
023: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
024: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
025: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
026: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
027: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
028: * POSSIBILITY OF SUCH DAMAGE.
029: */
030: package de.intarsys.pdf.font.outlet;
031:
032: import de.intarsys.pdf.font.PDFont;
033: import de.intarsys.pdf.pd.PDDocument;
034:
035: /**
036: * A factory for {@link PDFont} instances.
037: * <p>
038: * The factory can create "relative" requests ("getXYZFlavor) as well as
039: * "absolute" request defining the complete font attributes.
040: */
041: public interface IFontFactory {
042: /**
043: * A font based on <code>font</code>, but with "italic" style.
044: * <p>
045: * The font returned may be either a new one or a font already in use in a
046: * {@link PDDocument}. Thois decision is up to the factory.Be careful when
047: * changing the font returned!
048: * </p>
049: *
050: * @param font
051: * The base font to be "italicized".
052: *
053: * @return A font based on <code>font</code>, but with "italic" style.
054: */
055: public PDFont getItalicFlavor(PDFont font);
056:
057: /**
058: * A font based on <code>font</code>, but with "regular" style.
059: * <p>
060: * The font returned may be either a new one or a font already in use in a
061: * {@link PDDocument}. Thois decision is up to the factory.Be careful when
062: * changing the font returned!
063: * </p>
064: *
065: * @param font
066: * The base font to be "regularized".
067: *
068: * @return A font based on <code>font</code>, but with "regular" style.
069: */
070: public PDFont getRegularFlavor(PDFont font);
071:
072: /**
073: * A font based on <code>font</code>, but with "bold" style.
074: * <p>
075: * The font returned may be either a new one or a font already in use in a
076: * {@link PDDocument}. Thois decision is up to the factory.Be careful when
077: * changing the font returned!
078: * </p>
079: *
080: * @param font
081: * The base font to be "bolded".
082: *
083: * @return A font based on <code>font</code>, but with "bold" style.
084: */
085: public PDFont getBoldFlavor(PDFont font);
086:
087: /**
088: * A font satisfying the conditions defined in <code>query</code>.
089: * <p>
090: * The font returned may be either a new one or a font already in use in a
091: * {@link PDDocument}. Thois decision is up to the factory.Be careful when
092: * changing the font returned!
093: * </p>
094: *
095: * @param query
096: * A query defining the {@link PDFont} to be looked up.
097: * @return A font satisfying the conditions defined in <code>query</code>.
098: */
099: public PDFont getFont(IFontQuery query);
100:
101: /**
102: * Flag if the factory should create fonts that are embedded in the
103: * document.
104: *
105: * @param embedNew
106: * <code>true</code> if new fonts should be embedded.
107: */
108: public void setEmbedNew(boolean embedNew);
109: }
|