propane 3.5.0-java → 3.9.0-java

data/src/main/java/processing/opengl/Texture.java

@@ -143,8 +143,9 @@ public class Texture implements PConstants {
 
 
   /**
-   * Creates an instance of PTexture with size width x height. The texture is
-   * initialized (empty) to that size.
+   * Creates an instance of PTexture with size width x height.The texture is
+ initialized (empty) to that size.
+   * @param pg
    * @param width  int
    * @param height  int
    */
@@ -155,7 +156,8 @@ public class Texture implements PConstants {
 
   /**
    * Creates an instance of PTexture with size width x height and with the
-   * specified parameters. The texture is initialized (empty) to that size.
+   * specified parameters.The texture is initialized (empty) to that size.
+   * @param pg
    * @param width int
    * @param height int
    * @param params Parameters
@@ -436,7 +438,8 @@ public class Texture implements PConstants {
 
 
   /**
-   * Copy texture to pixels. Involves video memory to main memory transfer (slow).
+   * Copy texture to pixels.Involves video memory to main memory transfer (slow).
+   * @param pixels
    */
   public void get(int[] pixels) {
     if (pixels == null) {

data/src/main/java/processing/opengl/VertexBuffer.java

@@ -57,12 +57,12 @@ public class VertexBuffer {
     init();
   }
 
-  protected void create() {
+  protected final void create() {
     context = pgl.getCurrentContext();
     glres = new GLResourceVertexBuffer(this);
   }
 
-  protected void init() {
+  protected final void init() {
     int size = index ? ncoords * INIT_INDEX_BUFFER_SIZE * elementSize :
                        ncoords * INIT_VERTEX_BUFFER_SIZE * elementSize;
     pgl.bindBuffer(target, glId);

data/src/main/java/processing/pdf/PGraphicsPDF.java

@@ -0,0 +1,581 @@
+/*
+  Part of the Processing project - http://processing.org
+
+  Copyright (c) 2005-12 Ben Fry and Casey Reas
+  Copyright (c) 2012-18 The Processing Foundation
+
+  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 com.itextpdf.awt.DefaultFontMapper;
+import com.itextpdf.awt.PdfGraphics2D;
+import com.itextpdf.text.Document;
+import com.itextpdf.text.DocumentException;
+import com.itextpdf.text.Rectangle;
+import com.itextpdf.text.pdf.ByteBuffer;
+import com.itextpdf.text.pdf.PdfContentByte;
+import com.itextpdf.text.pdf.PdfWriter;
+import java.awt.Font;
+import java.awt.Graphics2D;
+import java.awt.Image;
+import java.io.BufferedOutputStream;
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.OutputStream;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import processing.awt.PGraphicsJava2D;
+import processing.core.PApplet;
+import processing.core.PConstants;
+import processing.core.PFont;
+import processing.core.PImage;
+import processing.core.PStyle;
+import processing.core.PSurface;
+import processing.core.PSurfaceNone;
+
+/**
+ * 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="https://github.com/itext/itextpdf">itextpdf</a>. This is currently using
+ * itextpdf-5.5.13.2.
+ */
+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;
+    protected PdfGraphics2D graphicContent;
+    /**
+     * Shared across instances because it's incredibly time-consuming to create.
+     */
+    static protected DefaultFontMapper mapper;
+    static protected String[] fontList;
+
+    @Override
+    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.
+     * @param output
+     */
+    public void setOutput(OutputStream output) {
+        this.output = output;
+    }
+
+    @Override
+    public PSurface createSurface() {
+        return surface = new PSurfaceNone(this);
+    }
+
+    @Override
+    protected void defaultSettings() {  // ignore
+        super.defaultSettings();
+        textMode = SHAPE;
+    }
+
+    @Override
+    public void beginDraw() {
+        if (document == null) {
+            ByteBuffer.HIGH_PRECISION = true;
+            document = new Document(new Rectangle(width, height));
+            boolean missingPath = false;
+            try {
+                if (file != null) {
+                    try {
+                        output = new BufferedOutputStream(new FileOutputStream(file), 16384);
+                    } catch (FileNotFoundException ex) {
+                        Logger.getLogger(PGraphicsPDF.class.getName()).log(Level.SEVERE, null, ex);
+                    }
+                } else if (output == null) {
+                    missingPath = true;
+                    throw new RuntimeException("PGraphicsPDF requires a path "
+                            + "for the location of the output file.");
+                }
+                try {
+                    writer = PdfWriter.getInstance(document, output);
+                } catch (DocumentException ex) {
+                    Logger.getLogger(PGraphicsPDF.class.getName()).log(Level.SEVERE, null, ex);
+                }
+                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);
+                }
+            }
+            g2 = new PdfGraphics2D(content, width, height);
+        }
+
+        // super in Java2D now creates an image buffer, don't do that
+        //super.beginDraw();
+        checkSettings();
+        resetMatrix(); // reset model matrix
+        vertexCount = 0;
+        pushMatrix();
+    }
+
+    static protected DefaultFontMapper getMapper() {
+        if (mapper == null) {
+            mapper = new DefaultFontMapper();
+            switch (PApplet.platform) {
+                case PConstants.MACOS:
+                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");
+                break;
+
+                case 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 (File root : roots) {
+                        if (root.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(root, "WINDOWS/Fonts");
+                        if (folder.exists()) {
+                            mapper.insertDirectory(folder.getAbsolutePath());
+                            break;
+                        }
+                        folder = new File(root, "WINNT/Fonts");
+                        if (folder.exists()) {
+                            mapper.insertDirectory(folder.getAbsolutePath());
+                            break;
+                        }
+                    }
+                    break;
+
+                case PConstants.LINUX:
+                    checkDir("/usr/share/fonts/", mapper);
+                    checkDir("/usr/local/share/fonts/", mapper);
+                    checkDir(System.getProperty("user.home") + "/.fonts", mapper);
+                    break;
+                default:
+                    break;
+            }
+        }
+        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>)
+     *
+     * @param folder
+     * @param mapper
+     */
+    static protected void traverseDir(File folder, DefaultFontMapper mapper) {
+        File[] files = folder.listFiles();
+        for (File file1 : files) {
+            if (file1.isDirectory()) {
+                mapper.insertDirectory(file1.getPath());
+                traverseDir(new File(file1.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
+    @Override
+    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();
+    }
+
+    /**
+     * 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) {
+        }
+        g2 = createGraphics();
+        beginDraw();
+        style(savedStyle);
+    }
+
+    protected Graphics2D createGraphics() {
+        if (textMode == SHAPE) {
+          return new PdfGraphics2D(content, width, height);
+        } else if (textMode == MODEL) {
+            return new PdfGraphics2D(content, width, height, getMapper());
+        }
+        // Should not be reachable...
+        throw new RuntimeException("Invalid textMode() selected for PDF.");
+    }
+
+    @Override
+    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.
+     * @return
+     */
+    @Override
+    public boolean displayable() {
+        return false;
+    }
+
+    @Override
+    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) image.getNative(), 0, 0, null);
+        } else {
+            PImage tmp = image.get(u1, v1, u2 - u1, v2 - v1);
+            g2.drawImage((Image) tmp.getNative(), 0, 0, null);
+        }
+        popMatrix();
+    }
+
+    //////////////////////////////////////////////////////////////
+    @Override
+    public void textFont(PFont which) {
+        super.textFont(which);
+        checkFont();
+    }
+
+    /**
+     * Change the textMode() to either SHAPE or MODEL. 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.
+     */
+     @Override
+     public void textMode(int mode) {
+         if (textMode != mode) {
+             switch (mode) {
+                 case SHAPE:
+                     textMode = SHAPE;
+                     g2.dispose();
+                     g2 = createGraphics();
+                     break;
+                 case MODEL:
+                     textMode = MODEL;
+                     g2.dispose();
+                     g2 = createGraphics();
+                     break;
+                 case SCREEN:
+                     throw new RuntimeException("textMode(SCREEN) not supported with PDF");
+                 default:
+                     throw new RuntimeException("That textMode() does not exist");
+             }
+         }
+     }
+
+    @Override
+    protected void textLineImpl(char buffer[], int start, int stop,
+            float x, float y) {
+        checkFont();
+        super.textLineImpl(buffer, start, stop, x, y);
+    }
+
+    //////////////////////////////////////////////////////////////
+    @Override
+    public void loadPixels() {
+        nope("loadPixels");
+    }
+
+    @Override
+    public void updatePixels() {
+        nope("updatePixels");
+    }
+
+    @Override
+    public void updatePixels(int x, int y, int c, int d) {
+        nope("updatePixels");
+    }
+
+    //
+    @Override
+    public int get(int x, int y) {
+        nope("get");
+        return 0;  // not reached
+    }
+
+    @Override
+    public PImage get(int x, int y, int c, int d) {
+        nope("get");
+        return null;  // not reached
+    }
+
+    @Override
+    public PImage get() {
+        nope("get");
+        return null;  // not reached
+    }
+
+    @Override
+    public void set(int x, int y, int argb) {
+        nope("set");
+    }
+
+    @Override
+    public void set(int x, int y, PImage image) {
+        nope("set");
+    }
+
+    //
+    /**
+     *
+     * @param alpha
+     */
+    @Override
+    public void mask(int alpha[]) {
+        nope("mask");
+    }
+
+    @Override
+    public void mask(PImage alpha) {
+        nope("mask");
+    }
+
+    /**
+     *
+     * @param kind
+     */
+    @Override
+    public void filter(int kind) {
+        nope("filter");
+    }
+
+    @Override
+    public void filter(int kind, float param) {
+        nope("filter");
+    }
+
+    //
+    @Override
+    protected void blendModeImpl() {
+        if (blendMode != REPLACE && blendMode != BLEND) {
+            showMissingWarning("blendMode");
+        }
+    }
+
+    //
+    @Override
+    public void copy(int sx1, int sy1, int sx2, int sy2,
+            int dx1, int dy1, int dx2, int dy2) {
+        nope("copy");
+    }
+
+    /**
+     *
+     * @param src
+     * @param sx1
+     * @param sy1
+     * @param sx2
+     * @param sy2
+     * @param dx1
+     * @param dy1
+     * @param dx2
+     * @param dy2
+     */
+    @Override
+    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");
+    }
+
+    @Override
+    public void blend(int sx1, int sy1, int sx2, int sy2,
+            int dx1, int dy1, int dx2, int dy2, int mode) {
+        nope("blend");
+    }
+
+    @Override
+    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");
+    }
+
+    //
+    @Override
+    public boolean save(String filename) {
+        nope("save");
+        return false;
+    }
+
+    //////////////////////////////////////////////////////////////
+    /**
+     * 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)
+     *
+     * @param directory
+     */
+    public void addFonts(String directory) {
+        mapper.insertDirectory(directory);
+    }
+
+    /**
+     * Check whether the specified font can be used with the PDF library.
+     *
+     */
+    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.
+     *
+     * @return
+     */
+    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();
+//      }
+            Arrays.sort(fontList);
+        }
+        return fontList;
+    }
+
+    //////////////////////////////////////////////////////////////
+    protected void nope(String function) {
+        throw new RuntimeException("No " + function + "() for " + getClass().getSimpleName());
+    }
+}