chartutilities.html

jfreechart1。0。2的api。

<FONT color="green">542</FONT>                throw new IllegalArgumentException("Null 'file' argument.");<a name="line.542"></a>
<FONT color="green">543</FONT>            }<a name="line.543"></a>
<FONT color="green">544</FONT>            if (chart == null) {<a name="line.544"></a>
<FONT color="green">545</FONT>                throw new IllegalArgumentException("Null 'chart' argument.");<a name="line.545"></a>
<FONT color="green">546</FONT>            }<a name="line.546"></a>
<FONT color="green">547</FONT>            OutputStream out = new BufferedOutputStream(new FileOutputStream(file));<a name="line.547"></a>
<FONT color="green">548</FONT>            writeChartAsJPEG(out, chart, width, height, info);<a name="line.548"></a>
<FONT color="green">549</FONT>            out.close();<a name="line.549"></a>
<FONT color="green">550</FONT>    <a name="line.550"></a>
<FONT color="green">551</FONT>        }<a name="line.551"></a>
<FONT color="green">552</FONT>    <a name="line.552"></a>
<FONT color="green">553</FONT>        /**<a name="line.553"></a>
<FONT color="green">554</FONT>         * Saves a chart to a file in JPEG format.  This method allows you to pass <a name="line.554"></a>
<FONT color="green">555</FONT>         * in a {@link ChartRenderingInfo} object, to collect information about the <a name="line.555"></a>
<FONT color="green">556</FONT>         * chart dimensions/entities.  You will need this info if you want to <a name="line.556"></a>
<FONT color="green">557</FONT>         * create an HTML image map.<a name="line.557"></a>
<FONT color="green">558</FONT>         *<a name="line.558"></a>
<FONT color="green">559</FONT>         * @param file  the file name (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.559"></a>
<FONT color="green">560</FONT>         * @param quality  the quality setting.<a name="line.560"></a>
<FONT color="green">561</FONT>         * @param chart  the chart (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.561"></a>
<FONT color="green">562</FONT>         * @param width  the image width.<a name="line.562"></a>
<FONT color="green">563</FONT>         * @param height  the image height.<a name="line.563"></a>
<FONT color="green">564</FONT>         * @param info  the chart rendering info (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.564"></a>
<FONT color="green">565</FONT>         *<a name="line.565"></a>
<FONT color="green">566</FONT>         * @throws IOException if there are any I/O errors.<a name="line.566"></a>
<FONT color="green">567</FONT>         */<a name="line.567"></a>
<FONT color="green">568</FONT>        public static void saveChartAsJPEG(File file,<a name="line.568"></a>
<FONT color="green">569</FONT>                                           float quality,<a name="line.569"></a>
<FONT color="green">570</FONT>                                           JFreeChart chart,<a name="line.570"></a>
<FONT color="green">571</FONT>                                           int width,<a name="line.571"></a>
<FONT color="green">572</FONT>                                           int height,<a name="line.572"></a>
<FONT color="green">573</FONT>                                           ChartRenderingInfo info) <a name="line.573"></a>
<FONT color="green">574</FONT>            throws IOException {<a name="line.574"></a>
<FONT color="green">575</FONT>    <a name="line.575"></a>
<FONT color="green">576</FONT>            if (file == null) {<a name="line.576"></a>
<FONT color="green">577</FONT>                throw new IllegalArgumentException("Null 'file' argument.");<a name="line.577"></a>
<FONT color="green">578</FONT>            }<a name="line.578"></a>
<FONT color="green">579</FONT>            if (chart == null) {<a name="line.579"></a>
<FONT color="green">580</FONT>                throw new IllegalArgumentException("Null 'chart' argument.");<a name="line.580"></a>
<FONT color="green">581</FONT>            }<a name="line.581"></a>
<FONT color="green">582</FONT>            OutputStream out = new BufferedOutputStream(new FileOutputStream(file));<a name="line.582"></a>
<FONT color="green">583</FONT>            writeChartAsJPEG(out, quality, chart, width, height, info);<a name="line.583"></a>
<FONT color="green">584</FONT>            out.close();<a name="line.584"></a>
<FONT color="green">585</FONT>    <a name="line.585"></a>
<FONT color="green">586</FONT>        }<a name="line.586"></a>
<FONT color="green">587</FONT>    <a name="line.587"></a>
<FONT color="green">588</FONT>        /**<a name="line.588"></a>
<FONT color="green">589</FONT>         * Writes a {@link BufferedImage} to an output stream in JPEG format.<a name="line.589"></a>
<FONT color="green">590</FONT>         *<a name="line.590"></a>
<FONT color="green">591</FONT>         * @param out  the output stream (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.591"></a>
<FONT color="green">592</FONT>         * @param image  the image (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.592"></a>
<FONT color="green">593</FONT>         *<a name="line.593"></a>
<FONT color="green">594</FONT>         * @throws IOException if there are any I/O errors.<a name="line.594"></a>
<FONT color="green">595</FONT>         */<a name="line.595"></a>
<FONT color="green">596</FONT>        public static void writeBufferedImageAsJPEG(OutputStream out, <a name="line.596"></a>
<FONT color="green">597</FONT>                                                    BufferedImage image)<a name="line.597"></a>
<FONT color="green">598</FONT>            throws IOException {<a name="line.598"></a>
<FONT color="green">599</FONT>    <a name="line.599"></a>
<FONT color="green">600</FONT>            // defer argument checking...<a name="line.600"></a>
<FONT color="green">601</FONT>            writeBufferedImageAsJPEG(out, 0.75f, image);<a name="line.601"></a>
<FONT color="green">602</FONT>    <a name="line.602"></a>
<FONT color="green">603</FONT>        }<a name="line.603"></a>
<FONT color="green">604</FONT>    <a name="line.604"></a>
<FONT color="green">605</FONT>        /**<a name="line.605"></a>
<FONT color="green">606</FONT>         * Writes a {@link BufferedImage} to an output stream in JPEG format.<a name="line.606"></a>
<FONT color="green">607</FONT>         *<a name="line.607"></a>
<FONT color="green">608</FONT>         * @param out  the output stream (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.608"></a>
<FONT color="green">609</FONT>         * @param quality  the image quality (0.0f to 1.0f).<a name="line.609"></a>
<FONT color="green">610</FONT>         * @param image  the image (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.610"></a>
<FONT color="green">611</FONT>         *<a name="line.611"></a>
<FONT color="green">612</FONT>         * @throws IOException if there are any I/O errors.<a name="line.612"></a>
<FONT color="green">613</FONT>         */<a name="line.613"></a>
<FONT color="green">614</FONT>        public static void writeBufferedImageAsJPEG(OutputStream out, float quality,<a name="line.614"></a>
<FONT color="green">615</FONT>                                                    BufferedImage image) <a name="line.615"></a>
<FONT color="green">616</FONT>            throws IOException {<a name="line.616"></a>
<FONT color="green">617</FONT>    <a name="line.617"></a>
<FONT color="green">618</FONT>            EncoderUtil.writeBufferedImage(image, ImageFormat.JPEG, out, quality);<a name="line.618"></a>
<FONT color="green">619</FONT>    <a name="line.619"></a>
<FONT color="green">620</FONT>        }<a name="line.620"></a>
<FONT color="green">621</FONT>    <a name="line.621"></a>
<FONT color="green">622</FONT>        /**<a name="line.622"></a>
<FONT color="green">623</FONT>         * Writes a {@link BufferedImage} to an output stream in PNG format.<a name="line.623"></a>
<FONT color="green">624</FONT>         *<a name="line.624"></a>
<FONT color="green">625</FONT>         * @param out  the output stream (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.625"></a>
<FONT color="green">626</FONT>         * @param image  the image (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.626"></a>
<FONT color="green">627</FONT>         *<a name="line.627"></a>
<FONT color="green">628</FONT>         * @throws IOException if there are any I/O errors.<a name="line.628"></a>
<FONT color="green">629</FONT>         */<a name="line.629"></a>
<FONT color="green">630</FONT>        public static void writeBufferedImageAsPNG(OutputStream out, <a name="line.630"></a>
<FONT color="green">631</FONT>                                                   BufferedImage image)<a name="line.631"></a>
<FONT color="green">632</FONT>            throws IOException {<a name="line.632"></a>
<FONT color="green">633</FONT>    <a name="line.633"></a>
<FONT color="green">634</FONT>            EncoderUtil.writeBufferedImage(image, ImageFormat.PNG, out);<a name="line.634"></a>
<FONT color="green">635</FONT>    <a name="line.635"></a>
<FONT color="green">636</FONT>        }<a name="line.636"></a>
<FONT color="green">637</FONT>    <a name="line.637"></a>
<FONT color="green">638</FONT>        /**<a name="line.638"></a>
<FONT color="green">639</FONT>         * Writes a {@link BufferedImage} to an output stream in PNG format.<a name="line.639"></a>
<FONT color="green">640</FONT>         *<a name="line.640"></a>
<FONT color="green">641</FONT>         * @param out  the output stream (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.641"></a>
<FONT color="green">642</FONT>         * @param image  the image (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.642"></a>
<FONT color="green">643</FONT>         * @param encodeAlpha  encode alpha?<a name="line.643"></a>
<FONT color="green">644</FONT>         * @param compression  the compression level (0-9).<a name="line.644"></a>
<FONT color="green">645</FONT>         *<a name="line.645"></a>
<FONT color="green">646</FONT>         * @throws IOException if there are any I/O errors.<a name="line.646"></a>
<FONT color="green">647</FONT>         */<a name="line.647"></a>
<FONT color="green">648</FONT>        public static void writeBufferedImageAsPNG(OutputStream out,<a name="line.648"></a>
<FONT color="green">649</FONT>                                                   BufferedImage image,<a name="line.649"></a>
<FONT color="green">650</FONT>                                                   boolean encodeAlpha,<a name="line.650"></a>
<FONT color="green">651</FONT>                                                   int compression) <a name="line.651"></a>
<FONT color="green">652</FONT>            throws IOException {<a name="line.652"></a>
<FONT color="green">653</FONT>    <a name="line.653"></a>
<FONT color="green">654</FONT>            EncoderUtil.writeBufferedImage(<a name="line.654"></a>
<FONT color="green">655</FONT>                image, ImageFormat.PNG, out, compression, encodeAlpha<a name="line.655"></a>
<FONT color="green">656</FONT>            );<a name="line.656"></a>
<FONT color="green">657</FONT>        }<a name="line.657"></a>
<FONT color="green">658</FONT>    <a name="line.658"></a>
<FONT color="green">659</FONT>        /**<a name="line.659"></a>
<FONT color="green">660</FONT>         * Encodes a {@link BufferedImage} to PNG format.<a name="line.660"></a>
<FONT color="green">661</FONT>         *<a name="line.661"></a>
<FONT color="green">662</FONT>         * @param image  the image (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.662"></a>
<FONT color="green">663</FONT>         *<a name="line.663"></a>
<FONT color="green">664</FONT>         * @return A byte array in PNG format.<a name="line.664"></a>
<FONT color="green">665</FONT>         * <a name="line.665"></a>
<FONT color="green">666</FONT>         * @throws IOException if there is an I/O problem.<a name="line.666"></a>
<FONT color="green">667</FONT>         */<a name="line.667"></a>
<FONT color="green">668</FONT>        public static byte[] encodeAsPNG(BufferedImage image) throws IOException {<a name="line.668"></a>
<FONT color="green">669</FONT>            return EncoderUtil.encode(image, ImageFormat.PNG);<a name="line.669"></a>
<FONT color="green">670</FONT>        }<a name="line.670"></a>
<FONT color="green">671</FONT>    <a name="line.671"></a>
<FONT color="green">672</FONT>        /**<a name="line.672"></a>
<FONT color="green">673</FONT>         * Encodes a {@link BufferedImage} to PNG format.<a name="line.673"></a>
<FONT color="green">674</FONT>         *<a name="line.674