Kit di sviluppo
Gli sviluppatori di software assistivi che volessero offrire ai propri utenti la possibilità di stampare in braille, oggi possono farlo con estrema facilità: basta seguire poche e semplici istruzioni.
Alcuni vantaggi che si ottengono integrando la stampa in braille di Biblos
- Con estrema semplicità si offre ai propri utenti un sistema di stampa in braille professionale e affidabile
- Biblos è un software gratuito, diffusamente utilizzato come software assistivo
- Biblos è un software accessibile, già utilizzato da persone vedenti e non-vedenti, professionisti, associazioni, scuole e stamperie
- Biblos è sempre aggiornato, utilizzabile in Windows Xp, Vista, 7, 8, 10, disponibile in versione 32 bit e 64 bit
- Biblos è un word processor completo con cui si risparmia, perché consente di non acquistare licenze di altri software. Per esempio, non si devono comprare licenze di Office
Biblos viene sempre installato nella cartella di sistema dei "Programmi": ..\DIGRANDE\BIBLOS5
La cartella "Programmi" dovrebbe essere sempre ricavata avvalendosi delle funzionalità di sistema, mai usando percorsi preimpostati. Quindi Biblos può essere avviato lanciando il file eseguibile "Biblos.exe".
Se il percorso e il file eseguibile non esistono, significa che Biblos non è installato nel sistema. Controllare la presenza del file "Biblos.exe" è utile per verificare se Biblos è installato. In coda a questo documento è presente un esempio di codice su come ricavare il percorso di Biblos, se presente.
Inoltre, è possibile avviare Biblos utilizzando solo il suo nome nella shell di sistema. Per esempio, si può aprire la finestra "Esegui" di Windows e scrivere il comando "Biblos". Questo avvierà Biblos. Il nome "Biblos" può essere utilizzato anche dall'istruzione API "ShellExecute".
Al fine di automatizzare l'apertura e la stampa braille di documenti, "Biblos.exe" accetta alcuni parametri:
Biblos.exe -p "%1" "%2"
- -p è il parametro che avvia Biblos ai fini della stampa in braille
- "%1" è il parametro in cui si specifica il nome del file da aprire e stampare in braille. E' bene racchiudere il parametro tra virgolette, per consentire a Windows di individuarne il nome completo, inclusi gli spazi
- "%2" è il parametro opzionale del nome della Tabella Braille da selezionare per la stampa Braille. Questo valore è utile metterlo tra virgolette, come quello del file. Biblos individua la Tabella da selezionare in due modi: per primo cerca secondo il nome della Tabella; se non trova un nome corrispondente, cerca secondo il nome del file della Tabella. In questo secondo caso il nome da specificare va indicato compreso di estensione ".bbt". In assenza della variabile %2 Biblos seleziona la Tabella memorizzata nelle opzioni
Come integrare la stampa in braille nel proprio software
- Nel menù File del software inserire il comando di menù: Stampa in braille con Biblos... In alternativa può essere utilizzata un'altra posizione di menù, un menù contestuale, un pulsante ecc..
- Durante l'inizializzazione dell'interfaccia utente, verificare la presenza di Biblos nel sistema, controllando la presenza del file eseguibile "Biblos.exe", come descritto prima. Se il file esiste, il comando di stampa verrà attivato; se non esiste verrà disattivato
Quando l'utente clicca sul comando di stampa in braille
- Si salva il documento da stampare in un percorso e file temporaneo
- È utile salvare il documento in un formato conosciuto da Biblos. Un buon compromesso è il formato RTF. Volendo in Biblos si può personalizzare un proprio formato utente, associando una determinata estensione di file a un formato predefinito
- Si avvia Biblos come spiegato prima. Quindi, il focus di sistema passa a Biblos che mostra la finestra di stampa in braille. Dopo la stampa in braille, o dopo averla annullata, Biblos si chiude e il focus torna nel proprio software
- Per controllare se Biblos è aperto, al fine di inibire altri comandi del proprio software, si può verificare la presenza delle finestre di Biblos o del suo processo di sistema. Il nome della classe della finestra di Biblos sempre presente quando Biblos è in esecuzione è: "TBiblosHidden". Ci si può avvalere dell'API di sistema FindWindow per verificare se la finestra sia presente. Più in basso è disponibile un esempio di codice che verifica se Biblos è in esecuzione
Una funzione Delphi che ritorna il path di Biblos 5, se installato
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;
Una funzione Delphi che ritorna true se Biblos è in esecuzione
Uses
WinApi.Windows;
Function IsBiblosRun: boolean;
begin
result:= not(FindWindow('TBiblosHidden',nil)=0);
end;