README-es.md edited on August 3, 2016 at 9:25am

README-es.md

@@ -1,11 +1,12 @@
-# Arreglos - Editor de Imagenes Simple
+# Arreglos - Editor de Imágenes Simple
 
 ![main1.png](images/main1.png)
 ![main2.png](images/main2.png)
 ![main3.png](images/main3.png)
 
+[verano2016 - Coralys]
 
-Los arreglos de datos (*arrays*) nos facilitan guardar y trabajar con grupos de datos del mismo tipo. Los datos se guardan en espacios de memoria consecutivos a los que se puede acceder utilizando el nombre del arreglo e índices o suscritos que indican la posición en que se encuentra el dato. Las estructuras de repetición nos proveen una manera simple de acceder a los datos de un arreglo. En la experiencia de laboratorio de hoy diseñarás e implementarás algoritmos simples de procesamiento de imágenes para practicar el uso de ciclos anidados en la manipulación de arreglos bi-dimensionales. 
+Los arreglos de datos (*arrays*) nos facilitan guardar y trabajar con grupos de datos del mismo tipo. Los datos se guardan en espacios de memoria consecutivos a los que se puede acceder utilizando el nombre del arreglo con índices o suscritos que indican la posición en la que se encuentra el dato. Las estructuras de repetición nos proveen una manera simple de acceder a los datos de un arreglo. En la experiencia de laboratorio de hoy, diseñarás e implementarás algoritmos simples de procesamiento de imágenes para practicar el uso de ciclos anidados en la manipulación de arreglos bi-dimensionales. 
 
 ## Objetivos:
 
@@ -13,9 +14,9 @@ Los arreglos de datos (*arrays*) nos facilitan guardar y trabajar con grupos de
 
 2. Aplicar ciclos anidados para implementar algoritmos simples de procesamiento de imágenes.
 
-3. Utilizar expresiones aritméticas para transformar colores de pixeles.
+3. Utilizar expresiones aritméticas para transformar colores de píxeles.
 
-4. Acceder pixeles en una imagen y descomponerlos en sus componentes rojo, azul y verde.
+4. Acceder píxeles en una imagen y descomponerlos en sus componentes rojo, azul y verde.
 
 
 ## Pre-Lab:
@@ -26,11 +27,11 @@ Antes de llegar al laboratorio debes:
 
 2. Haber repasado los conceptos básicos relacionados a estructuras de repetición y ciclos anidados.
 
-3. Conocer las funciones básicas de `QImage` para manipular los pixeles de las imágenes. 
+3. Conocer las funciones básicas de `QImage` para manipular los píxeles de las imágenes. 
 
 4. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
 
-5. Haber tomado el quiz Pre-Lab que se encuentra en Moodle.
+5. Haber tomado el quiz Pre-Lab disponible en Moodle.
 
 ---
 
@@ -39,32 +40,32 @@ Antes de llegar al laboratorio debes:
 
 ## Edición de imágenes
 
-En esta experiencia de laboratorio, trabajarás con varios conceptos y destrezas básicas de edición de imágenes. Te proveemos un interfaz gráfico (GUI) simple que le permite al usuario cargar una imagen e invertirla vertical y horizontalmente.  Tu tarea es crear e implementar una función para convertir una imagen a color a una imagen con tonos de gris, y otra función que convierta una imagen a color a una imagen en blanco y negro.
+En esta experiencia de laboratorio trabajarás con varios conceptos y destrezas básicas de edición de imágenes. Te proveemos un interfaz gráfico (GUI) simple que le permite al usuario cargar una imagen e invertirla vertical y horizontalmente.  Tu tarea es crear e implementar una función para convertir una imagen a color a una imagen con tonos de gris, y otra función que convierta una imagen a color a una imagen en blanco y negro.
 
 ### Píxeles
 
-Al elemento más pequeño de una imagen se le llama un *píxel*. Esta unidad consiste de un solo color. Como cada color es una combinación de tonalidades de los colores primarios rojo, verde y azul,   se codifica como un entero sin signo cuyos bytes  representan los tonos de rojo, verde y azul del pixel  (Figura 1). A esta combinación se le llama el *RGB* del color por las siglas de "Red-Green-Blue". Por ejemplo un píxel de color rojo (puro) tiene una representación RGB `0x00ff0000`, mientras que un píxel de color blanco tiene una representación RGB de `0x00FFFFFF` (ya que el color blanco es la combinación de los tonos rojo, verde y azul en toda su intensidad).
+Al elemento más pequeño de una imagen se le llama *píxel*. Esta unidad consiste de un solo color. Como cada color es una combinación de tonalidades de los colores primarios rojo, verde y azul, se codifica como un entero sin signo cuyos bytes representan los tonos de rojo, verde y azul del píxel (Figura 1). A esta combinación se le llama el *RGB* del color por las siglas de "Red-Green-Blue". Por ejemplo, un píxel de color rojo (puro) tiene una representación RGB `0x00ff0000`, mientras que un píxel de color blanco tiene una representación RGB de `0x00FFFFFF` (ya que el color blanco es la combinación de los tonos rojo, verde y azul en toda su intensidad).
 
 ---
 
 ![figure1.png](images/figure1.png)
 
-**Figura 1.** Distribución de bits para las tonalidades de rojo, verde y azul dentro de la representación RGB.  Cada tonalidad puede tener valores entre 0x00 (los ocho bits en 0) y 0xFF (los 8 bits en 1). 
+**Figura 1.** Distribución de bits para las tonalidades de rojo, verde y azul dentro de la representación RGB. Cada tonalidad puede tener valores entre 0x00 (los ocho bits en 0) y 0xFF (los 8 bits en 1). 
 
 ---
 
-En `Qt` se utiliza el tipo `QRgb` para representar valores `RGB`.  Utilizando ciertas funciones que describimos abajo podemos obtener los componentes rojo, verde y azul del valor `QRgb` del píxel y así manipular imágenes.
+En `Qt` se utiliza el tipo de dato `QRgb` para representar valores `RGB`.  Utilizando ciertas funciones que describimos abajo, podemos obtener los componentes rojo, verde y azul del valor `QRgb` del píxel y así manipular imágenes.
 
 ### Biblioteca
 
-La experiencia de laboratorio de hoy utilizará la clase `QImage`. Esta clase permite acceder a los datos de los pixeles de una imagen para poder manipularla. La documentación de la clase `QImage` se encuentra en http://doc.qt.io/qt-4.8/qimage.html.
+La experiencia de laboratorio de hoy utilizará la clase `QImage`. Esta clase permite acceder a los datos de los píxeles de una imagen para poder manipularla. La documentación de la clase `QImage` se encuentra en http://doc.qt.io/qt-4.8/qimage.html.
 
 El código que te proveemos contiene los siguiente objetos de la clase `QImage`:
 
 * `originalImage`   // contiene la información de la imagen original que vas a editar
 *  `editedImage`  // contendrá la imagen editada
 
-Los objetos de clase `QImage` tienen los siguiente métodos que serán útiles para la experiencia de laboratorio de hoy:
+Los objetos de la clase `QImage` tienen los siguiente métodos que serán útiles para la experiencia de laboratorio de hoy:
 
 
 * `width()`      // devuelve el valor entero del ancho de la imagen
@@ -97,12 +98,12 @@ Las siguientes funciones son útiles para trabajar con datos de tipo `QRgb`:
 
     `editedImage.setPixel(2,3,qRgb(0xff,0x00,0x00));`.
 
-4. La siguiente instrucción le asigna a `greenContent` el valor del tono de verde que contiene el pixel `(1,1)` de  `originalImage`:
+4. La siguiente instrucción le asigna a `greenContent` el valor del tono de verde que contiene el pixel `(1,1)` de `originalImage`:
 
     `int greenContent = qGreen(originalImage.pixel(1,1));`.
 
 
-5. El siguiente programa crea un objeto de clase `QImage` e imprime los componentes rojo, verde y azul del pixel en el centro de la imagen. La imagen utilizada es la que se especifica dentro del paréntesis durante la creación del objeto, esto es, el archivo `chuck.png`.
+5. El siguiente programa crea un objeto de la clase `QImage` e imprime los componentes rojo, verde y azul del pixel en el centro de la imagen. La imagen utilizada es la que se especifica dentro del paréntesis durante la creación del objeto, esto es, el archivo `chuck.png`.
 
 ---
 
@@ -148,7 +149,7 @@ En la experiencia de laboratorio de hoy diseñarás e implementarás algoritmos
 
 ### Ejercicio 1 - Entender el código provisto
 
-#### Instrucciones:
+#### Instrucciones
 
 
 1. Carga a `QtCreator` el proyecto `SimpleImageEditor`. Hay dos maneras de hacer esto:
@@ -168,9 +169,9 @@ En la experiencia de laboratorio de hoy diseñarás e implementarás algoritmos
 
 3. Estarás trabajando con el archivo `filter.cpp`. Estudia la función `HorizontalFlip` del archivo `filter.cpp` para que entiendas su operación.
 
-    En los ejercicios siguientes estarás usando mayormente los objetos `originalImage` y `editedImage` de clase `QImage`. ¿Cuál crees que es el propósito la variable `pixel`?
+    En los ejercicios siguientes estarás usando mayormente los objetos `originalImage` y `editedImage` de la clase `QImage`. ¿Cuál crees que es el propósito la variable `pixel`?
 
-4. El código que te proveemos ya tiene programado el funcionamiento de los botones de la interfaz gráfica. NO tienes que cambiar nada en este código pero te incluimos las siguientes explicaciones para que conozcas un poco del funcionamiento de los botones. En el archivo `mainwindow.cpp`, las etiquetas `lblOriginalImage` y `lblEditedImage` corresponden a las partes de la interfaz que identifican la imagen original y la imagen procesada. Los botones
+4. El código que te proveemos ya tiene programado el funcionamiento de los botones de la interfaz gráfica. NO tienes que cambiar nada en este código, pero te incluimos las siguientes explicaciones para que conozcas un poco del funcionamiento de los botones. En el archivo `mainwindow.cpp`, las etiquetas `lblOriginalImage` y `lblEditedImage` corresponden a las partes de la interfaz que identifican la imagen original y la imagen procesada. Los botones
 
     * `btnLoadImage`
     * `btnSaveImage`
@@ -190,7 +191,7 @@ En la experiencia de laboratorio de hoy diseñarás e implementarás algoritmos
 El "image grayscale" es una operación que se usa para convertir una imagen a color a una imagen que solo tenga tonalidades de gris. Para hacer esta conversión se usa la siguiente fórmula en cada uno de los píxeles: `gray = (red * 11 + green * 16 + blue * 5)/32 ;` donde `red`, `green` y `blue` son los valores para los tonos de los colores rojo, verde y azul en el píxel de la imagen original a color, y `gray` será el color asignado a los colores rojo, verde y azul en el píxel de la imagen editada. Esto es,
 `editedImage.setPixel( i, j, qRgb(gray, gray, gray) )`.
 
-#### Instrucciones:
+#### Instrucciones
 
 1. Utilizando pseudocódigo, expresa el algoritmo para convertir una imagen a color a una imagen solo con tonalidades de gris. El apéndice de este documento contiene algunos consejos sobre buenas prácticas al hacer pseudocódigos. 
 
@@ -210,7 +211,7 @@ El "image grayscale" es una operación que se usa para convertir una imagen a co
 
 "Thresholding" es una operación que se puede utilizar para convertir una imagen a color a una imagen en blanco y negro. Para hacer esta conversión debemos decidir cuáles colores de la imagen original van a convertirse en píxeles blancos y cuáles serán negros. Una manera sencilla de decidir esto es computando el promedio de los componentes rojo, verde y azul de cada píxel. Si el promedio es menor que el valor umbral ("threshold"), entonces cambiamos el píxel a negro; de lo contrario se cambia a blanco.
 
-#### Instrucciones:
+#### Instrucciones
 
 1. Utilizando pseudocódigo, expresa el algoritmo para "thresholding". Presume que utilizarás el valor del deslizador como umbral.
 
@@ -236,21 +237,21 @@ El "image grayscale" es una operación que se usa para convertir una imagen a co
 
 ---
 
-##Entrega
+## Entrega
 
-Utiliza "Entrega" en Moodle para entregar el archivo `filter.cpp` que contiene las funciones  `GreyScale` y `Threshold`. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
+Utiliza "Entrega" en Moodle para entregar el archivo `filter.cpp` que contiene las funciones  `GreyScale` y `Threshold`. Recuerda utilizar buenas prácticas de programación, incluye el nombre de los programadores y documenta tu programa.
 
 ---
 
 ---
 
-##Apéndice: Buenas prácticas al escribir pseudocódigos
+## Apéndice: Buenas prácticas al escribir pseudocódigos
 
-1. Provee una descripción de los datos de entrada y salida
-2. Enumera los pasos
-3. Usa estructuras de repetición y decisión comunes: `if, else, for, while`
-4. Indenta los bloques de pasos que están dentro de una estructura de repetición o decisión, "Python-style"
-5. No necesitas declarar los tipos de las variables pero si debes inicializarlas. Esto es especialmente importante para contadores y acumuladores
+1. Provee una descripción de los datos de entrada y salida.
+2. Enumera los pasos.
+3. Usa estructuras de repetición y decisión comunes: `if, else, for, while`.
+4. Indenta los bloques de pasos que están dentro de una estructura de repetición o decisión, "Python-style".
+5. No necesitas declarar los tipos de las variables, pero si debes inicializarlas. Esto es especialmente importante para contadores y acumuladores.
 6. Recuerda que el propósito de un pseudocódigo es que un humano lo pueda entender.
 
 **Ejemplo:**
@@ -269,7 +270,7 @@ Output: true if n is prime, false otherwise
 
 ---
 
-##Referencias
+## Referencias
 
 [1] http://www.willamette.edu/~gorr/classes/GeneralGraphics/imageFormats/24bits.gif