barrenderer.html

jfreechart1。0。2的api。

<FONT color="green">418</FONT>         * Returns the upper clip value.  This value is recalculated in the <a name="line.418"></a>
<FONT color="green">419</FONT>         * initialise() method.<a name="line.419"></a>
<FONT color="green">420</FONT>         *<a name="line.420"></a>
<FONT color="green">421</FONT>         * @return The value.<a name="line.421"></a>
<FONT color="green">422</FONT>         */<a name="line.422"></a>
<FONT color="green">423</FONT>        public double getUpperClip() {<a name="line.423"></a>
<FONT color="green">424</FONT>            // TODO:  this attribute should be transferred to the renderer state.<a name="line.424"></a>
<FONT color="green">425</FONT>            return this.upperClip;<a name="line.425"></a>
<FONT color="green">426</FONT>        }<a name="line.426"></a>
<FONT color="green">427</FONT>    <a name="line.427"></a>
<FONT color="green">428</FONT>        /**<a name="line.428"></a>
<FONT color="green">429</FONT>         * Initialises the renderer and returns a state object that will be passed <a name="line.429"></a>
<FONT color="green">430</FONT>         * to subsequent calls to the drawItem method.  This method gets called <a name="line.430"></a>
<FONT color="green">431</FONT>         * once at the start of the process of drawing a chart.<a name="line.431"></a>
<FONT color="green">432</FONT>         *<a name="line.432"></a>
<FONT color="green">433</FONT>         * @param g2  the graphics device.<a name="line.433"></a>
<FONT color="green">434</FONT>         * @param dataArea  the area in which the data is to be plotted.<a name="line.434"></a>
<FONT color="green">435</FONT>         * @param plot  the plot.<a name="line.435"></a>
<FONT color="green">436</FONT>         * @param rendererIndex  the renderer index.<a name="line.436"></a>
<FONT color="green">437</FONT>         * @param info  collects chart rendering information for return to caller.<a name="line.437"></a>
<FONT color="green">438</FONT>         * <a name="line.438"></a>
<FONT color="green">439</FONT>         * @return The renderer state.<a name="line.439"></a>
<FONT color="green">440</FONT>         */<a name="line.440"></a>
<FONT color="green">441</FONT>        public CategoryItemRendererState initialise(Graphics2D g2,<a name="line.441"></a>
<FONT color="green">442</FONT>                                                    Rectangle2D dataArea,<a name="line.442"></a>
<FONT color="green">443</FONT>                                                    CategoryPlot plot,<a name="line.443"></a>
<FONT color="green">444</FONT>                                                    int rendererIndex,<a name="line.444"></a>
<FONT color="green">445</FONT>                                                    PlotRenderingInfo info) {<a name="line.445"></a>
<FONT color="green">446</FONT>    <a name="line.446"></a>
<FONT color="green">447</FONT>            CategoryItemRendererState state = super.initialise(g2, dataArea, plot, <a name="line.447"></a>
<FONT color="green">448</FONT>                    rendererIndex, info);<a name="line.448"></a>
<FONT color="green">449</FONT>    <a name="line.449"></a>
<FONT color="green">450</FONT>            // get the clipping values...<a name="line.450"></a>
<FONT color="green">451</FONT>            ValueAxis rangeAxis = getRangeAxis(plot, rendererIndex);<a name="line.451"></a>
<FONT color="green">452</FONT>            this.lowerClip = rangeAxis.getRange().getLowerBound();<a name="line.452"></a>
<FONT color="green">453</FONT>            this.upperClip = rangeAxis.getRange().getUpperBound();<a name="line.453"></a>
<FONT color="green">454</FONT>    <a name="line.454"></a>
<FONT color="green">455</FONT>            // calculate the bar width<a name="line.455"></a>
<FONT color="green">456</FONT>            calculateBarWidth(plot, dataArea, rendererIndex, state);<a name="line.456"></a>
<FONT color="green">457</FONT>    <a name="line.457"></a>
<FONT color="green">458</FONT>            return state;<a name="line.458"></a>
<FONT color="green">459</FONT>            <a name="line.459"></a>
<FONT color="green">460</FONT>        }<a name="line.460"></a>
<FONT color="green">461</FONT>        <a name="line.461"></a>
<FONT color="green">462</FONT>        /**<a name="line.462"></a>
<FONT color="green">463</FONT>         * Calculates the bar width and stores it in the renderer state.<a name="line.463"></a>
<FONT color="green">464</FONT>         * <a name="line.464"></a>
<FONT color="green">465</FONT>         * @param plot  the plot.<a name="line.465"></a>
<FONT color="green">466</FONT>         * @param dataArea  the data area.<a name="line.466"></a>
<FONT color="green">467</FONT>         * @param rendererIndex  the renderer index.<a name="line.467"></a>
<FONT color="green">468</FONT>         * @param state  the renderer state.<a name="line.468"></a>
<FONT color="green">469</FONT>         */<a name="line.469"></a>
<FONT color="green">470</FONT>        protected void calculateBarWidth(CategoryPlot plot, <a name="line.470"></a>
<FONT color="green">471</FONT>                                         Rectangle2D dataArea, <a name="line.471"></a>
<FONT color="green">472</FONT>                                         int rendererIndex,<a name="line.472"></a>
<FONT color="green">473</FONT>                                         CategoryItemRendererState state) {<a name="line.473"></a>
<FONT color="green">474</FONT>                                             <a name="line.474"></a>
<FONT color="green">475</FONT>            CategoryAxis domainAxis = getDomainAxis(plot, rendererIndex);<a name="line.475"></a>
<FONT color="green">476</FONT>            CategoryDataset dataset = plot.getDataset(rendererIndex);<a name="line.476"></a>
<FONT color="green">477</FONT>            if (dataset != null) {<a name="line.477"></a>
<FONT color="green">478</FONT>                int columns = dataset.getColumnCount();<a name="line.478"></a>
<FONT color="green">479</FONT>                int rows = dataset.getRowCount();<a name="line.479"></a>
<FONT color="green">480</FONT>                double space = 0.0;<a name="line.480"></a>
<FONT color="green">481</FONT>                PlotOrientation orientation = plot.getOrientation();<a name="line.481"></a>
<FONT color="green">482</FONT>                if (orientation == PlotOrientation.HORIZONTAL) {<a name="line.482"></a>
<FONT color="green">483</FONT>                    space = dataArea.getHeight();<a name="line.483"></a>
<FONT color="green">484</FONT>                }<a name="line.484"></a>
<FONT color="green">485</FONT>                else if (orientation == PlotOrientation.VERTICAL) {<a name="line.485"></a>
<FONT color="green">486</FONT>                    space = dataArea.getWidth();<a name="line.486"></a>
<FONT color="green">487</FONT>                }<a name="line.487"></a>
<FONT color="green">488</FONT>                double maxWidth = space * getMaximumBarWidth();<a name="line.488"></a>
<FONT color="green">489</FONT>                double categoryMargin = 0.0;<a name="line.489"></a>
<FONT color="green">490</FONT>                double currentItemMargin = 0.0;<a name="line.490"></a>
<FONT color="green">491</FONT>                if (columns &gt; 1) {<a name="line.491"></a>
<FONT color="green">492</FONT>                    categoryMargin = domainAxis.getCategoryMargin();<a name="line.492"></a>
<FONT color="green">493</FONT>                }<a name="line.493"></a>
<FONT color="green">494</FONT>                if (rows &gt; 1) {<a name="line.494"></a>
<FONT color="green">495</FONT>                    currentItemMargin = getItemMargin();<a name="line.495"></a>
<FONT color="green">496</FONT>                }<a name="line.496"></a>
<FONT color="green">497</FONT>                double used = space * (1 - domainAxis.getLowerMargin() <a name="line.497"></a>
<FONT color="green">498</FONT>                                         - domainAxis.getUpperMargin()<a name="line.498"></a>
<FONT color="green">499</FONT>                                         - categoryMargin - currentItemMargin);<a name="line.499"></a>
<FONT color="green">500</FONT>                if ((rows * columns) &gt; 0) {<a name="line.500"></a>
<FONT color="green">501</FONT>                    state.setBarWidth(Math.min(used / (rows * columns), maxWidth));<a name="line.501"></a>
<FONT color="green">502</FONT>                }<a name="line.502"></a>
<FONT color="green">503</FONT>                else {<a name="line.503"></a>
<FONT color="green">504</FONT>                    state.setBarWidth(Math.min(used, maxWidth));<a name="line.504"></a>
<FONT color="green">505</FONT>                }<a name="line.505"></a>
<FONT color="green">506</FONT>            }<a name="line.506"></a>
<FONT color="green">507</FONT>        }<a name="line.507"></a>
<FONT color="green">508</FONT>    <a name="line.508"></a>
<FONT color="green">509</FONT>        /**<a name="line.509"></a>
<FONT color="green">510</FONT>         * Calculates the coordinate of the first "side" of a bar.  This will be <a name="line.510"></a>
<FONT color="green">511</FONT>         * the minimum x-coordinate for a vertical bar, and the minimum <a name="line.511"></a>
<FONT color="green">512</FONT>         * y-coordinate for a horizontal bar.<a name="line.512"></a>
<FONT color="green">513</FONT>         *<a name="line.513"></a>
<FONT color="green">514</FONT>         * @param plot  the plot.<a name="line.514"></a>
<FONT color="green">515</FONT>         * @param orientation  the plot orientation.<a name="line.515"></a>
<FONT color="green">516</FONT>         * @param dataArea  the data area.<a name="line.516"></a>
<FONT color="green">517</FONT>         * @param domainAxis  the domain axis.<a name="line.517"></a>
<FONT color="green">518</FONT>         * @param state  the renderer state (has the bar width precalculated).<a name="line.518"></a>
<FONT color="green">519</FONT>         * @param row  the row index.<a name="line.519"></a>
<FONT color="green">520</FONT>         * @param column  the column index.<a name="line.520"></a>
<FONT color="green">521</FONT>         * <a name="line.521"></a>
<FONT color="green">522</FONT>         * @return The coordinate.<a name="line.522"></a>
<FONT color="green">523</FONT>         */<a name="line.523"></a>
<FONT color="green">524</FONT>        protected double calculateBarW0(CategoryPlot plot, <a name="line.524"></a>
<FONT color="green">525</FONT>                                        PlotOrientation orientation, <a name="line.525"></a>
<FONT color="green">526</FONT>                                        Rectangle2D dataArea,<a name="line.526"></a>
<FONT color="green">527</FONT>                                        CategoryAxis domainAxis,<a name="line.527"></a>
<FONT color="green">528</FONT>                                        CategoryItemRendererState state,<a name="line.528"></a>
<FONT color="green">529</FONT>                                        int row,<a name="line.529"></a>
<FONT color="green">530</FONT>                                        int column) {<a name="line.530"></a>
<FONT color="green">531</FONT>            // calculate bar width...<a name="line.531"></a>
<FONT color="green">532</FONT>            double space = 0.0;<a name="line.532"></a>
<FONT color="green">533</FONT>            if (orientation == PlotOrientation.HORIZONTAL) {<a name="line.533"></a>
<FONT color="green">534</FONT>                space = dataArea.getHeight();<a name="line.534"></a>
<FONT color="green">535</FONT>            }<a name="line.535"></a>
<FONT color="green">536</FONT>            else {<a name="line.536"></a>
<FONT color="green">537</FONT>                space = dataArea.getWidth();<a name="line.537"></a>
<FONT color="green">538</FONT>            }<a name="line.538"></a>
<FONT color="green">539</FONT>            double barW0 = domainAxis.getCategoryStart(column, getColumnCount(), <a name="line.539"></a>
<FONT color="green">540</FONT>                    dataArea, plot.getDomainAxisEdge());<a name="line.540"></a>
<FONT color="green">541</FONT>            int seriesCount = getRowCount();<a name="line.541"></a>
<FONT color="green">542</FONT>            int categoryCount = getColumnCount();<a name="line.542"></a>
<FONT color="green">543</FONT>            if (seriesCount &gt; 1) {<a name="line.543"></a>
<FONT color="green">544</FONT>                double seriesGap = space * getItemMargin() <a name="line.544"></a>
<FONT color="green">545</FONT>                                   / (categoryCount * (seriesCount - 1));<a name="line.545"></a>
<FONT color="green">546</FONT>                double seriesW = calculateSeriesWidth(space, domainAxis, <a name="line.546"></a>
<FONT color="green">547</FONT>                        categoryCount, seriesCount);<a name="line.547"></a>
<FONT color="green">548</FONT>                barW0 = barW0 + row * (seriesW + seriesGap) <a name="line.548"></a>
<FONT color="green">549</FONT>                              + (seriesW / 2.0) - (state.getBarWidth() / 2.0);<a name="line.549"></a>
<FONT color="green">550</FONT>            }<a name="line.550"></a>
<FONT color="green">551</FONT>            else {<a name="line.551"></a>
<FONT color="green">552</FONT>                barW0 = domainAxis.getCategoryMiddle(column, getColumnCount(), <a name="line.552"></a>
<FONT color="green">553</FONT>                        dataArea, plot.getDomainAxisEdge()) - state.getBarWidth() <a name="line.553"></a>
<FONT color="green">554</FONT>                        / 2.0;<a name="line.554"></a>
<FONT color="green">555</FONT>            }<a name="line.555"></a>
<FONT color="green">556</FONT>            return barW0;<a name="line.556"></a>
<FONT color="green">557</FONT>        }<a name="line.557"></a>