GBMPLOAD()
 Carga en memoria un fichero de mapa de bits (.BMP) o de icono (.ICO)
------------------------------------------------------------------------------
 Sintaxis

     GBMPLOAD(<cNombreFich>) --> aMatrizBmp

 Argumentos

     <cNombreFich> es un valor de tipo carácter que representa el nombre
     del fichero .BMP o .ICO que se va a cargar en la memoria VMM.

 Devuelve

     GBMPLOAD() devuelve una referencia a <aMatrizBmp>, que es un puntero a
     la región VMM que contiene los datos del fichero .BMP o .ICO (el icono
     no es monocromo). Los dos primeros elementos de <aMatrizBmp> contienen
     la altura y la anchura en píxeles de la imagen del fichero .BMP o .ICO.
     No es aconsejable modificar esta matriz antes de pasársela a
     GBMPDISP(). La tabla siguiente muestra la estructura de la matriz:

     Estructura de aMatrizBmp
     ------------------------------------------------------------------------
     Posición de la matriz        Valor devuelto
     ------------------------------------------------------------------------
     LLG_BMP_X                    Devuelve el tamaño en el eje X
     LLG_BMP_Y                    Devuelve el tamaño en el eje Y
     ------------------------------------------------------------------------

     El tamaño y los elementos de la matriz nunca deben modificarse.

 Descripción

     GBMPLOAD() permite cargar en memoria uno o más ficheros .BMP o .ICO.
     Esta función no muestra el contenido de los ficheros. Es útil cuando
     se necesita cargar un grupo de ficheros .BMP que contienen pequeñas
     imágenes que la aplicación utiliza con frecuencia (p.e., botones).
     Evita cargar un fichero .BMP cada vez que es necesario mostrarlo.

     ¡Advertencia! No es conveniente almacenar en memoria tramas de
     fondo o imágenes salvo que se disponga de mucho espacio. Esto también
     es aplicable a cualquier variable que apunte a variables que contengan
     mapas de bits.

 Notas

     Si se almacena el contenido de un fichero .BMP o .ICO en una variable
     LOCAL, la memoria VMM ocupada se libera de forma automática al
     finalizar la función. La memoria puede liberarse en cualquier momento
     asignando un valor de NIL a la variable. Es posible utilizar GBMPLOAD()
     sin estar en modo gráfico, pero es preciso cambiar a este modo antes de
     llamar a GBMPDISP().

 Ejemplos

      Este ejemplo almacena en una matriz todos los botones
        utilizados por una aplicación:

        STATIC aIconos:= {}
        AADD(aIconos, GBMPLOAD('FLECHA_U.BMP'))
        AADD(aIconos, GBMPLOAD('FLECHA_D.BMP'))
        AADD(aIconos, GBMPLOAD('FLECHA_L.BMP'))
        AADD(aIconos, GBMPLOAD('FLECHA_R.BMP'))
        // Establece el modo gráfico de vídeo
        SET VIDEOMODE TO LLG_VIDEO_VGA_640_480_16
        // Visualiza FLECHA_U.BMP
        GBMPDISP(aIconos[1], 100, 200)

 Ficheros   La biblioteca asociada es LLIBG.LIB,
            el fichero de cabecera asociado es Llibg.ch.

 To download this example - click here.

See Also: GBMPDISP() GMODE() GSETPAL() GWRITEAT()