SDK - Kit de développement

Les développeurs de logiciels d'assistance qui souhaitent offrir à leurs utilisateurs la possibilité d'imprimer en braille peuvent désormais le faire très facilement : il leur suffit de suivre quelques instructions simples.

Quelques avantages de l'intégration de l'impression braille de Biblos

• Vous offrez très facilement à vos utilisateurs un système professionnel et fiable d'impression en braille
• Biblos est un logiciel accessible, déjà utilisé par des personnes voyantes et non-voyantes, des professionnels, des associations, des écoles et des imprimeries
• Biblos est constamment mis à jour et fonctionne sous Windows XP, Vista, 7, 8, 10. Il est disponible en versions 32 bits et 64 bits
• Biblos est un traitement de texte complet qui permet de réaliser des économies, puisqu'il évite l'achat de licences pour d'autres logiciels. Par exemple, il n'est pas nécessaire d'acquérir des licences Office

Biblos est toujours installé dans le dossier système « Programmes » : ..\DIGRANDE\BIBLOS5
Le dossier « Programmes » doit toujours être obtenu à l'aide des fonctionnalités du système, sans jamais utiliser de chemins prédéfinis. Biblos peut donc être lancé en exécutant le fichier « Biblos.exe ».
Si le chemin ou le fichier exécutable n'existe pas, cela signifie que Biblos n'est pas installé sur le système. Vérifier la présence du fichier « Biblos.exe » est un moyen simple de savoir si Biblos est installé. Un exemple de code permettant d'obtenir le chemin d'installation de Biblos, lorsqu'il est présent, figure à la fin de ce document.
Il est également possible de lancer Biblos en utilisant uniquement son nom dans l'interpréteur de commandes du système. Par exemple, ouvrez la fenêtre « Exécuter » de Windows et saisissez la commande « Biblos ». Cela lancera Biblos. Le nom « Biblos » peut également être utilisé avec l'instruction API « ShellExecute ».

Afin d'automatiser l'ouverture et l'impression en braille des documents, « Biblos.exe » accepte certains paramètres :

Biblos.exe -p "%1" "%2"

• -p est le paramètre qui lance Biblos en mode impression braille
• "%1" est le paramètre qui indique le nom du fichier à ouvrir et à imprimer en braille. Il est recommandé de placer ce paramètre entre guillemets afin de permettre à Windows d'identifier le nom complet du fichier, y compris les espaces
• "%2" est le paramètre facultatif indiquant le nom de la Table Braille à sélectionner pour l'impression en braille. Il est recommandé de placer également cette valeur entre guillemets, comme pour le nom du fichier. Biblos recherche la Table à sélectionner de deux manières : il recherche d'abord le nom de la Table ; s'il ne trouve aucune correspondance, il recherche ensuite le nom du fichier de la Table. Dans ce second cas, le nom doit être indiqué avec l'extension « .bbt ». Si la variable %2 n'est pas fournie, Biblos sélectionne la Table enregistrée dans les options

Comment intégrer l'impression en braille dans son propre logiciel

• Dans le menu Fichier du logiciel, ajouter la commande de menu : Imprimer en braille avec Biblos... Il est également possible d'utiliser un autre emplacement dans le menu, un menu contextuel, un bouton, etc.
• Lors de l'initialisation de l'interface utilisateur, vérifier la présence de Biblos sur le système en contrôlant la présence du fichier exécutable "Biblos.exe", comme décrit précédemment. Si le fichier existe, la commande d'impression sera activée ; s'il n'existe pas, elle sera désactivée

Lorsque l'utilisateur clique sur la commande d'impression en braille

• Enregistrer le document à imprimer dans un fichier temporaire
• Il est utile d'enregistrer le document dans un format reconnu par Biblos. Le format RTF constitue un bon compromis. Dans Biblos, il est également possible de personnaliser son propre format utilisateur en associant une extension de fichier donnée à un format prédéfini
• Lancer Biblos comme expliqué précédemment. Le focus système passe alors à Biblos, qui affiche la fenêtre d'impression en braille. Après l'impression en braille, ou après son annulation, Biblos se ferme et le focus revient dans le logiciel d'origine
• Pour vérifier si Biblos est ouvert, afin de désactiver temporairement d'autres commandes de son propre logiciel, il est possible de vérifier la présence des fenêtres de Biblos ou de son processus système. Le nom de classe de la fenêtre de Biblos, toujours présent lorsque Biblos est en cours d'exécution, est : "TBiblosHidden". L'API système FindWindow peut être utilisée pour vérifier si la fenêtre est présente. Un exemple de code permettant de vérifier si Biblos est en cours d'exécution est disponible plus bas

Une fonction Delphi qui retourne le chemin de Biblos 5, s'il est installé

---

uses
Winapi.Windows, Winapi.Shlobj, System.Sysutils;

Function getBiblosPath: string;

{}

Function getBP(cs: integer): string;
const
BiblosExe5 = 'digrande\biblos5\biblos.exe';
var
idl: pItemIdlist;
p: pChar;
begin
Result:= '';
Getmem(p,max_path);
Fillmemory(p,max_path,0);
if succeeded(shgetspecialfolderlocation(0, cs, idl)) then
if shgetpathfromidlist(idl,p) then
begin
Result:= IncludeTrailingPathDelimiter(string(p))+ BiblosExe5;
If fileExists(Result) = false then result:= '';
End;
Freemem(p,max_path);
End;

{}

Begin
Result:= getBP(csidl_program_files);;
If Result = '' then
Result:= getBP(csidl_program_filesx86);;
End;

---

Une fonction Delphi qui retourne true si Biblos est en cours d'exécution

---

Uses
WinApi.Windows;

Function IsBiblosRun: boolean;
begin
result:= not(FindWindow('TBiblosHidden',nil)=0);
end;

---