first commit - moved from local dev to git

This commit is contained in:
firebee
2022-10-02 10:09:40 +02:00
commit bbb3ef9333
1861 changed files with 167960 additions and 0 deletions

View File

@@ -0,0 +1,334 @@
<! *** En-t<>te ***>
<html><head><title>Thing V1.09 - Format des fichiers</title></head>
<body>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers ***>
<! ------------------------------------------------------------------------------------------------>
<h3>Format des fichiers</h3>
<ul>
<li><a href="#ICONS.INF">Affectation des ic&ocirc;nes</a> (ICONS.INF)
<li><a href="#THING.INF">Configuration g&eacute;n&eacute;rale</a> (THING.INF)
<li><a href="#XXXXYYYY.INF">Configuration du bureau</a> (xxxxyyyy.INF)
<li><a href="#*.GRP">Groupes d'objets</a> (*.GRP)
<li><a href="#THING.RSC">Ressource</a> (THING.RSC)
</ul>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers, 'ICONS.INF' ***>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<h3>Format des fichiers, <a name="ICONS.INF">'ICONS.INF'</a></h3>
<dl>
<dt>Voir aussi :
<dd><a href="../pages/icones.htm">Ic&ocirc;nes</a>
<dd><a href="../pages/tim.htm">Thing Icon Manager</a><p>
</dl>
'ICONS.INF' contient la liste d'affectation des ic&ocirc;nes. Cette liste d&eacute;finit quelles sont les ic&ocirc;nes
du fichier 'ICONS.RSC' associ&eacute;es aux diff&eacute;rents lecteurs, fichiers et dossiers. Si le fichier
'ICONS.INF' est introuvable, ce sont les <a href="../pages/icones.htm">ic&ocirc;nes</a> standard de Thing
qui sont utilis&eacute;es par d&eacute;faut.<p>
Thing recherche le fichier 'ICONS.INF' dans le m&ecirc;me r&eacute;pertoire que THING.APP et dans celui d&eacute;fini
par la variable d'environnement <a href="../pages/variable.htm#THINGDIR">THINGDIR</a>, si celle-ci
existe. La variable <a href="../pages/variable.htm#HOME">HOME</a> est ignor&eacute;e.<p>
<dl>
<dt>Structure de 'ICONS.INF' :
<dd>- Les lignes vierges sont ignor&eacute;es par Thing ;
<dd>- Les lignes pr&eacute;c&eacute;d&eacute;es par le caract&egrave;re '#' sont ignor&eacute;es par Thing ;
<dd>- La longueur maximale d'une ligne ne doit pas exc&eacute;der 510 caract&egrave;res ;
<dd>- 'ICONS.INF' n'est pas conserv&eacute; en m&eacute;moire. De ce fait, les affectations et interpr&eacute;tations ne
sont pas optimis&eacute;es par des structures internes et c'est pourquoi il n'existe pas de fonction &agrave;
l'int&eacute;rieur de Thing pour modifier les affectations d'ic&ocirc;nes.<p>
</dl>
Chaque ligne du fichier 'ICONS.INF' a le format suivant :<p>
<table border align=center>
<tr><th colspan=2 align=center>&lt;type&gt; "&lt;Ic&ocirc;ne&gt;" &lt;joker&gt;[,&lt;joker&gt;..]
[&lt;caract&egrave;re/s&gt;]
<tr><td align=center>&lt;type&gt;<td>IFIL - Affectation pour les fichiers/programmes ;<br>
IFLD - Affectation pour les dossiers ;<br>
IDRV - Affectation pour les lecteurs ;
<tr><td align=center>&lt;Ic&ocirc;ne&gt;<td>Description de l'ic&ocirc;ne dans le fichier 'ICONS.RSC' ;
<tr><td align=center>&lt;joker&gt;<td>Un ou plusieurs masques (jokers), s&eacute;par&eacute;s par une virgule,
peuvent &ecirc;tre sp&eacute;cifi&eacute;s. Il n'y a pas de diff&eacute;renciation entre les majuscules et les minuscules.
'*.TXT', '*.txt', '*.Txt' sont consid&eacute;r&eacute;s de la m&ecirc;me fa&ccedil;on. Les lecteurs peuvent &ecirc;tre suivis d'une
lettre correspondant &agrave; l'unit&eacute; comme : IDRV "FLOPPY" A,B.
<tr><td align=center>&lt;caract&egrave;re&gt;<td>Eventuellement, un caract&egrave;re peut &ecirc;tre ajout&eacute; &agrave; une ic&ocirc;ne
apr&egrave;s le masque &lt;joker&gt;. Ce caract&egrave;re doit &ecirc;tre pr&eacute;c&eacute;d&eacute; d'un espace et non d'une virgule. En
mode texte, ce caract&egrave;re appara&icirc;tra devant le nom du fichier. Il peut &ecirc;tre utile pour rep&eacute;rer
certains fichiers, surtout quand la fonte utilis&eacute;e contient des caract&egrave;res sous forme de symboles
graphiques.
</table>
<br>
Voici un exemple :<p>
<pre>
# Programmes individuels
#
IFIL "KOBOLD 2" kobold_2.prg
IFIL "PURE C" pc.prg
#
# Fichiers
#
IFIL "APP" *.prg,*.app
IFIL "TOS" *.tos,*.ttp
IFIL "RSC" *.rsc r
IFIL "TXT" *.txt,*.doc
#
# Dossiers
#
IFLD "AUTO DIR" auto
IFLD "GEMSYS DIR" gemsys
#
# Lecteurs
#
IDRV "DONALD" c
IDRV "FILESYSTEM" i,u
</pre>
<table border align=center>
<tr><td><img src="../images/229.gif" align=left alt="229.gif">
Il est important de d&eacute;finir tous les fichiers, programmes et dossiers individuels avant ceux
comportant des jokers (exemple : 'PC.PRG' avant '*.PRG'), car la liste est lue de haut en bas.<p>
Dans l'exemple ci-dessus, et si '*.PRG' est avant 'PC.PRG', l'ic&ocirc;ne affect&eacute;e &agrave; 'PC.PRG' ne sera pas
reconnue.
</table>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers, THING.INF ***>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<h3>Format des fichiers, <a name="THING.INF">THING.INF</a></h3>
'THING.INF' contient toutes les r&eacute;solutions ind&eacute;pendamment des pr&eacute;f&eacute;rences (mise &agrave; part les
affectations d'ic&ocirc;nes). Thing recherche ce fichier dans le m&ecirc;me r&eacute;pertoire que 'THING.APP' ainsi
que dans le r&eacute;pertoire d&eacute;fini par les variables d'environnement <a
href="../pages/variable.htm#THINGDIR">THINGDIR</a> et <a
href="../pages/variable.htm#HOME">HOME</a>, quand elles existent.<p>
<dl>
<dt>Les param&egrave;tres suivants sont sauvegard&eacute;s dans 'THING.INF' :
<dd>- Param&egrave;tres 'Fen&ecirc;tres' ;
<dd>- Param&egrave;tres 'TOS2GEM' ;
<dd>- Param&egrave;tres 'Copie' ;
<dd>- Param&egrave;tres 'Syst&egrave;me' ;
<dd>- Applications install&eacute;es ;
<dd>- Position et taille des fen&ecirc;tres y compris celle de la console ;
<dd>- Aspect 3D, clic droit et alignement d'ic&ocirc;nes.<p>
<dt>Structure de 'THING.INF' :
<dd>- Les lignes vierges sont ignor&eacute;es par Thing ;
<dd>- Les lignes pr&eacute;c&eacute;d&eacute;es du caract&egrave;re '#' sont ignor&eacute;es par Thing ;
<dd>- La longueur maximale d'une ligne ne doit pas exc&eacute;der 510 caract&egrave;res ;
<dd>- Chaque entr&eacute;e est constitu&eacute;e de 4 caract&egrave;res (mot-cl&eacute;) suivie d'une description sp&eacute;cifique.<p>
</dl>
Vu que Thing &eacute;volue, la structure de ce fichier peut changer. L'entr&eacute;e
'VERS' est une instruction pratique qui permet de conna&icirc;tre avec quelle
version de Thing le fichier a &eacute;t&eacute; cr&eacute;&eacute;, par exemple :<p>
VERS 61<p>
61 pour la version 0.61, 100 pour la version 1.00, ...<p>
<table border align=center>
<tr><td><img src="../images/229.gif" align=left alt="229.GIF">
Le num&eacute;ro de version est g&eacute;n&eacute;r&eacute; par Thing et ne doit &ecirc;tre modifi&eacute; manuellement !
L'instruction 'VERS' a &eacute;t&eacute; introduite &agrave; partir de la version 0.24 de Thing. Cependant, le
fichier 'THING.INF' peut servir pour n'importe quelle version, mais il sera interpr&eacute;t&eacute;
partiellement ou m&ecirc;me compl&eacute;tement ignor&eacute;.
</table>
<br>
D'autres informations sur la structure des diff&eacute;rentes lignes sont disponibles sur demande, mais &agrave;
l'heure actuelle, il n'y a pas d'int&eacute;r&ecirc;t &agrave; d&eacute;crire les donn&eacute;es contenues dans 'THING.INF', car
celles-ci sont diff&eacute;rentes pour chaque version.<p>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers, configuration du bureau ***>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<h3>Format des fichiers, <a name="XXXXYYYY.INF">configuration du bureau</a></h3>
La r&eacute;solution d'&eacute;cran, d&eacute;pendante de la configuration du bureau est sauvegard&eacute;e dans des fichiers
nomm&eacute;s de la fa&ccedil;on suivante :<p>
<pre>
xxxxyyyy.Izz
</pre>
'xxxx' correspond &agrave; la r&eacute;solution horizontale et 'yyyy' &agrave; la r&eacute;solution verticale en pixels. 'zz'
indique le nombre de couleurs de la palette : 01 en monochrome, 02 pour 4 couleurs, 04 pour 16
couleurs, ... Par exemple, une r&eacute;solution de 640x400 avec 2 couleurs aura un fichier nomm&eacute;
06400400.I01.<p>
Thing recherche ce fichier dans le m&ecirc;me r&eacute;pertoire que 'THING.APP' ainsi que dans le r&eacute;pertoire
d&eacute;fini par les variables d'environnement <a href="../pages/variable.htm#THINGDIR">THINGDIR</a> et
<a href="../pages/variable.htm#HOME">HOME</a>, quand elles existent.<p>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers, groupes d'objets ***>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<h3>Format des fichiers, <a name="*.GRP">groupes d'objets</a></h3>
Pour chaque groupe d'objets est g&eacute;n&eacute;r&eacute; un fichier avec l'extension 'GRP'. Pour chaque fen&ecirc;tre sont
sauv&eacute;es les informations suivantes :<p>
<dl>
<dd>- Le titre du groupe ;
<dd>- La position et la taille de la fen&ecirc;tre ;
<dd>- L'affichage sous forme d'ic&ocirc;nes ou de texte.<p>
</dl>
Le contenu d'un fichier groupe est similaire aux autres fichiers de configuration.<p>
<dl>
<dt>Structure d'un fichier groupe '*.GRP' :
<dd>- Les lignes vierges sont ignor&eacute;es par Thing ;
<dd>- Les lignes pr&eacute;c&eacute;d&eacute;es du caract&egrave;re '#' sont ignor&eacute;es par Thing ;
<dd>- La longueur maximale d'une ligne ne doit pas exc&eacute;der 510 caract&egrave;res ;
<dd>- Chaque entr&eacute;e est constitu&eacute;e de 4 caract&egrave;res (mot-cl&eacute;) suivie d'une description sp&eacute;cifique.<p>
</dl>
Contrairement aux autres fichiers de configuration, la structure des fichiers groupe restera
compatible avec les futures versions de Thing.<p>
La premi&egrave;re entr&eacute;e contient le titre du groupe, la position de la fen&ecirc;tre, ... :<p>
<table border align=center>
<tr><th colspan=2 align=center>INFO "&lt;titre&gt;" &lt;x&gt; &lt;y&gt; &lt;l&gt; &lt;h&gt;
&lt;affichage&gt; &lt;sauvegarde&gt;
<tr><td align=center>&lt;titre&gt;<td>Titre du groupe jusqu'&agrave; 32 caract&egrave;res ;
<tr><td align=center>&lt;x&gt;, &lt;y&gt;, &lt;l&gt;, &lt;h&gt;<td>Position et taille de la fen&ecirc;tre
convertie en coordonn&eacute;es syst&egrave;me de 0/0 &agrave; 10000/10000 ;
<tr><td align=center>&lt;affichage&gt;<td>Type d'affichage :<br>
0 = ic&ocirc;nes<br>
1 = texte
<tr><td align=center>&lt;sauvegarde&gt;<td>Sauvegarde automatique :<br>
0 = non<br>
1 = oui
</table>
<br>
Les objets des fichiers ont le format suivant :<p>
<table border align=center>
<tr><th colspan=2 align=center>OFIL "&lt;titre&gt;" &lt;fichier&gt; "&lt;param&egrave;tres&gt;"
<tr><td align=center>&lt;titre&gt;<td>Titre du fichier dans la fen&ecirc;tre jusqu'&agrave; 32 caract&egrave;res ;
<tr><td align=center>&lt;fichier&gt;<td>Nom du fichier ;
<tr><td align=center>&lt;param&egrave;tres&gt;<td>Ligne de commande des param&egrave;tres pour le programme.
</table>
<br>
Les objets des dossiers ont le format suivant :<p>
<table border align=center>
<tr><th colspan=2 align=center>OFLD "&lt;titre&gt;" &lt;r&eacute;pertoire&gt; "&lt;joker&gt;"
<tr><td align=center>&lt;titre&gt;<td>Titre du dossier dans la fen&ecirc;tre jusqu'&agrave; 32 caract&egrave;res ;
<tr><td align=center>&lt;r&eacute;pertoire&gt;<td>Nom du dossier suivi d'un '\' ;
<tr><td align=center>&lt;joker&gt;<td>Masque de fichiers ou '*' pour l'ensemble des fichiers.
</table>
<br>
Les <a href="../pages/bureau.htm#Objets">objets</a> sont affich&eacute;s dans la fen&ecirc;tre groupe dans
l'ordre de la liste du fichier '*.GRP'. S'il n'y a pas de r&eacute;pertoire absolu sp&eacute;cifi&eacute; pour les noms
de fichiers et dossiers, Thing utilise le r&eacute;pertoire du fichier de groupe. Quelques options
'sp&eacute;ciales' comme '..\readme' et d'autres similaires sont autoris&eacute;es. Egalement, le masque de
fichier peut &ecirc;tre omis (exemple : &lt;joker&gt; d&eacute;fini comme "").<p>
<table border align=center>
<tr><td><img src="../images/232.gif" align=left alt="232.GIF">
Il est possible d'ins&eacute;rer des caract&egrave;res sp&eacute;ciaux ainsi que des guillemets dans les titres
sous forme de code ASCII. Toutefois, ceux-ci ne sont pas admis dans les noms des fichiers et
dossiers.<p>
<pre>
ASCII 1 ... 31 "@01" ... "@31"
Guillemets (") "@34"
Arobace (@) "@64"
</pre>
Cette option peut &ecirc;tre utilis&eacute;e directement dans les programmes afin que ceux-ci puissent g&eacute;n&eacute;rer
eux-m&ecirc;mes des fichiers groupe !<p>
Thing peut aussi ouvrir des fichiers groupe si le nom du groupe est transmis par un message
AV_START ou <a href="../pages/protocol.htm#AV_STARTPROG">AV_STARPROG</a>. De cette fa&ccedil;on, d'autres
programmes peuvent int&eacute;grer cette fonctionnalit&eacute; et transmettre &agrave; Thing une ouverture de fichier
groupe.
</table>
<! ------------------------------------------------------------------------------------------------>
<! *** Format des fichiers, THING.RSC ***>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<h3>Format des fichiers, <a name="THING.RSC">THING.RSC</a></h3>
Thing utilise actuellement un fichier ressource externe qui peut &ecirc;tre &eacute;dit&eacute; &agrave; l'aide d'un &eacute;diteur
comme Interface, ORCS, WERCS, ... Si vous tentez d'&eacute;diter ce fichier, portez une attention
particuli&egrave;re &agrave; ce qui suit :<p>
<ul>
<li>Thing calcule les coordonn&eacute;es &agrave; l'aide de la 'taille contour' (outline size) plut"t qu'avec la
fonte syst&egrave;me. Le premier objet du fichier 'THING.RSC' contient cet &eacute;tat sous forme de cha&icirc;ne
(objet n&#176;1) dans le premier arbre :<p>
"8 16" ... signifie que le 'contour' (outline) du fichier est d'une taille de 8x16 pixels. Ce
param&egrave;tre doit &ecirc;tre modifi&eacute; pour travailler avec une fonte syst&egrave;me de remplacement qui peut, par
exemple, &ecirc;tre de 7x12, 8x8 pixels, ...<p>
<li><b>Un fichier ressource modifi&eacute; ne doit &ecirc;tre en aucun cas diffus&eacute; ! Si vous cr&eacute;ez une version
dans une autre langue, faites-moi parvenir une copie que j'inclurais dans la version officielle.
Actuellement sont disponibles les versions anglaise, allemande et fran&ccedil;aise.</b><p>
<li>Le fichier ressource est d&eacute;j&agrave; limit&eacute; &agrave; 64 Ko. Donc, si vous l'&eacute;ditez &agrave; l'aide d'Interface,
prenez soin de ne pas le sauver au format RSX, car le fichier sera trop gros !<p>
<li>Tous les raccourcis clavier sont compatibles avec MagiC (ils peuvent &ecirc;tre directement &eacute;dit&eacute;s
sous MagiC). En utilisant les intercalaires (index de cartes) dans les bo&icirc;tes de dialogue, les
raccourcis pour quelques boutons ne sont pas directement visibles, mais les d&eacute;finitions sont
compatibles avec MagiC.<p>
<li>Les raccourcis des menus peuvent &eacute;galement &ecirc;tre modifi&eacute;s. Seules les combinaisons [Shift]+[x]
et [Shift]+[Control]+[x] sont autoris&eacute;es. Le raccourci [Shift]+[Delete] pour 'Effacer' ne peut
&ecirc;tre retir&eacute;, mais d'autres raccourcis avec [Delete] peuvent &ecirc;tre affect&eacute;s.<p>
<li>L'&eacute;diteur de ressource doit &ecirc;tre capable de lire les 8 premiers octets du type d'objet
correctement. Effectivement, l'ancien &eacute;diteur RCS de Digital Research ne g&egrave;re pas ces octets
correctement !<p>
<li>Certaines bo&icirc;tes de dialogue de Thing utilisent plusieurs pages sous forme d'intercalaires.
V&eacute;rifiez que votre &eacute;diteur de ressource n'associe pas automatiquement les objets 'parent/enfant'.<p>
</ul>
<! ------------------------------------------------------------------------------------------------>
<hr size=1>
<table border align=center>
<tr><td align=center><a href="../pages/menus.htm">Commandes des menus</a>
<td align=center><a href="../pages/tim.htm">Thing Icon Manager</a>
<td align=center bgcolor=blue><font color=white>Format des fichiers</font>
<td align=center><a href="../pages/protocol.htm">Protocoles</a>
<td align=center><a href="../pages/variable.htm">Variables d'environnement</a>
<tr><td align=center><a href="../pages/intro.htm#TOSWIN">Thing et TOSWIN sous MiNT</a>
<td align=center><a href="../pages/histoire.htm">Historique</a>
<td align=center><a href="../pages/faq.htm">Questions/R&eacute;ponses</a>
<td align=center><a href="../pages/clavier.htm">Souris et clavier</a>
<td bgcolor=beige align=center><a href="../home.htm">Sommaire</a>
</table>
</body>
</html>