SDK - Kit de desarrollo
Los desarrolladores de software de asistencia que quieran ofrecer a sus usuarios la posibilidad de imprimir en braille ahora pueden hacerlo con extrema facilidad: basta con seguir unas pocas instrucciones sencillas.
Algunas ventajas de integrar la impresión en braille de Biblos
- Con extrema sencillez se ofrece a los usuarios un sistema de impresión en braille profesional y fiable
- Biblos es un software accesible, ya utilizado por personas videntes y ciegas, profesionales, asociaciones, escuelas e imprentas
- Biblos está siempre actualizado, puede utilizarse en Windows XP, Vista, 7, 8 y 10, y está disponible en versiones de 32 y 64 bits
- Biblos es un procesador de textos completo que permite ahorrar, ya que evita tener que adquirir licencias de otros programas. Por ejemplo, no es necesario comprar licencias de Office
Biblos siempre se instala en la carpeta del sistema "Programas": ..\DIGRANDE\BIBLOS5
La carpeta "Programas" debe obtenerse siempre utilizando las funciones del sistema, nunca mediante rutas preestablecidas. Por tanto, Biblos puede iniciarse ejecutando el archivo "Biblos.exe".
Si la ruta y el archivo ejecutable no existen, significa que Biblos no está instalado en el sistema. Comprobar la presencia del archivo "Biblos.exe" es útil para verificar si Biblos está instalado. Al final de este documento se incluye un ejemplo de código para obtener la ruta de Biblos, si está presente.
Además, es posible iniciar Biblos utilizando únicamente su nombre en el shell del sistema. Por ejemplo, se puede abrir la ventana "Ejecutar" de Windows y escribir el comando "Biblos". Esto iniciará Biblos. El nombre "Biblos" también puede utilizarse mediante la instrucción API "ShellExecute".
Para automatizar la apertura y la impresión en braille de documentos, "Biblos.exe" acepta algunos parámetros:
Biblos.exe -p "%1" "%2"
- -p es el parámetro que inicia Biblos para realizar la impresión en braille
- "%1" es el parámetro en el que se especifica el nombre del archivo que se debe abrir e imprimir en braille. Es conveniente incluir el parámetro entre comillas para permitir que Windows identifique el nombre completo, incluidos los espacios
- "%2" es el parámetro opcional que especifica el nombre de la tabla braille que se debe seleccionar para la impresión en braille. Es conveniente incluir este valor entre comillas, al igual que el nombre del archivo. Biblos identifica la tabla que debe seleccionar de dos maneras: primero busca por el nombre de la tabla; si no encuentra un nombre coincidente, busca por el nombre del archivo de la tabla. En este segundo caso, el nombre debe especificarse incluyendo la extensión ".bbt". Si no se proporciona la variable %2, Biblos selecciona la tabla almacenada en las opciones
Cómo integrar la impresión en braille en su propio software
- En el menú Archivo del software, incluya el comando de menú: Imprimir en braille con Biblos... Como alternativa, puede utilizarse otra ubicación del menú, un menú contextual, un botón, etc.
- Durante la inicialización de la interfaz de usuario, compruebe la presencia de Biblos en el sistema verificando la existencia del archivo ejecutable "Biblos.exe", tal como se ha descrito anteriormente. Si el archivo existe, el comando de impresión se activará; si no existe, se desactivará
Cuando el usuario hace clic en el comando de impresión en braille
- Guarde el documento que se va a imprimir en una ruta y un archivo temporales
- Es recomendable guardar el documento en un formato compatible con Biblos. Un buen compromiso es el formato RTF. Si se desea, en Biblos se puede personalizar un formato de usuario propio, asociando una determinada extensión de archivo a un formato predefinido
- Inicie Biblos como se ha explicado anteriormente. De este modo, el foco del sistema pasa a Biblos, que muestra la ventana de impresión en braille. Después de imprimir en braille, o de cancelar la impresión, Biblos se cierra y el foco vuelve al propio software
- Para comprobar si Biblos está abierto, con el fin de impedir otros comandos del propio software, se puede verificar la presencia de las ventanas de Biblos o de su proceso del sistema. El nombre de la clase de ventana de Biblos que siempre está presente cuando Biblos está en ejecución es: "TBiblosHidden". Puede utilizarse la API del sistema FindWindow para comprobar si la ventana está presente. Más abajo se incluye un ejemplo de código que comprueba si Biblos está en ejecución
Una función de Delphi que devuelve la ruta de Biblos 5, si está 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;
Una función de Delphi que devuelve true si Biblos está en ejecución
Uses
WinApi.Windows;
Function IsBiblosRun: boolean;
begin
result:= not(FindWindow('TBiblosHidden',nil)=0);
end;