Technical pages
Curves displaying application
Instructions
Use
Example
Principle
The goal of this page is to describe the curve file format allowing to be displayed with the application courbe.txt:

Instructions
When the application is loaded in the memory, the following instruction can be launched:
- COURBE
-
Curves displaying application
This application is able to
display up to 7 curves ("file.crb").
It is possible to generate a GIF
picture in portrait mode (840*1260) or in landscape mode
(1260*840).
@tmp_crb COURBE_AFFICHE erreur
Displaying of a curve from the memory.
@tmp_crb: beginning address of the curve description in the memory (tmp_crb),
erreur: 0 if OK, -1 if not enough memory, -2 if the format of tmp_crb is bad, -3 if the displaying is not possible.
- COURBE_EFFACE erreur
Clearing of the last displayed curve.
erreur: 0 if OK, -1 not any curve to clear.
@nom,@x,@y,fxmin,fxmax,fymin,fymax,typex,typey,nbp,@fcalcul COURBE_CREE @tmp_crb,lng
Creation of a curve in the memory.
@nom: address of the curve name,
@x,@y: addresses of the x and y axies unities,
fxmin,fxmax,fymin,fymax: 64 bits floating point numbers giving the curve displaying limits,
typex,typey: x and y axies types (0 for linear),
nbp: curve points number between fxmin and fxmax (2 to 32767),
@fcalcul: y computing function address for each x,
@tmp_crb: beginning address of the curve description in the memory (tmp_crb),
lng: bytes number of tmp_crb (0 if the curve is bad).
@tmp_crb,lng,nbp,@fcalcul COURBE_AJOUTE @tmp_crb',lng'
Addition of a supplementary curve in the memory (the total must not be more than 7).
@tmp_crb: beginning address of the curve description in the memory (tmp_crb),
lng: bytes number of tmp_crb,
nbp: curve points number between fxmin and fxmax (2 to 32767),
@fcalcul: y computing function address for each x,
@tmp_crb': beginning address of the modified curve description in the memory (tmp_crb),
lng': bytes number of tmp_crb' (0 if the curve is bad).
Use
The curve displaying application allows to display up to 7 files each containing up to 7 curbes.
The definition of a file describing a curve ("file.crb") is given in the following list:
0
--> name of the curve (string of 84 characters)
84 -->unity of the x axis (string of 8 characters)
92 --> unity of the y axis (string of 8 characters)
100 --> xmin (64 bits floating number)
108 --> xmax (64 bits floating number)
116 --> ymin (64 bits floating number)
124 --> ymax (64 bits floating number)
132
--> type of the x axes (0 for linear else logarithmic)
134
--> type of the y axes (0 for linear else logarithmic)
136
--> n1 (number of the points of the first curve)
138
--> -n1-1
140
--> y1 (floating number giving the value of the first point corresponding to xmin)
148
--> y2
156
--> ...
...
--> yn1 (floating number giving the value of the last point corresponding to xmin)
...
--> n2 (number of the points of the second curve)
...
--> -n2-1
...
--> y1
...
--> y2
...
--> ...
...
--> yn2
...
--> 0 (n = 0 when there is not any more curve or after the seventh curve)
...
--> 65535
The character strings are completed by spaces (32 or 0x20) when there are shortest than the allowed size.
The format of the 64 bits floating numbers is described here.
The following video shows to you how to use this software with the creation and displaying of sine and cosine curves:

Example
To illustrate this presentation, here an example of file GIF visualizing some curves resulting from this fichier: