Arreglos gramaticales, igual para los codigos fuentes

README-en.md

 ![main2.png](images/main2.png)
 ![main3.png](images/main3-small.png)
 
-[Verano 2016- Tatiana - Ive - Tatiana]
 
 Recursion is a technique that is commonly used in programming. With this technique, problems are done by solving similar problems but for smaller cases. We can construct sets of objects or tasks using *recursive rules* and *initial values*. *Recursive functions* are functions that are self-invoking, using smaller sets or elements each time, until reaching a point where an initial value is used instead of self-invoking. In this laboratory experience, you will implement some tools to draw and practice the use of recursive functions to fill with color some figures.
 
 	**Figure 1.**  The image shows the direction in which the coordinates are ordered in `Qt` images.
 
 
-* When we want to insert two-dimensional data (like the entries of a grid that has coordinates in $$x$$ and $$y$$) in an one-dimensional array we use a formula to convert every coordinate $$(x,y)$$ to an index $$i$$ of the array. For every point with coordinates $$(x,y)$$ in the grid, we evaluate $$i=(number-of-columns)*y+x$$, where `number-of-columns` represents the width of the two-dimensional array, and the result $$i$$ will be the index of the one-dimensional array that corresponds to the point with coordinates $$(x,y)$$ in the grid. For example, the index $$i$$ that corresponds to the point $$(1,2)$$ in the grid of width $$5$$ is $$i=(5)*2+1=11$$.
+* When we want to insert two-dimensional data (like the entries of a grid that has coordinates in $$x$$ and $$y$$) in a one-dimensional array we use a formula to convert every coordinate $$(x,y)$$ to an index $$i$$ of the array. For every point with coordinates $$(x,y)$$ in the grid, we evaluate $$i=(number-of-columns)*y+x$$, where `number-of-columns` represents the width of the two-dimensional array, and the result $$i$$ will be the index of the one-dimensional array that corresponds to the point with coordinates $$(x,y)$$ in the grid. For example, the index $$i$$ that corresponds to the point $$(1,2)$$ in the grid of width $$5$$ is $$i=(5)*2+1=11$$.
 
 
 ---
 
 * `int qFloor(qreal v)` // Returns the “floor” value $$v$$.
 * `qreal qSqrt(qreal v)` // Returns the square root of the value $$v$$.
-* `qreal qPow(qreal x, qreal y)` // Returns the value of $x$ to the power of $$y$$.
+* `qreal qPow(qreal x, qreal y)` // Returns the value of $$x$$ to the power of $$y$$.
 
 In addition, you will need to use the function that paints the grid:
 
 |---|----|----|
 | ![](images/colMajor01-small.png) | ![](images/colMajor02-small.png) | ![](images/colMajor03-small.png)|  
 
-**Figure 3.** (a) A drawing with a white background and red dots (b) When the user clicks on the vertical line button (`ColMajorFill`) and clicks the cell shown, (c) a vertical line that expands to the left and to the right of the cell clicked is drawn, until it finds a cell with a different color from the color of the background. 
+**Figure 3.** (a) A drawing with a white background and red dots (b) When the user clicks on the vertical line button (`ColMajorFill`) and clicks the cell shown, (c) a vertical line that expands to the top and to the bottom of the cell clicked is drawn, until it finds a cell with a different color from the color of the background. 
  
 
 ##### `DiagonalLeft`
 
 ### Exercise 2 - Implement the Functions that Operate the Buttons for Drawing Squares, Triangles and Circles. 
 
-Now, you will implement the functionality to draw squares, circles and triangles. The **size** of the figure drawn will depend on the size selected on sliding bar in the interface.
+Now, you will implement the functionality to draw squares, circles and triangles. The **size** of the figure drawn will depend on the size selected on by using the sliding bar in the interface.
 
 
 #### 2a: Squares 
 
 ### Exercise 3 - Implement the Function that Fills the Figures using Recursion. 
 
