GBMPDISP()
 Muestra en pantalla un fichero de mapa de bits (.BMP)
------------------------------------------------------------------------------
 Sintaxis

     GBMPDISP(<aMatrizBmp>  <cFich>, <nX>, <nY>, [<nColorTrans>])
        --> NIL

 Argumentos

     <aMatrizBmp> es el puntero creado con GBMPLOAD().

     -O bien-

     <cFich> define el fichero .BMP que se va a mostrar.

     <nX> es la posición del punto inicial del eje X (columna).

     <nY> es la posición del punto inicial del eje Y (línea).

     <nColorTrans> es el color que se va a excluir.

     Si <nColorTrans> se especifica, se visualizan todos los colores de la
     imagen excepto <nColorTrans>.

 Devuelve

     GBMPDISP() devuelve siempre NIL.

 Descripción

     GBMPDISP() muestra un fichero de mapa de bits (.BMP) o un icono (.ICO)
     cargado previamente en memoria o muestra un mapa de bits almacenado en
     un fichero en disco. Esta función sólo puede utilizarse si se ha
     establecido el modo gráfico para la pantalla mediante SET VIDEOMODE.
     GBMPDISP() respeta las restricciones definidas con GSETCLIP().

     ¡Advertencia! Al visualizar un mapa de bits se utiliza la paleta de
     colores actual. Si los usuarios están autorizados a modificar la paleta
     de colores, es posible que al visualizar el mapa de bits aparezca con
     colores distintos a los que se usaron en su creación.

 Notas

     Se pueden crear efectos visuales en la superficie de un mapa de bits,
     como por ejemplo, hacer que parezca que un botón se hunde al pulsarlo.
     El efecto anterior puede simularse superponiendo un rectángulo en modo
     XOR:

     #include "Llibg.ch"
     LOCAL aMiBoton
     SET VIDEOMODE TO LLG_VIDEO_VGA_640_480_16
     // Carga el mapa de bits
     aMiBoton := gBmpLoad ("MiBoton.BMP")


        // Muestra el mapa de bits, siempre en modo SET
     gBmpDisp (aMiBoton,100,200)

     .
     .   // Código
     .
     IF mState()[LLM_STATE_LEFT] == LLM_BUTTON_DOWN

        // Al pulsar el botón, se superpone un mapa de bits

        gRect( 100,;
                 200,;
                 100 + aMiBoton[LLG_BMP_X],;
                 200 + aMiBoton[LLG_BMP_Y],;
                 LLG_FILL,;
                 8,;
                 LLG_MODE_XOR)

     ENDIF

           // Mientras el botón está pulsado...
     DO WHILE mState()[LLM_STATE_LEFT] == LLM_BUTTON_DOWN
     .
     .   // Código
     .
     ENDDO

        // Al soltar el botón del ratón el mapa de bits
        // recupera su aspecto original

        gRect(100,;
                200,;
                100 + aMiBoton[LLG_BMP_X],;
                200 + aMiBoton[LLG_BMP_Y],;
                LLG_FILL,;
                8,;
                LLG_MODE_XOR)

 Ejemplos

      Este ejemplo muestra los botones almacenados en aIconos
        mediante GBMPLOAD():

        gBmpDisp(aIconos,100,200)

      Este ejemplo carga y visualiza un fondo sin utilizar
        variables. En este caso, el área que ocupa la matriz en VMM se
        libera una vez que CA-Clipper ha terminado de visualizar el mapa de
        bits.

        gBmpDisp(gBmpLoad("MiEscr.BMP") , 0 , 0 )

 To download this example - click here.

See Also: GBMPLOAD() GSETPAL() GWRITEAT() SET VIDEOMODE