
                       Libreria Visual para Modo Texto
                       -------------------------------
                                   VGATEXT
                                   -------




                          Que es VGATEXT.LIB 1.0 ?
                          ------------------------

VGATEXT es una librera ntegramente desarrollada en assembler, que provee
al programador de clipper (para DOS) una serie de herramientas que le
permitirn manipular la parte visual de su programa a travez de la placa de
video VGA, a niveles inpensables desde clipper. Ud. no necesitar programar
nada, simples invocaciones a los procedimientos adecuados haran de su
programa un deleite visual a los ojos del usuario..

La librera contiene un sistema inteligente que detecta automaticamente
la placa de video instalada en el quipo, si la placa de video o monitor, no
soportan los efectos especiales (Ej: Monitor Monocromo) Se realizan funciones
alternativas compatibles, de esta manera, usted no tiene que preocuparse de
que todas las computadoras donde se ejecutar el su sistema
sean VGA compatibles.


             Porque la MISMA APLICACION vale mas si usa VGATEXT?
             ---------------------------------------------------

El usuario normal solo VE lo que muestra la panatalla, no sabe la calidad
del codigo, ni la del programador, pero lo que ve es lo que puede juzgar.
Los efectos adicionales agregados por VGATEXT son incomparables y
deslumbrantes, no existe en el mundo competencia alguna, ni parecida a esta
librera para clipper, de modo que el comprador de su aplicacion en clipper
ver algo nunca antes visto, y se sorpender de la calidad visual,
asociandola con la calidad total del producto, el mismo programa con y sin
los efectos de VGATEXT puede variar su valor de venta en u$d 200 (Dolares).
dependiendo del valor base del sistema, usted puede incrementar el valor en
un 20% - 30%.

Como dice Bill Gates : Si puedes Hacerlo Bien, Haz que se VEA bien.

Estos mensajes me fueron enviados por usuarios de VGATEXT para Clipper:

- Mi sistema para Video Club incremento sus ventas notablemnte
  luego de agregarle numerosos efectos visuales de VGATEXT, Gracias por
  el excelente producto! - Roberto Benitez (Chile)

- Una empresa acaba de elegir mi sistema de entrada de datos, entre otros
  tres. Creo que VGATEXT se llev una parte del merito, porque los compradores
  elogiaron mucho la interface. - Augusto Hernn Palacios (Uruguay)

- Gracias por hacer VGATEXT, cadavez que muestro mis programas pasa lo
  mismo : Todos piensan que soy un experto en clipper por esos efectos
  especiales, claro que siempre digo que me llevaron bastante tiempo
  (algo as como una hora por programa:) - Esteban Lezama (Argentina)


*VGATEXT es SHAREWARE, para saber cmo registrarla leer al final del archivo!


                                  Funciones
                                  ---------


IsVga:
-----

Parmetros : Ninguno.
Retorno    : Entero.

Esta funcin es la encargada de detectar la presencia de una placa VGA
compatible, el retorno de un 1 (uno) significa que ha sido detectada la
presencia de dicha placa de video, por lo cual todas las funciones se
ejecutarn normalmente. El retorno de un 0 (cero) significa que no se ha
detectado, por lo tanto las funciones no harn los efectos esperados como
si la placa VGA hubiese sido detectada, sino que el chequeo interno de cada
funcin determinar la ejecucin de un efecto alternativo, soportado por
la placa de video vigente (Ejemplo : Si el efecto VGA era un borrado especial
de la pantalla, el efecto sin VGA, ser de un borrado normal). Esto quiere
decir, que aunque el programa contenga sofisticados efectos visuales que
requieran VGA, el programa se ejecutar normalmente en PC's con monitores
como Monocromticos, aunque salteando/reemplazando de forma interna y
automtica las partes exclusivas para placas de video VGA.



AlterCol:
--------

Parmetros : (NROColor, RED, GREEN, BLUE)
Retorno    : Ninguno.

