T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
Listing 13-16. JRXML Syntax
<!ELEMENT bar3DPlot (plot, categoryAxisLabelExpression?, 
categoryAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
<!ATTLIST bar3DPlot
isShowLabels (true | false ) "false"
xOffset CDATA #IMPLIED
yOffset CDATA #IMPLIED
>
3D Effect
This plot exposes two special attributes, 
xOffset
and 
yOffset
, that allow users to 
control the 3D effect. Both accept numeric values representing the number of pixels in 
the 3D effect on the two axes.
L
INE
P
LOT
This plot is used by the Line and XY Line charts. Its JRXML syntax is given in Listing 
13-17.
Listing 13-17. JRXML Syntax
<!ELEMENT linePlot (plot, categoryAxisLabelExpression?, 
categoryAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
<!ATTLIST linePlot
isShowLines (true | false) "true"
isShowShapes (true | false) "true"
>
Axis Labels
The Line plot also has two axes. Their labels can be controlled by using the 
<categoryAxisLabelExpression>
and 
<valueAxisLabelExpression>
tags to 
return 
java.lang.Comparable
values to use as labels.
Show Lines
The Line plot draws lines between the points that represent the chart items inside the plot 
area. Those lines can be suppressed if the 
isShowLines
attribute is set to 
false
.
P
AGE
189
Copy text from pdf without formatting - extract text content from PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Feel Free to Extract Text from PDF Page, Page Region or the Whole PDF File
extract text from pdf java; cut and paste text from pdf document
Copy text from pdf without formatting - VB.NET PDF Text Extract Library: extract text content from PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
How to Extract Text from PDF with VB.NET Sample Codes in .NET Application
extract text from pdf open source; copying text from pdf into word
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
Show Shapes
The Line plot also marks each item point with a small graphical shape that is different 
for each series in the underlying dataset. This small shape can be hidden by setting the 
isShowShapes
flag to 
false
.
A
REA
P
LOT
Area charts and Stacked Area charts rely on this plot to render their axes and items. This 
kind of plot allows users to specify only the labels for both axes and their format. 
Currently no other settings are permitted, as shown in the Listing 13-18, where the 
complete JRXML syntax for the Area plot is given.
Listing 13-18. JRXML Syntax
<!ELEMENT areaPlot (plot, categoryAxisLabelExpression?, 
categoryAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
S
CATTER
P
LOT
Scatter plots are used only with Scatter Plot charts. They render items as points on a two-
axis plot area. This plot closely resembles the Line plot just described, in that it lets users 
configure the labels for both axes, the rendering of lines to unite the item points, and the 
rendering of the small shapes that mark each item point on the target plot area. Listing 
13-19 gives the JRXML syntax for the Scatter plot.
Listing 13-19. JRXML Syntax
<!ELEMENT scatterPlot (plot, xAxisLabelExpression?, xAxisFormat?, 
yAxisLabelExpression?, yAxisFormat?)>
<!ATTLIST scatterPlot
isShowLines (true | false) "true"
isShowShapes (true | false) "true"
>
<!ELEMENT xAxisFormat (axisFormat)>
<!ELEMENT yAxisFormat (axisFormat)>
B
UBBLE
P
LOT
Only Bubble charts use this type of plot. Like all other two-axis plots, it lets users control 
the labels displayed for each axis. Listing 13-20 gives the JRXML syntax for the Bubble 
plot.
P
AGE
190
VB.NET Create PDF from Excel Library to convert xlsx, xls to PDF
edit, C#.NET PDF pages extract, copy, paste, C# rotate PDF pages, C#.NET search text in PDF all Excel spreadsheet into high quality PDF without losing formatting
delete text from pdf; copy and paste text from pdf to word
VB.NET PDF Convert to Word SDK: Convert PDF to Word library in vb.
high-fidelity PDF to Word conversion without depending on All PDF pages can be converted to separate In addition, texts, pictures and font formatting of source
extract highlighted text from pdf; export text from pdf to word
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
Listing 13-20. JRXML Syntax
<!ELEMENT bubblePlot (plot, xAxisLabelExpression?, xAxisFormat?, 
yAxisLabelExpression?, yAxisFormat?)>
<!ATTLIST bubblePlot
scaleType (BothAxes | DomainAxis | RangeAxis) "RangeAxis"
>
Bubble Scale Type
The plot draws an ellipse for each item present in the dataset for a given series. Usually 
this is a circle whose radius is specified by the Z value in that chart item. However, the 
plot needs to know whether the Z value is proportional to its corresponding X value or to 
its corresponding Y value in order to calculate the actual size of the bubble.
The type of bubble scaling is specified by the 
scaleType
attribute that the plot exposes:
   Range axis scaling: The bubble is a circle with the radius proportional to the Y 
value for each item (
scaleType="RangeAxis"
).
   Domain axis scaling: The bubble is a circle with the radius proportional to the 
X value for each item (
scaleType="DomainAxis"
).
   Scaling on both axes: The bubble is an ellipse with the height proportional to 
the Y value and the width proportional to the X value for each item 
(
scaleType="BothAxes"
).
By default, bubbles scale on the range axis.
T
IME
S
ERIES
P
LOT
This type of plot is similar to the Line plot and Scatter plot in that it lets users configure 
the labels for both axes, the rendering of lines to unite the item points, and the rendering 
of the small shapes that mark each item point on the target plot area. It is used only in 
combination with Time Series charts, and its JRXML syntax is given in Listing 13-21.
Listing 13-21. JRXML Syntax
<!ELEMENT timeSeriesPlot (plot, timeAxisLabelExpression?, 
timeAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
<!ATTLIST timeSeriesPlot
isShowLines (true | false) "true"
isShowShapes (true | false) "true"
>
<!ELEMENT timeAxisFormat (axisFormat)>
P
AGE
191
C# Create PDF from Word Library to convert docx, doc to PDF in C#.
A convenient C#.NET control able to turn all Word text and image content into high quality PDF without losing formatting. Convert
c# read text from pdf; erase text from pdf file
C# Create PDF from PowerPoint Library to convert pptx, ppt to PDF
Excellent .NET control for turning all PowerPoint presentation into high quality PDF without losing formatting in C#.NET Class. Convert
export text from pdf; extract text from pdf
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
H
IGH
-L
OW
P
LOT
Used only in combination with High-Low charts, this type of plot lets users customize 
the labels for both axes, like all the other axis-oriented plots. The JRXML syntax of this 
type of plot is given in Listing 13-22.
Listing 13-22. JRXML Syntax
<!ELEMENT highLowPlot (plot, timeAxisLabelExpression?, 
timeAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
<!ATTLIST highLowPlot
isShowCloseTicks (true | false) "true"
isShowOpenTicks (true | false) "true"
>
Show Tick Marks
This special type of plot draws the items as vertical lines that start at the high value and 
go downward to the low value. On each line the plot displays by default small ticks to 
indicate the open and close values corresponding to the current item. To suppress these 
ticks, set to 
false
the two flags available inside the plot definition: 
isShowCloseTicks 
and 
isShowOpenTicks
.
C
ANDLESTICK
P
LOT
The Candlestick plot is also an axis-oriented plot and allows you to customize axis labels 
using expressions. It can be used only in combination with a Candlestick chart, and its 
JRXML syntax is given in Listing 13-23.
Listing 13-23. JRXML Syntax
<!ELEMENT candlestickPlot (plot, timeAxisLabelExpression?, 
timeAxisFormat?, 
valueAxisLabelExpression?, valueAxisFormat?)>
<!ATTLIST candlestickPlot
isShowVolume (true | false) "true"
>
Show Volume
The Candlestick chart uses a High-Low dataset, but unlike the High-Low chart, the 
Candlestick chart can make use of the volume value inside each dataset item.
P
AGE
192
C# Create PDF from Excel Library to convert xlsx, xls to PDF in C#
Turn all Excel spreadsheet into high quality PDF without losing formatting. Evaluation library and components for PDF creation from Excel in C#.NET framework.
get text from pdf file c#; copy paste pdf text
VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to
Remove Image from PDF Page. Image: Copy, Paste, Cut VB.NET convert PDF to text, VB.NET PowerPoint presentation into high quality PDF without losing formatting.
delete text from pdf with acrobat; copy text from pdf without formatting
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
The volume value is displayed as the body of the candlestick figure rendered for each 
item. The volume is displayed by default in a Candlestick chart but can be suppressed by 
setting the 
isShowVolume
flag to 
false
.
M
ETER
P
LOT
This type of plot can be used only for Meter charts, and its syntax is given in Listing 13-
24.
Listing 13-24. JRXML Syntax
<!ELEMENT meterPlot (plot, valueDisplay?, dataRange, 
meterInterval*)>
<!ATTLIST meterPlot
shape (chord | circle | pie) "pie"
angle CDATA "180"
units CDATA #IMPLIED
tickInterval CDATA "10.0"
meterColor CDATA #IMPLIED
needleColor CDATA #IMPLIED
tickColor CDATA #IMPLIED
>
<!ELEMENT valueDisplay (font?)>
<!ATTLIST valueDisplay
color CDATA #IMPLIED
mask CDATA #IMPLIED
>
<!ELEMENT dataRange (lowExpression, highExpression)>
<!ELEMENT meterInterval (dataRange)>
<!ATTLIST meterInterval
label CDATA #IMPLIED
color CDATA #IMPLIED
alpha CDATA "1.0"
>
Meter Angle and Shape
The 
angle
attribute of the plot represents the extent of the meter in degrees. By default 
the meter dial is a semicircle. 
The 
shape
attribute is used only if the angle of the dial is over 180 degrees. In such 
cases, the space between the start and end of the meter can be filled in several different 
P
AGE
193
VB.NET Create PDF from Word Library to convert docx, doc to PDF in
to PDF. Image: Remove Image from PDF Page. Image: Copy, Paste, Cut Export all Word text and image content into high quality PDF without losing formatting.
copy text from scanned pdf; extract all text from pdf
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
ways. The best way to visualize this is to think of a 12-hour clock face. If the angle of the 
meter is 240 degrees, the meter will start at 8, and then sweep up past 12 and down to 4. 
This attribute specifies how to fill the area between 4 o’clock and 8 o’clock, and there 
are three possibilities:
chord
: A straight line is drawn between the start point and the end point, and the 
area bounded by the meter and this line is shaded with the background color 
(
shape="chord"
).
circle
: The unused portion of the circle that describes the meter is shaded with 
the background color (
shape="circle"
).
pie
: The unused portion of the circle that describes the meter is not shaded at all 
(
shape="pie"
).
The last option is also the default.
Units and Value Display Options
The meter chart displays a single value, and the optional 
units
attribute can be used to 
describe this value. The text will be appended to the value.
When displayed, the value of the meter chart can use a specified font and color, and can 
have a formatting pattern. All these are introduced by the nested 
<valueDisplay>
tag.
Date Range and Intervals
The dial of the meter chart has a minimum and a maximum value that can be specified 
using the 
<dataRange>
tag. 
In addition, the dial can be divided into sections such as “normal,” “warning,” and 
“critical,” which can be color-coded to help interpret the value. You can do so by using 
additional 
<meterInterval>
tags, which introduce data ranges with their labels and 
colors.
Meter Colors
The Meter plot also lets you specify the background color of the dial (which will be 
masked by individual interval colors), the color of the needle, and the color of the ticks 
on the dial.
T
HERMOMETER
P
LOT
This type of plot can be used only for Thermometer charts, which display a single value 
on a thermometer. In addition to the value being plotted, three ranges can be specified to 
help interpret the value as shown in Listing 13-25, where the complete JRXML syntax is 
given.
P
AGE
194
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
Listing 13-25. JRXML Syntax
<!ELEMENT thermometerPlot (plot, valueDisplay?, dataRange, 
lowRange?, 
mediumRange?, highRange?)>
<!ATTLIST thermometerPlot
valueLocation ( none | left | right | bulb ) "bulb"
isShowValueLines ( true | false) "false"
mercuryColor CDATA #IMPLIED
>
<!ELEMENT valueDisplay (font?)>
<!ATTLIST valueDisplay
color CDATA #IMPLIED
mask CDATA #IMPLIED
>
<!ELEMENT dataRange (lowExpression, highExpression)>
<!ELEMENT lowRange (dataRange)>
<!ELEMENT mediumRange (dataRange)>
<!ELEMENT highRange (dataRange)>
Value Location
valueLocation
specifies where to display the textual representation of the value being 
displayed, relative to the thermometer outline. The possible values are as follows:
none
: The text value is not displayed (
valueLocation="none"
).
left
: The text value is displayed to the left of the thermometer outline 
(
valueLocation="left"
).
right
: The text value is displayed to the right of the thermometer outline 
(
valueLocation="right"
).
bulb
: The text value is displayed in the bulb at the bottom of the thermometer 
(
valueLocation="bulb"
).
The last option is also the default.
Value Display Options
Besides specifying the font, color, and pattern to use when rendering the chart value 
using the 
<valueDisplay>
tag options, this plot also allows suppressing the lines on the 
thermometer or changing the color of the liquid.
P
AGE
195
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
M
ULTI
-
AXIS
P
LOT
This plot is for Multi-axis charts. It groups all the common plot options shared by the 
charts inside the Multi-axis chart. The JRXML syntax for this type of plot is given in 
Listing 13-26.
Listing 13-26. JRXML Syntax
<!ELEMENT multiAxisPlot (plot, axis+)>
<!ELEMENT axis (barChart | bar3DChart | xyBarChart | 
stackedBarChart 
| stackedBar3DChart| lineChart | xyLineChart | areaChart | 
xyAreaChart 
| scatterChart | bubbleChart | timeSeriesChart | highLowChart | 
candlestickChart 
| stackedAreaChart)>
<!ATTLIST axis
position (leftOrTop | rightOrBottom) "leftOrTop"
>
The nested charts are specified via the 
<axis>
tags. All nested charts must share the 
same type of domain axis: category, numeric (XY), or time based.
A
XIS
F
ORMAT
Chart plots that display axes also provide a way to customize these axes and specify how 
to draw the axis line, its label, and the label tick marks. Listing 13-27 gives the JRXML 
syntax for specifying an axis format.
Listing 13-27. JRXML Syntax
<!ELEMENT axisFormat (labelFont?, tickLabelFont?)>
<!ATTLIST axisFormat
labelColor CDATA #IMPLIED
tickLabelColor CDATA #IMPLIED
tickLabelMask CDATA #IMPLIED
axisLineColor CDATA #IMPLIED
>
<!ELEMENT labelFont (font?)>
<!ELEMENT tickLabelFont (font?)>
Depending on the types of values displayed by the axis, 
tickLabelMask
can be a 
number format pattern (
<valueAxisFormat>
<xAxisFormat>
<yAxisFormat>
), a 
P
AGE
196
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
date/time format pattern (
<timeAxisFormat>
), or simply ignored 
(
<categoryAxisFormat>
).
C
HART
T
YPES
JasperReports offers built-in support for several chart types. The JFreeChart library used 
to render the charts supports an even wider range of chart types, but the subset offered 
through the chart element available in JasperReports should be sufficient for the majority 
of reporting requirements. 
Note
You can still render special charts by making direct calls to the charting API inside a generic image 
element placed inside the report template.
Each of the predefined chart types in JasperReports is a combination of a dataset and a 
plot. These types are described in the sections that follow. Listings 13-28 through 13-47 
present the JRXML syntax for each.
P
IE
C
HART
This chart is a combination of a Pie dataset and a Pie plot. 
Listing 13-28. JRXML Syntax
<!ELEMENT pieChart (chart, pieDataset, piePlot)>
P
IE
3D C
HART
This chart groups a Pie dataset and a Pie 3D plot.
Listing 13-29. JRXML Syntax
<!ELEMENT pie3DChart (chart, pieDataset, pie3DPlot)>
B
AR
C
HART
This chart is a basic combination of a Category dataset and a Bar plot.
Listing 13-30. JRXML Syntax
<!ELEMENT barChart (chart, categoryDataset, barPlot)>
P
AGE
197
T
HE
J
ASPER
R
EPORTS
U
LTIMATE
G
UIDE
B
AR
3D C
HART
This chart wraps a Category dataset and a Bar 3D plot.
Listing 13-31. JRXML Syntax
<!ELEMENT bar3DChart (chart, categoryDataset, bar3DPlot)>
XY B
AR
C
HART
This chart supports Time Period datasets, Time Series datasets, and XY datasets, and 
uses a Bar plot to render the axis and the items.
Listing 13-32. JRXML Syntax
<!ELEMENT xyBarChart (chart, (timePeriodDataset | timeSeriesDataset 
| xyDataset ), 
barPlot)>
S
TACKED
B
AR
C
HART
Just like the Bar chart, the Stacked Bar chart uses data from a Category dataset and 
renders its content using a Bar plot.
Listing 13-33. JRXML Syntax
<!ELEMENT stackedBar3DChart (chart, categoryDataset, bar3DPlot)>
S
TACKED
B
AR
3D C
HART
This type of chart is very similar to the Bar 3D chart in that it wraps together a Category 
dataset and a Bar 3D plot.
Listing 13-34. JRXML Syntax
<!ELEMENT stackedBar3DChart (chart, categoryDataset, bar3DPlot)>
L
INE
C
HART
Line charts are made of a Category dataset and a Line plot.
Listing 13-35. JRXML Syntax
<!ELEMENT lineChart (chart, categoryDataset, linePlot)>
XY L
INE
C
HART
This chart groups an XY dataset and a Line plot.
P
AGE
198
Documents you may be interested
Documents you may be interested