Envío de faxes desde programas Clipper

Faxual II ofrece a los programas Clipper 5.x la posibilidades de usar cualquier tarjeta fax/módem Clase 1 o Clase 2. Los faxes pueden contener texto o gráficos en formato PCX. Faxual II es totalmente compatible con ExoSpace y Blinker, y puede hacerse un overlay casi completo usando Blinker y WarpLink. Faxual II actúa como una tarea de fondo sin interferir el programa que se ejecuta en primer plano.

Requerimientos

• CA-Clipper 5.x o posterior
• Menos de 2 Kb de memoria convencional

Lista de funciones

Funciones generales:

F2ErrorMessage() – Convierte un código de error en un mensaje
F2Error() – Código de error de la última operación

Funciones del dispositivo fax:

El dispositivo fax es el software equivalente a una máquina fax. Es el responsable de enviar y recibir faxes, y de informar de su estado. Enviar un fax requiere los pasos siguientes (algunos son opcionales):

1. Crear uno o más faxes a enviar. Puesto que puede enviar varios ficheros en un mismo trabajo de fax, puede incluir una portada en un fichero y el texto en otra, o unir varios documentos diferentes para crear un solo fax.
2. Configurar el dispositivo fax. (Sólo se requiere hacerlo una vez, antes de enviar el primer fax). Todo programa debe al menos llamar a estas dos funciones: FaxLocalId() para establecer el ID local (número de teléfono en la cabecera de página) y FaxPort() para conectar el dispositivo de fax a un puerto serie.
3. Abrir el puerto serie mediante SerOpen(). Puede abrir y cerrar el puerto para cada fax, o abrirlo al inicio del programa y dejarlo así hasta su finalización.
4. Ejecutar FaxSend(). Tras comprobar que el dispositivo de fax está disponible y que todos los ficheros son correctos, FaxSend() finaliza y se inicia la transmisión del fax como tarea de fondo.
5. Esperar la finalización del envío. Durante este tiempo, el programa puede hacer otro trabajo, o simplemente esperar a que el controlador de fax finalice. Es posible comprobar el estado del fax enviado mediante FaxStatus(), o ignorarlo hasta que sea necesario enviar otro fax.
6. Comprobar su finalización. Una vez que FaxStatus() indique que el trabajo de fax ha finalizado, puede determinar si ha tenido éxito (o por qué ha fallado) mediante StError(). Puede obtener otros datos de interés en ese momento, como el tiempo de comunicación (StConTime()) o el número de páginas enviadas (StJPagesDone()).
7. Reiniciar el dispositivo fax. Con ello, se prepara para aceptar otro trabajo de fax. (También reinicia el estado del último trabajo.)
8. Si lo desea, puede cerrar el puerto serie. También puede mantenerlo abierto y listo para el siguiente trabajo.

FaxCancel() – Cancela la operación actual
FaxDriver() – Asigna al controlador de fax un intervalo de tiempo
FaxModemType() – Lee/fija el tipo de módem
FaxOptions() – Lee/fija opciones del dispositivo
FaxReset() – Reinicia dispositivo
FaxSend() – Envía un fax
FaxStatus() – Obtiene estado del dispositivo fax

Funciones de estado del dispositivo fax:

StConTime() – Obtiene tiempo de conexión
StDate() – Obtiene fecha del fax
StError() – Obtiene código de error
StFByteCount() – Obtiene cuenta de bytes del fichero
StFBytesDone() – Obtiene bytes de fichero procesados
StFileNumber() – Obtiene número de fichero
StFilename() – Obtiene nombre de fichero
StFPageCount() – Obtiene cuenta de páginas del fichero
StFPageNumber() – Obtiene número de página del fichero
StFPagesDone() – Obtiene páginas del fichero procesadas
StJByteCount() – Obtiene cuenta de bytes del trabajo
StJBytesDone() – Obtiene bytes del trabajo procesados
StJFileCount() – Obtiene cuenta de ficheros del trabajo
StJFilesDone() – Obtiene ficheros del trabajo procesados
StJPageCount() – Obtiene cuenta de páginas del trabajo
StJPageNumber() – Obtiene número de página del trabajo
StJPagesDone() – Obtiene páginas del trabajo procesadas
StMode() – Obtiene modo de operación
StPByteCount() – Obtiene cuenta de bytes de la página
StPBytesDone() – Obtiene bytes de la página procesados
StPhase() – Determina la fase de la operación
StPhaseTime() – Obtiene tiempo de la fase
StRemoteId() – Obtiene ID remota
StSpeed() – Obtiene velocidad de conexión
StTime() – Obtiene hora del fax
StTotTime() – Obtiene tiempo total del trabajo

