ChartDirector Ver 4.1 (ColdFusion Edition)

ChartDirector.CFChart


ChartDirector.CFChart is the Java class representing the access point of the ChartDirector API. You may use the ColdFusion "CreateObject" function to set up a variable to represent ChartDirector.CFChart.

For example :

cd = CreateObject("java", "ChartDirector.CFChart");

In the ColdFusion edition of ChartDirector, constructors for the main chart objects are implemented as static methods of ChartDirector.CFChart. Predefined constants are implemented as static properties of ChartDirector.CFChart.

For example, to create an XYChart object, one has to call the cd.XYChart method, where cd is the variable representing ChartDirector.CFChart. Similarly, to access the NoValue constant, one has to use cd.NoValue.

Properties
NameDescription
NoValueA constant equals to 1.7E+308 to represent missing values in ChartDirector.
BottomLeftA constant equals to 1 to represent the bottom left position.
BottomLeft2A constant equals to 12 to represent the alternative exterior bottom left position.
BottomCenterA constant equals to 2 to represent the bottom center position.
BottomRightA constant equals to 3 to represent the bottom right position.
BottomRight2A constant equals to 13 to represent the alternative exterior bottom right position.
LeftA constant equals to 4 to represent the left position.
CenterA constant equals to 5 to represent the center position.
RightA constant equals to 6 to represent the right position.
TopLeftA constant equals to 7 to represent the top left position.
TopLeft2A constant equals to 10 to represent the alternative exterior top left position.
TopCenterA constant equals to 8 to represent the top center position.
TopRightA constant equals to 9 to represent the top right position.
TopRight2A constant equals to 11 to represent the alternative exterior top right position.
BottomA constant equals to 2 to represent the bottom position.
TopA constant equals to 8 to represent the top position.
TransparentA constant equals to FF000000 (in hex) to represent the transparent color.
BackgroundColorA constant equals to FFFF0000 (in hex) to represent the background color.
LineColorA constant equals to FFFF0001 (in hex) to represent the default line color.
TextColorA constant equals to FFFF0002 (in hex) to represent the default text color.
SameAsMainColorA constant equals to FFFF0007 (in hex) to represent the current main color.
PaletteA constant equals to FFFF0000 (in hex) to represent the starting index of the color palette.
DataColorA constant equals to FFFF0008 (in hex) to represent the starting index of automatic data color.
defaultPaletteA constant array of integers to represent the default palette.
whiteOnBlackPaletteA constant array of integers to represent the white on black palette.
transparentPaletteA constant array of integers to represent the semi-transparent palette.
NormalGlareA constant equals to 3 to represent using normal glare strength in ChartDirector.CFChart.glassEffect shading style.
ReducedGlareA constant equals to 2 to represent using reduced glare strength in ChartDirector.CFChart.glassEffect shading style.
NoGlareA constant equals to 1 to represent disabling the glare in ChartDirector.CFChart.glassEffect shading style.
DashLineA constant equals to 0505 (in hex) to represent a dash line pattern for use in dash colors.
DotLineA constant equals to 0202 (in hex) to represent a dotted line pattern for use in dash colors.
DotDashLineA constant equals to 05050205 (in hex) to represent a dot-dash line pattern for use in dash colors.
AltDashLineA constant equals to 0A050505 (in hex) to represent a alternating long/short dash line pattern for use in dash colors.
goldGradientA constant array of integers to represent a gradient that looks like a golden color.
silverGradientA constant array of integers to represent a gradient that looks like a silver color.
redMetalGradientA constant array of integers to represent a gradient that looks like a red metallic color.
blueMetalGradientA constant array of integers to represent a gradient that looks like a blue metallic color.
greenMetalGradientA constant array of integers to represent a gradient that looks like a green metallic color.
SquareShapeA constant equals to 1 to represent a square.
DiamondShapeA constant equals to 2 to represent a diamond shape.
TriangleShapeA constant equals to 3 to represent a triangle pointing upwards.
RightTriangleShapeA constant equals to 4 to represent a triangle pointing rightwards.
LeftTriangleShapeA constant equals to 5 to represent a triangle pointing leftwards.
InvertedTriangleShapeA constant equals to 6 to represent a triangle pointing downwards.
CircleShapeA constant equals to 7 to represent a circle.
DiamondPointerA constant equals to 0 to represent the diamond style meter pointer.
TriangularPointerA constant equals to 1 to represent the triangular style meter pointer.
ArrowPointerA constant equals to 2 to represent the arrow style meter pointer.
ArrowPointer2A constant equals to 3 to represent the alternative arrow style meter pointer.
LinePointerA constant equals to 4 to represent the line style meter pointer.
PencilPointerA constant equals to 5 to represent the pencil style meter pointer.
PNGA constant equals to 0 to represent the PNG image format.
GIFA constant equals to 1 to represent the GIF image format.
JPGA constant equals to 2 to represent the JPG image format.
BMPA constant equals to 4 to represent the BMP image format.
WMPA constant equals to 3 to represent the WAP bitmap image format.
NoAntiAliasA constant equals to 0 to represent that text should be drawn without using anti-alias.
AntiAliasA constant equals to 1 to represent that text should be drawn with anti-alias.
AutoAntiAliasA constant equals to 2 to represent that text should be drawn with anti-alias if necessary based on font attributes.
TryPaletteA constant equals to 0 to represent that palette based image format should be used if the image contains 256 colors or less.
ForcePaletteA constant equals to 1 to represent that palette based image format should always be used (dither the image if necessary).
NoPaletteA constant equals to 2 to represent that true color image format should always be used.
QuantizeA constant equals to 0 to represent that the quantize dithering method should be used if dithering is required.
OrderedDitherA constant equals to 1 to represent that the ordered dithering method should be used if dithering is required.
ErrorDiffusionA constant equals to 2 to represent that the error diffusion dithering method should be used if dithering is required.
SideLayoutA constant equals to 0 to represent the side label layout method for pie/donut charts.
CircleLayoutA constant equals to 1 to represent the circular label layout method for pie/donut charts.
SideA constant equals to 3 to represent the "Side" data representation method for multiple data sets.
StackA constant equals to 1 to represent the "Stack" data representation method for multiple data sets.
OverlayA constant equals to 0 to represent the "Overlay" data representation method for multiple data sets.
PercentageA constant equals to 4 to represent the "Percentage" data representation method for multiple data sets.
LogTickA constant equals to +1.6e308 to represent that the ticks in a log scale axis should be 1 - 2 - 5 - 10 style increments.
MinorTickOnlyA constant equals to -1.7e308 to represent that the label position should contain a minor tick only.
MicroTickOnlyA constant equals to -1.6e308 to represent that the label position should contain a micro tick only.
PixelScaleA constant equals to 0 to represent that the size is measured in pixels.
XAxisScaleA constant equals to 1 to represent that the size is measured using the x-axis scale.
YAxisScaleA constant equals to 2 to represent that the size is measured using y-axis scale.
AngularAxisScaleA constant equals to 1 to represent that the size is measured using the angular-axis scale.
RadialAxisScaleA constant equals to 2 to represent that the size is measured using the radial-axis scale.
XAxisAtOriginA constant equals to 1 to represent that the x-axis should intersect with the zero point of the y-axis if it exists on the chart.
YAxisAtOriginA constant equals to 2 to represent that the y-axis should intersect with the zero point of the x-axis if it exists on the chart.
XYAxisAtOriginA constant equals to 3 to represent that the x-axis and y-axis should intersect at the origin if it exists on the chart.
XAxisSymmetricA constant equals to 1 to represent that the x-axis should be symmetrical about the origin.
XAxisSymmetricIfNeededA constant equals to 2 to represent that the x-axis should be symmetrical about the origin if the data contain both positive and negative values.
YAxisSymmetricA constant equals to 4 to represent that the y-axis should be symmetrical about the origin.
YAxisSymmetricIfNeededA constant equals to 8 to represent that the y-axis should be symmetrical about the origin if the data contain both positive and negative values.
XYAxisSymmetricA constant equals to 16 to represent that the the x-axis and y-axis should be symmetrical about the origin.
XYAxisSymmetricIfNeededA constant equals to 32 to represent that the x-axis and y-axis should be symmetrical about the origin if the data contain both positive and negative values.
NormalLegendA constant equals to 0 to represent that the legend keys order should follow the creation order of the data sets.
ReverseLegendA constant equals to 1 to represent that the legend keys order is the reverse of the creation order of the data sets.
NoLegendA constant equals to 2 to represent that no legend keys should be added to the legend box.
AutoGridA constant equals to -2 to represent that the number of columns in the legend box with grid layout is automatically determine.
ChartBackZA constant equals to 100 (in hex) to represent the z-order of the back surface of the chart.
ChartFrontZA constant equals to ffff (in hex) to represent the z-order of the front surface of the chart.
PlotAreaZA constant equals to 1000 (in hex) to represent the z-order of the plot area back surface of the chart.
GridLinesZA constant equals to 2000 (in hex) to represent the z-order of the grid lines of the chart.
TouchBarA constant equals to -1.7e-100 to represent that the bars in a bar layer should touch each others with no gap in between.
HLOCDefaultA constant equals to 0 to represent that the HLOC symbols should be drawn using the same color.
HLOCOpenCloseA constant equals to 1 to represent that the HLOC symbols should be drawn using two alternative colors based on whether the closing price is higher than the opening price.
HLOCUpDownA constant equals to 2 to represent that the HLOC symbols should be drawn using two alternative colors based on whether the closing price is higher than the previous closing price.
AggregateSumA constant equals to 0 to represent using the sum as the aggregated value in ArrayMath.aggregate.
AggregateAvgA constant equals to 1 to represent using the average as the aggregated value in ArrayMath.aggregate.
AggregateStdDevA constant equals to 2 to represent using the standard deviation as the aggregated value in ArrayMath.aggregate.
AggregateMinA constant equals to 3 to represent using the minimum value as the aggregated value in ArrayMath.aggregate.
AggregateMedA constant equals to 4 to represent using the median value as the aggregated value in ArrayMath.aggregate.
AggregateMaxA constant equals to 5 to represent using the maximum value as the aggregated value in ArrayMath.aggregate.
AggregatePercentileA constant equals to 6 to represent using the percentile value as the aggregated value in ArrayMath.aggregate.
AggregateFirstA constant equals to 7 to represent using the first value as the aggregated value in ArrayMath.aggregate.
AggregateLastA constant equals to 8 to represent using the last value as the aggregated value in ArrayMath.aggregate.
AggregateCountA constant equals to 9 to represent using the item count as the aggregated value in ArrayMath.aggregate.
BoxFilterA constant equals to 0 to represent a Box graphical re-sampling filter.
LinearFilterA constant equals to 1 to represent a Linear graphical re-sampling filter.
QuadraticFilterA constant equals to 2 to represent a Quadratic graphical re-sampling filter.
BSplineFilterA constant equals to 3 to represent a B-spline graphical re-sampling filter.
HermiteFilterA constant equals to 4 to represent a Hermite graphical re-sampling filter.
CatromFilterA constant equals to 5 to represent a Catrom graphical re-sampling filter.
MitchellFilterA constant equals to 6 to represent a Mitchell graphical re-sampling filter.
SincFilterA constant equals to 7 to represent a Sinc graphical re-sampling filter.
LanczosFilterA constant equals to 8 to represent a Lanczos graphical re-sampling filter.
GaussianFilterA constant equals to 9 to represent a Gaussian graphical re-sampling filter.
HanningFilterA constant equals to 10 to represent a Hanning graphical re-sampling filter.
HammingFilterA constant equals to 11 to represent a Hamming graphical re-sampling filter.
BlackmanFilterA constant equals to 12 to represent a Blackman graphical re-sampling filter.
BesselFilterA constant equals to 13 to represent a Bessel graphical re-sampling filter.
MouseUsageDefaultA constant equals to 0 to represent using the default mouse behaviour.
MouseUsageScrollA constant equals to 2 to represent using the mouse for drag scrolling.
MouseUsageZoomInA constant equals to 3 to represent using the mouse for zoom in actions.
MouseUsageZoomOutA constant equals to 4 to represent using the mouse for zoom out actions.
DirectionHorizontalA constant equals to 0 to represent that the zoom and/or scroll orientation is horizontal.
DirectionVerticalA constant equals to 1 to represent that the zoom and/or scroll orientation is vertical.
DirectionHorizontalVerticalA constant equals to 2 to represent that the zoom and/or scroll orientation can be both horizontal and vertical.

Methods
NameDescription
PieChartCreates a new PieChart object.
XYChartCreates a new XYChart object.
PolarChartCreates a new PolarChart object.
AngularMeterCreates a new AngularMeter object.
LinearMeterCreates a new LinearMeter object.
MultiChartCreates a new MultiChart object.
FinanceChartCreates a new FinanceChart object.
DrawAreaCreates a DrawArea object.
ArrayMathCreates an ArrayMath object and initialize it with the given array.
RanTableCreates a RanTable object.
FinanceSimulatorCreates a FinanceSimulator object.
WebChartViewerCreates a new WebChartViewer object.
setLicenseCodeSets the license code into ChartDirector.
getVersionGets ChartDirector version information.
getBootLogA diagnostic function to obtain the ChartDirector boot log.
testFontA diagnostic function to perform a font loading test.
chartTimeObtain the second elapsed since 01-01-0001 00:00:00 to the given time, which is the date/time format used by ChartDirector.
chartTime2Converts a UNIX time (seconds elapsed since 01-01-1970 00:00:00 GMT) to the date/time format used by ChartDirector.
getChartYMDGets the year, month and day represented by a ChartDirector date/time.
getChartWeekDayGets the weekday represented by a ChartDirector date/time.
CTimeConverts a ColdFusion date to ChartDirector's date/time format.
CTime2Converts an array of ColdFusion date objects to ChartDirector's date/time format.
NTimeConverts a date/time in ChartDirector's date/time format to a ColdFusion date object.
NTime2Converts an array of dates/times in ChartDirector's date/time format to ColdFusion date objects.
goldColorCreates a golden color, most commonly used as a background color.
silverColorCreates a silver color, most commonly used as a background color.
metalColorCreates a color by modulates the brightness of another color to create metallic shiny effects.
glassEffectA complex shading effect that emulates tinted glass or semi-transparent plastic material.
softLightingA special shading effect that looks like gradient coloring.
PolygonShapeGets the shape id that represents a polygon.
Polygon2ShapeGets the shape id that represents a polygon in an alternative orientation.
StarShapeGets the shape id that represents a star shape.
CrossShapeGets the shape id that represents a '+' shape.
Cross2ShapeGets the shape id that represents a 'X' shape.
StartOfHourFilterCreates a data filter that matches date/times that represent the start of a new hour in a date/time series.
StartOfDayFilterCreates a data filter that matches date/times that represent the start of a new day in a date/time series.
StartOfWeekFilterCreates a data filter that matches date/times that represent the start of a new week in a date/time series.
StartOfMonthFilterCreates a data filter that matches date/times that represent the start of a new month in a date/time series.
StartOfYearFilterCreates a data filter that matches date/times that represent the start of a new year in a date/time series.
RegularSpacingFilterCreates a data filter that matches 1 out of every N elements.
AllPassFilterCreates a data filter that matches every element.
NonePassFilterCreates a data filter that matches no element.
SelectItemFilterCreates a data filter that matches the specified item.