Added diagnostic questions

README.md

@@ -28,11 +28,11 @@ Antes de llegar al laboratorio debes:
 
 1. Haber repasado los siguientes conceptos:
 
-  a. creación de objetos de una clase.
+    a. creación de objetos de una clase.
 
-  b. utilización de métodos "getters" para acceder a los atributos de un objeto.
+    b. utilización de métodos "getters" para acceder a los atributos de un objeto.
 
-  c. utilización de métodos "setters" para modificar los atributos de un objeto.
+    c. utilización de métodos "setters" para modificar los atributos de un objeto.
 
 2. Haber estudiado la documentación de la clase `Bird` disponible en [este enlace] (http://ada.uprrp.edu/~ranazario/bird-html/class_bird.html).
 
@@ -66,7 +66,7 @@ Lo siguiente es el esqueleto de la declaración de una clase:
 
 ---
 
-```
+```cpp
   class NombreClase
    {
     // Declaraciones
@@ -107,7 +107,7 @@ Los métodos de una clase determinan qué acciones podemos tomar sobre los objet
 ---
 
 
-```
+```cpp
 class Bird : public QWidget
 {
 .
@@ -165,21 +165,29 @@ El encabezado de la función será algo así:
 
 La clase `Bird` que estarás usando en la sesión de hoy tiene dos constructores (funciones sobrecargadas):
 
-`Bird (QWidget *parent=0)`
+```cpp
+Bird (QWidget *parent=0)`
+```
 
-`Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)`
+```cpp
+Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)
+```
 
 Puedes ver las declaraciones de los prototipos de estos métodos en la declaración de la clase `Bird` en el archivo `bird.h` del proyecto. La documentación se encuentra en http://ada.uprrp.edu/~ranazario/bird-html/class_bird.html. El primer constructor, `Bird (QWidget *parent=0)`, es un método  que se puede invocar con uno o ningún argumento. Si al invocarlo no se usa argumento, el parámetro de la función toma el valor 0. 
 
 El constructor de una clase que se puede invocar sin usar argumentos es el *constructor* "*default*" de la clase; esto es, el constructor que se invoca cuando creamos un objeto usando una instrucción como:
 
-`Bird pitirre;`
+```cpp
+Bird pitirre;
+```
 
 Puedes ver las implementaciones de los métodos de la clase Birden el archivo `bird.cpp`. Nota que el primer constructor, `Bird (QWidget *parent=0)`, asignará valores aleatorios ("random") a cada uno de los atributos del objeto. Más adelante hay una breve explicación de la función `randInt`.
 
 Dale un vistazo a la documentación del segundo constructor, `Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)`. Esta función requiere cuatro argumentos y tiene un quinto argumento que es opcional porque tiene un valor por defecto. Una manera para usar este constructor es creando un objeto como el siguiente:
 
-`Bird guaraguao(200, Bird::UPSET, "blue", "red");`
+```cpp
+Bird guaraguao(200, Bird::UPSET, "blue", "red");
+```
 
 
 ####"Setters" ("mutators")
@@ -194,7 +202,7 @@ Las clases proveen métodos para modificar los valores de los atributos de un ob
 
 Puedes ver las declaraciones de los métodos en la Figura 1 y en la declaración de la clase `Bird` en  `bird.h`, y la implementación de algunos de los métodos en `bird.cpp`. El código en el siguiente ejemplo crea el objeto `bobo` de la clase `Bird` y luego cambia su tamaño a 333.
 
-```
+```cpp
 Bird bobo;
 bobo.setSize(333);
 ```
@@ -212,7 +220,7 @@ Las clases también proveen métodos para acceder  ("get") el valor del atributo
 
 Puedes ver las declaraciones de los métodos en la Figura 1 y en la declaración de la clase `Bird` en  `bird.h`, y las implementaciones de algunos de métodos en `bird.cpp`. El código en el siguiente ejemplo crea el objeto `piolin` de la clase `Bird` e imprime su tamaño.
 
-```
+```cpp
 Bird piolin;
 cout << piolin.getSize();
 ```
@@ -221,15 +229,19 @@ cout << piolin.getSize();
 
 **MainWindow:** El archivo `mainwindow.h` contiene la declaración de una clase llamada `MainWindow`. Los objetos que sean instancias de esta clase podrán utilizar los métodos sobrecargados
 
-`void MainWindow::addBird(int x, int y, Bird &b)`  
+```cpp
+void MainWindow::addBird(int x, int y, Bird &b)
+```
 
-`void MainWindow::addBird(Bird &b)` 
+```cpp
+void MainWindow::addBird(Bird &b)` 
+```
 
 que añadirán a la pantalla un dibujo del objeto de la clase `Bird` que es recibido como argumento. El código en el siguiente ejemplo crea un objeto `w` de la clase `MainWindow`, crea un objeto `zumbador` de la clase `Bird` y lo añade a la posición (200,200) de la pantalla `w` usando el primer método.
 
 
 
-```
+```cpp
 MainWindow w;
 Bird zumbador;
 w.addBird(200,200,zumbador);
@@ -252,12 +264,24 @@ w.addBird(200,200,zumbador);
 
 **randInt:** La clase `Bird` incluye el método
 
-`int Bird::randInt(int min, int max)`
+```cpp
+int Bird::randInt(int min, int max)
+```
 
 para generar números enteros aleatorios ("random") en el rango [min, max]. El método `randInt` depende de otra función para generar números aleatorios que requiere un primer elemento o *semilla* para ser evaluada. En este proyecto, ese primer elemento se genera con la invocación `srand(time(NULL)) ;`.
 
 
 
+!INCLUDE "../../eip-diagnostic/birds-objects/es/diag-birds-objects-01.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/es/diag-birds-objects-02.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/es/diag-birds-objects-03.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/es/diag-birds-objects-04.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/es/diag-birds-objects-05.html"
+
 ---
 
 ---
@@ -279,15 +303,15 @@ En este ejercicio te familiarizarás con la clase `Bird` y con algunos métodos
 
 3. En el archivo `main.cpp` (en Sources) la función `main` hace lo siguiente:
 
-  a. Crea un objeto aplicación de Qt, llamado `a`. Lo único que necesitas saber sobre este objeto es que gracias a él es que podemos crear una aplicación gráfica en Qt e interaccionar con ella.
+    a. Crea un objeto aplicación de Qt, llamado `a`. Lo único que necesitas saber sobre este objeto es que gracias a él es que podemos crear una aplicación gráfica en Qt e interaccionar con ella.
 
-  b. Crea un objeto  de la clase MainWindow llamado `w`. Este objeto corresponde a la ventana que verás cuando corras la aplicación.
+    b. Crea un objeto  de la clase MainWindow llamado `w`. Este objeto corresponde a la ventana que verás cuando corras la aplicación.
 
-  c. Inicializa la semilla del generador de números aleatorios de Qt. Esto hará que los pájaros nuevos tengan tamaños, colores y cejas aleatorias (a menos que los forcemos a tener valores específicos).
+    c. Inicializa la semilla del generador de números aleatorios de Qt. Esto hará que los pájaros nuevos tengan tamaños, colores y cejas aleatorias (a menos que los forcemos a tener valores específicos).
 
-  d. Invoca el método `show()` al objeto `w`. Esto logra que se muestre la ventana donde se desplegarán los resultados.
+    d. Invoca el método `show()` al objeto `w`. Esto logra que se muestre la ventana donde se desplegarán los resultados.
 
-  e. En los programas que no tienen interfaz gráfica, la función `main()` usualmente termina con la instrucción `return 0;`. En este proyecto se utiliza la instrucción `return a.exec();` para que el objeto `a` se haga cargo de la aplicación a partir de ese momento.
+    e. En los programas que no tienen interfaz gráfica, la función `main()` usualmente termina con la instrucción `return 0;`. En este proyecto se utiliza la instrucción `return a.exec();` para que el objeto `a` se haga cargo de la aplicación a partir de ese momento.
 
 4. Ejecuta el programa marcando la flecha verde en el menú de la izquierda de la ventana de Qt Creator. El programa debe mostrar una ventana blanca.
 
@@ -303,37 +327,34 @@ En este ejercicio crearás objetos del tipo `Bird` usando el constructor por def
 
 3. Utiliza los "setters" `setSize(int size)`, `setFaceColor(Qstring color)`, `setEyeColor(Qstring color)`,  y `setEyebrow(EyeBrowType)` para que `abelardo` luzca como en la Figura 2  (su size es 200).
 
-  
-  ---
-
-  ![figure2.png](images/figure2.png)
+    ---
 
-  **Figura 2.** Abelardo.
+    ![figure2.png](images/figure2.png)
 
-  ---
+    **Figura 2.** Abelardo.
 
+    ---
 
 4. Crea otro objeto de la clase Bird llamado `piolin` que tenga cara azul, ojos verdes, y cejas UNI invocando el constructor `Bird(int size, EyeBrowType brow, QString faceColor, QString eyeColor, QWidget *parent = 0)`. Su tamaño debe ser la mitad que el de `abelardo`. Añádelo a la misma ventana donde se muestra a  `abelardo` usando `w.addBird(300, 100, piolin)` para obtener una imagen como la que se muestra en la Figura 3
 
+    ---
 
-   ---
-
-  ![figure3.png](images/figure3.png)
+    ![figure3.png](images/figure3.png)
 
-  **Figura 3.** Abelardo y Piolin.
-
-  ---
+    **Figura 3.** Abelardo y Piolin.
 
+    ---
+    
 5. Crea otros dos objetos llamados `juana` y `alondra` que salgan dibujados en las coordenadas (100, 300) y (300,300) respectivamente. Crea a `juana` usando el constructor por defecto para que sus propiedades sean asignadas de forma aleatoria.
 Luego crea a `alondra` usando el otro constructor (el que recibe argumentos) para que puedas especificar sus propiedades durante su creación.  `alondra` debe ser  igual de grande que `juana`, tener el mismo tipo de cejas, y el mismo color de ojos.  Su cara debe ser blanca. Añade a `alondra` y a `juana` a la misma ventana de `abelardo` y `piolin`. La ventana debe ser similar a la de la Figura 4.
 
-   ---
+    ---
 
-  ![figure4.png](images/figure4.png)
+    ![figure4.png](images/figure4.png)
 
-  **Figura 4.** Abelardo, Piolín, Juana y Alondra.
+    **Figura 4.** Abelardo, Piolín, Juana y Alondra.
 
-  ---
+    ---
 
 6. Corre varias veces el programa para asegurarte que `alondra` y `juana` siguen pareciéndose en tamaño, cejas y ojos. 
 
@@ -394,11 +415,11 @@ Before the lab session each student should have:
 
 1. Reviewed the following concepts:
 
-  a. the creation of objects of a class.
+    a. the creation of objects of a class.
 
-  b. using the "getter" method functions to access the attributes of an object.
+    b. using the "getter" method functions to access the attributes of an object.
 
