Editor de fuentes QL
====================

Versin: 1.1
Autor:   Pedro Reina
Fecha:   S.7.3.1998


Objetivo del programa
---------------------

Editar fuentes de pantalla para el QL que sean completas, es decir, que
contengan los 256 caracteres.


Requisitos del programa
-----------------------

El programa puede funcionar en un QL o en un PC, y para que se pueda utilizar
en el PC es necesario que disponga de tarjeta grfica VGA.


Arranque del programa
---------------------

Para arrancar el programa en el QL, ste debe estar en modo de alta resolucin
(MODE 4); hay que teclear

EXEC_W EFQL_exe

Se puede usar cualquier orden equivalente a EXEC_W, como por ejemplo EW.

En el PC se teclea

EFQL

Opcionalmente, se puede invocar el programa escribiendo como parmetro el
nombre del fichero de configuracin que se desea usar. Si se deseara usar el
fichero de nombre "Ejemplo", habra que teclear en el QL

EXEC_W EFQL_exe ; "Ejemplo"

(Para usar esta opcin es necesario que en el QL est instalado Toolkit II).

En el PC habra que teclear

EFQL Ejemplo


Lectura de la configuracin
---------------------------

Si se invoca EFQL sin especificar ninguna configuracin, se busca una por
defecto:

En el QL, se busca el fichero EFQL_cnf en el directorio de datos establecido
por Toolkit II.

En el PC, se busca el fichero EFQL.cnf en el directorio actual.


Uso del programa
----------------

El programa presenta un men principal con cinco opciones:

La opcin Salida permite concluir el programa. Tambin se puede salir del
programa pulsando ESC en el men principal.

La opcin Explica presenta unas indicaciones sobre el uso del programa y la
forma de contactar con el autor.

La opcin Fichero es la que permite leer y grabar fuentes de letras.
Se encuentran 4 opciones:

    La opcin Lee busca en el directorio seleccionado todos los ficheros que
    coincidan con la mscara que est escrita en ese momento y que tengan la
    extensin correcta. Aparece un men con todos los archivos encontrados. Se
    selecciona el que se desea leer o se pulsa ESC para anular el proceso.

    Opcionalmente, los ficheros pueden aparecer en orden alfabtico si en el
    men "Opciones" se selecciona "Orden" S.

    Nota: en el QL los nombres de ficheros muy largos pueden no aparecer
    completos en la lista, aunque se leern perfectamente.

    La opcin Grabar permite almacenar en un fichero la fuente de letras que
    est en memoria en ese momento. Una fuente se puede grabar de dos formas:
    en formato nativo, que es el utilizado directamente por el QL, y en formato
    de texto C, que es cdigo fuente en C para poder incluir la fuente en un
    programa en C.

    Cuando el programa pida un nombre para grabar la fuente, hay que escribir
    el nombre sin extensin, ya que esta se asigna automticamente segn sea el
    formato que se vaya a usar.

    La opcin Directorio permite especificar el directorio donde se buscarn
    los ficheros. Si se deja en blanco, se toma como directorio en el PC, el
    actual y en el QL, el de datos de Toolkit II.

    La opcin Mscara permite escribir la mscara que se usar para buscar
    ficheros. Se pueden usar dos caracteres especiales: el asterisco (*), que
    significa cualquier cantidad de caracteres y la interrogacin (?), que
    significa uno o ningn carcter.

    La opcin Extensin permite especificar la extensin de los ficheros
    de fuentes.

La opcin Edicin es la que dirige la creacin y modificacin de las fuentes de
letras. Cuando se entra en esta opcin, aparecen tres cuadros en la pantalla:

    El grande de la derecha permite observar la fuente completa. Si se desea
    que la representacin en pantalla de la fuente est siempre actualizada,
    basta poner en el men "Opciones" la entrada "Juego" en Visible.

    El cuadro pequeo de arriba a la izquierda se utiliza en algunas opciones
    para pedir datos al usuario.

    El cuadro grande de abajo a la izquerda es en el que se puede editar cada
    carcter individualmente.

Dentro de la opcin "Edicin" se dispone de un men con cinco opciones que se
explican a continuacin:

    En la opcin Carcter se pide el nmero de carcter que se desea editar y a
    continuacin aparece el carcter magnificado de manera que es fcil variar
    su aspecto.

    Nota: no se aconseja usar ni la columna de la izquierda ni las dos de la
    derecha, ya que entonces los caracteres se sobreescribiran en algunos
    tamaos.

    La opcin Fuente permite que aparezcan todos los caracteres tal como se
    encuentran en ese momento. Si el "Opciones" se ha especificado "Juego" como
    visible, esta opcin no es necesaria.

    La opcin Copiar permite copiar un carcter sobre otro.

    La opcion Aadir permite aadir los puntos que forman un carcter sobre los
    de otro, pero de modo que no se pierden los puntos que forman el carcter
    destino.

    La opcin Borrar permite borrar todos los caracteres de la fuente. Se pide
    confirmacin al usuario antes de borrar efectivamente los caracteres.

La opcin Opciones se usa para especificar tres parmetros del programa:

    La opcin Sonido permite tener seales acsticas durante el programa.

    La opcin Juego controla que todos los caracteres se visualicen siempre
    actualizados dentro de la opcin "Edicin" o slo se actualicen al activar
    la opcin "Fuente"

    La opcin Orden determina que la lista de ficheros que aparece en la opcin
    "Lee" del men "Fichero" est en orden alfabtico o aparezcan tal como se
    encuentran en el directorio.


El fichero de configuracin
---------------------------

Cuando se invoca EFQL se puede cargar un fichero de configuracin para definir
algunos parmetros del programa.

Los ficheros de configuracin son simples ficheros de texto que se pueden crear
y modificar con cualquier editor de texto. Se pueden introducir cuantos
comentarios se desee. Se considera comentario toda lnea que comience con el
carcter '*' y toda la parte de una lnea a partir de la doble barra ("//").
Las lneas en blanco se ignoran.

Para configurar un parmetro hay que introducir una lnea en el fichero que
tenga como primera palabra el indicador de lo que se quiere configurar y a
continuacin el valor o valores que se desean dar. Se pueden introducir en
cualquier orden.

Para ayudar al usuario a crear su propio fichero de configuracin se incluye
uno de ejemplo, llamado EFQL_cnf en el QL y EFQL.cnf en el PC.

Para configurar un parmetro hay que introducir una lnea en el fichero que
tenga como primera palabra el indicador de lo que se quiere configurar y a
continuacin el valor o valores que se desean dar. Se pueden introducir en
cualquier orden.

Para ayudar al usuario a crear su propio fichero de configuracin se incluye
uno de ejemplo, llamado EFQL_cnf en el QL y EFQL.cnf en el PC.

A continuacin se describen las posibles entradas:

Sonido

Escribiendo "S" o "No", se especifica si el programa debe comenzar con el
sonido conectado o no. Si este parmetro no se incluye el programa toma por
defecto el valor "No".

Mostrar

Escribiendo "S" o "No", se especifica si el juego de caracteres debe
presentarse siempre actualizado dentro de men "Edicin". Si este parmetro no
se incluye el programa toma por defecto el valor "No".

Ordenar

Escribiendo "S" o "No", se especifica si la lista de ficheros que aparece en
la opcin "Lee" del men "Fichero" debe verse en orden alfabtico o tal como se
encuentran en el directorio. Si este parmetro no se incluye el programa toma
por defecto el valor "No".

Fuentes de ejemplo
------------------

Junto con el programa se entregan dos fuentes de letras: Decimal_qls y
Thor_qls. La primera permite conocer el nmero decimal de cualquier octeto de
un fichero binario, usando por ejemplo la utilidad MORE de Simon N. Goodwin. La
segunda es una fuente til para reemplazar la original del QL y creo que
apareci por primera vez en los ordenadores Thor.
