diff --git a/.gitattributes b/.gitattributes index 3e037f7765..104349c246 100644 --- a/.gitattributes +++ b/.gitattributes @@ -5178,6 +5178,7 @@ components/tachart/editors/tatooleditors.pas svneol=native#text/pascal components/tachart/fpdoc/descr.lst svneol=native#text/plain components/tachart/fpdoc/input.lst svneol=native#text/plain components/tachart/fpdoc/tachartaxis.xml svneol=native#text/plain +components/tachart/fpdoc/tachartaxisutils.xml svneol=native#text/xml components/tachart/fpdoc/tachartutils.xml svneol=native#text/plain components/tachart/fpdoc/tacustomseries.xml svneol=native#text/plain components/tachart/fpdoc/tadbsource.xml svneol=native#text/plain diff --git a/components/tachart/fpdoc/tachartaxis.xml b/components/tachart/fpdoc/tachartaxis.xml index 1fce3b4763..44123fe423 100644 --- a/components/tachart/fpdoc/tachartaxis.xml +++ b/components/tachart/fpdoc/tachartaxis.xml @@ -21,7 +21,7 @@ for vertical axises. Title is shown if Visible is true and Caption is not empty - Determines the side of the chart whcih the axis is aligned to + Determines the side of the chart to which the axis is aligned Left- and right-aligned axises are vertical, top- and bottom-aligned axises are horizontal. @@ -29,7 +29,8 @@ for vertical axises. Pen used for grid drawing Grid lines are drawn across the chart from each axis mark - + Inverts the axis scale from increasing to decreasing. + If true, the axis is drawn on the chart Invisible axis might still be used for series transformation @@ -40,7 +41,13 @@ for vertical axises.

If the source is set, marks are determined by X or Y coordinates of Source items for horizontal and vertical axises correspondingly.

-

Otherwise, marks are created automatically.

+

Otherwise, marks are created automatically.

+ +
+ + Axis of a chart +

TAChart uses four coordinate systems:

  • Axis coordinates (known in some other applications as object coordinates) -- this is the "raw" coordinate values obtained from the data. As the name implies, axis coordinates are interpreted in terms of specific axis -- the same coordinate value may have different meaning depending on the axis it is applied to.
  • Graph coordinates are converted from the axis coordinates using axis transformations, such as logarithmic scale. Graph coordinates are common for all objects in the chart.
  • Image coordinates (aka screen coordinates) are converted from graph coordinates based on the chart viewport. This transformation is always linear and can be influenced by chart tools such as zooming and panning.
  • Device coordinates are usually equal to screen coordinates, but may be adjusted to the drawing back-end to accommodate different physical resolutions (DPI values). See, for example, printer drawer.
  • +

You can add or remove an arbitrary number of axes by editing the AxisList property of the chart. By default, a chart has two axes: one horizontal and one vertical. They are accessible via the BottomAxis and LeftAxis properties. Note that those properties are aliases to AxisList[0] and AxisList[1], so if you remove those default axes, accessing BottomAxis and LeftAxis will return nil.

Visually, an axis consists of the axis line (drawn by AxisPen), grid lines (drawn by GridPen), ticks, marks and an arrow.

Each axis is drawn inside its own rectangle, determined by the size of mark labels and ticks. By assigning several axes the same positive Group number, you can have them share the same rectangular area. Grouped axes can be used to achieve a "panes" look, when several series are drawn on different portions of the same graph.

Axes with the same alignment, but different groups, are stacked alongside each other. You can use the Margin property to control the spacing between such axes.

diff --git a/components/tachart/fpdoc/tachartaxisutils.xml b/components/tachart/fpdoc/tachartaxisutils.xml new file mode 100644 index 0000000000..d45a5b64b0 --- /dev/null +++ b/components/tachart/fpdoc/tachartaxisutils.xml @@ -0,0 +1,38 @@ + +TChartBasicAxis is the ancestor of the chart's axis class

The basic axis consists of

+
  • ticks (short line strokes perpendicular to the axis direction)
  • marks, i.e. labels placed at the tick positions
  • grid lines starting at the tick positions and running across the entire chart
  • an optional arrow at the end of the axis line
  • +
+
+ +
If switched to false the axis is hidden along with ticks and labels. + Length of the (outer) axis ticks (in pixels)Inner length of the ticks + + Length of the inner axis ticks (in pixels)Length of the outer ticks + + Color of the axis ticks + Determines wether the axis has grid lines and how they are displayed + + Determines how the tick intervals of the axis are calculated. + + Defines the side of the chart at which the axis is shown + + Determines whether and how an arrow is drawn at the end of the axis + + Provides parameters how labels ("marks") are to be drawn at the axis + + Returns true when the axis is drawn in the opposite direction (right-to-left, or top-to-bottom)In TChartBasicAxis, the function always returns false. It is +overridden by its descendant TChartAxis + which +conisiders the state of the axis' +Inverted and chart's +BiDiMode properties. + + Creates the axis as an element of the specified chart and as a member of the axislist given as ACollection + + Destroys the axis and removes it from the collection to which it belongs. + Defines the parameters used to draw the grid of the axis. + + +
+
+
diff --git a/components/tachart/fpdoc/tachartutils.xml b/components/tachart/fpdoc/tachartutils.xml index 65841e4e2a..6e9fa728a9 100644 --- a/components/tachart/fpdoc/tachartutils.xml +++ b/components/tachart/fpdoc/tachartutils.xml @@ -6,9 +6,50 @@ Data type for a point with floating point coordinates X and Y
- Data structure for a rectangle with floating point coordinates defined by opposite corner points a and b - + Data structure for a rectangle with floating point coordinates defined by opposite corner points a and b or by a 4-element array + + + Enumeration of elements deciding whether a color will override a brush or pen color. + Set of elements deciding whether a color will override a brush or pen color. + + Dynamic array of + records (having integer coordinates) + Dynamic array of + records (having floating point coordinates) + Helper type which allows to interpret a TPoint record as an integer array.For a TPoint variable P, the type-cast TPointBoolArr(P)[b] returns +P.X when the boolean variable b is false, and +P.Y when it is +true. + + Helper type which allows to interpret a TDoublePoint record as a floating point array.For a + + variable +P, the type-cast +TDoublePointBoolArr(P)[b] returns +P.X when the boolean variable +b is +false, and +P.Y when it is +true. + + Data type for an interval of floating point numbers. + + Defines which information is displayed in the text of a series label + + Enumeration of two ways how text can be interpreted by TAChart: either directly or as being encoded in HTML. + diff --git a/components/tachart/fpdoc/tagraph.xml b/components/tachart/fpdoc/tagraph.xml index 6e858d9066..b93cf3859f 100644 --- a/components/tachart/fpdoc/tagraph.xml +++ b/components/tachart/fpdoc/tagraph.xml @@ -11,7 +11,18 @@ Main charting component. -

The chart is composed of list of series and fixed elements like legend, axes and footers.

Chart methods work with four coordinate systems: