PDF de programación - MiniWin Documentation

MiniWin Documentation
Release 0.2.1

Pau Fernández (@pauek)

09/05/2017 a las 21:13

Contents

1 Motivación

2 Instalación Rápida

3 Autores

4 Contribuciones

5 Índice

5.1
5.2

Instalación .
Funciones .
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

.
.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3

5

7

9

11
11
25

i

ii

MiniWin Documentation, Release 0.2.1

Última actualización: 09/05/2017 a las 21:13.
MiniWin es una mini-librería (para ser justos, no llega ni a eso) para poder abrir una ventana, pintar en ella, detectar la
presión de las teclas y el movimiento y los botones del ratón. Tiene un objetivo pedagógico, sirve esencialmente para
poder implementar programas muy simples (como pequeños juegos) que dibujen cosas por la pantalla y con los que
se pueda interaccionar mínimamente.
Actualmente funciona en Windows y Linux (si álguien se ofrece a subvencionar un MacBook, quizás entonces me
plantee hacer la versión Mac OS X...).

Contents

1

MiniWin Documentation, Release 0.2.1

2

Contents

CHAPTER 1

Motivación

MiniWin es una utilidad motivada por la realización de vídeos pedagógicos en la web sobre cursos de programación
minidosis.org.

3

MiniWin Documentation, Release 0.2.1

4

Chapter 1. Motivación

CHAPTER 2

Instalación Rápida

Si usas Code::Blocks, descarga uno de los proyectos siguientes:

• Para Windows, descarga HolaMiniWin-windows.
• Para Linux, descarga HolaMiniWin-linux.

Una vez descargado, descomprime el archivo y dentro de la carpeta HolaMiniWin verás un fichero con extensión
.cbp (un proyecto Code::Blocks). Ábrelo y compila directamente. Te aparecerá una ventana que dice “Hola, Mini-
Win!”.
Si no usas Code::Blocks, consulta el tema Instalación.

5

MiniWin Documentation, Release 0.2.1

6

Chapter 2.

Instalación Rápida

Pau Fernández (Google+, Twitter)

CHAPTER 3

Autores

7

MiniWin Documentation, Release 0.2.1

8

Chapter 3. Autores

Carlos (@mesjetiu en YouTube).

CHAPTER 4

Contribuciones

9

MiniWin Documentation, Release 0.2.1

10

Chapter 4. Contribuciones

CHAPTER 5

Índice

Instalación

Antes que nada: descarga MiniWin.
Verás que dentro del Zip hay dos ficheros: miniwin.h y miniwin.cpp. Puedes ignorar todo lo demás. Estos dos
ficheros deben formar parte del proyecto que se está desarrollando. En C++, se pueden hacer programas con más de
un fichero fuente (si estás empezando esto no es evidente). Entornos de programación como Dev-C++, Code::Blocks
o Geany permiten compilar este tipo de proyectos.

Instalación Rápida para Code::Blocks

Si usas Code::Blocks en Windows o Linux, descarga el proyecto HolaMiniWin-windows u HolaMiniWin-linux, abre
el fichero HolaMiniWin.cbp con Code::Blocks y ya puedes empezar trabajar.

Creación de un proyecto en Code::Blocks que use MiniWin

Esta explicación también está en vídeo.
Para usar MiniWin en un proyecto en Code::Blocks sigue los siguientes pasos:

• Crea un nuevo proyecto en Code::Blocks (menú “File - New - Project...”):

11

MiniWin Documentation, Release 0.2.1

• Escoge el tipo de proyecto como “Win32 GUI”:

• Escoge “Frame based” en el tipo de proyecto:

12

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

• Pon un nombre al proyecto, como por ejemplo “MiProyecto”, y luego escoge una carpeta donde ponerlo:

5.1.

Instalación

13

MiniWin Documentation, Release 0.2.1

• Marca las dos configuraciones de “Release” y “Debug” (típicamente saldrán marcadas por defecto):

14

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

• Quita el fichero main.cpp del proyecto:

5.1.

Instalación

15

MiniWin Documentation, Release 0.2.1

• Descarga MiniWin y copia los ficheros miniwin.cpp y miniwin.h a la carpeta del proyecto.

16

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

• Añade ficheros al proyecto:

5.1.

Instalación

17

MiniWin Documentation, Release 0.2.1

• Escoge miniwin.cpp y miniwin.h para añadirlos al proyecto:

18

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

• Marca las configuraciones “Debug” y “Release” (normalmente salen marcadas por defecto):

• Crea un nuevo fichero:

5.1.

Instalación

19

MiniWin Documentation, Release 0.2.1

• Escoge el tipo C++/source:

• Escoge el lenguaje C++:

20

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

• Escoge un nombre para el nuevo fichero (dentro de la misma carpeta del proyecto) y marca la opción “Add file

to active project”, marcando también “Debug” y “Release”:

5.1.

Instalación

21

MiniWin Documentation, Release 0.2.1

• Escribe el programa principal y compílalo:

Creación de un proyecto en Dev-C++ que use MiniWin

Para crear proyectos usando MiniWin en Dev-C++, debes hacer lo siguiente:

22

Chapter 5.

Índice

• Creas un nuevo proyecto en Dev-C++, del tipo “Windows Application”, y le pones un nombre como por ejemplo

“MiJuego”:

MiniWin Documentation, Release 0.2.1

