JOGL v2.6.0-rc-20250712
JOGL, High-Performance Graphics Binding for Java™ (public API).
PrintableBase.java
Go to the documentation of this file.
1/**
2 * Copyright 2013 JogAmp Community. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without modification, are
5 * permitted provided that the following conditions are met:
6 *
7 * 1. Redistributions of source code must retain the above copyright notice, this list of
8 * conditions and the following disclaimer.
9 *
10 * 2. Redistributions in binary form must reproduce the above copyright notice, this list
11 * of conditions and the following disclaimer in the documentation and/or other materials
12 * provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED
15 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
16 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
20 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
21 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
22 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 *
24 * The views and conclusions contained in the software and documentation are those of the
25 * authors and should not be interpreted as representing official policies, either expressed
26 * or implied, of JogAmp Community.
27 */
28package com.jogamp.opengl.test.junit.jogl.tile;
29
30import java.awt.Container;
31import java.awt.print.Printable;
32import java.awt.print.PrinterJob;
33
34import com.jogamp.common.util.locks.LockFactory;
35import com.jogamp.common.util.locks.RecursiveLock;
36import com.jogamp.opengl.util.TileRenderer;
37
38/**
39 * Base {@link Printable} implementation class.
40 *
41 * <h5>Virtual printer driver</h5>
42 * <p>
43 * Note, on OSX you might need to setup a dummy printer, i.e. <i>print to file</i>.<br>
44 * As root:
45 * <pre>
46 cupsctl FileDevice=Yes
47 killall -HUP cupsd
48 mkdir /data/lp
49 chown USER /data/lp
50 chmod ugo+rwx /data/lp
51 lpadmin -p lprint -E -v file:/data/lp/out.ps -P /Library/Printers/PPDs/Contents/Resources/HP\ LaserJet\ 4\ Plus.gz
52 * </pre>
53 */
54public abstract class PrintableBase implements Printable {
55
56 public static final double MM_PER_INCH = 25.4;
57
58 public final PrinterJob job;
59 public final Container cont;
60 public final int dpi;
61 public final int numSamples;
62 public final int tileWidth, tileHeight;
63 protected final RecursiveLock lockPrinting = LockFactory.createRecursiveLock();
64
65 /**
66 *
67 * @param job
68 * @param printContainer
69 * @param printDPI
70 * @param numSamples multisampling value: < 0 turns off, == 0 leaves as-is, > 0 enables using given num samples
71 * @param tileWidth custom tile width for {@link TileRenderer#setTileSize(int, int, int) tile renderer}, pass -1 for default.
72 * @param tileHeight custom tile height for {@link TileRenderer#setTileSize(int, int, int) tile renderer}, pass -1 for default.
73 */
74 public PrintableBase(final PrinterJob job, final Container printContainer, final int printDPI, final int numSamples, final int tileWidth, final int tileHeight) {
75 this.job = job;
76 this.cont = printContainer;
77 this.dpi = printDPI;
78 this.numSamples = numSamples;
79 this.tileWidth = tileWidth;
80 this.tileHeight = tileHeight;
81 }
82
83 /** Wait for idle .. simply acquiring all locks and releasing them. */
84 public void waitUntilIdle() {
85 lockPrinting.lock();
86 lockPrinting.unlock();
87 }
88}
PrintableBase(final PrinterJob job, final Container printContainer, final int printDPI, final int numSamples, final int tileWidth, final int tileHeight)