SDK - Kit de desenvolvimento

Os desenvolvedores de softwares assistivos que desejarem oferecer aos seus usuários a possibilidade de imprimir em Braille podem fazer isso hoje com extrema facilidade: basta seguir algumas instruções simples.

Algumas vantagens obtidas ao integrar a impressão em Braille do Biblos

Com extrema simplicidade, é possível oferecer aos próprios usuários um sistema profissional e confiável de impressão em Braille
O Biblos é um software acessível, já utilizado por pessoas cegas e videntes, profissionais, associações, escolas e gráficas especializadas
O Biblos está sempre atualizado, pode ser utilizado no Windows XP, Vista, 7, 8 e 10 e está disponível nas versões de 32 e 64 bits
O Biblos é um processador de texto completo que permite economizar, pois dispensa a aquisição de licenças de outros softwares. Por exemplo, não é necessário comprar licenças do Office

O Biblos é sempre instalado na pasta de sistema "Programas": ..\DIGRANDE\BIBLOS5
A pasta "Programas" deve ser sempre obtida utilizando as funcionalidades do sistema, nunca por meio de caminhos predefinidos. Portanto, o Biblos pode ser iniciado executando o arquivo "Biblos.exe".
Se o caminho e o arquivo executável não existirem, significa que o Biblos não está instalado no sistema. Verificar a presença do arquivo "Biblos.exe" é útil para confirmar se o Biblos está instalado. No final deste documento há um exemplo de código para obter o caminho do Biblos, caso esteja presente.
Além disso, é possível iniciar o Biblos utilizando apenas seu nome no shell do sistema. Por exemplo, é possível abrir a janela "Executar" do Windows e digitar o comando "Biblos". Isso iniciará o Biblos. O nome "Biblos" também pode ser utilizado pela instrução da API "ShellExecute".

Para automatizar a abertura e a impressão em Braille de documentos, "Biblos.exe" aceita alguns parâmetros:

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

-p é o parâmetro que inicia o Biblos para fins de impressão em Braille
"%1" é o parâmetro no qual é especificado o nome do arquivo a ser aberto e impresso em Braille. É recomendável colocar o parâmetro entre aspas, para permitir que o Windows identifique seu nome completo, incluindo os espaços
"%2" é o parâmetro opcional que especifica o nome da Tabela Braille a ser selecionada para a impressão em Braille. É recomendável colocar este valor entre aspas, assim como o nome do arquivo. O Biblos identifica a Tabela a ser selecionada de duas maneiras: primeiro, procura pelo nome da Tabela; se não encontrar um nome correspondente, procura pelo nome do arquivo da Tabela. Nesse segundo caso, o nome especificado deve incluir a extensão ".bbt". Na ausência da variável %2, o Biblos seleciona a Tabela armazenada nas opções

Como integrar a impressão em Braille ao seu software

No menu Arquivo do software, insira o comando de menu: Imprimir em Braille com o Biblos... Como alternativa, pode ser utilizada outra posição no menu, um menu de contexto, um botão etc.
Durante a inicialização da interface do usuário, verifique a presença do Biblos no sistema, verificando a existência do arquivo executável "Biblos.exe", conforme descrito anteriormente. Se o arquivo existir, o comando de impressão será ativado; se não existir, será desativado

Quando o usuário clica no comando de impressão em Braille

Salve o documento a ser impresso em um caminho e arquivo temporários
É recomendável salvar o documento em um formato conhecido pelo Biblos. Um bom compromisso é o formato RTF. Se desejar, no Biblos é possível personalizar um formato de usuário próprio, associando uma determinada extensão de arquivo a um formato predefinido
Inicie o Biblos conforme explicado anteriormente. Em seguida, o foco do sistema passa para o Biblos, que exibe a janela de impressão em Braille. Após a impressão em Braille, ou depois que ela for cancelada, o Biblos é fechado e o foco retorna ao seu software
Para verificar se o Biblos está aberto, a fim de desabilitar outros comandos do seu software, é possível verificar a presença das janelas do Biblos ou de seu processo no sistema. O nome da classe da janela do Biblos, sempre presente quando o Biblos está em execução, é: "TBiblosHidden". É possível utilizar a API do sistema FindWindow para verificar se a janela está presente. Mais abaixo há um exemplo de código que verifica se o Biblos está em execução

Uma função Delphi que retorna o caminho do Biblos 5, se instalado

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;

Uma função Delphi que retorna true se o Biblos estiver em execução

Uses
WinApi.Windows;

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