-  c. using the "setter" method functions to modify the attributes of an object.
+    c. using the "setter" method functions to modify the attributes of an object.
 
 2. Studied the documentation for the class `Bird` available in [this link.](http://ada.uprrp.edu/~ranazario/bird-html/class_bird.html)
 
@@ -429,7 +450,7 @@ The following is the skeleton of the declaration of a class:
 
 ---
 
-```
+```cpp
   class ClassName
    {
     // Declarations
@@ -470,7 +491,7 @@ The methods of a class determine the actions that we can take on the objects of
 ---
 
 
-```
+```cpp
 class Bird : public QWidget
 {
 .
@@ -530,22 +551,29 @@ The function header will be like this:
 
 The class `Bird` that you will be using in today's session has two constructors (overloaded functions):
 
-`Bird (QWidget *parent=0)`
+```cpp
+Bird (QWidget *parent=0)
+```
 
-`Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)`
+```cpp
+Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)
+```
 
 You can see the declarations of the method prototypes in the declaration of the `Bird` class in the project's `bird.h` file. The documentation can be found in [this link.](http://ada.uprrp.edu/~ranazario/bird-html/class_bird.html) The first constructor, `Bird (QWidget *parent=0)`, is a method that can be invoked with one or no argument. If no argument is used, the function's parameter has a value of 0.
 
 A class' constructor that can be invoked without using an argument is the class' *default constructor*; that is, the constructor that is invoked when we create an object using an instruction  like:
 
-`Bird pitirre;`
+```cpp
+Bird pitirre;
+```
 
 You can see the implementations of the class `Bird` in the file `bird.cpp`. Note that the first constructor, `Bird (QWidget *parent=0)`, will assign random values to each of the object's attributes. Later on there is a brief explanation for the `randInt` function.
 
 Have a look at the documentation for the second constructor, `Bird (int, EyeBrowType, QString, QString, QWidget *parent=0)`. This function requires four arguments and has a fifth argument that is optional since it has a default value. One way to use this constructor is creating an object like this:
 
-`Bird guaraguao(200, Bird::UPSET, "blue", "red");`
-
+```cpp
+Bird guaraguao(200, Bird::UPSET, "blue", "red");
+```
 
 ####Setters (mutators)
 
@@ -559,7 +587,7 @@ Classes provide methods to modify the values of the attributes of an objected th
 
 You can see the method's declarations in Figure 1 and in the `Bird` class declaration in `bird.h`, and the implementation of the some of the methods in `bird.cpp`. The code in the following example creates the object `bobo` of the `Bird` class and then changes its size to 333.
 
-```
+```cpp
 Bird bobo;
 bobo.setSize(333);
 ```
@@ -575,7 +603,7 @@ Classes also provide methods to access (get) the value of the attribute of an ob
 
 You can see the declarations of the methods in Figure 1 and  in the `Bird` class declaration in `bird.h`, and the implementations of some of the methods in `bird.cpp`. The code in the following example creates the object `piolin` of the `Bird` class and prints its size:
 
-```
+```cpp
 Bird piolin;
 cout << piolin.getSize();
 ```
@@ -584,13 +612,17 @@ cout << piolin.getSize();
 
 **MainWindow:** The file `mainwindow.h` contains the declaration of a class called `MainWindow`. The objects that are instances of this class will be able to use the overloaded methods
 
-`void MainWindow::addBird(int x, int y, Bird &b)`  
+```cpp
+void MainWindow::addBird(int x, int y, Bird &b)
+```
 
-`void MainWindow::addBird(Bird &b)`  
+```cpp
+void MainWindow::addBird(Bird &b)
+```
 
 that will add to the screen a drawing of an object of the `Bird` class that is received as an argument. The code in the following example creates an object `w` of the `MainWindow` class, creates an object `zumbador` of the `Bird` class and adds it in the position (200,200) on the screen `w` using the first method.
 
-```
+```cpp
 MainWindow w;
 Bird zumbador;
 w.addBird(200,200,zumbador);
@@ -612,11 +644,25 @@ w.addBird(200,200,zumbador);
 
 **randInt:** The `Bird` class includes the method
 
-`int Bird::randInt(int min, int max)`
+```cpp
+int Bird::randInt(int min, int max)
+```
+
 
 to generate random numbers in the range [min, max]. The method `randInt` depends on another function to generate random numbers that require a first element or *seed* to be evaluated. In this project, that first element is generated with the function call `srand(time(NULL)) ;`.
 
 
+
+!INCLUDE "../../eip-diagnostic/birds-objects/en/diag-birds-objects-01.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/en/diag-birds-objects-02.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/en/diag-birds-objects-03.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/en/diag-birds-objects-04.html"
+
+!INCLUDE "../../eip-diagnostic/birds-objects/en/diag-birds-objects-05.html"
+
 ---
 
 ---
@@ -637,15 +683,15 @@ In this exercise you will familiarize yourself with the `Bird` class and with so
 
 3. In the `main.cpp` file (in Sources) the `main` function does the following:
 
-  a. Creates a Qt object application, called `a`. The only thing you need to know is that thanks to this object we can create a graphical application in Qt and interact with it.
+    a. Creates a Qt object application, called `a`. The only thing you need to know is that thanks to this object we can create a graphical application in Qt and interact with it.
 
-  b. Creates an object of the MainWindow class called `w`. This object corresponds to the window that you will see when you run the application.
+    b. Creates an object of the MainWindow class called `w`. This object corresponds to the window that you will see when you run the application.
 
-  c. Initializes the seed of Qt's random number generator. As a result of this, the new birds will have random sizes, colors and eyebrows (unless we force them to have specific values).
+    c. Initializes the seed of Qt's random number generator. As a result of this, the new birds will have random sizes, colors and eyebrows (unless we force them to have specific values).
 
-  d. Invokes the method `show()` on the object `w`. This shows the window where the results will be displayed.
+    d. Invokes the method `show()` on the object `w`. This shows the window where the results will be displayed.
 
-  e. In programs that don't have a graphical interface, the `main()` function usually ends with the instruction `return 0;`. In this project, the `return a.exec();` instruction is used so that the object `a` takes charge of the application from that moment on.
+    e. In programs that don't have a graphical interface, the `main()` function usually ends with the instruction `return 0;`. In this project, the `return a.exec();` instruction is used so that the object `a` takes charge of the application from that moment on.
 
 4. Execute the program by clicking on the green arrow in the left menu on the Qt Creator window. The program should display a blank window.
 
@@ -661,33 +707,33 @@ In this exercise you will create an object of type `Bird` using the default cons
 
 3. Use the setters `setSize(int size)`, `setFaceColor(Qstring color)`, `setEyeColor(Qstring color)`, and `setEyebrow(EyeBrowType)` so that `abelardo` looks as in Figure 2  (its size is 200).
 
-  ---
+    ---
 
-  ![figure2.png](images/figure2.png)
+    ![figure2.png](images/figure2.png)
 
-  **Figure 2.** Abelardo.
+    **Figure 2.** Abelardo.
 
-  ---
+    ---
 
 4. Create another object of class Bird called `piolin` that has a blue face, green eyes and UNI eyebrows invoking the constructor `Bird(int size, EyeBrowType brow, QString faceColor, QString eyeColor, QWidget *parent = 0)`. Its size should be half of `abelardo`'s. Add it to the same window where `abelardo` is being displayed by using `w.addBird(300, 100, piolin)`, to obtain an image like the one in Figure 3
 
-  ---
+    ---
 
-  ![figure3.png](images/figure3.png)
+    ![figure3.png](images/figure3.png)
 
-  **Figure 3.** Abelardo and Piolin.
+    **Figure 3.** Abelardo and Piolin.
 
-  ---
+    ---
 
 5. Create two other objects called `juana` and `alondra` that will appear drawn in the coordinates (100, 300) and (300,300) respectively. Create `juana` using the default constructor so that its properties are assigned randomly. Create `alondra` using the other constructor so that you may specify its properties during its creation.  `alondra` should have the same size as `juana`, have the same type of eyebrows, and the same eye color. Its face should be white. Add `alondra` and `juana` to the window where `abelardo` and `piolin` are. The window should look similar to the one in Figure 4.
 
-  ---
+    ---
 
-  ![figure4.png](images/figure4.png)
+    ![figure4.png](images/figure4.png)
 
-  **Figure 4.** Abelardo, Piolin, Juana and Alondra.
+    **Figure 4.** Abelardo, Piolin, Juana and Alondra.
 
-  ---
+    ---
 
 6. Run the program several times making sure that `alondra` and `juana` have the same size, eyebrows and eyes.