Funciones serie E/S:

Faxual II permite usar tanto su propio conjunto de funciones de E/S predefinidas, como el de la biblioteca de comunicaciones serie Telepathy para comunicarse con el fax/módem. Las funciones descritas en este apartado están disponibles en cualquier caso. Si utiliza la capa de E/S serie predefinida, estas funciones llaman a esta capa; si utiliza Telepathy, se llaman a las funciones adecuadas de Telepathy en su lugar.

SerClose() – Cierra puerto serie
SerFormat() – Lee/fija formato de datos serie
SerHandshake() – Lee/fija handshaking
SerOpen() – Abre puerto serie
SerReceive() – Recibe datos
SerSend() – Envía datos
SerSetup() – Configura puerto serie
SerSpeed() – Lee/fija velocidad puerto serie

Funciones RIP de los ficheros de fax:

RIP es el acrónimo de Raster Image Processor. RIP es el procesador que ejecuta una impresora. El RIP de Faxual II realiza esta misma función. En este caso, es un software RIP el que produce los ficheros fax.

RipBegin() – Crea una página fax
RipCJust() – Centra una línea de texto
RipClipLimit() – Lee/fija el límite de recorte
RipClipRect() – Fija el rectángulo de recorte
RipCol() – Lee/fija columna actual
RipColUnit() – Lee/fija unidad de columna
RipCurX() – Lee/fija posición X actual
RipCurY() – Lee/fija posición Y actual
RipCutoff() – Obtiene longitud de página utilizada
RipDrawBitmap() – Dibuja un bitmap
RipDrawRect() – Dibuja el borde de un rectángulo
RipEject() – Final de página
RipEnd() – Final de fax
RipFillRect() – Rellena un rectángulo de gris
RipFont() – Lee/fija fuente actual
RipLength() – Lee longitud de página
RipLJust() – Justifica a la izquierda una línea de texto (X/Y)
RipMoveRel() – Mueve el punto actual de forma relativa (X/Y)
RipMoveTo() – Mueve el punto actual de forma absoluta (X/Y)
RipOrigin() – Fija el origen de coordenadas
RipPos() – Mueve el punto actual (R/C)
RipRCCJust() – Centra una línea de texto (R/C)
RipRCLJust() – Justifica a la izquierda una línea de texto (R/C)
RipRCRJust() – Justifica a la derecha una línea de texto (R/C)
RipRCUnits() – Fija unidades de fila/columna
RipRJust() – Justifica a la derecha una línea de texto (X/Y)
RipResolution() – Obtiene resolución de página
RipRow() – Lee/fija fila actual
RipRowUnit() – Lee/fija unidad de filas
RipTextOp() – Lee/fija operador de texto
RipTextSize() – Lee tamaño de texto
RipUnit() – Lee fija unidades X/Y
RipWidth() – Lee anchura de página
RipWrite() – Escribe texto en la posición actual
RipXOrigin() – Lee/fija origen X
RipYOrigin() – Lee/fija origen Y

Funciones de tipo de letra:

Un fichero de tipo de letra contiene, además de la imagen de los caracteres, diferente información sobre el tipo de letra. Los atributos incluyen:

FontCharSet() – Obtiene juego de caracteres
FontFamilyName() – Obtiene nombre de la familia del tipo de letra
FontFullName() – Obtiene nombre completo del tipo de letra
FontIsBold() – Obtiene indicador de negrita
FontIsItalic() – Obtiene indicador de cursiva
FontPointSize() – Obtiene tamaño en puntos del tipo de letra
FontResolution() – Obtiene resolución del tipo de letra

Mediciones del tipo de letra:

Estas funciones miden la altura de partes diferentes del tipo de letra. Se usan para determinar el espacio de texto en vertical de la página.

FontAscent() – Obtiene ascenso del carácter
FontAveWidth() – Obtiene anchura media del carácter
FontDescent() – Obtiene descenso del carácter
FontHeight() – Obtiene altura del carácter
FontLineSpacing() – Obtiene espacio entre líneas
FontMaxWidth() – Obtiene anchura máxima del carácter

Funciones de Bitmap:

BmCount() – Obtiene número de bitmaps cargados
BmHandle() – Obtiene manejador de bitmap cargado
BmLength() – Obtiene longitud de bitmap
BmLoadPcx() – Carga un fichero gráfico PCX
BmWidth() – Obtiene anchura de bitmap
BmUnload() – Descarga un bitmap