Modifica un color con las ingredientes primarios dados. NROColor es el nmero
de color a modificar (0 al 15), RED, GREEN y BLUE varan entre 0 y 63,
convinandolos con los valores adecuados se puede crear cualquier color de
los 262.144 de la paleta completa de la VGA.
Esta es la tabla de los NROColor:

Color de fondo        ->    0  Black                  8  Dark Gray
                            1  Blue                   9  Light Blue
                            2  Green                 10  Light Green
                            3  Cyan                  11  Light Cyan
                            4  Red                   12  Light Red
                            5  Magenta               13  Light Magenta
                            6  Brown                 14  Yellow
Color normal de texto ->    7  Light Gray (W)        15  White (W+)


Aclaracin : El primer parmetro (NROColor) debe ser un NUMERO (0..15)
             necesariamente, no se aceptan letras como "W".



RESTORE:
-------

Parmetros : Ninguno.
Retorno    : Ninguno.

Esta funcin DEBE ser llamada Como ltima instruccin del programa!!
Es la encargada de "Volver a la normalidad" los colores retocados con la
funcin ALTERCOL.

Aclaracin : No es necesario llamar a esta funcin si el programa no ha usado
             ninguna vez la funcion AlterCol.


VGA_off:
-------

Parmetros : Ninguno.
Retorno    : Ninguno.

Desactiva la visualizacin del display. El contenido de la pantalla no se
visualizar, pero quedar y podra modificarse

Aclaracin: No tendra ningn efecto la llamada a esta funcion si el display
            ya ha sido desactivado.

VGA_on:
------

Parmetros : Ninguno.
Retorno    : Ninguno.

Activa la visualizacin del display. El contenido de la pantalla "ocultado"
anteriormente podra verse ahora...

Aclaracin: No tendra ningn efecto la llamada a esta funcion si el display
            ya ha sido activado.


FadeOut:
-------

Parmetros : Ninguno.
Retorno    : Ninguno.

Realiza un efecto visual de "Desvanecimiento" sobre todo el contenido de la
pantalla, los contenidos son borrados totalmente.

Aclaracin : A diferencia del VGA_off, esta funcin borra los contenidos de
             la pantalla tal cual lo hace un Clear, por lo cual no son
             recuperables.


FadeIn:
------

Parmetros : Ninguno.
Retorno    : Ninguno.

Realiza un efecto visual de "Surgimiento" sobre todo el contenido de la
pantalla.

Modo de uso :

A) Llamar a la funcin VGA_off, la cual desactiva la visualizacin de display.
b) Actualizar/Poner los contenidos de la pantalla
c) Llamar a la funcin FadeIn

Aclaracin : No es necesario llamar a la funcin VGA_on luego de realizado
             el FadeIn, puesto que esta ltima, realiza ese trabajo
             internamente.



Copper:
------

Parmetros : (NROColor, ClearAfter, Tiempo Max, Matiz)
Retorno    : Ninguno.

Efecto degradee multiple sobre un color, muestra hasta 400 colores diferentes
simultaneamente (Modo Texto!), ideal para presentacion.

NROColor   : Numero de Color sobre el cual actuar el efecto (0..15)

ClearAfter : Si es 1 (uno), la funcin limpiara los contenidos de la pantalla
             luego de terminado el efecto.

Tiempo Max : Tiempo Mximo en segundos que durar el efecto si es que antes
             no se presion la tecla <ESC> la cual termina el efecto
             inmediatamente. El tiempo vara entre 1 y 255 Segundos, si
             un 0 (cero) es pasado como parmetro, no habr lmite de tiempo
             y el efecto terminar al ser presionada la tecla <ESC> .

Matiz      : Paleta de colores que se utilizar para el efecto (0..4)
             0) Multicolor degradee, ideal para recuadro o letras grandes.
             1) Degradee Blanco.
             2) Degradee Rojo.
             3) Degradee Verde.
             4) Degradee Azul, similar al de Windows Tm


Cascada:
-------

Parmetros : Ninguno.
Retorno    : Ninguno.

Despliega los contenidos de la pantalla de forma rpida y vistosa, muy
recomendado para pantallas llenas/completas !

Modo de uso :

A) Llamar a la funcin VGA_off, la cual desactiva la visualizacin de display.
b) Actualizar/Poner los contenidos de la pantalla a ser desplegados.
c) Llamar a la funcin Cascada.


Aclaracin : No es necesario llamar a la funcin VGA_on luego de realizado
             el Cascada, puesto que esta ltima, realiza ese trabajo
             internamente.



                                Requerimientos
                                --------------

- Clipper Summer '87 o Posterior

- PC AT 286 o Superior

- Monitor VGA o Superior (La libreria funciona correctamente en monitores
  monocormaticos, pero no realiza los mismos efectos, sino que automaticamente
  los remplaza por otros)



                                  COPYRIGHT
                                  ---------

Todos los derechos sobre VGAText estn registrados. VGAText est siendo
distribuda como *GIFTWARE*/*SHAREWARE*.


                                RESTRICCIONES
                                -------------

Las funciones includas en VGAText no pueden ser usadas en ninguna
aplicacin, con propsitos que no sean de testeo, por los usuarios
NO REGISTRADOS. No puede ser incluida en ninguna aplicacin que est en su
forma final, sin registracin.


                                  GARANTIAS
                                  ---------

No hay garanta de ningn tipo respecto a las funciones de VGAText.


                                 REGISTRACION
                                 ------------

La libreria VGATEXT se puede obtener INSTANTANEAMENTE registrandose
por Tarjeta de Credito desde cualquier parte del mundo, servicio provisto
por RegNet Internacional.

Dirigase al Sitio oficial : www.wp.com.ar/vgatext y entre
a la seccion REGISTRACION.
La registracion se efectua a traves de RegNet - The Registration Network -
Si lo desea puede registrarse desde la pagina de RegNet :

Vgatext For Clipper
http://www.reg.net/product.asp?ID=4694

o dirijase a http://www.reg.net/   codigo de producto = 4694

Por Telefono - 1 800 WWW2REG (1 800 999-2734) o (661) 288-1827 (USA - 24hs)
Por Fax - 1 (661) 288-1867

Valor Comercial de VGATEXT: 24.90 (u$d) Dolares.

Para los usuarios de Argentina el uso de VGAText puede ser registrado mandando :

 - CUALQUIER REGALO, DE CUALQUIER tipo, que supere el valor de 9 Dolares
   al momento de envo.

Cualquier usuario registrado puede inclur las funciones de VGAText en
cualquiera de sus aplicaciones para uso personal o comercial, o cualquier
aplicacin distribuda como ejecutable. Tambin puede hacer igual uso de
versiones posteriores.

La registracin no provee los derechos para inclur las funciones de VGAText
como parte de libreras o funciones. La registracin solo provee el derecho
para inclur las funciones de VGAText solo en aplicaciones distribudas como
ejecutables (.EXE).


(El autor usa el EXEInspector para verificar el uso de sus rutinas en EXEs)

---------------------------------------------------
Para regitrar envar el REGALO a :

Fernando A. Diament
Fco. Beiro 2661
1636 Olivos
Prov. de Bs. As.
Argentina

incluya su e-mail o mande uno (direccion al final de este documento)indicando
cual fue su regalo, y recibira por ese medio, la libreria (.lib) para usar
desde Clipper.

Aclaracion: Debido a razones arbitrarias no incluy la librera de testeo
en el paquete que usted baj de internet, la unica manera de tener la
librera es REGISTRANDOSE!


-----------------------------------------------------------------------------
                           Por Fernando A. Diament
-----------------------------------------------------------------------------

Consultas/Comentarios/Opiniones/Etc sern
apreciados a vgatext@wp.com.ar