• DevC++ te pedirá guardar el proyecto (un fichero .dev) en un directorio. Crea un directorio especial para el

proyecto (supongamos “MiJuego” también).

• Ahora aparecerá un fichero main.cpp en la pantalla principal de edición con código C++ escrito. Este fichero
lo genera Dev-C++ y es estándar. Debes cerrar la ventana (observa que el fichero no está guardado, porque tiene
un asterisco entre corchetes antes del nombre):

5.1.

Instalación

23

MiniWin Documentation, Release 0.2.1

• DevC++ preguntará si quieres guardar los cambios a main.cpp. Dí que no:

El proyecto quedará vacío.

• Copia los ficheros miniwin.h y miniwin.cpp en el directorio “MiJuego” que has creado anteriormente.
• Añade al proyecto de Dev-C++ el fichero miniwin.cpp. Esto se puede hacer clicando con el botón derecho

el proyecto y luego seleccionando “Añadir al proyecto”:

• Haz el programa principal (la función main) en un fichero aparte (por ejemplo: mijuego.cpp), y lo añades

también al proyecto (tendrás, entonces, 2 ficheros en el proyecto, el tuyo y miniwin.cpp).

• En el fichero mijuego.cpp añades las líneas:

#include "miniwin.h"
using namespace miniwin;

al principio de todo, tal como pones normalmente otros #includes o el using namespace std.

24

Chapter 5.

Índice

MiniWin Documentation, Release 0.2.1

Ahora puedes compilar el proyecto.

Crear un proyecto en Geany que usa MiniWin

Para crear un proyecto que use MiniWin en Geany hay que seguir los siguientes pasos:

• Crea un directorio (por ejemplo “MiJuego”).
• Copia los ficheros miniwin.h y miniwin.cpp al directorio “Mi Juego”.
• Haz el programa principal (la función main) en un fichero aparte (por ejemplo: mijuego.cpp), y lo añades

también al proyecto (tendrás, entonces, 2 ficheros en el proyecto, el tuyo y miniwin.cpp).

• Crea un fichero Makefile en el directorio “MiJuego” (con Geany mismo) y escribes lo siguiente (puedes

sustituir mijuego por el nombre que hayas escogido):

all: mijuego

mijuego: miniwin.o mijuego.o

g++ -o mijuego.exe miniwin.o mijuego.o -mwindows

Ahora, para compilar el proyecto, debes seleccionar la opción del menú “Construir” que pone “Compilar”, pero no la
primera, sino la que aparece justo al lado de “Mayúsc + F9” (o si quieres, presiona esa combinación de teclas). Mira
la ventana de mensajes para comprobar que todo sale bien.

Funciones

MiniWin es super-simple: sólo es un miniconjunto de funciones. Para usar MiniWin solamente hay que seguir 2 pasos
importantes:

• Poner arriba del programa principal:

#include "miniwin.h"
using namespace miniwin;

Fíjate en que hay comillas dobles y no ángulos alrededor de miniwin.h en el #include. El using
namespace miniwin te será familiar por su equivalente con std.

• Hacer la función main así:

int main() {

return 0;

}

Es decir, sin parámetros y devolviendo int. El return 0 es obligatorio.

Aparte de eso se trata de utilizar las funciones que se comentan a continuación.

Control de la ventana

En MiniWin, al ejecutar el programa principal siempre se creará una sola ventana, a la que nos referiremos como
“la ventana”. Esta ventana no se puede redimensionar con el ratón (solamente con la acción vredimensiona())
y mantiene el dibujo que pintas aunque la minimices. Algunas funciones utilizan coordenadas en esta ventana. Las
coordenadas son un par ordenado de valores, donde el primer valor es x y el segundo es y:

• La esquina superior-izquierda es el orígen, con coordenadas (0,0).

5.2. Funciones

25

MiniWin Documentation, Release 0.2.1

• A medida que nos desplazamos a la derecha la coordenada x crece.
• A medida que nos desplazamos hacia abajo la coordenada y crece.

El diagrama sería el siguiente:

Hay 3 funciones relacionadas con las dimensiones de la ventana.
void vredimensiona(int ancho, int alto)

Acción que cambia las dimensiones (en píxeles) de la ventana. El primer parámetro indica la anchura y el
segundo la altura, ambos son enteros. Por ejemplo:

vredimensiona(800, 600);

cambiará las dimensiones de la ventana a 800 por 600 píxeles. El hecho de redimensionar la ventana implica
que ésta se borrará, como si hiciésemos borra() justo después del vredimensiona().

int vancho()

Función que averigua el ancho de la ventana en píxeles, devolviendo un entero. Por ejemplo, el siguiente código
utiliza la función vancho():

int a = vancho();
if (a > 500) {

cout << "El ancho de la ventana es mayor que 500" << endl;

}

int valto()

Función que averigua la altura de la ventana en píxeles, devolviendo un entero. Es similar a vancho().

void vcierra()

Acción que cierra la ventana y termina el programa. Si no se llama esta acción, cuando acaba la función main
la ventana se queda abierta mostrando el dibujo que hayamos hecho, y hay que cerrarla manualmente. Esto nos
puede interesar para observar el dibujo que hayamos hecho.

Pintar en la ventana

Para pintar en la ventana hay que utilizar alguna de las acciones linea(), rectangulo(), circulo(), etc. y
luego hay que invocar la acción refresca(). Esencialmente, todo lo que se pinta se acumula en un “buffer” y
luego l