-In this exercise you will implement the functionality to fill the color of the figures.One of the more convinient ways to express the algorithm to fill the figures is using recursion. A basic recursive algorithm (but it’s pretty weak) is found in Wikipedia:
+In this exercise you will implement the functionality to fill the color of the figures. One of the most convinient ways to express the algorithm to fill the figures is using recursion. A basic recursive algorithm (but it’s pretty weak) is found in Wikipedia:
 
 
 ```
 
 [3] http://en.wikipedia.org/wiki/Flood_fill
 
----
-
----
----
-
----
-
-----
-
-
-
-
-
 

README-es.md

 
 
 
-La recursión es una técnica muy utilizada en programación. Con esta técnica se resuelven problemas resolviendo un problema similar pero para casos más pequeños. Podemos construir conjuntos de objetos o procesos utilizando *reglas recursivas* y *valores iniciales*. Las *funciones recursivas* son funciones que se auto-invocan, utilizando cada vez conjuntos o elementos más pequeños,  hasta llegar a un punto en donde se utiliza la condición inicial en lugar de auto-invocarse. En esta experiencia de laboratorio implementarás algunas herramientas para dibujar y practicarás el uso de funciones recursivas para rellenar de color algunas figuras.
+La recursión es una técnica muy utilizada en programación. Con esta técnica se resuelven problemas resolviendo un problema similar pero para casos más pequeños. Podemos construir conjuntos de objetos o procesos utilizando *reglas recursivas* y *valores iniciales*. Las *funciones recursivas* son funciones que se auto-invocan, utilizando cada vez conjuntos o elementos más pequeños,  hasta llegar a un punto en donde se utiliza la condición inicial en lugar de auto-invocarse. En esta experiencia de laboratorio implementarás algunas herramientas para dibujar y practicarás el uso de funciones recursivas para rellenar de color algunas figuras. Esta experiencia de laboratorio es una adaptación de la asignación *GridPlotter* presentada por Alyce Brady y Pamela Cutter en [1]. La implementación de la cuadrícula y la capacidad de pintar en ella fue presentada por Sacha Schutz en [2] pero fue arreglada, modificada y adaptada para esta experiencia de laboratorio.
+
 
 ## Objetivos:
 
 1. Definir e implementar funciones recursivas.
 2. Practicar el uso de estructuras de repetición.
 
-Esta experiencia de laboratorio es una adaptación de la asignación *GridPlotter* presentada por Alyce Brady y Pamela Cutter en [1]. La implementación de la cuadrícula y la capacidad de pintar en ella fue presentada por Sacha Schutz en [2] pero fue arreglada, modificada y adaptada para esta experiencia de laboratorio.
 
 
 ## Pre-Lab:
 
 * `void switchOn(int x, int y, const QColor& color);` // Pinta la celda $$(x,y)$$ con el color dado. (No tienes que preocuparte por `QColor` porque se pasa a la función por parámetro.)
 
-Aunque no se ve en el archivo `tools.cpp`, hay una arreglo llamado `mColors` que contiene el color de todas las celdas de la cuadrilla. Esto te ayudará a saber cuál color está en una celda: `mColors[columns * y + x]`. Nota que el índice de este arreglo se calcula utilizando la conversión para cambiar coordenadas $$(x,y)$$ a índices que explicamos arriba.
+Aunque no se ve en el archivo `tools.cpp`, hay una arreglo llamado `mColors` que contiene el color de todas las celdas de la cuadrilla. Esto te ayudará a saber qué color está en una celda: `mColors[columns * y + x]`. Nota que el índice de este arreglo se calcula utilizando la conversión para cambiar coordenadas $$(x,y)$$ a índices que explicamos arriba.
 
 ---
 
 	* Utilizando la máquina virtual: Haz doble “click” en el archivo `GridPlotter.pro` que se encuentra  en el directorio `/home/eip/labs/recursion-gridplotter` de la máquina virtual.
 	* Descargando la carpeta del proyecto de `Bitbucket`: Utiliza un terminal y escribe el commando `git clone http:/bitbucket.org/eip-uprrp/recursion-gridplotter` para descargar la carpeta `recursion-gridplotter` de `Bitbucket`. En esa carpeta, haz doble “click” en el archivo `GridPlotter.pro`.
 
-2. El proyecto contiene el esqueleto para una aplicación para dibujar líneas o figuras en una cuadrilla. La aplicación tiene una interfaz que le permite al usuario seleccionar el color para pintar, el color para el trasfondo de la cuadrilla, la figura que se va a dibujar (por ejemplo, círculo, cuadrado) y el tamaño de la figura. La figura seleccionada se dibuja cuando el usuario marca una celda en la cuadrilla.
+2. El proyecto contiene el esqueleto de una aplicación para dibujar líneas o figuras en una cuadrilla. La aplicación tiene una interfaz que le permite al usuario seleccionar el color para pintar, el color para el trasfondo de la cuadrilla, la figura que se va a dibujar (por ejemplo, círculo, cuadrado) y el tamaño de la figura. La figura seleccionada se dibuja cuando el usuario marca una celda en la cuadrilla.
 
 Estarás trabajando en el archivo `tools.cpp`. Tu primera tarea es implementar las funciones `RowMajorFill`, `ColMajorFill`, `DiagonalLeft` y `DiagonalRight` que hacen que los botones para dibujar líneas funcionen. La función `RowMajorFill` ya está implementada para que la tengas de ejemplo. Las funciones deben trabajar como se indica adelante.
 
 
 [3] http://en.wikipedia.org/wiki/Flood_fill
 
----
-
----
----
-
----
-
-----
-
-
-
-
-
-
 

dialog.cpp

 /// \~English
 /// \brief  Enables the redo button
 /// \~Spanish
-/// \brief Permite utilizar el boton de (rehacer)
+/// \brief Permite utilizar el boton de rehacer (redo)
 void Dialog::setRedo(bool can){
     if (can == true) ui->redoButton->setDisabled(false);
     else ui->redoButton->setDisabled(true);
 /// \~English
 /// \brief Sets the tool to Diagonal Left fill
 /// \~Spanish
-/// \brief Ajusta la herrramienta a llenar en diagonal a la izquierda
+/// \brief Ajusta la herrramienta a llenar la diagonal hacia la izquierda
 void Dialog::on_diagonalleftButton_clicked()
 {
     ui->mainGrid->setTool("diagonal left");
 /// \~English
 /// \brief Sets the tool to Diagonal Right fill
 /// \~Spanish
-/// \brief Ajusta la herrramienta a llenar en diagonal a la derecha
+/// \brief Ajusta la herrramienta a llenar la diagonal hacia la derecha
 void Dialog::on_diagonalrightButton_clicked()
 {
     ui->mainGrid->setTool("diagonal right");

dialog.h

     /// \~English
     /// \brief Sets the tool to Diagonal Left fill
     /// \~Spanish
-    /// \brief Ajusta la herrramienta a llenar en diagonal a la izquierda
+    /// \brief Ajusta la herrramienta a llenar la diagonal hacia la izquierda
     void on_diagonalleftButton_clicked();
 
     /// \fn void Dialog::on_diagonalrightButton_clicked()
     /// \~English
     /// \brief Sets the tool to Diagonal Right fill
     /// \~Spanish
-    /// \brief Ajusta la herrramienta a llenar en diagonal a la derecha
+    /// \brief Ajusta la herrramienta a llenar la diagonal hacia la derecha
     void on_diagonalrightButton_clicked();
 
     /// \fn void Dialog::on_drawsquareButton_clicked()
     /// \~English
     /// \brief  Enables the redo button
     /// \~Spanish
-    /// \brief Permite utilizar el boton de (rehacer)
+    /// \brief Permite utilizar el boton de rehacer (redo)
     void setRedo(bool cannot);
 
     void on_floodButton_clicked();

grid.cpp

 /// \param rowCount number of rows in the grid
 /// \param columnCount number of columns in the grid
 /// \param parent parent window
-/// \~English
+/// \~Spanish
 /// \brief Constructor que recibe el numero de filas y columnas en la cuadricula
 /// \param rowCount numero de filas en la cuadricula
 /// \param columnCount numero de columnas en la cuadricula
 /// \~English
 /// \param tool choosen tool
 /// \brief Sets the tool
-/// \param tool herramienta escogida
 /// \~Spanish
+/// \param tool herramienta escogida
 /// \brief Ajusta la herramienta
 void GridWidget::setTool(QString tool){
     Tool = tool;
 /// the redo vector(newStates) and the last state in the undo vector(oldStates)
 /// is painted on the grid.
 /// \~Spanish
-/// \brief Cuando el boton es apretado el estado acutual es empujado en
-/// el vector(newStates) de redo y el ultimo estado en el vector(oldStates) undo es
-/// pintado en la cuadricula
+/// \brief Cuando el boton de deshacer (undo) es presionado el estado actual es empujado
+/// al vector(newStates) de rehacer (redo) y el ultimo estado del vector(oldStates) de 
+/// deshacer (undo) es pintado en la cuadricula
 void GridWidget::undo(){
 
     /* When the undo button is pressed the current state is pushed into
      * the redo vector and the last state in the undo vector is painted
      * on the grid.
-     * Cuando el boton undo es marcado el estado corriente es empujaro en
-     * el vector redo y el ultimo estado en el vector undo es pintado en la
-     * cuadricula
+     * Cuando el boton de deshacer (undo) es presionado  el estado corriente es empujado
+     * al vector de rehacer (redo) y el ultimo estado del vector de deshacer (undo) es
+     * pintado en la cuadricula
      */
 
     if (!oldStates.empty()){
 /// \brief When the redo button is pressed the current state is pushed into
 /// the undo vector(oldStates) and the last state in the redo vector(newStates)
 /// is painted on the grid.
-/// \~Spanish Cuando el boton redo es marcado el estado actual es empujado en
-/// el vector(oldStates) undo y el ultimo estado en el vector redo(newStates) es
-/// pintaod en el grid.
+/// \~Spanish Cuando el boton de rehacer (redo) es presionado el estado actual es empujado 
+/// al vector(oldStates) de deshacer (undo) y el último estado del vector (newStates) de 
+/// de rehacer (redo) es pintado en la cuadrícula.
 ///
 void GridWidget::redo(){
 
 /// \~English
 /// \brief Clears the grid and sets it to its initial state
 /// \~Spanish
-/// \brief Limpa la cuadricula y la pone en su estado inicial.
+/// \brief Limpia la cuadricula y la pone en su estado inicial.
 void GridWidget::clear()
 {
     oldStates.push_back(mColors);
 /// \param x coordinate x of the cell in the grid.
 /// \param y coordinate y of the cell in the grid.
 /// \~Spanish
-/// \brief Esta funcion es llamada en cada evento de el mouse presionado dentro
+/// \brief Esta funcion es llamada en cada evento del mouse presionado dentro
 /// de la cuadricula.  Identifica la forma en que el grid va a ser pintado llamando
 /// la funcion del tool recibido en los parametros (dot, rowfill, column fill, diagonal, square,
 /// triangles and circles).

grid.h

     ///* Tool and ToolSize: Sets the Tool which is going to be used to draw the grid
     ///* frontColor: The color which will be used to paint to black
     ///* backColor: Current clicked square
-    ///* background: Sets the background color to white
+    ///* background: The background color to white
     /// \~English
     /// \brief Constructor por defecto. Las propiedades de el grid se ajustan como sigue:
     /// * mCellSize: Ajusta el tamano de la celda a 10px
     /// * mRowCount: Ajusta el numero de filas en la cuadricula a 39
     /// * ColumnCount: Ajusta el numero de columnas en el grid a 27
-    /// * Tool and ToolSize: Ajusta la herramiento que se va a utilizar para dibujar
+    /// * Tool and ToolSize: Ajusta la herramienta que se va a utilizar para dibujar
     /// el grid.
-    /// * frontColor: El color que se utilizara para pintar a negro
+    /// * frontColor: El color que se utilizara para pintar en negro
     /// * backColor: Cuadrado marcado actualmente
     /// * background: El color del fondo en blanco
     GridWidget(QWidget *parent);
     /// \param rowCount number of rows
     /// \param columnCount number of columns
     /// \~Spanish
-    /// \brief Ajusta el numero de columnas y fileas de la cuadricula
+    /// \brief Ajusta el numero de columnas y filas de la cuadricula
     /// \param rowCount numero de filas
     /// \param columnCount numero de columnas
     void setGridSize(int rowCount, int columnCount);
     /// \param x coordinate x of the cell in the grid
     /// \param y coordinate y of the cell in the grid
     /// \~Spanish
-    /// \brief Remueve la posicion dada del vector que representa
+    /// \brief Elimina la posicion dada del vector que representa
     /// las celdas pintadas en la cuadricula
     /// \param x coordenada x de la celda en el cuadricula
     /// \param y coordenada y de la celda en la cuadricula
     /// \~English
     /// \brief Clears the grid and sets it to its initial state
     /// \~Spanish
-    /// \brief Limpa la cuadricula y la pone en su estado inicial.
+    /// \brief Limpia la cuadricula y la pone en su estado inicial.
     void clear();
 
     /// \fn void GridWidget::setCellSize(int size)
 
     /// \fn void GridWidget::setTool(QString tool)
     /// \~English
-    /// \param tool choosen tool
+    /// \param tool chosen tool
     /// \brief Sets the tool
-    /// \param tool herramienta escogida
     /// \~Spanish
+    /// \param tool herramienta escogida
     /// \brief Ajusta la herramienta
     void setTool(QString tool);
 
     /// It identifies the way the grid will be painted calling the function of the
     /// tool received in the parameters (dot, rowfill, column fill, diagonal, square,
     /// triangles and circles).
-    /// \param tool the tool to be called by the funtion
+    /// \param tool the tool to be called by the function
     /// \param x coordinate x of the cell in the grid.
     /// \param y coordinate y of the cell in the grid.
     /// \~Spanish
-    /// \brief Esta funcion es llamada en cada evento de el mouse presionado dentro
+    /// \brief Esta funcion es llamada en cada evento del mouse presionado dentro
     /// de la cuadricula.  Identifica la forma en que el grid va a ser pintado llamando
     /// la funcion del tool recibido en los parametros (dot, rowfill, column fill, diagonal, square,
     /// triangles and circles).
     /// \param toolColor color of the cells painted by the tool
     /// \~Spanish
     /// \brief Recibe las coordenadas de la cuadricula donde el usuario marco
-    /// y pinta (desde ese punto hacia la arriba o abajo) la columna mas larga del mismo color
+    /// y pinta (desde ese punto hacia arriba o abajo) la columna mas larga del mismo color
     /// de la celda que fue marcada con el color de la herramienta.
     /// \param x coordenada x de la celda en la cuadricula
     /// \param y coordenada y de la celda en la cuadricula
     /// the redo vector(newStates) and the last state in the undo vector(oldStates)
     /// is painted on the grid.
     /// \~Spanish
-    /// \brief Cuando el boton es apretado el estado acutual es empujado en
-    /// el vector(newStates) de redo y el ultimo estado en el vector(oldStates) undo es
-    /// pintado en la cuadricula
+    /// \brief Cuando el boton de deshacer (undo) es presionado el estado actual es empujado 
+    /// al vector(newStates) de rehacer (redo) y el ultimo estado del vector(oldStates) de
+    /// deshacer (undo) es pintado en la cuadricula
     void undo();
 
 
     /// its parent receives a repaint signal.
     /// \param event received event reference
     /// \~Spanish
-    /// \brief Esta funcion es invocada automaticmente cada ves que el widget o
+    /// \brief Esta funcion es invocada automaticmente cada vez que el widget o
     /// el padre recibe una senal de repintar.
     /// \param event referencia a un evento recibido
     virtual void paintEvent(QPaintEvent *);

tools.cpp

 
 // Receives the x,y grid coordinates and the color of cell where the user
 // clicked. Paints the row (from that point left and right) of color toolColor until
-// it hits a cell of a different color than that one clicked.
+// it hits a cell of a different color than the one clicked.
 
 void GridWidget::RowMajorFill(int x, int y, QColor colorClicked, QColor toolColor){
      for (int i = x; i<getGridColumns() && (getCellColor(i,y) == colorClicked) ; i++)
 
 // Receives the grid x,y coordinates and the color of cell where the user
 // clicked. Paints the column (from that point up and down) of color toolColor until
-// it hits a cell of a different color than that one clicked.
+// it hits a cell of a different color than the one clicked.
 
 void GridWidget::ColMajorFill(int x, int y, QColor colorClicked, QColor toolColor){
 
 
 // Receives the grid x,y coordinates and the color of cell where the user
 // clicked. Paints a left-diagonal of color toolColor until it hits a cell
-// of a different color than that one clicked.
+// of a different color than the one clicked.
 
 void GridWidget::DiagonalLeft(int x, int y, QColor colorClicked, QColor toolColor){
 
 
 // Receives the grid x,y coordinates and the color of the cell where the user
 // clicked. Paints a right-diagonal of color toolColor until it hits a cell
-// of a different color than that one clicked.
+// of a different color than the one clicked.
 
 void GridWidget::DiagonalRight(int x, int y, QColor colorClicked, QColor toolColor){