Document fait avec Nvu Document made with Nvu
acceuilnouveautesintroductioncoeurmini_systemepages_techniquesrevue_de_presselienscourriel



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: