Scientific & Business Charts Library Version 1.03,   May 2001,   © K.V.Vorontsov, MICEX

WARNING: This document was translated authomatically from Russian ChartLib documentation by translation program PROMT.  Author do not responds for its quality.  If you are interested in good translation, mail me please.

The library allows to build a graphics of the following types

•  Bidimentional a graphics, containing points, lines and the filled squares.
• Bidimentional a graphics with an explosive horizontal axis, in particular lasting many days a graphics.
• Some bidimentional diagrams on one slide with possibility of synchronization on one or several axes.
• Exchange a graphics with automatic classification of points in interval histograms or the Japanese candles.
• Vertical and horizontal histograms.
• Pie charts.
• Network and tree charts.
• Three-dimensional a graphics, containing points, trajectories, tapes and figures.
• Three-dimensional surfaces.

•  Loading from a text file of CHD format CL_DataFile function. {CL_DataFile}
• Transmission of stream of text strings(lines) through CL_DataLine function. {CL_DataLine}
• Transmission of the dataflow through CL_DataVector function. {CL_DataVector}
• Transmission of the interface of a data access through CL_DataMatrix function. {CL_DataMatrix}

•  The window or any other device of a Windows having a context.
• The file of graphics WMF format or EMF.
• The file of graphics GIF format.

•  ChartLib library.

Contains a base set of functions for conversion of the dataflow in a graphics image. It is most convenient for on-line generation of GIF-maps in Internet. It is intended for programmers.
•  TSliChart components.

Expands base possibilities ChartLib under Delphi, simplifies construction of diagrams in user's applications. It is intended for programmers.
•  ChdView utility.

The application for review of the CHD-files, intended for end users. Creation of CHD-files needs knowledge of CHD format described in the given manual.

•  Dynamic ChartLib.dll library.
• ChdView utility for interactive review of diagrams. {chdView}
• ChdConv utility for converting CHD-files in WMF, EMF and GIF. {chdConv}
• Examples of CHD-files.
• Documentation.
• The initial code TSliChart component for Delphi.
• The initial code of chdView utilities and chdConv.
• Demonstration examples of applications on Visual C ++ and Delphi with the initial codes.

---

Introduction: entry CHD format

• Strings(lines) of the data
• Objects: films, slides, panels, areas
• Areas on panels 2D, pie, text and on slides
• Strings(lines) of controlling commands
• Example 1: there Is enough only two commands
• Example 2: And nevertheless it is not enough two commands
• Example 3: Some diagrams on a slide
• Example 4: Exchange tenders - a unusual camera angle
• Example 5: it Is possible to do without the data

Syntax of CHD format

Strings(lines) can be two sorts: controlling commands and the data. Controlling commands differ the character * in the first position. Empty strings(lines) are ignored. The strings(lines) starting with **, are perceived as the comment and also ignored. If at the end of string(line) there are dots "...", she(it) is prolonged for the following string(line).

 Introduction: Syntax of strings(lines) of the data

Values inside text string(line) of the data are divided by commas or tab characters. The values containing a current separator, it is necessary to quote. The list of valid separators and characters of quotes can be changed Syntax command. {Syntax}

Dates are set in [[[YY YY/M M/D D format or D [D]/M [M]/YYYY. Time sets in hh format [:mm [:ss]]. Date and time are separated by a blank or it is familiar underlines. If date is given only, time is necessary equal 00:00:00. If time is given only, as date option value SystemDate or system (today's' date if this parameter is not given takes. Date / time also it is possible to set values of type the integers compatible to time_t type of the language With, usually such number is interpreted as number of seconds, past since midnight January, 1, 1970.

In strings(lines) of the data empty values are admitted. They are set or skip of value (two separators in succession), or three questions???. Skip in the data is handled as follows. If this essential given, such as coordinate of a point an appropriate unit a graphics - a point, the line or square is not displayed. If it is the auxiliary parameter, such as the form or color of a point at mapping the default value is used.

 Introduction: Objects

•  Films
• Slides
• Panels
• Areas

The slide creates NewSlide command. The created slide at once becomes active - all subsequent commands and strings(lines) of the data will concern to it(him). To switch an active slide it is possible at any moment with the help of Slide command. {Slide} {NewSlide}

Films
Film is a sequence of slides. At review of a slide in the window the user has possibility to switch from one slide on another inside one film.

The slide is inserted into film by SetFilm command. The slide can not belong to several films simultaneously. Inside film slides allocate by way of their creation. {SetFilm}

To set a name of film it is possible also at creation of a slide by NewSlide command. By default, if the name of film is not given, the slide is inserted into film with a name default.

Panels on slides
The slide can contain one or several diagrams, text boxes and a legend. The diagram together with auxiliary areas adjoining to it(him) (headers, axes and their names) will derivate the panel. Each panel has a unique name which gives it(her) at creation by NewPanel command. The created panel at once becomes active, and the input stream of commands is routed to it(her). Any panel can be made active by name or to a serial number on a slide Panel command. {Panel} {NewPanel}

If on a slide some panels are created, their allocation and relative sizes are set by Group command. Without this command of the panel have an identical size and are placed the friend under the friend. {Group}

To use SetFilm commands, NewSlide and NewPanel in obvious sort not necessarily. If them to not use, film default with a unique slide default, containing the unique panel with a name default will be automatically created.

Areas on panels
For creation of appearance of panels properties of separate areas on panels of a slide will be updated. The list of areas of which panels of various types are made below is resulted.

 Areas on panels 2D

Areas on panels pie

Areas on panels text

Areas on slides

Introduction: Syntax of controlling commands

Controlling commands are three sorts:

* имя_объекта. имя_параметра = value
* имя_параметра = value
* имя_объекта = value

In the second case the name of the object is lowered(omitted), and the command concerns to the current object on a slide. For all diagrams it is Chart object. If on a slide some panels with the diagrams, current are considered Chart object on the panel, activated last Panel command or NewPanel. The current panel also is the object, and to it(her) it is possible to address by name Panel or by name, given it(her) at creation by NewPanel command. {Panel}

In the third case the name of the parameter is lowered(omitted), and the command concerns to main property of the object. For headers, names of axes and other text objects main property is Text, for a legend - Line. For example, the following commands are equivalent:

*Title. Text = the diagram of dependence
*Title = the diagram of dependence

Some commands do not concern to one of objects. They are for handle of slides and installation of preferences.

The equal-sign can be substituted a blank. Names of commands are case-sensitive: for example, Visible=on command is true, and visible=on command - is not present, and will be ignored. {Visible}

 Introduction: the Example 1
There is enough only two commands

NewData command creates a new matrix of the data with the given columns and does(makes) its(her) current. The number of values in each subsequent string(line) of the data should be equaled to quantity(amount) of columns in a matrix.

Series command creates a series of points on a graphics and describes its(her) properties, such as X-coordinate, Y-coordinate, color, the form of a point etc. Each property can be either a constant, or a name of a column of the data from any matrix of a current slide. Cвойства points are in detail described in section of a Series.

The following diagram shows the speaker of the prices and sizes of tenders by actions(shares) of the company ONIONS(BOW) ОЙЛ on the Moscow Interbank Stock Exchange since February till November, 1999.

The diagram was constructed on an input stream containing on 3 values in each string(line): date, the price and size. Each string(line) corresponded(met) to one day. The initial fragment of an input stream below is resulted:

*NewData day, price, value
*Series X=day Y=price S=0 LC=1
*Series X=day Z=value S=0 LC=3
28/01/99 25.35 216335
29/01/99 25.68 124938
01/02/99 25.57 10226
...

 Introduction: the Example 2
And nevertheless it is not enough two commands

*Locale = rus
*Slide. Background = 17 17 7 7, bidir
*Slide. GradMaxSize = 2
*Title Tenders by actions(shares) ONIONS(BOW) ОЙЛ, 1999
*YName = the price
*ZName = size, one million руб
*XAxis.Type = date
*YAxis. Color = 1
*ZAxis. Color = 3
*NewData day, price, value
*Let vmill = value / 1000000
*Series X=day Y=price S=0 LP=2 LW=2 LC=1
*Series X=day Z=vmill S=0 LP=2 LW=1 LC=3 FD=1 FP=2 FC=15
*Series X=day Z=0 S=0
28/01/99 25.35 216335
29/01/99 25.68 124938
01/02/99 25.57 10226
...

Introduction: the Example 3
Some diagrams on one slide

The data for this purpose a graphics the same, as in examples 1 and 2. The slide is divided into two panels by NewPanel commands. Group command places these panels the friend under the friend and speaks, that the upper panel is three times higher. CandleWidth command sets width of the Japanese candlesticks in seconds (here it is one week). {Group} {NewPanel}

** We define the data
*NewData day, price, value
*Let vmill = value / 1000000
*Slide. Background = 17 17 7 7, bidir
*Slide. GradMaxSize = 2

** We define the upper panel of the prices
*NewPanel price
*Title Tenders by actions(shares) ONIONS(BOW) ОЙЛ, 1999
*YName = the price
*XAxis. Type = date
*XAxis. Visible off
*Series X=day MC=price MS=2 C=7
*CandleWidth 604800

** We define the lower panel of sizes
*NewPanel volume
*Title. Border 0, 1, 0, 1
*Title. IndentVert 0
*XAxis. Type = date
*XAxis. SpaceVert 1
*XAxis. IndentVert 0
*Series X=day MC=vmill ML=0 MS=3 C=15
*CandleWidth 604800

** We allocate panels the friend under the friend, we shall clock axes
*Group (3,1 ( 1 ) main = price, volume
*SyncAxis price. XAxis, volume. XAxis

27/01/99 24.85 66913
28/01/99 25.35 216335
29/01/99 25.68 124938
...

Introduction: the Example 4
Exchange tenders - a unusual camera angle

Let's create one more panel and we shall place on it(her) гистограммную a series. Two additional commands are necessary for construction of the histogram of allocation. HorizHist speaks, that the histogram horizontal and each point is displayed separately inside a column. ColWidth command sets width of a column of the histogram.

** We define the data
*NewData day, price, value
*Let vmill = value / 1000000
*Slide. Background = 17 17 7 7, bidir
*Slide. GradMaxSize = 2

** We define the upper panel of the prices
*NewPanel price
*Title Tenders by actions(shares) ONIONS(BOW) ОЙЛ, 1999
*YName = the price
*XAxis. Type = date
*XAxis. SpaceVert 1
*XAxis. IndentVert 0
*XAxis. RulePose both
*Series X=day MC=price MS=2 C=7
*CandleWidth 604800

** We define the lower panel of sizes
*NewPanel volume
*Title. IndentVert 0
*XAxis. Type = date
*XAxis. Visible off
*Series X=day MC=vmill ML=0 MS=3 C=15
*CandleWidth 604800

** We define the right panel with the histogram of sizes
*NewPanel hist
*HorizHist = detailed
*ColWidth=5
*YAxis. Visible off
*Series Y=price HW=vmill HS=time C=15

** We allocate panels the friend under the friend, we shall clock axes
*Group (3,1 ( 2,1 ) main = price, hist, volume
*SyncAxis price. XAxis, volume. XAxis
*SyncAxis price. YAxis, hist. YAxis

27/01/99 24.85 66913
28/01/99 25.35 216335
29/01/99 25.68 124938
...

Introduction: the Example 5
It is possible to do without the data

*Let x = pointno/5-4
*Let y = FNorm (x)
*ResizeData 40
*Series X=x Y=y

---

Controlling commands

• The common properties applied to all objects
• Properties of text boxes
• Properties of a legend
• Properties of axes
• Flow control
• Properties of diagrams and histograms
• Properties of histograms
• Parameters of three-dimensional maps
• Commands of handle of slides and films
• Panels on slides
• Commands of the interactive mode
• Global commands
• Debug commands
• Anachronisms
• Color box

•  Valid values of parameters are selected(allocated) bold. As well as commands, they are case-sensitive. Therefore Visible=on command is true, and Visible=On command - is not present.
• Optional parameters of commands consist in square brackets [...]
• Properties with value b are булевскими (logical) and accept values on, yes, true or 1, designating "yes", and off, no, false or 0, designating "are not present".
• Properties with value color are the color number in a color box.

---

Commands: the Common properties applied to all objects

 Visible = b

 Color = color

 BorderColor = color

 Border = wL [, wT, wR, wB]

 Border3D = we, wi

 Background = color

 Background = LT, TR, RB, BL [, bidir]

 Background = off

 Transparency = n

 GradMaxSize = n
GradMinCells = n

 FontStyle = style

 IndentHoriz = n

 IndentLeft = n
IndentRight = n

 IndentVert = n

 IndentTop = n
IndentBottom = n

 SpaceHoriz = n

 SpaceVert = n

 MinWidth = len
MinHeight = len

 Style = style_name

*DefStyle bsty
    *Background 17
    *Border 2
*EndStyle
*XAxis. Style bsty

*XAxis. Background 17
*XAxis. Border 2

*Slide. Style bsty

---

Commands: Properties of text boxes

 Text = text

*Title. Text = the diagram of sine
*Title = the diagram of sine

Justify = s

 Shadow = x, y, t, s

---

Commands: Properties of a legend

 Line = list-text

*Legend  C=5 S=3 W=8 LC=3 LW=2 bargains

PlacingStyle = s

 PatternWidth = n
PatternHeight = n

---

Commands: Properties of axes

 Type = type

 DateTimeRange =  date1 - date2, time1 - time2

 Ranges = min₁ , max₁ [, per₁ , n₁]   |... |   min_N , max_N [, per_N , n_N]

[ min,  max],
[ min + per,  max + per],
... And so on up to...
[ min + (n-1) per,  max + (n-1) per].

 SyncMaster = b

 Rule = width, depth, tickext, tickint
Rule = off

 RulePose = s

 RuleColor = color

 SpaceInterv = p

 DateFormat = format

 LabelFormat = format

 Labels = b

 Justify = s

---

Commands: Flow control

 NewData n = [type₁] name₁ ..., [type_N] name_N

 Data = n

 ClearData = n

 DeleteData = n

 Let [type] name = expr

 ResizeData n rows

---

Commands: Properties of bidimentional diagrams and histograms

 Series name: property₁=value₁ ..., property_N=value_N

 SeriesModify name: property₁=value₁ ..., property_N=value_N

 SeriesOn = name
SeriesOff = name

 ExtraX = min [, max]
ExtraY = min [, max]
ExtraZ = min [, max]

 CandleWidth = n

 CandleBase = n

 ZoomX = x1, x2
ZoomX = min, x
ZoomX = max, x
ZoomX = max

 ZoomY
ZoomZ

 SyncYZ = y0, z0
SyncYZ = max
SyncYZ = off

 EmptyIntervals = b

 AutoScaleX = s
AutoScaleY = s
AutoScaleZ = s

 RobustPoints = n
RobustLimit = n

 RobustFactor = n

 VGrid = n

 HGrid = n

 GridOverFills = b

 GridColor = color

 SelectColor = color

 ActiveColor = color

 HighlightColor = color

 ShowTN = s

 PoseTN = s

 ShowLN = s

 TableTitle = text

 ArrowSize = n
ArrowAngle = n

 StatusOnMouseMove = expr

StatusOnMouseMove = " [CoordXText]; [CoordYText] "

 StatusOnMouseDrag = expr

StatusOnMouseDrag = " [CoordXStartText] - [CoordXText];  [CoordYStartText] - [CoordYText] "

---

Commands: Properties of histograms

 VertHist = type

 HorizHist = type

 nCols = n
nPointsPerCol = n
ColWidth = n

 ColumnsThickness = n

 AverageColors = b

 OutlineColumns = b

---

Commands: Parameters of three-dimensional maps

 ViewTheta = f

 ViewFi = f

 ViewPersp = f

 ViewScaleX = f
ViewScaleY = f
ViewScaleZ = f

---

Commands: Handle of slides and films

 NewSlide = name

 NewSlide

 Slide = nslide

name film  a slide with a name name in film film;
n film     a slide with number n;
< < film    the first slide;
> > film    the last slide;
< n         a slide with number, on n smaller numbers of a current slide;
> n         a slide with number, on n big numbers of a current slide;
<          the previous slide;
>           The following slide;

 SlideMove = nslide

 DataSlide = nslide
DataSlide off

 ClearSlide

 DeleteSlide

 SetFilm = name

 DeleteFilm = name

---

Commands: Panels on slides

 NewPanel n [: type]

 Panel = n

 Group (hrows) (wcols)  group = panels

Example: the command

*Group (2,1 ( 2,1,1 ) gr5 = p1, p2, p3, p4, p5

If the slide has some panels, and Group command is absent, vertical grouping Group (1 is by default applied..., 1) (1).

 SyncAxis = panel₁.axis₁ ...,  panel_N.axis_N

 TitlePose = s

 TitleBelowPose = s

 XNamePose = s

 LegendPose = s

 About = text

---

Commands: Parameters of the interactive mode

 SelectShape = s

 SelectMode = s

 SelectOutside = b

 Cursor = s

 DrawBlockSize = n

---

Commands: Preferences

 DefColor color = R, G, B

 DefFont style = library: family,  width x height,  flags, angle

library
The name of the font library depending on the operating system and current implementation ChartLib. In the present version two libraries of fonts are supported:
    Win - the fonts of a Windows used at drawing in the window and EMF files or BMP;
    GdFont - the fonts used at creation of GIF files.
To each style style there corresponds(meets) the defined font in each library library. The parameter can not be lowered(omitted).

family
The name of the set of the font, accepted in the given font library library.

width
Width of characters in pixels. If width parameter is lowered(omitted) or equal to zero, the proportional font is selected.

height
Height of characters in pixels.

flags
Flags of additional properties of the font, encoded by characters:
    B - bold,
    b - bold,
    I - oblique,
    U - underlined,
    S - crossed.
If flags parameter is lowered(omitted), the normal font is selected.

angle
Corner of turn of the font in degrees counter-clockwise. If it is lowered(omitted), 0 - the text allocates horizontally from left to right.

Example:

*DefFont  title = Win: Times New Roman, 8x20, BI
*DefFont  title = GdFont: Courier, 9x15, BI

DefStyle = style_name

 EndStyle

 Syntax = usage₁ { symbols₁}... usage_N { symbols_N }

*Syntax = C {*} N. T {:} D {/} Q {" "} F {\t,}

Locale = text

 Encoding = char

 OutEncoding = char

 SystemDate = date
SystemDate = today

 Include filename

---

Commands: Resources of debugging

•  The broad gully - file. Contains the protocol of all error messages by way of their arrival. The name of the broad gully - file is installed by interface CL_WorkDebug function. The broad gully - file is disabled by call CL_WorkDebug (0). By default the broad gully - file is disconnected. {CL_WorkDebug}
• The dump - file. It is used for obtaining the auxiliary and debug information by **Dump * commands. Includes / disables DumpFile command, it is by default disconnected. {DumpFile}
• The echo - file. Contains an exact copy of an input stream of strings(lines), including the data transmitted through interface CL_DataVector function, but not including the data transmitted through CL_DataMatrix.  Includes / disables EchoFile command, it is by default disconnected. {EchoFile} {CL_DataVector}

DumpFile  [filename]

 DumpData  expr

 DumpDataStructure

 DumpSeriesStructure

 DumpSlideStructure

 DumpSlidesList

 DumpPcode  expr

 EchoFile  [filename]

 Echo str

---

Commands: Out-of-date commands

 Format = format

Controlling Format command combines in itself NewData commands, Let and Series. Owing to the extreme congestion she(it) will not be supported in the following versions of the library. Matrix commands are closely connected to it(her), MatrixClear, MatrixEnable and SeriesSize also considered out-of-date. Instead of them it is recommended to use NewData commands, Data, ClearData, ResizeData, SeriesOn and SeriesOff. {NewData} {Matrix} {NewData}

Format command sets properties of series with the help of the property list the same as it is done(made) with Series command, but with the following differences:

•  It is possible to set at once some series in one command, having separated their characters / or \;
• As values of properties it is authorized to set not only numerical constants, names of columns of the data and variables, but also the arbitrary expressions made in parentheseses, and also string constants with inserts;
• For property can be not indicated in general any value (the equal-sign in this case also is omitted(dropped));
• The command defines(determines) a new matrix of the data which columns correspond(meet) to all properties of all series for which it is not indicated any value;
• If property X for a series is lowered(omitted), it will be taken for the previous series.

The description 1

*Let x = pointno/10-4
*Let y = exp (-x^2/2)
*Let z = FNorm (x)
*Series p: X=x Y=y S=0 LC=13 LW=2
*Series f: X=x Z=z S=0 LC=33 LW=2
*SeriesSize 80: f, p

*Format X = (pointno/10-4) Y = (exp (-X^2/2)) S=0 LC=13 LW=2...
    \ Z = (FNorm (X)) S=0 LC=33 LW=2
*SeriesSize 80

SeriesSize = size:  name₁ ..., name_N

 Matrix = n
Matrix = name

 MatrixClear [= n]

 MatrixEnable = [n], b

---

Commands: the color Box

The standard graphic palette of ChartLib library contains 27 colors with numbers from 0 up to 26. DefColor command allows to add new colors and to reassign already available. The changes made in a color box, are global, and influence all slides and films. {DefColor}

---

Properties of series

• Properties of points
• Properties боксов
• Properties of points in histograms
• Properties of points in exchange diagrams
• Properties of the lines connecting a point with adjacent
• Properties of lines of pair connections
• Properties of flood fillings
• Columns of the data (anachronism)

A series creates Series command. Each property of a series sets one or a two-letter name which the equal-sign and value follows. Value should be either a numerical constant, or a name of a column of the data defined by NewData commands or Let. Properties are divided by commas or blanks. {NewData} {Series}

For example, the following command will derivate a new series with a name priceline:

*Series priceline: X=time Y=price S=0 LP=2 LC=1

The created series can be reassigned anew, repeatedly having set Series command with the same name of a series and other values of properties. For example, to replace red color of lines on dark blue, it is necessary to give the command

*Series priceline: X=time Y=price S=0 LP=2 LC=3

*SeriesModify priceline: LC=3

The name of a series can be omitted(dropped) at creation of a series. However if after that to define(determine) one more series access to the first for Series commands, SeriesOn, SeriesOff, SeriesModify and SeriesSize will be closed for ever.

The number of points in a series is equal to maximum length of columns of the data indicated in properties of a series. Usually all columns have identical length, however this condition is not mandatory. Missing values are interpreted as empty.

If properties of a series do not refer to one column of the data defined by NewData command the number of points in such series is by default equal to zero. That in the obvious image to set number of points, it is necessary to use SeriesSize command or ResizeData. {SeriesSize} {NewData}

Properties of series: Parameters of points

 X

 Y

 Z

 TX

 TY

 C

 G

 I

 W

 S

K

 U

 TI

TN

 TR

 TB

 TT

 TQ

 TC

---

Properties of series: Боксов parameters

 BX

 BY

 BZ

---

Properties of series: Parameters of histograms

 HS

 HW

---

Properties of series: Parameters of exchange diagrams

 X

 MC

 MO

 MH

 ML

 MS

MT

 C

 G

 I

 LC, LG, LI

 TN, TR, TB

---

Properties of series: Parameters of lines

 LC

 LG

 LI

 LW

 LS

LP

LD

 LA

---

Properties of series: Parameters of pair connections

 PA

 PB

 LB

---

Properties of series: Parameters of flood fillings

 FC

 FG

 FI

 FS

FD

FP

---

Properties of points in series: Columns of the data

 DB

 DR

 DT

---

Usage of expressions

• Data types and constants
• Variables
• Strings(lines) with inserts
• Formats of output of numbers
• Formats of output of dates
• Operations and their priority
• Functions

Expressions are created from variables, constants, signs of operations, functions, and brackets of any level of an enclosure.

In a role of variables names of columns of the data entered by NewData commands and Let appear. Names of variables can consist of any characters, however if the name contains special symbols (signs of operations, brackets) or blanks, it is necessary to conclude it(him) in apostrophes. {NewData}

The scope of names is limited to a current slide. To address to the column of the data defined on the other slide, it is necessary to use " a name with a point ":

ИмяСлайда. ИмяСтолбцаДанных

 Expressions: Data types and constants

•  Logical bool (0 or 1);
• Whole int (4-байта);
• Material with double precision real;
• String string (strings(lines) of arbitrary length);
• Date - time datetime (number of seconds, past since January, 1 1970);
• Error error.

It is possible to set integer constants both in a decimal number system, and in binary or hexadecimal, for example:

0b0100.1010 - binary 74
0xFFFF - hexadecimal 65535

Real constants are set or in the exponential form, or with a floating point: 2.345e+8, 345E-8, 20.345.

String constants are written in rabbit earses. It is possible to include characters in string constants with any codes, including quotes and unprintable special symbols:
    \ooo - the character given by decimal ooo code
    \xHH - the character given by hexadecimal HH code
    \a - AlertBel character,  \x07
    \b - Backspace character,  \x08
    \t - HorizontalTab character,  \x09
    \n - Newline character,  \x0A or \x0D \x0A
    \v - VerticalTab character,  \x0B
    \f - Formfeed character,  \x0C
    \r - CarriageReturn character,  \x0D
    \\ - the character of return(converse) слэша \
    \ " - the character of a rabbit ears "

Constants of date - time are set as string with conversion of type: datetime (" 2005/08/21 11:15:20 "). By default a separator of year, month and day in dates is the character "/". The separator can be changed Syntax command.. {Syntax}

Non-initialized values to which in a matrix of the data there corresponds(meets) skip or???, matter empty. Conversion empty to numerical types gives 0, to the string type - "empty".

By default in the library values of some constants which can be used in all expressions are predetermined:

empty;
false   = int (0);
true    = int (1);
PI      = 3.1415926535897931;
MINUTE  = long (60);
HOUR    = long (60 * 60);
DAY     = long (60 * 60 * 24);
WEEK    = long (60 * 60 * 24 * 7);

Expressions: Variables

 Characteristics of a current matrix of the data

 Characteristics of a current candle

 Characteristics of a point of a slide

•  In Status command for creation of the text статусной the strings(lines), output at cursor update of the mouse; {Status}
• In the expressions transmitted to interface CL_ChartGetXYInfo function   for obtaining of the information on a point of a series, the nearest to the indicated point of a slide. {CL_ChartGetXYInfo}

Variables with suffix Text contain the values of coordinates optimally formatted in view of a current scale a graphics.

 Expressions: Strings(lines) with inserts

" The Number пи = " and PI and ", is more exact пи = " and format (" % .16f ", PI) and "."
" The Number пи = [PI], is more exact пи = [PI %.16f]. "

The number пи=3.14159, is more exact пи=3.1415926535897931

 Expressions: Formats of output of numbers

•  [flag] - a combination of flags-, +, 0, a blank, *;
• [width] - minimum length of output string(line) in characters;
• [.prec] - number of signs after a comma at output of real numbers.

 Expressions: Formats of dates and times

" Today [now () % *d %B %Y, %A, %H: % M: % S]. "

Today 4 February 2000, Monday, 15:04:55

Formats of date - time d, x, X clash with the same numerical formats. If one of these characters appeared last in the format of date - time, after it(her) it is necessary to put T character:

" Today [now () % *xT]. "

Expressions: Operations and their priority

The priority of operations can be changed with the help of brackets.

Operations of assignment and sequential calculation are used for abbreviation(cutting) of recording and rise of speed of calculations. The sense of these operations and their usage are completely similar to C language. For example, the following two expressions produce the same result, but the second is calculated more effectively:

exp (23.67*x*x+1.2905*x-45.892) + 1/exp (23.67*x*x+1.2905*x-45.892)
T: = exp (23.67*x*x+1.2905*x-45.892),  T+1/T

Result of the operation of sequential calculation is the last expression in the list.

Variables, standing assignments in the left part are local variables of the given expression and should not coincide with names of columns of the data.

Small difference from traditional programming languages is present in operations of matching. Recording 0 < = x < 1 is correct and is abbreviation(cutting) of longer expression 0 < = x  and  x < 1, that is has usual mathematical sense. Chains of matchings of the arbitrary length, including any of 6 operations of matching, for example 0 < x < = y1 = y2 > 1 are admitted.

 Expressions: Functions

On number of arguments of the function are divided into 4 groups:

•  Functions with the fixed number of arguments (sqrt, sin, exp, mod).
• Functions with optional arguments (log, rand, setbit).
• Functions with arbitrary number of arguments (min, if, steps, xor).
• Functions without arguments (now (), rand ()).

Below the complete list of valid functions with their specifications and descriptions is resulted. Specifications specify types of all arguments and returned value.

Specifications are resulted as

имя_функции (типы_входных_аргументов): тип_значения

 Expressions: Functions of type conversion

Bool (any): bool

Conversion any in the logical type

Int  (any): int

Conversion any in the whole type

Real (any): real

Conversion any in the material type

String (any): string

Conversion any in string the type

Datetime (any): datetime

Conversion any in date and time

Expressions: Functions of check of values

IsEmpty (any): bool

TRUE if any empty or erratic

IsNumber (any): bool

TRUE if any it is resulted(brought) in real type

IsTime (any): bool

TRUE if any it is resulted(brought) to datetime

Expressions: Numerical functions with the fixed number of arguments

Abs  (real): real

Absolute value (unit) of number real

Sign (real): int

сигнум numbers real, accepts values:-1 at real < 0;   0 at real=0;   1 at real > 0

Max  ({real}): real

Maxima of numbers

Min  ({real}): real

Minimum of numbers

Sqrt (real): real

The square root of number real

Sin  (real): real

Sine of number real

Cos  (real): real

Cosine of number real

Tg   (real): real

Tangent of number real

Arcsin (real): real

Arcsine of number real

Arccos (real): real

Arccosine of number real

Arctg (real): real

Arctangent of number real

Sh   (real): real

Hyperbolic sine of number real

Ch   (real): real

Hyperbolic cosine of number real

Th   (real): real

Hyperbolic tangent of number real

Exp  (real): real

Exponential curve of number real

Log  (real, [real2]): real

Log real1 on the basis real2, or natural if real2 it is lowered(omitted)

FNorm (real, [real1], [real2]): real

The function of normal allocation with МО=real1 and СКО=real2.
If real2 it is lowered(omitted), it is necessary МО=0, СКО = real1.
If real1 and real2 are lowered(omitted), it is necessary МО=0, СКО=1.

rand ([real1], [real2]): real

Random number from a range [real1, real2), [0, real1) or [0,1)

round (real): real

Roundoff up to the nearest the whole

upround (real): real

The nearest greater or equal the whole (ceiling)

dnround (real): real

The nearest smaller or equal the whole (floor)

Expressions: Logical functions

Xor  (bool, {bool}): bool

Logical eliminating OR

Expressions: Bit functions for integers

Bit  (int1, int2): bool

int2-ый Bats in an integer int1

SetBit (int1, [int2], [bool]): int

To place(install) int1-ый bats of number int2 (0 if it is lowered(omitted)) in bool (1 if is lowered(omitted))

NotBit (int): int

Bit negation

OrBit (int, {int}): int

Bit OR

AndBit (int, {int}): int

Bit And

XorBit (int, {int}): int

Bit eliminating OR

Expressions: Functions for operation with date and time

now  (): datetime

Current date - time

time (any): datetime

Conversion any in datetime with selection of time

date (any): datetime

Conversion any in datetime with selection of date

year (datetime): int

Selection of year from datetime

month (datetime): int

Number of month in one year, indexing with 1

day  (datetime): int

Number for in one month, indexing with 1

hours (datetime): int

Selection of hours since midnight from datetime

minutes (datetime): int

Selection of minutes from datetime

seconds (datetime): int

Selection of seconds from datetime

WeekDay (datetime): int

Number of day of week, ВС=0, ПН=1..., СБ=6

YearDay (datetime): int

Number of day in one year

Expressions: Functions for operation with strings(lines)

len  (string): int

Length of string(line)

pos  (string1, string2): string

The position of string(line) string2 in string(line) string1, or (-1) if not is retrieved; indexing of characters of string(line) starts with 0

left (string, int): string

Head part of string(line) in length int

right (string, int): string

Tail of string(line) in length int

mid  (string, int1, int2): string

Average part of string(line) since a position int1 in length int2, indexing with 0

format (string, any): string

Formatted output any according to the specification given in string

Expressions: Conditional and threshold functions

if   ({bool1, any1}, [anyLast]): any

The conditional, returns:
    any1, if bool1=TRUE,
    any2, if bool2=TRUE,
    ... And so on...,
    anyLast if all odd arguments are equal FALSE.

steps (real1, {real}): int

The step-function, returns:
    0, if real1 < real2,
    1, if real2 < =real1 < real3,
    2, if real3 < =real1 < real4,
    ... And so on...

switch (any, {any1, any2} [anyLast]): any

The switch of values, returns:
    any2, if any=any1,
    any4, if any=any3,
    ... And so on...
    anyLast if all equalities are not true.

API: functions of ChartLib library

• Functions of initialization and completion
• Functions for operation with output devices
• Functions of loading of the data
• Functions of operation with slides
• Functions of operation with the diagram
• Interactive functions
• Example: the initial code of chdConv utility

*include "cl.h"

1.  Initialization of the library by CL_WorkStart function. {CL_WorkStart}
2. Creation of a slide by CL_DataLine functions, CL_DataVector, CL_DataFile. {CL_DataLine}
3. Creation new рисователя CL_DrawerCreate, or activation of old CL_DrawerUse.
4. Installation of sizes of slide CL_SlideSetRect on a surface рисователя,  in pixels.
5. Installation of viewport for all diagrams on slide CL_SlideMaxZoom or CL_ChartSetZoom.
6. Optimal allocation of areas on slide CL_SlideRefresh.
7. Drawing of a slide entirely CL_SlideDraw, or portions CL_SlideBeginDraw and CL_SlideContinueDraw.
8. The termination(ending) of operation CL_WorkFinish.

typedef const char* clString;

1.  If the string(line) is for data transfer in the interface function she(it) transfers as clString and the library can not update her(it).
2. If the string(line) is for returning the data from the interface function she(it) transfers as clString* and calling(causing) program should not update her(it).

API: the error Codes, returned by the interface functions

CL_ERR_NOTSTARTED =-1001;    // the library was not initialized by CL_WorkStart function
CL_ERR_CANTSTART =-1002;     // it is impossible to initialize the library
CL_ERR_EXCEPTION =-1005;     // the exclusive situation caught try-catch
CL_ERR_OPENLOG =-1008;       // it is impossible to open the broad gully - file
CL_ERR_SLIDE =-1011;         // there is no slide
CL_ERR_CHART =-1012;         // there is no diagram on a slide
CL_ERR_POINTINFO =-1015;     // there is no recording with the information on a point
CL_ERR_DRAWER =-1020;        // it is impossible to create or use indicated рисователь
CL_ERR_DRAWERUPDATE =-1021;  // current рисователь does not support the function of upgrade
CL_ERR_DRAWERSAVE =-1022;    // current рисователь does not support the function of saving
CL_ERR_DRAWERDELETE =-1023;  // it is impossible to delete active рисователь
CL_ERR_FILENAME =-1030;      // the filename is not given
CL_ERR_DATA =-1040;          // data errors are detected
CL_ERR_DATAMATRIX =-1041;    // it is impossible to place(install) structure of a matrix
CL_ERR_DATARECORD =-1051;    // recording for data reading from a vector - column is not defined
CL_ERR_VECTOR =-1052;        // on a slide there is no vector - column with the indicated name
CL_ERR_VECTORSIZE =-1053;    // in vector - column there is no string(line) with indicated number
CL_ERR_VECTOREADONLY =-1054; // it is impossible to write the data in a vector - column
CL_ERR_AREANOTFOUND =-1060;  // the slide has no such area
CL_ERR_AXIS =-1070;          // the diagram has no axis
CL_ERR_OVERZOOM =-1071;      // exceeding of valid accuracy at scaling a graphics
CL_ERR_NOSERIES =-1081;      // there is no such series
CL_ERR_NOPOINT =-1082;       // there is no such point in a series
CL_ERR_POINTSELECT =-1091;   // the point can not be selected(allocated)
CL_ERR_POINTACTIVE =-1092;   // there is no active point
CL_ERR_UNDERDEVEL =-1999;    // the function yet is not realized

 API: Initialization and completion

int CL_WorkStart ()

 int CL_WorkFinish ()

 int CL_WorkDebug (clString filename, FErrorsHandler errfunc)

typedef int (*FErrorsHandler) (
    int srcline,         // a line number of the initial code
    const char* srcfile, // a name of a source file
    int chdlineno,       // a line number in CHD-stream
    const char* chdline, // processed CHD-string
    const char* message  // the text of the message
);

API: Functions for operation with output devices

int CL_DrawerCreate (TDrawerDef* data)

struct TDrawerDef {
    TDrawerType type;  // рисователя type
    char* filename;    // a filename for GPT, GIF, WMF
    FILE* fout;        // the file open outside of the library, is used if filename == 0
    int fhandle;       // the descriptor of the file, is used if filename == 0 and fout == 0
    TIntRect Rect;     // rectangular area of drawing
    int hdc;           // a context of the device for a Windows - рисователей
};

// Rectangular area in screen coordinates
struct TIntRect {
    int x1, y1;
    int x2, y2;
};

// Types of devices
enum TDrawerType {
    CL_DRAWER_NO = 0,  // the type is unknown
    CL_DRAWER_BUF = 1,  // the buffer in memory
    CL_DRAWER_GPT = 2,  // debug text file GTP
    CL_DRAWER_GIF = 3,  // the GIF-file
    CL_DRAWER_WIN = 4,  // the window or other context of the device of a Windows
    CL_DRAWER_WMF = 5,  // a Windows матафайл
    CL_DRAWER_EMF = 6   // Enhanced a Windows матафайл
};

 int CL_DrawerUpdate (TDrawerDef* data)

 int CL_DrawerUse (int drawer)

 int CL_DrawerSave ()

 int CL_DrawerDelete (int drawer)

 API: Functions of operation with the data

 int CL_DataVector (int slide, const TInputData* data)

struct TInputData {
    int unused;
    TDataType Type;
    union {
        Byte byte;
        double real;
        char* text;
    };
};

// Types of input data
enum TDataType {
    CL_DATA_NODATA,   // the end of string(line) of the data
    CL_DATA_BYTE,   // an integer 0. 255
    CL_DATA_REAL,   // вещ number
    CL_DATA_TEXT,   // string(line) char*
};

*define CL_EMPTY_BYTE (-32768)
*define CL_EMPTY_REAL (-1.7E308)
*define CL_EMPTY_TEXT "??? "

int CL_DataLine (int* slide, clString line)

 int CL_DataFile (int* slide, clString filename)

 int CL_DataMatrix (int slide, int rows, clString description, FMatrixInterface func, void* object)

The external matrix sets with the help of the function of a data access func. This function is defined(determined) by the user of the library and called(caused) from within libraries. The type of FMatrixInterface function is described as follows:

typedef int (*FMatrixInterface) (void* object, int row, int col, TInputData* data);

The pointer object it is possible to use to transfer functions of access any data. It is necessary in that case when the same function of access is used for performance of several matrixes. The object, указаный at registration of the function of access, will be transferred it(her) by each call as the first argument. It is completely safe to do(make) the pointer object zero.

To reassign an external matrix (to change rows, func or object), repeatedly it is necessary to call(cause) CL_DataMatrix, having transferred it(her) in quality description only a name of a matrix.

 int CL_DataGetValue (int slide, int point, clString colname, TInputData* data)

 int CL_DataSetValue (int slide, int point, clString colname, const TInputData* data)

 API: Functions of operation with slides

 int CL_SlideMaxZoom (int slide)

 int CL_SlideRefresh (int slide)

 int CL_SlideSetRect (int slide, int xleft, int ytop, int xright, int ybottom)

 int CL_SlideGetSize (int slide, clString area, int *xleft, int *ytop, int *xright, int *ybottom)

 int CL_SlideDraw (int slide)

 int CL_SlideBeginDraw (int slide, int from_stage)
int CL_SlideContinueDraw (int slide, int to_stage)

0    beginning of plotting
1    all not graphics areas, background, grid, mandatory units of diagrams
2    filled squares
3    боксы
4    histograms
5    candles
6    lines and pair connections
7    points
8    active point, including the text comment
9    инициация search of a current point
10    continuations of search of a current point, its(her) illumination and output статусной the information
11    dynamic units on diagrams
12    end of plotting

 API: Functions of operation with the diagram

 int CL_ChartGetZoom (int slide, double *x1, double *y1, double *x2, double *y2)

 int CL_ChartGetMaxZoom (int slide, double *x1, double *y1, double *x2, double *y2)

 int CL_ChartSetZoom (int slide, double x1, double y1, double x2, double y2)

 int CL_ChartScreenToReal (int slide, int x, int y, double* X, double* Y, double* Z)

 int CL_ChartRealToScreen (int slide, double X, double Y, int* x, int* y)

 int CL_ChartGetXYInfo (int slide, int x, int y, clString series_name, clString expr, clString *buffer)

 int CL_ChartGetPointInfo (int slide, TPointInfo* info)

struct TPointInfo {
    clString panel_name;    // a name of the panel
    clString series_name;   // a name of a series
    int series;             // number of a series
    int point;              // number of a point in a series
    double X, Y, Z;         // coordinates of a point
    clString text;          // information string(line)
    int selected; whether // the point selected(allocated) is
    int can_be_selected; whether // there can be a point selected(allocated)
};

int CL_ChartGetTableLine (int slide, TPointInfo* info)

 int CL_ChartDrawPoint (int slide, TPointInfo* info, int stage)

2    filled squares
3    боксы
4    histograms
5    candles
6    lines and pair connections
7    points

int CL_ChartSelectPoint (int slide, TPointInfo* info, int selectmode)

 int CL_ChartSelectAll (int slide, int selectmode)

 int CL_ChartGetActivePoint (int slide, TPointInfo* info)

 int CL_ChartSetActivePoint (int slide, TPointInfo* info, int dir)

dir = 0 - a point info-> point in a series info-> series;
dir =-1 - the previous point in a series info-> series;
dir = +1 - the following point in a series info-> series;
dir = +2 - the nearest point in the following series;
dir =-2 - the nearest point in the previous series.

 API: Interactive functions

 int CL_OnMouseDown (int slide, int x, int y, int buttons)
int CL_OnMouseUp (int slide, int x, int y, int buttons)
int CL_OnMouseMove (int slide, int x, int y, int buttons)

enum TButtonsState {
  CL_BUTT_NO = 0,
  CL_BUTT_SHIFT = 1,
  CL_BUTT_ALT = 2,
  CL_BUTT_CTRL = 4,
  CL_BUTT_LEFT = 8,
  CL_BUTT_RIGHT = 16,
  CL_BUTT_MIDDLE = 32,
  CL_BUTT_DOUBLE = 64
};

int CL_OnKeyPress  (int slide, int keycode, int buttons)

enum TKeyCode {
  CL_KEY_NO = 0,
  CL_KEY_LEFT = 1,
  CL_KEY_RIGHT = 2,
  CL_KEY_UP = 3,
  CL_KEY_DOWN = 4,
  CL_KEY_PAGEUP = 5,
  CL_KEY_PAGEDOWN = 6,
  CL_KEY_HOME = 7,
  CL_KEY_END = 8,
  CL_KEY_TAB = 9,
  CL_KEY_ENTER = 10,
  CL_KEY_INSERT = 11,
  CL_KEY_DELETE = 12,
  CL_KEY_BACKSP = 13,
  CL_KEY_SPACE = 14,
  CL_KEY_ESCAPE = 15
};

int CL_SlideCallBack (int slide, FCallBack function, void* object)

typedef int (*FCallBack) (TCallBackInfo* cb);

struct TCallBackInfo {
  void* object;        // the object given at installation of the reflexive function of a slide
  TCallBackType type;  // the type of event
  clString text;       // статусная string(line), string(line) of the data, the information on a point
  clString area;       // a name of area of a slide on which there was an event
  int series;          // number of a series of points
  int point;           // number of a point in a series
  int selected;        // the point is selected(allocated)?
  TZoom prev;          // a former size of viewport
  TZoom curr;          // a current size of viewport current a graphics
};

struct TZoom {
  double x1, y1, z1;
  double x2, y2, z2;
};

enum TCallBackType {
  CL_CBACK_NO = 0,
  CL_CBACK_DATACHANGE = 1,     // change of the data
  CL_CBACK_ZOOM = 2,           // scaling a graphics
  CL_CBACK_POINTACTIVATE = 3,  // activation of a point
  CL_CBACK_POINTSELECT = 4,    // selection or a deselecting of one point
  CL_CBACK_POINTHIGHLIGHT = 5, // illumination of a point
  CL_CBACK_SCENECHANGE = 6,    // change of layout of the 3D-scene
  CL_CBACK_STATUSCHANGE = 7    // change статусной strings(lines)
};

API: the Example of usage of ChartLib library:
ChdView utility for converting a graphics

The command line allows to convert arbitrary number of files for once:

chdConv <format> <files>... <Format> <files>

The initial code of chdConv utility below represented.

*include <stdio.h>
*include <math.h>
*include "cl.h"

int slide = 0;
const int MAXBUF = 256;
char save [MAXBUF];
TDrawerDef drdata;

// Generation of the file
int generate (const char* filename, const char* extension, TDrawerType type) {
    if (*filename == '-' || *filename == '?') return 0;

 // Creation of a filename
    const char *s, *point = filename, *shortname = filename;
    for (s=filename; *s; s ++) {
        if (*s == '/' || *s == '\\') shortname = s+1;
       if (*s == '.') point = s;
    }
    if (point < =shortname) point = s;
    char name [MAXBUF];
    strncpy (name, shortname, point-shortname);
    name [point-shortname] = '\0 ';
    sprintf (drdata.filename=save, " %s. % s ", name, extension);

 // The debug message
    printf (" doing %s\n ", drdata.filename);

 // Loading the data
    CL_DataLine (*slide, "*NewSlide");
    CL_DataFile (*slide, filename);
    CL_DataLine (*slide, " *StatusBar.Visible off ");

 // Creation рисователя
    drdata. Rect.x1=0; drdata. Rect.y1=0;
    drdata. Rect.x2=548; drdata. Rect.y2=412;
    drdata.type = type;
    CL_DrawerCreate (*drdata);

 // Generation and recording a graphics
    CL_SlideSetRect (slide, 2, 2, 546, 410);
    CL_SlideMaxZoom (slide);
    CL_SlideRefresh (slide);
    CL_SlideDraw (slide);
    if (type == CL_DRAWER_GIF)
       CL_DrawerSave ();

 // Just in case - disconnect of echo - output of commands
    CL_DataLine (*slide, "*EchoFile");
    return 1;
}

void usage () {
    printf (" ChartLib v1.03   (c) K.Vorontsov, MICEX, 1999-2001\n ");
    printf (" CHD (CHart Description format) converter to GIF, GPT and EMF.\n ");
    printf (" chdConv usage:\n ");
    printf ("    chdConv [-gif] f1.chd f2.chd. -convert files to Compuserve GIF\n ");
    printf ("    chdConv-gpt f1.chd f2.chd. -convert files to Graphics Primitives Text\n ");
    printf ("    chdConv-emf f1.chd f2.chd. -convert files to Enhanced Metafile\n ");
    printf ("    chdConv-wmf f1.chd f2.chd. -convert files to Windows Metafile\n ");
}

int main (int argc, char* argv []) {
    if (argc == 1) {
        usage ();
        return 0;
    }
    TDrawerType otype = CL_DRAWER_GIF;
    const char* ext = "gif";

 // Initialization of the library
    CL_WorkStart ();
    CL_WorkDebug ("chdConv.log", 0);

 // Reading the command line and processing of files
    for (int a=1; a < argc; a ++) {
        if (*argv [a] == '-') {
           ext = argv [a] +1;
           if (strcmp (ext, "gif") == 0) otype = CL_DRAWER_GIF;
           else if (strcmp (ext, "gpt") == 0) otype = CL_DRAWER_GPT;
           else if (strcmp (ext, "emf") == 0) otype = CL_DRAWER_EMF;
           else if (strcmp (ext, "wmf") == 0) otype = CL_DRAWER_WMF;
        }
        else if (*argv [a] == '?')
           usage ();
        else
           generate (argv [a], ext, otype);
    }

 // Release of the library
    CL_WorkFinish ();
    return 0;
}

---

TSliChart components

• Инсталяция TSliChart component in Delphi
• Usage the component in the project
• Properties TSliChart component
• Events TSliChart component
• Procedures and functions TSliChart component

 TSliChart: Инсталяция the component

•  To select from Component menu Install Component item.
• To select with help Unit file name/Browse src\WinDelphi\SliChart.pas file from distribution kit ChartLib.
• In Package window to fulfil compilation (Compile button) and installation (Install button) package.
• To close the current project with help File/Close All, having saved the project.

 TSliChart: Usage the component in the project

•  Components always displays in accuracy one slide. However it is possible to switch from one slide to another with the help of Slide CHD-command. {Slide}
• That the object such as TSliChart, placed on the form, handled events of the mouse and the keyboard, property of form ActiveControl should specify this object. To place(install) this property it is possible both during development, and in execution time.
• That on a graphics it was possible to select(allocate) points, it is necessary to place(install) for property SelectMode any value except for smNone.
• That on a graphics it was possible to select(allocate) areas, it is necessary to place(install) for property SelectShape any value except for shNone.
• That the function of construction of the summary table on the selected(allocated) points worked, it is necessary to place(install) property SelectedPointsGrid.

The guideline 2: select the optimal moment for upgrade of a slide
During arrival of the data on a slide the library, components do not update a slide. It is made for rise of efficiency that upgrade to make once after a series of operations with the diagram. Upgrade includes installation of scale SlideMaxZoom and image generation SlideRefresh.

The guideline 3: use SetFilm command to organize show of films {SetFilm}
By default, if SetFilm command is not fulfilled, the slide is located in film with a name default. It is special film for allocation of single slides. In it(him) scrolling, moving and deleting of slides is impossible.

 TSliChart: Properties the component

 Property HasBuffer: boolean

 Property HasStatus: boolean

 Property SelectOutside: boolean

 Property SelectMode: TSelectMode

  // Modes of selection of subsets of points
  TSelectMode = (smNone, smSelect, smUnselect, smInvert);

Property SelectShape: TSelectShape

  // Forms of selection of subsets of points
  TSelectShape = (shNone, shRectangle, shEllipse, shHalf, shStrip);

Property SelectedPointsGrid: TStringGrid

 Property SlideNo: integer

 Property Busy: boolean

 Property ChartLibError: integer

 TSliChart: Events the component

Other events are defined in TSliChart class. Events OnPropertyChange, OnShowTable, OnPaintStart, OnPaintFinish have standard TNotifyEvent type. Other events have TChartEvent type which also is described in SliChart.pas unit:

TChartEvent = procedure (Sender: TObject; var Info: TChartBackInfo) of object;

TChartBackInfo = record
  slide: TSliChart;    // the pointer on the object
  event: integer;      // the type of event
  text: PChar;         // статусная string(line), string(line) of the data, the information on a point
  area: PChar;         // a name of area of a slide on which there was an event
  series: integer;     // number of a series of points
  point: integer;      // number of a point in a series
  selected: integer;   // the point is selected(allocated)?
  prev: TZoom;         // the previous boundary of viewport
  curr: TZoom;         // current boundary of viewport
  prev_slide: integer; // number of a current slide before switching
  curr_slide: integer; // number of a current slide after switching
end;

Event OnStatusChange: TChartEvent

 Event OnDataChange: TChartEvent

 Event OnSlideChange: TChartEvent

 Event OnDataFile: TChartEvent

 Event OnZoom: TChartEvent

 Event OnPointActivate: TChartEvent

 Event OnPointSelect: TChartEvent

 Event OnPointHighlight: TChartEvent

 Event OnSceneChange: TChartEvent

 Event OnPropertyChange: TNotifyEvent

 Event OnShowTable: TNotifyEvent

 Event OnPaintStart: TNotifyEvent

 Event OnPaintFinish: TNotifyEvent

 TSliChart: Procedures and functions the component

procedure DataFile (const FileName: PChar)

 procedure DataLine (const Line: PChar)

 procedure DataVector (var Data: TInputData)

const
  CL_DATA_NODATA = 0; // the end of string(line) of the data
  CL_DATA_BYTE = 1;   // an integer
  CL_DATA_REAL = 2;   // вещ number
  CL_DATA_TEXT = 3;   // string(line) char*

type TInputData = record
  unused: integer;
  case dType: integer of
   CL_DATA_BYTE: (dByte: Smallint);  // an integer
   CL_DATA_REAL: (dReal: double);    // вещ number
   CL_DATA_TEXT: (dText: PChar);     // string(line) char*
  end;

 procedure DataMatrix (rows: integer; fields: PChar; func: FMatrixInterface; obj: TObject);

FMatrixInterface = function (
    DataHolder: TObject;
    row, col: integer;
    var data: TInputData
): integer; cdecl;

 procedure DataGet (row: integer; colname: PChar; var data: TInputData)

 procedure DataPut (row: integer; colname: PChar; var data: TInputData)

 procedure SlideSetRect ()

 procedure SlideMaxZoom ()

 procedure SlideRefresh ()

 procedure SlideDraw ()

 procedure ChartGetZoom (var x1: double; var y1: double; var x2: double; var y2: double)

 procedure ChartGetMaxZoom (var x1: double; var y1: double; var x2: double; var y2: double)

 procedure ChartSetZoom (x1: double; y1: double; x2: double; y2: double)

 procedure ChartScreenToReal (x, y: integer; var PX, PY, PZ: double)

 procedure ChartRealToScreen (xreal, yreal: double; var x, y: integer)

 procedure ChartDrawPoint (var info: TPointInfo; stage: integer)

 procedure ChartSelectPoint (var info: TPointInfo)

 procedure ChartSelectAll ()

 procedure ChartSetActivePoint (var info: TPointInfo; dir: integer)

 procedure ChartGetActivePoint (var info: TPointInfo)

 procedure ChartGetPointInfo (var info: TPointInfo)

 procedure ChartGetTableLine (var info: TPointInfo)

 procedure ChartGetXYInfo (x, y: integer; series, expr: PChar; var buffer: PChar)

 procedure SaveAsEMF (const filename: string)

 procedure SaveAsBMP (const filename: string)

 procedure SaveAsGIF (const filename: string)

 procedure CopyToClipboard ()

 procedure Print ()

 procedure ShowTable ()

---

Addition of devices of mapping

• Abstract рисователь CDrawer
• Characteristics of the device
• The designer and деструктор
• The beginning and the end of drawing, filing
• Parameter setup of drawing
• Functions of drawing
• Operations with pixels
• Transition in OpenGL mode
• Obtaining of the information

That the map looked equally on various devices, developers of classes - successors CDrawer should adhere to uniform agreements that each function of drawing and as various functions cooperate with each other does(makes). These agreements are described in the given section.

For addition new рисователя with name Xyz it is necessary to fulfil the following steps:

•  To define(determine) new CDrawXyz class by inheriting CDrawer class. To realize in it(him) all virtual functions of drawing. To place the description of the new class in clDrwXyz.cpp files and clDrwXyz.h. In the beginning of heading clDrwXyz.h file to define(determine) макрос __ CL_XYZ_H __.
• In clTypes.h file to add the code of new device CL_DRAW_XYZ in listing enum TDrawerType.
• In the beginning of cl.cpp file to add string(line)
*include "clDrwXyz.h"
• In CL_DrawerCreate function of cl.cpp file to add call of the designer of the new class:
*ifdef __ CL_XYZ_H __
    case CL_DRAW_XYZ:
        newdraw = new CDrawXyz (ddef);  break;
*endif
• To recompile ChartLib library.

---

Рисователи: Abstract рисователь CDrawer

Further definition of CDrawer class from clDraw.h file is entirely resulted.

class CDrawer {
public:
    // The beginning and termination with a graphics
    CDrawer ();
    virtual ~CDrawer ();
    virtual int Reset (TDrawerDef* ddef);
    virtual int Clear ();
    virtual int Save ();

 // Plotting graphics primitives
    virtual int Line (int x0, int y0, int x1, int y1) = 0;
    virtual int LineTo (int x1, int y1) = 0;
    virtual int Rect (int x0, int y0, int x1, int y1) = 0;
    virtual int Ellipse (int x0, int y0, int x1, int y1) = 0;
    virtual int EllipsePie (int x0, int y0, int x1, int y1,
        double fromangle, double toangle) = 0;
    virtual int Fill (int nPoints, int* xy) = 0;
    virtual int Text (int x0, int y0, const char* text, TFontStyle font) = 0;

 // Parameter setup of drawing
    virtual int SetColor (TColor color) = 0;
    virtual int SetFillColor (TColor color) = 0;
    virtual int SetLineStyle (TLineStyle linestyle, int width) = 0;
    virtual int SetFillStyle (TFillStyle fillstyle) = 0;
    virtual int SetFont (TFontStyle font, const char* library,
        const char* family, int width, int height,
        const char* flags=0, double angle=0.0);

 // The functions used in the interactive mode
    virtual int SetPixel (int x0, int y0, const TColor *color);
    virtual int GetPixel (int x0, int y0, TColor *color);

 // Functions for support OpenGL and a three-dimensional graphics
    virtual int BeginOpenGL (TIntRect and Rwin, TIntRect and Rclip);
    virtual int EndOpenGL ();

 // Information functions
    virtual int GetTextSizes (const char* text,
        TFontStyle font, int* width, int* height) = 0;
    virtual char GetFontEncoding (TFontStyle font);

 // Possibilities of the graphics device
    int RightBottomShift;
    int HasPixelOperations;
    int HasInteractivity;
    int HasFontBackground;

protected:
    TDrawerDef DrawerDef;// a determinant transferred(handed) Reset
    FILE* open_file ();        // to open the file in the beginning of Save operation
    int close_file (FILE* f);  // to close the file at the end of Save operation
};

---

Рисователи: Characteristics of the graphics device

 int RightBottomShift

 int HasPixelOperations

 int HasInteractivity

 int HasFontBackground

---

Рисователи: the Designer and деструктор

Designer CDrawXyz ()

 Деструктор ~CDrawXyz ()

---

Рисователи: the Beginning and the end of drawing, filing

int Reset (TDrawerDef* ddef)

The function should be reassigned necessarily. The developer рисователя should расчитывать that she(it) can be called(caused) repeatedly for reinstallation of various рисователя parameters, for example at resizing area, a filename or a descriptor. Once she(it) is called(caused) necessarily right after creations рисователя.

Structure TDrawerDef is defined in clTypes.h file. She(it) unites in herself all data which can be necessary for initialization рисователей various types. Рисователь has the right to ignore those fields of structure as which it(he) will count unnecessary. In future TDrawerDef it can be enlarged by new fields.

struct TDrawerDef {
    TDrawerType type; // рисователя type
    char* filename;   // a filename for GPT, GIF, WMF
    FILE* fout; // the file open outside of the library, is used if filename == 0
    int fhandle; // the descriptor of the file, is used if filename == 0 and fout == 0
    TIntRect Rect; // rectangular area of drawing
    int hdc;   // a context of the device for a Windows - рисователей
};

enum TDrawerType {
    CL_DRAWER_NO=0,// the type is unknown
    CL_DRAWER_BUF=1,// the buffer in memory
    CL_DRAWER_GPT=2,// a text file of graphics primitives
    CL_DRAWER_GIF=3,// the GIF-file
    CL_DRAWER_WIN=4,// the window or others рисователи a Windows
    CL_DRAWER_WMF=5,// a Windows матафайл
    CL_DRAWER_EMF=6// Enhanced a Windows матафайл
};

struct TIntRect {
    int x1, y1;
    int x2, y2;
};

Fields filename, fout, fhandle set three alternate ways of a file transfer for recording in him(it) of a graphics image. They are used only by Save function. That it is correct to open and close the file irrespective of a way of his(its) job(definition), use functions of the base class {Save}

FILE* CDrawer:: open_file ();// to open the file in the beginning of Save operation
int CDrawer:: close_file (FILE* f); // to close the file at the end of Save operation

int CDrawXyz:: Reset (TDrawerDef *ddef) {
    if (CDrawer:: Reset (ddef))
        return (-1);
    //.........
}

int Clear ()

To reassign Clear function it is not necessary in the following cases:

1.  If рисователь does not create the objects connected to the peripheral,
2. If the peripheral does not fail,
3. If at corrupting it deletes all objects.

int Save ()

That it is correct to open and close the file, it is necessary to use functions of the base class

FILE* CDrawer:: open_file ();// to open the file in the beginning of Save operation
int CDrawer:: close_file (FILE* f); // to close the file at the end of Save operation

---

Рисователи: Parameter setup of drawing

int SetColor (TColor color)

struct TColor {
    short Red, Green, Blue;
};

int SetFillColor (TColor color)

 int SetLineStyle (TLineStyle linestyle, int width)

typedef int TLineStyle;
const TLineStyle CL_LINE_NO = 0;
const TLineStyle CL_LINE_SOLID = 1;
const TLineStyle CL_LINE_DASH = 2;
const TLineStyle CL_LINE_DOT = 3;
const TLineStyle CL_LINE_DASHDOT = 4;
const TLineStyle CL_LINE_DASHDOTDOT = 5;
const TLineStyle CL_LINE_STYLEMASK = 0x0F;
const TLineStyle CL_LINE_XOR = 0x10;

 int SetFillStyle (TFillStyle fillstyle)

enum TFillStyle {
    CL_FILL_NO,
    CL_FILL_SOLID,
    CL_FILL_LEFT,
    CL_FILL_RIGHT,
    CL_FILL_CROSS
    CL_FILL_CROSSDIAG
};

int SetFont (TFontStyle font, const char* library, const char* family, 
            int width, int height, const char* flags=0, double angle=0.0)

ChartLib library limits quantity(amount) of simultaneously used fonts. There are 9 predetermined and 9 user's styles of fonts. All fonts are initialized at creation рисователя, and to Text functions and GetTextSizes transfers only number of style. {Text}

Font parameter sets type style which is defined in clTypes.h as an integer from 0 up to 17:

enum TFontStyle {
    CL_FONT_DEFAULT=0,// the elementary font which always is
    CL_FONT_TITLE=1,// header a graphics
    CL_FONT_NAME=2,// names of axes
    CL_FONT_LABEL=3,// labels of axes
    CL_FONT_INFO=4,// the text of information fields
    CL_FONT_INSIDE=5,// text TI inside points
    CL_FONT_NEAR=6,// text TN near to points
    CL_FONT_RIGHT=7,// text TR on a right-click
    CL_FONT_STATUS=8,// text TB статусная string(line)
    CL_FONT_USER_1=9,
    CL_FONT_USER_2=10,
    CL_FONT_USER_3=11,
    CL_FONT_USER_4=12,
    CL_FONT_USER_5=13,
    CL_FONT_USER_6=14,
    CL_FONT_USER_7=15,
    CL_FONT_USER_8=16,
    CL_FONT_USER_9=17,// nine user's fonts
    CL_FONTS=18
};

if (library ** *library ** strcmpcu (library, "Win"))
    return (-1);

Width parameter sets width of characters in pixels. If the used font library does not support disproportionate stretchings of fonts, this parameter can be ignored. Zero value should be interpreted as the instruction(indication) to select the proportional font.

Height parameter sets height of characters in pixels.

Flags parameter sets additional flags. It is text string(line) which can include the following characters:

B - bold,
b - bold,
I - oblique,
U - underlined,
S - crossed.

Рисователи: Functions of drawing

 int Line (int x0, int y0, int x1, int y1)

 int LineTo (int x1, int y1)

 int Rect (int x0, int y0, int x1, int y1)

 int Ellipse (int x0, int y0, int x1, int y1)

 int EllipsePie (int x0, int y0, int x1, int y1, double fromangle, double toangle)

 int Fill (int nPoints, int* xy)

 int Text (int x0, int y0, const char* text, TFontStyle font)

---

Рисователи: Operations with pixels

 int SetPixel (int x0, int y0, const TColor *color)

 int GetPixel (int x0, int y0, TColor *color)

---

Рисователи: Transition in OpenGL mode

 int BeginOpenGL (TIntRect and Rwin, TIntRect and Rclip)

struct TIntRect {
    int x1, y1;
    int x2, y2;
};

int EndOpenGL ()

---

Рисователи: Obtaining of the information

int GetTextSizes (const char* text, TFontStyle font, int* width, int* height)

 char GetFontEncoding (TFontStyle font)

W - the coding of Windows CP-1251,
D - the alternate coding of a DOS,
K - coding KOI-8,
I - coding ISO-8859-5.

---

Interactive possibilities

• Navigating on a 2D-graphics (it is supported by ChartLib library)
• Navigating on a 3D-graphics (it is supported by ChartLib library)
• Research of points a graphics (it is supported by ChartLib library)
• Shortcuts (are supported by component TSliChart)
• The utility of review of diagrams chdView
• Functions of the menu (are supported by chdView utility)

Functions of navigating on a graphics and review of points are supported at a level of ChartLib library.
Shortcuts are supported by component TSliChart.
Functions of the menu are realized in the utility of review chdView.

 Interactivity: Navigating on bidimentional a graphics

Scaling is made at selection of rectangular area by the right mouse button. Selection from left to right increases a scale, selection from right to left returns the diagram to an automatic scale at which all points a graphics are visible.

Shift a graphics is made by movement of the mouse with the pressed right button and simultaneously pressed Shift key.

Scaling on an axis is made if to pull for an axis at the pressed right mouse button. Movement aside a positive direction of an axis increases a scale (expands the diagram), aside negative - reduces a scale (compresses the diagram). The scale on the second axis does not vary. Motionless on an axis остаётся a point from which we have started to pull.

Shift on an axis is made if to pull for an axis at the pressed left mouse button. The direction of shift coincides with a direction of movement along an axis. Thus the scale on the second axis does not vary.

 Interactivity: Navigating on three-dimensional a graphics

Review of the three-dimensional scene can be made in passive or a foreground. In the first case the spectator, being in a motionless point, spins, shifts and scales the scene. This mode is intended for the common browse of the scene. In the second case the spectator moves under the scene in arbitrary directions that allows to study the scene in details. The passive mode is by default placed(installed).

In both browse modes keys operate

	Switching of browse mode: active / passive
	Return in a starting position of the scene
	Expansion - compression of the scene on axis X
	Expansion - compression of the scene on axis Y
	Expansion - compression of the scene synchronously on axes X and Y
	Expansion - compression of the scene on axis Z

In the passive mode keys operate

	Rotations of the scene
	Shift of the scene concerning centre of the window
	Increase of the scene
	Decrease of the scene

In a foreground keys operate

	Moving перёд-back
	Turn on a place to the left - to the right
	Moving, not turning, upwards - вниз-влево-вправо
	To look above (" to lift a head ")
	To look below (" to lower(omit) a head ")
	To turn back back

 Interactivity: Review of points a graphics

Choice of a subset of points a graphics at selection of area by the left mouse button. The form of selected(allocated) area can be varied (a rectangle, the ellipse, a half-plane, a bar). Click on a point the left mouse button selects the indicated point or a little at once if they are overlapped. Selected points are outlined by color (by default white). The points having a size (S > 1 and W > 0) can be selected only.

Output of the summary table on selected points. For each point text string(line) TT is output. Moving on table lines is clocked with activation of a point on a graphics.

Activation of any point by right button click. Activation differs from choice by that, that one point can be active only. keys  and make active the previous and following point in limits of the same series. keys  and allow to move on series. The active point is highlighted (by default yellow color), number outputs text comment TR. Right button click outside of points removes activation.

Output of the comment near to each of selected points. The text of the comment sets for each point property TN.

Illumination of a point, candle or column of the histogram on which the mouse pointer (by default blue color) has stopped. Simultaneously in статусную string(line) the text comment set by property TB is output.

Output of current coordinates of a mouse pointer in статусную string(line). If the mouse works in the mode of selection, shift or scaling, in статусной the size of selected(allocated) area is informed string(line).

 Interactivity: Shortcuts

	Repeated loading from the file
	Copying a graphics without reading from the file
	Copying a graphics in a clipboard
	Printing a graphics on the printer
	Output of the table of the selected(allocated) points
	Transition to the following slide
	Transition to the previous slide
	Cyclic switching of modes of selection of points: addition, deleting, inversion of selection
	Cyclic switching of the form of selected(allocated) area: a rectangle, the ellipse, a half-plane, a bar
	Selection of all points (removal, inverting - depending on the current mode of selection)
	Navigating on panels of a slide

 Interactivity: the Utility of review of diagrams chdView

By call of the utility to it(her) transfers the list of loaded files:

chdView <options> <file>... <Options> <file> of <option>

At start without parameters chdView utility shows a slide with the empty diagram. In this case the user loads the CHD-file for review with the help of buttons of the menu.

 Interactivity: Functions of the menu

The main menu	Submenu

The menu consists of two parts. Buttons the main menu, on the right - buttons of a submenu at the left are located. Buttons the main menu the user switches from one submenu to another. Each submenu unites group of functions close to destination.

Buttons the main menu

	Loading, conversion and printing of CHD-files
	Parameter setup of mapping
	Selection of a subset of points and output of the summary table on the selected(allocated) points
	Scrolling of films, deleting and moving of slides
	Operation with series of points on current to a graphics
	Windowing
	Manual, hints and the other information
	Automatically generated submenu from 12 most popular buttons

Buttons of operation with files

	To open the CHD-file and to load his(its) contents on a new pure(clean) slide
	To open the CHD-file and to load his(its) contents instead of a current slide
	To open the CHD-file and to load his(its) contents atop of a current slide
	To open the CHD-file and to load his(its) contents in the new window
	To save a slide as the raster map in the file of BMP format
	To save a slide as the vector map in the file of EMF format
	To save a slide as the raster map in the file of GIF format
	To print out a slide
	To close all windows, to leave from the program

Buttons of parameters of mapping

	To cancel show тектовых comments TR near to points
	To show тектовые comments TR only near to the selected(allocated) points
	To show тектовые comments TR near to all points
	To refresh a slide
	To place(install) a maximum scale of mapping for all diagrams on a slide. A maximum scale the graphics allows to see all points.
	To include / disable the mode of double-buffer. At the included buffering the slide appears faster and without flashing on the screen, but it demands the greater memory size.

Buttons of selection of a subset of points

	To select(allocate) points
	To deselect from points
	To invert selection of points
	To select(allocate) all points a graphics
	The form выделителя areas - a rectangle
	The form выделителя areas - the ellipse
	The form выделителя areas - a half-plane
	The form выделителя areas - a bar
	To select / not to select(allocate) the points which are taking place outside area visible in the window a graphics
	To output the summary table on the selected(allocated) points

Buttons of operations with slides and films

	To proceed(pass) to the first slide in film
	To proceed(pass) to the previous slide in film
	To proceed(pass) to the following slide in film
	To proceed(pass) to the last slide in film
	To start show of film. All slides are shown sequentially with the given delay.
	To stop show of film
	To show film in cycle an infinite number of times
	To copy a slide in the buffer
	To clear a slide, having deleted with him(it) all of a graphics
	To delete a slide, to withdraw it(him) from film
	To move a current slide, having put his(its) the first in film
	To swap a current slide and previous
	To swap a current slide and the following
	To move a current slide, having put his(its) latter in film
	To produce help information about quantity(amount) and names of slides

Buttons for operation with series of points on a graphics

	To include / disable mapping a selected series of points
	To draw a selected series of points atop of other units a graphics

Buttons for windowing

To attach the information table to the window a graphics

Buttons of hints and documentation

	Manual on CHD format
	The instruction of using chdView utility
	To include / disable pop-up hints on buttons of the menu
	Home page of the developer in Internet
	Briefly about the program