335 lines
17 KiB
HTML
335 lines
17 KiB
HTML
<! *** 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ônes</a> (ICONS.INF)
|
||
<li><a href="#THING.INF">Configuration géné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ônes</a>
|
||
<dd><a href="../pages/tim.htm">Thing Icon Manager</a><p>
|
||
</dl>
|
||
|
||
'ICONS.INF' contient la liste d'affectation des icônes. Cette liste définit quelles sont les icônes
|
||
du fichier 'ICONS.RSC' associées aux différents lecteurs, fichiers et dossiers. Si le fichier
|
||
'ICONS.INF' est introuvable, ce sont les <a href="../pages/icones.htm">icônes</a> standard de Thing
|
||
qui sont utilisées par défaut.<p>
|
||
|
||
Thing recherche le fichier 'ICONS.INF' dans le même répertoire que THING.APP et dans celui dé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ée.<p>
|
||
|
||
<dl>
|
||
<dt>Structure de 'ICONS.INF' :
|
||
<dd>- Les lignes vierges sont ignorées par Thing ;
|
||
<dd>- Les lignes précédées par le caractère '#' sont ignorées par Thing ;
|
||
<dd>- La longueur maximale d'une ligne ne doit pas excéder 510 caractères ;
|
||
<dd>- 'ICONS.INF' n'est pas conservé en mémoire. De ce fait, les affectations et interprétations ne
|
||
sont pas optimisées par des structures internes et c'est pourquoi il n'existe pas de fonction à
|
||
l'intérieur de Thing pour modifier les affectations d'icônes.<p>
|
||
</dl>
|
||
|
||
Chaque ligne du fichier 'ICONS.INF' a le format suivant :<p>
|
||
|
||
<table border align=center>
|
||
<tr><th colspan=2 align=center><type> "<Icône>" <joker>[,<joker>..]
|
||
[<caractère/s>]
|
||
<tr><td align=center><type><td>IFIL - Affectation pour les fichiers/programmes ;<br>
|
||
IFLD - Affectation pour les dossiers ;<br>
|
||
IDRV - Affectation pour les lecteurs ;
|
||
<tr><td align=center><Icône><td>Description de l'icône dans le fichier 'ICONS.RSC' ;
|
||
<tr><td align=center><joker><td>Un ou plusieurs masques (jokers), séparés par une virgule,
|
||
peuvent être spécifiés. Il n'y a pas de différenciation entre les majuscules et les minuscules.
|
||
'*.TXT', '*.txt', '*.Txt' sont considérés de la même façon. Les lecteurs peuvent être suivis d'une
|
||
lettre correspondant à l'unité comme : IDRV "FLOPPY" A,B.
|
||
<tr><td align=center><caractère><td>Eventuellement, un caractère peut être ajouté à une icône
|
||
après le masque <joker>. Ce caractère doit être précédé d'un espace et non d'une virgule. En
|
||
mode texte, ce caractère apparaîtra devant le nom du fichier. Il peut être utile pour repérer
|
||
certains fichiers, surtout quand la fonte utilisée contient des caractè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é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ône affectée à '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ésolutions indépendamment des préférences (mise à part les
|
||
affectations d'icônes). Thing recherche ce fichier dans le même répertoire que 'THING.APP' ainsi
|
||
que dans le répertoire dé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ètres suivants sont sauvegardés dans 'THING.INF' :
|
||
<dd>- Paramètres 'Fenêtres' ;
|
||
<dd>- Paramètres 'TOS2GEM' ;
|
||
<dd>- Paramètres 'Copie' ;
|
||
<dd>- Paramètres 'Système' ;
|
||
<dd>- Applications installées ;
|
||
<dd>- Position et taille des fenêtres y compris celle de la console ;
|
||
<dd>- Aspect 3D, clic droit et alignement d'icônes.<p>
|
||
|
||
<dt>Structure de 'THING.INF' :
|
||
<dd>- Les lignes vierges sont ignorées par Thing ;
|
||
<dd>- Les lignes précédées du caractère '#' sont ignorées par Thing ;
|
||
<dd>- La longueur maximale d'une ligne ne doit pas excéder 510 caractères ;
|
||
<dd>- Chaque entrée est constituée de 4 caractères (mot-clé) suivie d'une description spécifique.<p>
|
||
</dl>
|
||
|
||
Vu que Thing évolue, la structure de ce fichier peut changer. L'entrée
|
||
'VERS' est une instruction pratique qui permet de connaître avec quelle
|
||
version de Thing le fichier a été créé, 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éro de version est généré par Thing et ne doit être modifié manuellement !
|
||
L'instruction 'VERS' a été introduite à partir de la version 0.24 de Thing. Cependant, le
|
||
fichier 'THING.INF' peut servir pour n'importe quelle version, mais il sera interprété
|
||
partiellement ou même complétement ignoré.
|
||
</table>
|
||
<br>
|
||
|
||
D'autres informations sur la structure des différentes lignes sont disponibles sur demande, mais à
|
||
l'heure actuelle, il n'y a pas d'intérêt à décrire les données contenues dans 'THING.INF', car
|
||
celles-ci sont diffé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ésolution d'écran, dépendante de la configuration du bureau est sauvegardée dans des fichiers
|
||
nommés de la façon suivante :<p>
|
||
|
||
<pre>
|
||
xxxxyyyy.Izz
|
||
</pre>
|
||
|
||
'xxxx' correspond à la résolution horizontale et 'yyyy' à la ré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ésolution de 640x400 avec 2 couleurs aura un fichier nommé
|
||
06400400.I01.<p>
|
||
|
||
Thing recherche ce fichier dans le même répertoire que 'THING.APP' ainsi que dans le répertoire
|
||
dé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énéré un fichier avec l'extension 'GRP'. Pour chaque fenêtre sont
|
||
sauvées les informations suivantes :<p>
|
||
|
||
<dl>
|
||
<dd>- Le titre du groupe ;
|
||
<dd>- La position et la taille de la fenêtre ;
|
||
<dd>- L'affichage sous forme d'icô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ées par Thing ;
|
||
<dd>- Les lignes précédées du caractère '#' sont ignorées par Thing ;
|
||
<dd>- La longueur maximale d'une ligne ne doit pas excéder 510 caractères ;
|
||
<dd>- Chaque entrée est constituée de 4 caractères (mot-clé) suivie d'une description spé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ère entrée contient le titre du groupe, la position de la fenêtre, ... :<p>
|
||
|
||
<table border align=center>
|
||
<tr><th colspan=2 align=center>INFO "<titre>" <x> <y> <l> <h>
|
||
<affichage> <sauvegarde>
|
||
<tr><td align=center><titre><td>Titre du groupe jusqu'à 32 caractères ;
|
||
<tr><td align=center><x>, <y>, <l>, <h><td>Position et taille de la fenêtre
|
||
convertie en coordonnées système de 0/0 à 10000/10000 ;
|
||
<tr><td align=center><affichage><td>Type d'affichage :<br>
|
||
0 = icônes<br>
|
||
1 = texte
|
||
<tr><td align=center><sauvegarde><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 "<titre>" <fichier> "<paramètres>"
|
||
<tr><td align=center><titre><td>Titre du fichier dans la fenêtre jusqu'à 32 caractères ;
|
||
<tr><td align=center><fichier><td>Nom du fichier ;
|
||
<tr><td align=center><paramètres><td>Ligne de commande des paramè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 "<titre>" <répertoire> "<joker>"
|
||
<tr><td align=center><titre><td>Titre du dossier dans la fenêtre jusqu'à 32 caractères ;
|
||
<tr><td align=center><répertoire><td>Nom du dossier suivi d'un '\' ;
|
||
<tr><td align=center><joker><td>Masque de fichiers ou '*' pour l'ensemble des fichiers.
|
||
</table>
|
||
<br>
|
||
|
||
Les <a href="../pages/bureau.htm#Objets">objets</a> sont affichés dans la fenêtre groupe dans
|
||
l'ordre de la liste du fichier '*.GRP'. S'il n'y a pas de répertoire absolu spécifié pour les noms
|
||
de fichiers et dossiers, Thing utilise le répertoire du fichier de groupe. Quelques options
|
||
'spéciales' comme '..\readme' et d'autres similaires sont autorisées. Egalement, le masque de
|
||
fichier peut être omis (exemple : <joker> défini comme "").<p>
|
||
|
||
<table border align=center>
|
||
<tr><td><img src="../images/232.gif" align=left alt="232.GIF">
|
||
Il est possible d'insérer des caractères spé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 être utilisée directement dans les programmes afin que ceux-ci puissent générer
|
||
eux-mê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çon, d'autres
|
||
programmes peuvent intégrer cette fonctionnalité et transmettre à 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 être édité à l'aide d'un éditeur
|
||
comme Interface, ORCS, WERCS, ... Si vous tentez d'éditer ce fichier, portez une attention
|
||
particulière à ce qui suit :<p>
|
||
|
||
<ul>
|
||
<li>Thing calcule les coordonnées à l'aide de la 'taille contour' (outline size) plut"t qu'avec la
|
||
fonte système. Le premier objet du fichier 'THING.RSC' contient cet état sous forme de chaîne
|
||
(objet n°1) dans le premier arbre :<p>
|
||
|
||
"8 16" ... signifie que le 'contour' (outline) du fichier est d'une taille de 8x16 pixels. Ce
|
||
paramètre doit être modifié pour travailler avec une fonte système de remplacement qui peut, par
|
||
exemple, être de 7x12, 8x8 pixels, ...<p>
|
||
|
||
<li><b>Un fichier ressource modifié ne doit être en aucun cas diffusé ! Si vous cré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çaise.</b><p>
|
||
|
||
<li>Le fichier ressource est déjà limité à 64 Ko. Donc, si vous l'éditez à 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 être directement édités
|
||
sous MagiC). En utilisant les intercalaires (index de cartes) dans les boîtes de dialogue, les
|
||
raccourcis pour quelques boutons ne sont pas directement visibles, mais les définitions sont
|
||
compatibles avec MagiC.<p>
|
||
|
||
<li>Les raccourcis des menus peuvent également être modifiés. Seules les combinaisons [Shift]+[x]
|
||
et [Shift]+[Control]+[x] sont autorisées. Le raccourci [Shift]+[Delete] pour 'Effacer' ne peut
|
||
être retiré, mais d'autres raccourcis avec [Delete] peuvent être affectés.<p>
|
||
|
||
<li>L'éditeur de ressource doit être capable de lire les 8 premiers octets du type d'objet
|
||
correctement. Effectivement, l'ancien éditeur RCS de Digital Research ne gère pas ces octets
|
||
correctement !<p>
|
||
|
||
<li>Certaines boîtes de dialogue de Thing utilisent plusieurs pages sous forme d'intercalaires.
|
||
Vérifiez que votre é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é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>
|