Java tutorial
/* Part of the Processing project - http://processing.org Copyright (c) 2005-11 Ben Fry and Casey Reas This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License version 2.1 as published by the Free Software Foundation. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ package processing.pdf; import java.awt.Font; import java.awt.Graphics2D; import java.awt.Image; import java.io.*; import java.util.*; import com.lowagie.text.*; import com.lowagie.text.pdf.*; import processing.awt.PGraphicsJava2D; import processing.core.*; /** * Thin wrapper for the iText PDF library that handles writing PDF files. * The majority of the work in this library is done by * <a href="http://www.lowagie.com/iText/">iText</a>. * <br /> <br /> * This is currently using iText 2.1.7. * <br /> <br /> * The issue is that versions from the 5.x series were slow to handle lots of * fonts with the DefaultFontMapper. 2.x seemed a little slower than 1.x, * but 5.x took up to 10 times the time to load, meaning a lag of several * seconds when starting sketches on a machine that had a good handful of * fonts installed. (Like, say, anyone in our target audience. Or me.) */ public class PGraphicsPDF extends PGraphicsJava2D { /** File being written, if it's a file. */ protected File file; /** OutputStream being written to, if using an OutputStream. */ protected OutputStream output; protected Document document; protected PdfWriter writer; protected PdfContentByte content; /** Shared across instances because it's incredibly time-consuming to create. */ static protected DefaultFontMapper mapper; static protected String[] fontList; /* public PGraphicsPDF() { // PDF always likes native fonts. Always. hint(ENABLE_NATIVE_FONTS); } */ public void setPath(String path) { this.path = path; if (path != null) { file = new File(path); if (!file.isAbsolute()) { file = null; } } if (file == null) { throw new RuntimeException( "PGraphicsPDF requires an absolute path " + "for the location of the output file."); } } /** * Set the library to write to an output stream instead of a file. */ public void setOutput(OutputStream output) { this.output = output; } // /** // * all the init stuff happens in here, in case someone calls size() // * along the way and wants to hork things up. // */ // protected void allocate() { // // can't do anything here, because this will be called by the // // superclass PGraphics, and the file/path object won't be set yet // // (since super() called right at the beginning of the constructor) // } @Override public PSurface createSurface() { return surface = new PSurfaceNone(this); } @Override protected void defaultSettings() { // ignore super.defaultSettings(); textMode = SHAPE; } public void beginDraw() { // long t0 = System.currentTimeMillis(); if (document == null) { document = new Document(new Rectangle(width, height)); boolean missingPath = false; try { if (file != null) { //BufferedOutputStream output = new BufferedOutputStream(stream, 16384); output = new BufferedOutputStream(new FileOutputStream(file), 16384); } else if (output == null) { missingPath = true; throw new RuntimeException( "PGraphicsPDF requires a path " + "for the location of the output file."); } writer = PdfWriter.getInstance(document, output); document.open(); content = writer.getDirectContent(); // template = content.createTemplate(width, height); } catch (RuntimeException re) { if (missingPath) { throw re; // don't re-package our own error } else { throw new RuntimeException("Problem saving the PDF file.", re); } } catch (FileNotFoundException fnfe) { throw new RuntimeException("Can't save the PDF file to " + path, fnfe); } catch (DocumentException de) { throw new RuntimeException("Error inside the PDF library.", de); } g2 = content.createGraphicsShapes(width, height); } // super in Java2D now creates an image buffer, don't do that //super.beginDraw(); checkSettings(); resetMatrix(); // reset model matrix vertexCount = 0; // Also need to push the matrix since the matrix doesn't reset on each run // http://dev.processing.org/bugs/show_bug.cgi?id=1227 pushMatrix(); } static protected DefaultFontMapper getMapper() { if (mapper == null) { // long t = System.currentTimeMillis(); mapper = new DefaultFontMapper(); if (PApplet.platform == PConstants.MACOSX) { try { String homeLibraryFonts = System.getProperty("user.home") + "/Library/Fonts"; mapper.insertDirectory(homeLibraryFonts); } catch (Exception e) { // might be a security issue with getProperty() and user.home // if this sketch is running from the web } // add the system font paths mapper.insertDirectory("/System/Library/Fonts"); mapper.insertDirectory("/Library/Fonts"); } else if (PApplet.platform == PConstants.WINDOWS) { // how to get the windows fonts directory? // could be c:\winnt\fonts or c:\windows\fonts or not even c: // maybe do a Runtime.exec() on echo %WINDIR% ? // Runtime.exec solution might be a mess on systems where the // the backslash/colon characters not really used (i.e. JP) // find the windows fonts folder File roots[] = File.listRoots(); for (int i = 0; i < roots.length; i++) { if (roots[i].toString().startsWith("A:")) { // Seems to be a problem with some machines that the A: // drive is returned as an actual root, even if not available. // This won't fix the issue if the same thing happens with // other removable drive devices, but should fix the // initial/problem as cited by the bug report: // http://dev.processing.org/bugs/show_bug.cgi?id=478 // If not, will need to use the other fileExists() code below. continue; } File folder = new File(roots[i], "WINDOWS/Fonts"); if (folder.exists()) { mapper.insertDirectory(folder.getAbsolutePath()); break; } folder = new File(roots[i], "WINNT/Fonts"); if (folder.exists()) { mapper.insertDirectory(folder.getAbsolutePath()); break; } } } else if (PApplet.platform == PConstants.LINUX) { checkDir("/usr/share/fonts/", mapper); checkDir("/usr/local/share/fonts/", mapper); checkDir(System.getProperty("user.home") + "/.fonts", mapper); } // System.out.println("mapping " + (System.currentTimeMillis() - t)); } return mapper; } static protected void checkDir(String path, DefaultFontMapper mapper) { File folder = new File(path); if (folder.exists()) { mapper.insertDirectory(path); traverseDir(folder, mapper); } } /** * Recursive walk to get all subdirectories for font fun. * Patch submitted by Matthias Breuer. * (<a href="http://dev.processing.org/bugs/show_bug.cgi?id=1566">Bug 1566</a>) */ static protected void traverseDir(File folder, DefaultFontMapper mapper) { File[] files = folder.listFiles(); for (int i = 0; i < files.length; i++) { if (files[i].isDirectory()) { mapper.insertDirectory(files[i].getPath()); traverseDir(new File(files[i].getPath()), mapper); } } } // endDraw() needs to be overridden so that the endDraw() from // PGraphicsJava2D is not inherited (it calls loadPixels). // http://dev.processing.org/bugs/show_bug.cgi?id=1169 public void endDraw() { // Also need to pop the matrix since the matrix doesn't reset on each run // http://dev.processing.org/bugs/show_bug.cgi?id=1227 popMatrix(); } /** * Gives the same basic functionality of File.exists but can be * used to look for removable media without showing a system * dialog if the media is not present. Workaround pulled from the * <A HREF="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4089199"> * bug report</A> on bugs.sun.com. This bug was fixed in Java 6, and we * can remove the workaround when we start requiring Java 6. */ protected static boolean fileExists(File file) { try { Process process = Runtime.getRuntime() .exec(new String[] { "cmd.exe", "/c", "dir", file.getAbsolutePath() }); // We need to consume all available output or the process will block. boolean haveExitCode = false; int exitCode = -1; InputStream out = process.getInputStream(); InputStream err = process.getErrorStream(); while (!haveExitCode) { while (out.read() >= 0) { } while (err.read() >= 0) { } try { exitCode = process.exitValue(); haveExitCode = true; } catch (IllegalThreadStateException e) { // Not yet complete. Thread.sleep(100); } } //int exitCode = process.waitFor(); return exitCode == 0; } catch (IOException e) { System.out.println("Unable to check for file: " + file + " : " + e); return false; } catch (InterruptedException e) { System.out.println("Unable to check for file. Interrupted: " + file + " : " + e); return false; } } /** * Call to explicitly go to the next page from within a single draw(). */ public void nextPage() { PStyle savedStyle = getStyle(); endDraw(); g2.dispose(); try { // writer.setPageEmpty(false); // maybe useful later document.newPage(); // is this bad if no addl pages are made? } catch (Exception e) { e.printStackTrace(); } g2 = createGraphics(); beginDraw(); style(savedStyle); } protected Graphics2D createGraphics() { if (textMode == SHAPE) { return content.createGraphicsShapes(width, height); } else if (textMode == MODEL) { return content.createGraphics(width, height, getMapper()); } // Should not be reachable... throw new RuntimeException("Invalid textMode() selected for PDF."); } public void dispose() { if (document != null) { g2.dispose(); document.close(); // can't be done in finalize, not always called document = null; } //new Exception().printStackTrace(System.out); } /** * Don't open a window for this renderer, it won't be used. */ public boolean displayable() { return false; } /* protected void finalize() throws Throwable { System.out.println("calling finalize"); //document.close(); // do this in dispose instead? } */ ////////////////////////////////////////////////////////////// /* public void endRecord() { super.endRecord(); dispose(); } public void endRaw() { System.out.println("ending raw"); super.endRaw(); System.out.println("disposing"); dispose(); System.out.println("done"); } */ ////////////////////////////////////////////////////////////// /* protected void rectImpl(float x1, float y1, float x2, float y2) { //rect.setFrame(x1, y1, x2-x1, y2-y1); //draw_shape(rect); System.out.println("rect implements"); g2.fillRect((int)x1, (int)y1, (int) (x2-x1), (int) (y2-y1)); } * /* public void clear() { g2.setColor(Color.red); g2.fillRect(0, 0, width, height); } */ ////////////////////////////////////////////////////////////// protected void imageImpl(PImage image, float x1, float y1, float x2, float y2, int u1, int v1, int u2, int v2) { pushMatrix(); translate(x1, y1); int imageWidth = image.width; int imageHeight = image.height; scale((x2 - x1) / imageWidth, (y2 - y1) / imageHeight); if (u2 - u1 == imageWidth && v2 - v1 == imageHeight) { g2.drawImage(image.getImage(), 0, 0, null); } else { PImage tmp = image.get(u1, v1, u2 - u1, v2 - v1); g2.drawImage((Image) tmp.getNative(), 0, 0, null); } popMatrix(); } ////////////////////////////////////////////////////////////// public void textFont(PFont which) { super.textFont(which); checkFont(); // Make sure a native version of the font is available. // if (textFont.getFont() == null) { // throw new RuntimeException("Use createFont() instead of loadFont() " + // "when drawing text using the PDF library."); // } // Make sure that this is a font that the PDF library can deal with. // if ((textMode != SHAPE) && !checkFont(which.getName())) { // System.err.println("Use PGraphicsPDF.listFonts() to get a list of available fonts."); // throw new RuntimeException("The font " + which.getName() + "? cannot be used with PDF Export."); // } } /** * Change the textMode() to either SHAPE or MODEL. * <br/> * This resets all renderer settings, and therefore must * be called <EM>before</EM> any other commands that set the fill() * or the textFont() or anything. Unlike other renderers, * use textMode() directly after the size() command. */ public void textMode(int mode) { if (textMode != mode) { if (mode == SHAPE) { textMode = SHAPE; g2.dispose(); // g2 = content.createGraphicsShapes(width, height); g2 = createGraphics(); } else if (mode == MODEL) { textMode = MODEL; g2.dispose(); // g2 = content.createGraphics(width, height, mapper); g2 = createGraphics(); // g2 = template.createGraphics(width, height, mapper); } else if (mode == SCREEN) { throw new RuntimeException("textMode(SCREEN) not supported with PDF"); } else { throw new RuntimeException("That textMode() does not exist"); } } } protected void textLineImpl(char buffer[], int start, int stop, float x, float y) { checkFont(); super.textLineImpl(buffer, start, stop, x, y); } ////////////////////////////////////////////////////////////// public void loadPixels() { nope("loadPixels"); } public void updatePixels() { nope("updatePixels"); } public void updatePixels(int x, int y, int c, int d) { nope("updatePixels"); } // public int get(int x, int y) { nope("get"); return 0; // not reached } public PImage get(int x, int y, int c, int d) { nope("get"); return null; // not reached } public PImage get() { nope("get"); return null; // not reached } public void set(int x, int y, int argb) { nope("set"); } public void set(int x, int y, PImage image) { nope("set"); } // public void mask(int alpha[]) { nope("mask"); } public void mask(PImage alpha) { nope("mask"); } // public void filter(int kind) { nope("filter"); } public void filter(int kind, float param) { nope("filter"); } // public void copy(int sx1, int sy1, int sx2, int sy2, int dx1, int dy1, int dx2, int dy2) { nope("copy"); } public void copy(PImage src, int sx1, int sy1, int sx2, int sy2, int dx1, int dy1, int dx2, int dy2) { nope("copy"); } // public void blend(int sx, int sy, int dx, int dy, int mode) { nope("blend"); } public void blend(PImage src, int sx, int sy, int dx, int dy, int mode) { nope("blend"); } public void blend(int sx1, int sy1, int sx2, int sy2, int dx1, int dy1, int dx2, int dy2, int mode) { nope("blend"); } public void blend(PImage src, int sx1, int sy1, int sx2, int sy2, int dx1, int dy1, int dx2, int dy2, int mode) { nope("blend"); } // public boolean save(String filename) { nope("save"); return false; } ////////////////////////////////////////////////////////////// /** * Add a directory that should be searched for font data. * <br/> * On Mac OS X, the following directories are added by default: * <UL> * <LI>/System/Library/Fonts * <LI>/Library/Fonts * <LI>~/Library/Fonts * </UL> * On Windows, all drive letters are searched for WINDOWS\Fonts * or WINNT\Fonts, any that exists is added. * <br/><br/> * On Linux or any other platform, you'll need to add the * directories by hand. (If there are actual standards here that we * can use as a starting point, please file a bug to make a note of it) */ public void addFonts(String directory) { mapper.insertDirectory(directory); } /** * Check whether the specified font can be used with the PDF library. * @param name name of the font * @return true if it's ok */ protected void checkFont() { Font awtFont = (Font) textFont.getNative(); if (awtFont == null) { // always need a native font or reference to it throw new RuntimeException( "Use createFont() instead of loadFont() " + "when drawing text using the PDF library."); } else if (textMode != SHAPE) { if (textFont.isStream()) { throw new RuntimeException( "Use textMode(SHAPE) with PDF when loading " + ".ttf and .otf files with createFont()."); } else if (mapper.getAliases().get(textFont.getName()) == null) { //System.out.println("alias for " + name + " = " + mapper.getAliases().get(name)); // System.err.println("Use PGraphicsPDF.listFonts() to get a list of " + // "fonts that can be used with PDF."); // throw new RuntimeException("The font " + textFont.getName() + "? " + // "cannot be used with PDF Export."); if (textFont.getName().equals("Lucida Sans")) { throw new RuntimeException( "Use textMode(SHAPE) with the default " + "font when exporting to PDF."); } else { throw new RuntimeException("Use textMode(SHAPE) with " + "" + textFont.getName() + "? " + "when exporting to PDF."); } } } } /** * List the fonts known to the PDF renderer. This is like PFont.list(), * however not all those fonts are available by default. */ static public String[] listFonts() { if (fontList == null) { HashMap<?, ?> map = getMapper().getAliases(); // Set entries = map.entrySet(); // fontList = new String[entries.size()]; fontList = new String[map.size()]; int count = 0; for (Object key : map.keySet()) { // for (Object entry : map.entrySet()) { // fontList[count++] = (String) ((Map.Entry) entry).getKey(); fontList[count++] = (String) key; } // Iterator it = entries.iterator(); // int count = 0; // while (it.hasNext()) { // Map.Entry entry = (Map.Entry) it.next(); // //System.out.println(entry.getKey() + "-->" + entry.getValue()); // fontList[count++] = (String) entry.getKey(); // } fontList = PApplet.sort(fontList); } return fontList; } ////////////////////////////////////////////////////////////// protected void nope(String function) { throw new RuntimeException("No " + function + "() for " + getClass().getSimpleName()); } }