Firebee/FireBee_Setup
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

moved from dev to prod

Browse Source
This commit is contained in:
root
2022-11-14 10:05:42 +01:00
parent ac142715b0
commit 43d589aa9b
1364 changed files with 27705 additions and 6101 deletions
Download Patch File Download Diff File Expand all files Collapse all files

496
tools/vision/LDV/doc/struct.htm Normal file
View File

@@ -0,0 +1,496 @@
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
<title>Documentation VISION (LDV) : Structures</title>
</head>
<body background="images/conc2.gif" bgcolor="#FFFFFF">
<div align="center"><center>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="center" width="17%"><a href="defines.htm"><img
src="images/cprev.jpg" alt="Chapitre pr<70>c<EFBFBD>dent"
border="0" hspace="2" width="46" height="26"></a><a
href="index.htm"><img src="images/csom.jpg"
alt="Retour au sommaire" border="0" hspace="2" width="26"
height="26"></a><a href="kitdev.htm"><img
src="images/csuiv.jpg" alt="Chapitre suivant" border="0"
hspace="2" width="43" height="26"></a></td>
<td align="center" valign="top" rowspan="2" width="8%"><p
align="center"><img src="images/icoprinc.gif" width="59"
height="71"></p>
</td>
<td width="33%"><p align="center"><font color="#0000FF"
size="5"><strong>Documentation </strong><em><strong>VISION
(LDV)</strong></em></font></p>
</td>
<td align="center" valign="top" rowspan="2" width="8%"><p
align="center"><img src="images/icointro.gif" width="59"
height="71"></p>
</td>
<td valign="top" width="17%"><p align="left">Derni<EFBFBD>re
mise <20> jour : <!--webbot bot="Timestamp" startspan
s-type="EDITED" s-format="%d/%m/%y" -->16/05/01<!--webbot
bot="Timestamp" i-checksum="12425" endspan --></p>
</td>
</tr>
<tr>
<td width="17%"><p align="center"><a
href="..\..\download/dvldv.zip">T<EFBFBD>l<EFBFBD>charger la doc</a></p>
</td>
<td width="33%"><p align="center"><font size="4"><strong>5.
S T R U C T U R E S</strong></font></p>
</td>
<td align="center" width="17%">&nbsp; <!--webbot
bot="HTMLMarkup" startspan --><A HREF="http://www.estat.com/getstats?serial=1390118421">
<IMG SRC="http://perso.estat.com/cgi-bin/perso/1390118421?page=DocVisionLDV"
BORDER=0></A>
<!--webbot
bot="HTMLMarkup" endspan --></td>
</tr>
</table>
</center></div>
<hr>
<p>.<a name="LDV_INFOS"></a><font size="4"><strong>5.1 LDV_INFOS</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
short StrSize ;
short Type ;
char Authors[1+45] ;
LDV_CAPS Caps[10] ;
char RFU[16] ;
}
LDV_INFOS ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">StrSize</td>
<td align="center" width="15%">short</td>
<td width="75%">Taille de la structure LDV_INFOS. Doit
<20>tre initialis<69> <20> sizeof(LDV_INFOS). Le but de ce
champ est de permettre <20> <em><strong>VISION</strong></em>
de ne pas exploser ses donn<6E>es internes si la taille de
cette structure est amen<65>e <20> changer.</td>
</tr>
<tr>
<td align="center" width="10%">Type</td>
<td align="center" width="15%">short</td>
<td width="75%">Doit valoir <a href="defines.htm#TLDV">TLDV_MODIFYIMG</a>,
<a href="defines.htm#TLDV">TLDV_LOADIMG</a> ou <a
href="defines.htm#TLDV">TLDV_SAVEIMG</a>, voire plus <20>
venir. Actuellement, seul le type <a
href="defines.htm#TLDV">TLDV_MODIFYIMG</a> est accept<70>
par <em><strong>VISION</strong></em></td>
</tr>
<tr>
<td align="center" width="10%">Authors</td>
<td align="center" width="15%">char[1+45]</td>
<td width="75%">Noms du ou des auteurs. 45 caract<63>res
sont disponibles <20> cet effet.</td>
</tr>
<tr>
<td align="center" width="10%">Caps</td>
<td align="center" width="15%"><a href="#LDV_CAPS">LDV_CAPS</a>[10]</td>
<td width="75%">Tableau d<>crivant les capacit<69>s du LDV
pour chaque nombre de plans. Au maximum le LDV peut
g<>rer 9 nombres de plans diff<66>rents car le tableau de
structures doit se terminer par une struture avec des
champs initialis<69>s <20> z<>ro.</td>
</tr>
<tr>
<td align="center" width="10%">RFU</td>
<td align="center" width="15%">char[16]</td>
<td width="75%">Pour usage futur. Ne pas toucher !</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_CAPS"></a><font size="4"><strong>5.2 LDV_CAPS</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
char NbPlanes ;
char NbPlanesOut ;
unsigned long Flags ;
}
LDV_CAPS ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">NbPlanes</td>
<td align="center" width="15%">char</td>
<td width="75%">Nombre de plans pour cette capacit<69> (1,
2, 4, 8 , 16, 24 (non g<>r<EFBFBD>), 32)</td>
</tr>
<tr>
<td align="center" width="10%">NbPlanesOut</td>
<td align="center" width="15%">char</td>
<td width="75%">Nombre de plans en sortie pour cette
capacit<69>. Pour un LDV de type <a href="defines.htm#TLDV">TLDV_MODIFYIMG</a>,
ce champ doit <20>galer NbPlanes</td>
</tr>
<tr>
<td align="center" width="10%">Flags</td>
<td align="center" width="15%">unsigned long</td>
<td width="75%">Combinaison (symbole |) des masques
suivants:<ul>
<li><a href="defines.htm#LDVF">LDVF_STDFORMAT</a> :
le LDV accepte le format standard</li>
<li><a href="defines.htm#LDVF">LDVF_ATARIFORMAT</a> :
le LDV accepte le format ATARI</li>
<li><a href="defines.htm#LDVF">LDVF_SPECFORMAT</a> :
le LDV accepte le format sp<73>cifique de la carte
graphique</li>
<li><a href="defines.htm#LDVF">LDVF_SUPPORTPREVIEW</a>
: le LDV fournit la fonction Preview (fortement
conseill<6C> m<>me si elle ne fait qu'appeller Run)</li>
<li><a href="defines.htm#LDVF">LDVF_AFFECTPALETTE</a>
: le LDV modifie la palette (NbPlanes doit <20>tre
inf<6E>rieur ou <20>gal <20> 8)</li>
<li><a href="defines.htm#LDVF">LDVF_SUPPORTPROG</a> :
le LDV appellera la fonction <a
href="vapi/pr.htm#PrSetProg">PrSetProg</a> de
l'interface <a
href="vapi/index.htm#Pr<50>sentation">VAPI</a>
(conseill<6C> si le traitement dure plus de 2
secondes)</li>
<li><a href="defines.htm#LDVF">LDVF_OPINPLACE</a> :
le LDV sait travailler sur l'image source, sans
que <em><strong>VISION</strong></em> alloue la
destination (on dit que la transformation se fait
sur place). En ce cas, le param<61>tre out de la
fonction Run est le m<>me que in. Dans la mesure
du possible, utilisez ce flag, cela <20>conomise de
la m<>moire.</li>
<li><a href="defines.htm#LDVF">LDVF_REALTIMEPARAMS</a>
: le LDV effectue assez rapidement la fonction
Preview (image petite affich<63>e par la boite de
dialogue de <em><strong>VISION</strong></em>),
pour que la modification des param<61>tres du LDV
par les ascenseurs soit suffisamment fluide (au
moins 1 image par seconde)</li>
<li><a href="defines.htm#LDVF">LDVF_SUPPORTCANCEL</a>
: la fonction <a href="descrip.htm#run">Run</a>
peut <20>tre annul<75>e par l'utilisateur (<28>
utiliser conjointement avec la fonction <a
href="vapi/pr.htm#PrSetProgEx">PrSetProgEx</a> de
l'interface <a href="vapi/pr.htm">Progress</a> de
<a href="vapi/index.htm">VAPI</a>)</li>
</ul>
</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_IMAGE"></a><font size="4"><strong>5.3 LDV_IMAGE</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
short RasterFormat ;
MFDB Raster ;
LDV_PALETTE Palette ; /* Structure fournie si Raster.fd_nplanes &lt;= 8 */
}
LDV_IMAGE ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">RasterFormat</td>
<td align="center" width="15%">short</td>
<td width="75%"><a href="defines.htm#LDVF">LDVF_STDFORMAT</a>,
<a href="defines.htm#LDVF">LDVF_ATARIFORMAT</a> ou <a
href="defines.htm#LDVF">LDVF_SPECFORMAT</a></td>
</tr>
<tr>
<td align="center" width="10%">Raster</td>
<td align="center" width="15%">MFDB</td>
<td width="75%">Le MFDB classique ATARI d<>crivant les
donn<6E>es de l'image (hors palette)</td>
</tr>
<tr>
<td align="center" width="10%">Palette</td>
<td align="center" width="15%"><a href="#LDV_PALETTE">LDV_PALETTE</a></td>
<td width="75%">Pointeur sur une structure <a
href="#LDV_PALETTE">LDV_PALETTE</a> d<>crivant la palette
assoic<69>e <20> l'image si le nombre de bits est inf<6E>rieur
ou <20>gal <20> 8.</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_PALETTE"></a><font size="4"><strong>5.4
LDV_PALETTE</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
short NbColors ;
VDI_ELEMENTPAL* Pal ;
}
LDV_PALETTE ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">NbColors</td>
<td align="center" width="15%">short</td>
<td width="75%">Le nombre d'<27>l<EFBFBD>ments dans le tableau
point<6E> par Palette (soit 2, 4, 16 ou 256 couleurs)</td>
</tr>
<tr>
<td align="center" width="10%">Pal</td>
<td align="center" width="15%"><a
href="#LDV_VDIELEMENTALPAL">VDI_ELEMENTALPAL</a> *</td>
<td width="75%">Pointeur sur un tableau de NbColors
<20>l<EFBFBD>ments de type VDI_ELEMENTPAL. La palette propos<6F>e
est index<65>e sur les indices VDI (ceux utilis<69>s par les
fonctions VDI comme le trac<61> d'une ligne) et non TOS
(ceux que vous r<>cup<75>rerez par les fonctions raster de <a
href="vapi/index.htm#Pr<50>sentation">VAPI</a>).
Heureusement, <a href="vapi/index.htm#Pr<50>sentation">VAPI</a>
propose des fonctions pour transformer les indices VDI en
indices TOS et vice-versa.</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_VDIELEMENTALPAL"></a><font size="4"><strong>5.5
VDI_ELEMENTALPAL</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
short Red ;
short Green ;
short Blue ;
}
VDI_ELEMENTPAL ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">Red</td>
<td align="center" width="15%">short</td>
<td width="75%">Composante <font color="#FF0000">Rouge</font>
de l'index VDI de la palette (0 &lt;= index &lt;= 1000)</td>
</tr>
<tr>
<td align="center">Green</td>
<td align="center">short</td>
<td>Composante <font color="#00FF00">Verte</font> de
l'index VDI de la palette (0 &lt;= index &lt;= 1000)</td>
</tr>
<tr>
<td align="center">Blue</td>
<td align="center">short</td>
<td>Composante <font color="#0000FF">Bleue</font> de
l'index VDI de la palette (0 &lt;= index &lt;= 1000)</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_PARAMS"></a><font size="4"><strong>5.6 LDV_PARAMS</strong></font></p>
<pre><font size="4"><strong>typedef struct
{
short x1, y1, x2, y2 ;
short NbParams ;
LDV_BASICPARAM Param[LDVNBMAX_PARAMETERS] ;
void* UserParam ;
}
LDV_PARAMS ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">x1</td>
<td align="center" width="15%">short</td>
<td width="75%">Position X du bord haut-gauche du
rectangle <20> traiter (0 si image enti<74>re)</td>
</tr>
<tr>
<td align="center">y1</td>
<td align="center">short</td>
<td>Position Y du bord haut-gauche du rectangle <20>
traiter (0 si image enti<74>re)</td>
</tr>
<tr>
<td align="center">x2</td>
<td align="center">short</td>
<td>Position X du bord bas-droit du rectangle <20> traiter
(largeur image - 1 si image enti<74>re)</td>
</tr>
<tr>
<td align="center">y2</td>
<td align="center">short</td>
<td>Position Y du bord bas-droit du rectangle <20> traiter
(hauteur image - 1 si image enti<74>re)</td>
</tr>
<tr>
<td align="center">NbParams</td>
<td align="center">short</td>
<td>Nombre de param<61>tres valides dans le tableau Param</td>
</tr>
<tr>
<td align="center">Param</td>
<td align="center"><a href="#LDV_BASICPARAM">LDV_BASICPARAM</a></td>
<td>Tableau contenant les param<61>tres saisis depuis
l'interface de <em><strong>VISION</strong></em></td>
</tr>
<tr>
<td align="center">UserParam</td>
<td align="center">void *</td>
<td>Si votre LDV a besoin de stocker des donn<6E>es
suppl<70>mentaires lors d'un appel <20> <a
href="descrip.htm#getparams">GetParams</a>, ce pointeur
peut <20>tre utilis<69> pour <20>a. Par exemple si votre LDV
prend en pararm<72>tre un tableau de matrice 4x4, c'est
clair que la structure &quot;de base&quot; LDV_PARAMS ne
peut convenir. Il vous suffit alors de faire pointer
UserParam sur votre matrice lors de l'appel <20> <a
href="descrip.htm#getparams">GetParams</a>, vous
retrouverez cette m<>me valeur lorsque <em><strong>VISION</strong></em>
appellera la fonction <a href="descrip.htm#run">Run</a>.
Vous pouvez m<>me d<>cider d'allouer dynamiquement la
structure qui vous convient lors de l'appel <20> <a
href="descrip.htm#getparams">GetParams</a>, puis de
l'utiliser (et de la lib<69>rer...) lors de l'appel <20> <a
href="descrip.htm#run">Run</a>.</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<p><a name="LDV_BASICPARAM"></a><font size="4"><strong>5.7
LDV_BASICPARAM (UNION)</strong></font></p>
<pre><font size="4"><strong>typedef union
{
short s ;
float f ;
}
LDV_BASICPARAM ;</strong></font></pre>
<div align="center"><center>
<table border="2" width="100%">
<tr>
<td align="center" width="10%"><strong>Champ</strong></td>
<td align="center" width="15%"><strong>Type</strong></td>
<td align="center" width="75%"><strong>Remarques</strong></td>
</tr>
<tr>
<td align="center" width="10%">s</td>
<td align="center" width="15%">short</td>
<td width="75%">Valeur du param<61>tre (si ce param<61>tre,
d<>fini dans le <a href="descrip.htm#fichier ini">.INI
associ<63></a> est de type entier)</td>
</tr>
<tr>
<td align="center">f</td>
<td align="center">float</td>
<td>Valeur du param<61>tre (si ce param<61>tre, d<>fini dans
le <a href="descrip.htm#fichier ini">.INI associ<63></a>
est de type float). Actuellement le type float n'est pas
g<>r<EFBFBD> et <20>tant donn<6E> que les compilateurs peuvent ne
pas coder les float suivant le m<>me format, je vous
recommande fortement d'utiliser le type short.</td>
</tr>
</table>
</center></div>
<p>&nbsp;</p>
<hr>
<div align="center"><center>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="center" width="17%"><a href="defines.htm"><img
src="images/cprev.jpg" alt="Chapitre pr<70>c<EFBFBD>dent"
border="0" hspace="2" width="46" height="26"></a><a
href="index.htm"><img src="images/csom.jpg"
alt="Retour au sommaire" border="0" hspace="2" width="26"
height="26"></a><a href="kitdev.htm"><img
src="images/csuiv.jpg" alt="Chapitre suivant" border="0"
hspace="2" width="43" height="26"></a></td>
<td align="center" valign="top" rowspan="2" width="8%"><p
align="center"><img src="images/icoprinc.gif" width="59"
height="71"></p>
</td>
<td width="33%"><p align="center"><font color="#0000FF"
size="5"><strong>Documentation </strong><em><strong>VISION
(LDV)</strong></em></font></p>
</td>
<td align="center" valign="top" rowspan="2" width="8%"><p
align="center"><img src="images/icointro.gif" width="59"
height="71"></p>
</td>
<td valign="top" width="17%"><p align="left">Derni<EFBFBD>re
mise <20> jour : <!--webbot bot="Timestamp" startspan
s-type="EDITED" s-format="%d/%m/%y" -->16/05/01<!--webbot
bot="Timestamp" i-checksum="12425" endspan --></p>
</td>
</tr>
<tr>
<td width="17%"><p align="center"><a
href="..\..\download/dvldv.zip">T<EFBFBD>l<EFBFBD>charger la doc</a></p>
</td>
<td width="33%"><p align="center"><font size="4"><strong>S
T R U C T U R E S</strong></font></p>
</td>
<td valign="top" width="17%">&nbsp; </td>
</tr>
</table>
</center></div>
</body>
</html>