Manual de xsEasyC
Como Dibujar Marcos y Ventanas

La librería xsbox de xsEasyC proporciona funciones para el diseño de Marcos y Ventanas para aplicaciones de Consola. Esta librería hace uso de la librería conio; para lo cual al realizar la compilación del archivo; se debe de agregar el uso de esta librería, tal y como se muestra en el siguiente ejemplo:

gcc dibujarArea.c -lxseasyc -lconio -o dibujarArea

El comando anterior compilará el archivo dibujarArea.c (incluido en los ejemplos) y utilizará la librería xsEasyC y la librería conio; para generar el ejecutable dibujarArea.exe.

Las Funciones que incluye la librería son las siguientes:

  • dibujarArea
    Función para dibujar-llenar un área de la pantalla con un caracter específico.
    Esta función utiliza 5 parámetros:
    Entero columna1. Este valor indica la columna correspondiente a la esquina superior izquierda del área a dibujar.
    Entero renglon1. Este valor indica el renglón correspondiente a la esquina superior izquierda del área a dibujar.
    Entero columna2. Este valor indica la columna correspondiente a la esquina inferior derecha del área a dibujar.
    Entero renglon2. Este valor indica la columna correspondiente a la esquina inferior derecha del área a dibujar.
    Entero relleno. Este valor indica el tipo de relleno a utilizar. Los valores disponibles son: RELLENO_SUAVE, RELLENO_MEDIO, RELLENO_FUERTE y RELLENO_SOLIDO.

    Ejemplo:

    // Mensaje
    Imprimir("Dibujando Area Solido en 15,5,80,10");
    dibujarArea(15,5,80,10,RELLENO_SOLIDO);
    CL;

    El Ejemplo anterior Dibuja un Área con relleno solido, en el cuadro generado por la esquina superior izquierda con posición 15,5; y la esquina inferior derecha con posición: 80,10.

    gcc versión

    Nota. La visualización del Área dependerá de la resolución en Columnas y Renglones que esté manejando la Terminal al lanzar la aplicación de Consola.

  • dibujarLineaHorizontal
    Función para dibujar una Línea Horizontal en un renglón específico.
    Esta función utiliza 5 parámetros:
    Entero renglon. Este valor indica el renglón en donde se dibujará la Línea.
    Entero columna1. Este valor indica la columna izquierda desde la cual se dibujará la Línea.
    Entero columna2. Este valor indica la columna erecha donde finalizará la Línea.
    Logico lineaSencilla. Este valor, que puede ser VERDAD/FALSO; indica si la Línea a dibujar será sencilla o doble.
    Logico conDelimitador. Este valor, que puede ser VERDAD/FALSO; indica si la Línea tendrá al principio y al final un delimitador.

    Ejemplo:

    // Desplegando Lineas Sencillas
    dibujarLineaHorizontal(7,1,80,LINEA_SENCILLA,SIN_DELIMITADOR);
    dibujarLineaHorizontal(8,1,80,LINEA_SENCILLA,CON_DELIMITADOR);

    // Desplegando Lineas Dobles
    dibujarLineaHorizontal(10,10,120,LINEA_DOBLE,SIN_DELIMITADOR);
    dibujarLineaHorizontal(11,10,120,LINEA_DOBLE,CON_DELIMITADOR);

    El Ejemplo anterior se observa como se dibujan Líneas Horizontales Sencillas y Dobles con delimitador y sin Delimitador.

    linea Horizontal


  • dibujarLineaVertical
    Función para dibujar una Línea Vertical en una columna específica.
    Esta función utiliza 5 parámetros:
    Entero columna. Este valor indica la columna en donde se dibujará la Línea.
    Entero renglon1. Este valor indica la columna izquierda desde la cual se dibujará la Línea.
    Entero renglon2. Este valor indica la columna erecha donde finalizará la Línea.
    Logico lineaSencilla. Este valor, que puede ser VERDAD/FALSO; indica si la Línea a dibujar será sencilla o doble.
    Logico conDelimitador. Este valor, que puede ser VERDAD/FALSO; indica si la Línea tendrá al principio y al final un delimitador.

    Ejemplo:

    // Desplegando Lineas Sencillas
    dibujarLineaVertical(7,10,15,LINEA_SENCILLA,SIN_DELIMITADOR);
    dibujarLineaVertical(8,10,15,LINEA_SENCILLA,CON_DELIMITADOR);

    // Desplegando Lineas Dobles
    dibujarLineaVertical(17,15,19,LINEA_DOBLE,SIN_DELIMITADOR);
    dibujarLineaVertical(18,15,19,LINEA_DOBLE,CON_DELIMITADOR);

    El Ejemplo anterior se observa como se dibujan Líneas Verticales Sencillas y Dobles con delimitador y sin Delimitador.

    linea vertical


  • dibujarMarco
    Función para dibujar un Marco en la Pantalla.
    Esta función utiliza 5 parámetros:
    Entero columna1. Este valor indica la columna correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero renglon1. Este valor indica el renglón correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero columna2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Entero renglon2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Logico lineaSencilla. Este valor indica si el Tipo de Línea para dibujar el Marco será sencilla o doble.
    Caracter relleno. Este valor indica el caracter de relleno se utilizará en el Marco.
    Ejemplo:

    // Imprimir
    Imprimir("Desplegando un Marco en 5,5,80,10");
    dibujarMarco(5,5,80,10,LINEA_SENCILLA,RELLENO_SOLIDO);

    El Ejemplo anterior se observa como se dibuja un Marco Línea Sencilla y con Relleno Sólido.

    Marco


  • dibujarMarcoConTitulo
    Función para dibujar un Marco con Título en la Pantalla.
    Esta función utiliza 8 parámetros:
    Entero columna1. Este valor indica la columna correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero renglon1. Este valor indica el renglón correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero columna2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Entero renglon2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Logico lineaSencilla. Este valor indica si el Tipo de Línea para dibujar el Marco será sencilla o doble.
    Caracter relleno. Este valor indica que tipo de relleno se utilizará en el Marco.
    Caracter *titulo. Este valor indica el Título que se desplegará en el Marco.
    Entero posicion. Este valor indica la posición en que se desplegará el Título. Los valores posibles son: TITULO_SUP_IZQ, TITULO_SUP_CEN, TITULO_SUP_DER, TITULO_INF_IZQ, TITULO_INF_CEN y TITULO_INF_DER.

    Ejemplo:

    Imprimir("Desplegando un Marco con Titulo Inferior a la Izquierda en 15,7,80,10");
    dibujarMarcoConTitulo(15,7,80,18,LINEA_DOBLE,RELLENO_FUERTE,"Titulo",TITULO_INF_IZQ);

    Marco con Titulo


  • dibujarVentana
    Función para dibujar un Marco con Título en la Pantalla.
    Esta función utiliza 8 parámetros:
    Entero columna1. Este valor indica la columna correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero renglon1. Este valor indica el renglón correspondiente a la esquina superior izquierda del Marco a dibujar.
    Entero columna2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Entero renglon2. Este valor indica la columna correspondiente a la esquina inferior derecha del Marco a dibujar.
    Logico lineaSencilla. Este valor indica si el Tipo de Línea para dibujar el Marco será sencilla o doble.
    Caracter relleno. Este valor indica que tipo de relleno se utilizará en el Marco.
    Caracter *titulo. Este valor indica el Título que se desplegará en el Marco.
    Entero posicion. Este valor indica la posición en que se desplegará el Título. Los valores posibles son: TITULO_SUP_IZQ, TITULO_SUP_CEN, TITULO_SUP_DER, TITULO_INF_IZQ, TITULO_INF_CEN y TITULO_INF_DER.

    Ejemplo:

    Imprimir("Desplegando una Ventana con Titulo Superior Derecha en 15,7,80,10");
    dibujarVentana(15,7,80,18,LINEA_SENCILLA,RELLENO_SUAVE,"Titulo",TITULO_SUP_DER);

    Ventana