initial commit

2023-06-12 09:14:09 +02:00
commit b4912f303e
2545 changed files with 209350 additions and 0 deletions
--- a/tools/vision/LDV/doc/defines.htm
+++ b/tools/vision/LDV/doc/defines.htm
@@ -0,0 +1,329 @@
+<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) : Defines</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="descrip.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="struct.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" -->24/07/01<!--webbot
+        bot="Timestamp" i-checksum="12454" 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>4.
+        D E F I N 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_STATUS"></a><font size="4"><strong>4.1 Type de
+code de retour</strong></font></p>
+
+<p><font size="4"><strong>typedef long LDV_STATUS</strong></font></p>
+
+<p><font size="3">Le type de code de retour des fonctions LDV est
+un entier 32 bits. Pourquoi ? Tout d'abord parce que certains
+compilateurs (GCC par exemple) retournent un entier 32 bits m<>me
+si on sp<73>cifie une entier 16 bits (short). Ensuite, cela permet
+de pr<70>voir une extension du code de retour, pour une <20>volution
+future, dans les bits restant.</font></p>
+
+<p>&nbsp;</p>
+
+<p><a name="ELDV"></a><font size="4"><strong>4.2 Codes de retour</strong></font></p>
+<div align="center"><center>
+
+<table border="2" width="100%">
+    <tr>
+        <td align="center" width="10%"><strong>Define</strong></td>
+        <td align="center" width="75%"><strong>Description</strong></td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">ELDV_NOERROR</td>
+        <td width="75%">Pas d'erreur. La fonction a fonctionn<6E>
+        correctement</td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">ELDV_INVALIDPARAMETER</td>
+        <td width="75%">Au moins un des param<61>tres est invalide</td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">ELDV_NBPLANESNOTSUPPORTED</td>
+        <td width="75%">La fonction ne supporte pas le nombre de
+        plans pass<73> en param<61>tre</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_NOTENOUGHMEMORY</td>
+        <td>M<EFBFBD>moire insuffisante</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_PREVIEWNOTSUPPORTED</td>
+        <td>La fonction Preview n'est pas d<>finie (pointe sur
+        NULL)</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_RUNNOTSUPPORTED</td>
+        <td>La fonction Run n'est pas d<>finie (pointe sur NULL).
+        Je me demande bien qui serait suffisamment naze pour
+        <20>crire un LDV ne faisant rien !</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_BADVAPIVERSION</td>
+        <td>La version de <a href="vapi/index.htm#Pr<50>sentation">VAPI</a>
+        disponible ne permet pas d'utiliser le LDV (il manque
+        certaines fonctions ou interfaces)</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_IMGFORMATMISMATCH</td>
+        <td>Les formats d'images g<>r<EFBFBD>s par le LDV ne permettent
+        pas <20> <em><strong>VISION</strong></em> de fournir une
+        image compatible avec un des formats attendus. Cela est
+        <20> priori une erreur du LDV.</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_CANCELLED</td>
+        <td>L'op<6F>ration en cours a <20>t<EFBFBD> annul<75>e par
+        l'utilisateur</td>
+    </tr>
+    <tr>
+        <td align="center">ELDV_GENERALFAILURE</td>
+        <td>Echec g<>n<EFBFBD>ral, raison non pr<70>cis<69>e</td>
+    </tr>
+</table>
+</center></div>
+
+<p>Ces codes peuvent <20>tre renvoy<6F>s par les fonctions du LDV ou
+par <em><strong>VISION</strong></em> vers l'utilisateur afin
+d'afficher le message d'erreur correspondant. Pensez aussi <20>
+utiliser la macro LDV_SUCCESS qui vous indique si le code pass<73>
+en param<61>tre correspond <20> un succes ou une erreur.</p>
+
+<p>&nbsp;</p>
+
+<p><a name="TLDV"></a><font size="4"><strong>4.3 Types de modules</strong></font></p>
+<div align="center"><center>
+
+<table border="2" width="100%">
+    <tr>
+        <td align="center" width="10%"><strong>Define</strong></td>
+        <td align="center" width="75%"><strong>Description</strong></td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">TLDV_MODIFYIMG</td>
+        <td width="75%">Module modificateur d'image. Peut
+        <20>galement servir <20> initialiser une image en <20>crasant
+        compl<70>tement son contenu afin d'en g<>n<EFBFBD>rer une
+        nouvelle, sans prendre en compte les donn<6E>es actuelles.</td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">TLDV_LOADIMG</td>
+        <td width="75%">Module de chargement d'image. <em><strong>VISION</strong></em>
+        ne le g<>re pas encore</td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">TLDV_SAVEIMG</td>
+        <td width="75%">Module de sauvegarde d'image. <em><strong>VISION</strong></em>
+        ne le g<>re pas encore</td>
+    </tr>
+</table>
+</center></div>
+
+<p>&nbsp;</p>
+
+<p><a name="LDVF"></a><font size="4"><strong>4.4 Informations sur
+les capacit<69>s</strong></font></p>
+<div align="center"><center>
+
+<table border="2" width="100%">
+    <tr>
+        <td align="center" width="10%"><strong>Define</strong></td>
+        <td align="center" width="75%"><strong>Description</strong></td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">LDVF_STDFORMAT</td>
+        <td width="75%">Le LDV accepte le format image standard
+        d<>fini par ATARI (bit-plans <20> la suite les uns des
+        autres). Ce format n'est pas valable en True Color.</td>
+    </tr>
+    <tr>
+        <td align="center" width="10%">LDVF_ATARIFORMAT</td>
+        <td width="75%">Le LDV accepte le format ATARI (bit-plans
+        entrelac<61>s (ST), modes True Color du Falcon)</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_SPECFORMAT</td>
+        <td>Le LDV accepte le format sp<73>cifique de la carte
+        graphique</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_SUPPORTPREVIEW</td>
+        <td>Le LDV fournit la fonction Preview (fortement
+        conseill<6C> m<>me si elle appelle Run)</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_AFFECTPALETTE</td>
+        <td>Le LDV modifie la palette (modes bit-plans
+        uniquement). En ce cas, l'op<6F>ration sur la palette doit
+        toujours se faire &quot;sur place&quot;. <em><strong>VISION</strong></em>
+        sauvegardera syst<73>matiquement la palette de l'image dans
+        le tampon undo.</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_SUPPORTPROG</td>
+        <td>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).
+        Avant d'appeler <a href="descrip.htm#run">Run</a>, <em><strong>VISION</strong></em>
+        affichera une fen<65>tre de progression pour le LDV et la
+        fera disparaitre ensuite. En appelant <a
+        href="vapi/pr.htm#PrSetProg">PrSetProg</a> de l'interface
+        <a href="vapi/index.htm#Pr<50>sentation">VAPI</a>, le LDV
+        pourra informer l'utilisateur de la progression du
+        traitement.</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_OPINPLACE</td>
+        <td>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 <a href="descrip.htm#run">Run</a> est le m<>me
+        que in. Dans la mesure du possible, utilisez ce flag,
+        cela <20>conomise de la m<>moire. La pr<70>sence de ce flag
+        impose <20>videmment que le LDV ne modifie pas la taille de
+        l'image.</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_REALTIMEPARAMS</td>
+        <td>Le LDV effectue assez rapidement la fonction <a
+        href="descrip.htm#run">Run</a> en mode 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). En ce cas, <em><strong>VISION</strong></em>
+        appelera la fonction Preview lorsque l'utilisateur agira
+        sur un ascenseur de contr<74>le de param<61>tre, sans que
+        celui-ci soit oblig<69> d'appuyer sur le bouton
+        &quot;Pr<EFBFBD>-Viualisation&quot;</td>
+    </tr>
+    <tr>
+        <td align="center">LDVF_SUPPORTCANCEL</td>
+        <td>La fonction <a href="descrip.htm#run">Run</a> peut
+        <20>tre annul<75>e en cours d'ex<65>cution. <em><strong>VISION</strong></em>
+        permet alors <20> la fen<65>tre de progression d'<27>tre
+        ferm<72>e par le bouton de fermeture de fen<65>tre GEM
+        (CLOSER) et par Control-C. D<>s que le LDV supporte la
+        progression, je vous conseille d'ajouter (et de g<>rer
+        ..) ce flag, c'est bien utile et <a
+        href="descrip.htm#run">pas compliqu<71> <20> impl<70>menter</a>.</td>
+    </tr>
+    <tr>
+        <td><p align="center">LDVF_NOSELECTION</p>
+        </td>
+        <td>Ce LDV ne peut pas travailler sur un bloc <20>
+        l'int<6E>rieur de l'image (s<>lection). En ce cas, <em><strong>VISION</strong></em>
+        invalide la possibilit<69> de sp<73>cifier la s<>lection lors
+        de l'application du LDV.<br>
+        Remarque : depuis la version 4.0e, <em><strong>VISION</strong></em>
+        cr<63>e une image &quot;bloc&quot; faisant ainsi croire au
+        LDV qu'il travaille sur un bloc. <em><strong>VISION</strong></em>
+        replace ensuite le bloc modifi<66> dans l'image d'origine
+        sans que le LDV ait <20> se pr<70>occuper des sp<73>cificit<69>s
+        du travail sur un bloc. En bref, si vous ne voulez pas
+        vous emb<6D>ter <20> g<>rer le travail sur un bloc,
+        positionnez ce flag, <em><strong>VISION</strong></em> se
+        charge de tout !</td>
+    </tr>
+</table>
+</center></div>
+
+<p><font size="3">Ces flags sont <20> combiner avec le &quot;ou
+logique&quot; (|).</font></p>
+
+<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="descrip.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="struct.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" -->24/07/01<!--webbot
+        bot="Timestamp" i-checksum="12454" 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>D
+        E F I N E S</strong></font></p>
+        </td>
+        <td valign="top" width="17%">&nbsp; </td>
+    </tr>
+</table>
+</center></div>
+</body>
+</html>