root 8 anni fa
parent
commit
10d284a3ee
3 ha cambiato i file con 559 aggiunte e 559 eliminazioni
  1. 271
    0
      README-en.md
  2. 286
    0
      README-es.md
  3. 2
    559
      README.md

+ 271
- 0
README-en.md Vedi File

@@ -0,0 +1,271 @@
1
+
2
+
3
+# Arrays - Simple Image Editor
4
+
5
+![main1.png](images/main1.png)
6
+![main2.png](images/main2.png)
7
+![main3.png](images/main3.png)
8
+
9
+Arrays help us to store and work with groups of data of the same type. The data is stored in consecutive memory spaces which can be accessed by using the name of the array and indexes or subscripts that indicate the position where the data is stored. Repetition structures provide us a simple way of accessing the data within an array. In today's laboratory experience you will design and implement simple algorithms for image processing to practice the use of nested loops to manipulate bi-dimensional arrays.
10
+
11
+##Objectives
12
+
13
+1. Practice the access and manipulation of data in an array.
14
+
15
+2. Apply nested loops to implement simple image processing algorithms.
16
+
17
+3. Use arithmetic expressions to transform colors in pixels.
18
+
19
+4. Access pixels in an image and break them down into their red, blue, and green components.
20
+
21
+
22
+##Pre-Lab:
23
+
24
+Before coming to the laboratory session you should have:
25
+
26
+1. Acquired one or more files with a colored image in one of the following formats: `tiff, jpg, png`.
27
+
28
+2. Reviewed the basic concepts related to repetition structures and nested loops.
29
+
30
+3. Become familiar with the basic functions in `QImage` to manipulate the pixels in the images.
31
+
32
+4. Studied the concepts and instructions for the laboratory session.
33
+
34
+5. Taken the Pre-Lab quiz available through the course’s Moodle portal.
35
+
36
+---
37
+
38
+---
39
+
40
+##Image editing
41
+
42
+In this laboratory experience, you will work with various concepts and basic skills of image editing. We have provided a simple graphical user interface that allows the user to load an image and invert it vertically and horizontally. Your task is to create and implement a function to convert the colored image into an image with gray tones, and another function that converts the colored image into a black and white image.
43
+
44
+###Pixels
45
+
46
+The smallest element in an image is called a *pixel*. This unit consists of a single color. Since each color is a combination of tones for the primary red, green and blue colors, it is coded as an unsigned integer whose bytes represent the tones of red, green and blue of the pixel (Figure 1). This combination is called the color's *RGB* which is an acronym for "Red-Green-Blue". For example, a pure red pixel has an RGB representation of `0x00ff0000`, while a white pixel has an RGB representation of `0x00FFFFFF` (since the color white is a combination of tones of red, green and blue in all of their intensity).
47
+
48
+---
49
+
50
+![figure1.png](images/figure1.png)
51
+
52
+**Figure 1.** Bit distribution for the tones of red, green and blue in an RGB representation. Each tone can have values between 0x00 (the eight bits in 0) and (0xFF (the 8 bits in 1).
53
+
54
+---
55
+
56
+`Qt` uses the `QRgb` type to represent `RGB` values. Using certain functions that are described below we can obtains the red, green and blue components of the `QRgb` value of the pixel and manipulate the images.
57
+
58
+###Library
59
+
60
+In today's laboratory experience you will use the `QImage` class. This class permits access to the data in the pixels of an image to manipulate it. The documentation for the `QImage` class can be found in http://doc.qt.io/qt-4.8/qimage.html.
61
+
62
+The code provided in this project contains the following objects of the `QImage` class:
63
+
64
+* `originalImage`   // contains the information of the original image that you will edit
65
+*  `editedImage`  // will contain the edited image
66
+
67
+The objects of the `QImage` class have the following methods that will be useful for today's laboratory experience:
68
+
69
+* `width()`      // returns the integer value for the image's width
70
+* `height()`      // returns the integer value for the image's height
71
+* `pixel(i, j)`       // returns the `QRgb` for the pixel in position `(i,j)`
72
+* `setPixel(i,j, pixel)`   // modifies the value for the pixel in position `(i,j)` to the value of pixel `QRgb`
73
+
74
+The following functions are useful to work with data of type `QRgb`:
75
+
76
+* `qRed(pixel)`   // returns the tone for the pixel's red color
77
+* `qGreen(pixel)` // returns the tone for the pixel's green color
78
+* `qBlue(pixel)`  // returns the tone for the pixel's blue color
79
+* `qRgb(int red, int green, int blue)` // returns the `QRgb` pixel composed of the red, green and blue values received.
80
+
81
+
82
+####Examples:
83
+
84
+1. `QRgb myRgb = qRgb(0xff, 0x00, 0xff);`: Assigns the value `0xff00ff` to `myRgb` which represents the color ![figure2.jpg](images/figure2.jpg)
85
+
86
+    Notice that the value `0xff00ff` represents the values `0xff`, `0x0`, and `0xff`, that correspond to the red, green and blue components in `myRgb`.
87
+
88
+2. If the following `4 x 4` image of pixels represents the object `originalImage`,
89
+
90
+ ![ejemplo.png](images/ejemplo.png)
91
+
92
+then `originalImage.pixel(2,1)` returns the  `rgb` value that represents the color blue ( `0x0000ff`).
93
+
94
+3. The following instruction assigns the color red to the pixel in position `(2,3)` in the edited image:
95
+
96
+`editedImage.setPixel(2,3,qRgb(0xff,0x00,0x00));`.
97
+
98
+4. The following instruction assigns to `greenContent` the value of the green tone that is contained in the pixel `(1,1)` of `originalImage`:
99
+
100
+    `int greenContent = qGreen(originalImage.pixel(1,1));`.
101
+
102
+5. The following program creates an object of the `QImage` class and prints the red, green and blue components of the pixel in the center of the image. The image used is the one specified within the parenthesis during the creation of the object, that is, the file `chuck.png`
103
+
104
+---
105
+
106
+```cpp
107
+#include <QImage>
108
+#include <iostream>
109
+
110
+using namespace std;
111
+int main() {
112
+    QImage myImage(“/Users/rarce/Downloads/chuck.png”);
113
+    QRgb    centralPixel;
114
+
115
+    centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
116
+
117
+    cout    << hex;
118
+
119
+    cout    << “The red, green and blue components of the middle pixel are: “
120
+        << qRed(centralPixel) << “, “
121
+        << qGreen(centralPixel) << “, “
122
+        << qBlue(centralPixel) << endl;
123
+    return 0;
124
+}
125
+```
126
+
127
+---  
128
+
129
+---
130
+
131
+!INCLUDE "../../eip-diagnostic/simple-image-editor/en/diag-simple-image-editor-01.html"
132
+
133
+!INCLUDE "../../eip-diagnostic/simple-image-editor/en/diag-simple-image-editor-02.html"
134
+
135
+
136
+---
137
+
138
+---
139
+
140
+
141
+##Laboratory Session:
142
+
143
+In today's laboratory experience you will design and implement simple image processing algorithms to practice the use of nested loops and the manipulation of bi-dimensional arrays.
144
+
145
+###Exercise 1: Understand the provided code
146
+
147
+####Instructions
148
+
149
+1. Load the Qt project called `SimpleImageEditor` by double-clicking on the `SimpleImageEditor.pro` file in the `Documents/eip/Arrays-SimpleImageEditor` folder of your computer. You may also go to `http://bitbucket.org/eip-uprrp/arrays-simpleimageeditor` to download the `Arrays-SimpleImageEditor` folder to your computer.
150
+
151
+2. The code that we provide creates the interface in Figure 2.
152
+
153
+    ---
154
+
155
+    ![figure3.png](images/figure3.png)
156
+
157
+    **Figura 2.** Interface del editor de imágenes.
158
+
159
+    ---
160
+
161
+3. You will be working with the `filter.cpp` file. Study the `HorizontalFlip` function in the `filter.cpp` file so you understand how it operates.
162
+
163
+In the following exercises you will be mainly using the objects `originalImage` and `editedImage` of the `QImage` class. What do you think is the purpose for the `pixel` variable?
164
+
165
+4. The provided code already has the the functionality of the buttons in the graphical user interface programmed. You do NOT have to change anything in this code but we provide the following explanations so you can know a little about how the buttons work. In the `mainwindow.cpp` file, the `lblOriginalImage` and `lblEditedImage` objects correspond to the parts of the interface that identify the original image and the processed image. The buttons
166
+
167
+    * `btnLoadImage`
168
+    * `btnSaveImage`
169
+    * `btnInvertThreshold`
170
+    * `btnFlipImageHorizontally`
171
+    * `btnFlipImageVertically`
172
+    * `btnGreyScaleFilter`
173
+    * `btnRevertImage` 
174
+
175
+are connected to functions so when a button in the interface is pressed, a certain task is carried out. For example, when you press the `LoadImage` button, a window will appear for you to select the file with the image you want to edit, which when read, the image is assigned to `originalImage`. The slider `thresholdSlider` can assume values between 0 and 255.
176
+
177
+
178
+5. Compile and run the program. Test the buttons for `Load New Image` and `Flip Image Horizontally` with the images that you brought so you can validate if the buttons are working.
179
+
180
+###Exercise 2: Convert a colored image to an image with gray tones
181
+
182
+Image grayscale is an operation that is used to convert a colored image to an image with only tones of gray. To make this conversion the following formula is used in each pixel:
183
+
184
+`gray = (red * 11 + green * 16 + blue * 5)/32 ;`
185
+
186
+where `red`, `green` and `blue` are the values for the tones of the red, green and blue colors in the pixel of the original colored image, and `gray` will be the assigned color to the red, green, and blue colors in the pixel of the edited image. That is,
187
+
188
+`editedImage.setPixel( i, j, qRgb(gray, gray, gray) )`.
189
+
190
+####Instructions
191
+
192
+1. Using pseudocode, express the algorithm to convert a colored image to an image with only gray tones. The appendix in this document contains some advice about good techniques for writing pseudocode.
193
+
194
+2. Complete the `GreyScale` function in the `filter.cpp` file to implement the grayscale algorithm. The function should produce a result similar to that in Figure 3, where the image on the left is the original image and the one on the right is the edited image.
195
+
196
+    ---
197
+
198
+    ![chuck-color.png](images/chuck-color.png)
199
+    ![chuck-gris.png](images/chuck-gris.png)
200
+
201
+    **Figure 3.** Original image and image after applying the `GreyScale` function.
202
+
203
+    ---
204
+
205
+###Exercise 3: Convert a colored image to a black and white image ("Thresholding")
206
+
207
+Thresholding es an operation that can be used to convert a colored image to an image in black and white. To make this conversion we must decide which colors of the original image will be converted to white pixels and which to black. One simple way of deciding this is to compute the average of the red, green and blue components of each pixel. If the average is smaller than the threshold value, then we change the pixel to black; if not, it's changed to white.
208
+
209
+####Instructions
210
+
211
+1. Using pseudocode, express the thresholding algorithm. Assume that you will use the slider's value as the threshold.
212
+
213
+2. In the program, if the `chkboxThreshold` box is marked, the `applyThresholdFilter` function is invoked. The `applyThresholdFilter` function is also invoked each time that the value of the slider is changed.
214
+
215
+3. Complete the `ThresholdFilter` function so it implements the threshold algorithm in the colored image using the slider's value as the threshold. If the implementation is correct, the image on the right should be the original image but in black and white. The threshold value is a parameter of the `ThresholdFilter` function. The code provided in `mainwindow.h` has the constants `BLACK` and `WHITE` defined with their hexadecimal values; you can take advantage of this and use them in your code.
216
+
217
+4. The boolean parameter `invertColor` will be `true` if the option to invert the colors has been selected. Write the code so that the white and black colors are inverted if `invertColor` is `true`.
218
+
219
+5. Test the program with different images and different threshold values.
220
+
221
+    ---
222
+
223
+    ![chuck-color.png](images/chuck-color.png)
224
+    ![chuck-threshold.png](images/chuck-threshold.png)
225
+
226
+    **Figure 4.** Original image and image after applying the `ThresholdFilter` function.
227
+
228
+    ---
229
+
230
+ ---
231
+
232
+ ---
233
+
234
+##Deliverables
235
+
236
+Use "Deliverables" in Moodle to upload the `filter.cpp` file that contains the `GreyScale` and `Threshold` functions. Remember to use good programming techniques, include the names of the programmers involved, and to document your program.
237
+
238
+---
239
+
240
+---
241
+
242
+##Appendix: Good techniques for writing pseudocode
243
+
244
+1. Provide a description of the input and output data
245
+2. Enumerate the steps
246
+3. Use common repetition and decision structures: `if, else, for, while`
247
+4. Indent the blocks of steps that are inside of a decision or repetition structure, "Python-style"
248
+5. You do not need to declare the types of variables but you should initialize them. This is especially important for counters and accumulators
249
+6. Remember that the purpose of pseudocode is so a human can understand it.
250
+
251
+**Example:**
252
+
253
+```
254
+Input: n, a positive integer
255
+Output: true if n is prime, false otherwise
256
+---------------------------------------------------------
257
+1. for i = 3 to n / 2
258
+2.   if n % i == 0:
259
+3.      return false
260
+4. return true
261
+```
262
+
263
+---
264
+
265
+---
266
+
267
+##References
268
+
269
+[1] http://www.willamette.edu/~gorr/classes/GeneralGraphics/imageFormats/24bits.gif
270
+
271
+[2] http://doc.qt.io/qt-4.8/qimage.html.

+ 286
- 0
README-es.md Vedi File

@@ -0,0 +1,286 @@
1
+
2
+# Arreglos - Editor de Imagenes Simple
3
+
4
+![main1.png](images/main1.png)
5
+![main2.png](images/main2.png)
6
+![main3.png](images/main3.png)
7
+
8
+
9
+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. 
10
+
11
+##Objetivos:
12
+
13
+1. Practicar el acceder y manipular datos en un arreglo.
14
+
15
+2. Aplicar ciclos anidados para implementar algoritmos simples de procesamiento de imágenes.
16
+
17
+3. Utilizar expresiones aritméticas para transformar colores de pixeles.
18
+
19
+4. Acceder pixeles en una imagen y descomponerlos en sus componentes rojo, azul y verde.
20
+
21
+
22
+##Pre-Lab:
23
+
24
+Antes de llegar al laboratorio debes:
25
+
26
+1. Conseguir y tener disponible uno o más archivos con una imagen a color en alguno de los siguientes formatos: `tiff, jpg, png`.
27
+
28
+2. Haber repasado los conceptos básicos relacionados a estructuras de repetición y ciclos anidados.
29
+
30
+3. Conocer las funciones básicas de `QImage` para manipular los pixeles de las imágenes. 
31
+
32
+4. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
33
+
34
+5. Haber tomado el quiz Pre-Lab que se encuentra en Moodle.
35
+
36
+---
37
+
38
+---
39
+
40
+
41
+##Edición de imágenes
42
+
43
+En esta experiencia de laboratorio, trabajarás con varios conceptos y destrezas básicas de edición de imágenes. Te proveemos un interface 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.
44
+
45
+###Píxeles
46
+
47
+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).
48
+
49
+---
50
+
51
+![figure1.png](images/figure1.png)
52
+
53
+**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). 
54
+
55
+---
56
+
57
+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.
58
+
59
+###Biblioteca
60
+
61
+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.
62
+
63
+El código que te proveemos contiene los siguiente objetos de la clase `QImage`:
64
+
65
+* `originalImage`   // contiene la información de la imagen original que vas a editar
66
+*  `editedImage`  // contendrá la imagen editada
67
+
68
+Los objetos de clase `QImage` tienen los siguiente métodos que serán útiles para la experiencia de laboratorio de hoy:
69
+
70
+
71
+* `width()`      // devuelve el valor entero del ancho de la imagen
72
+* `height()`      // devuelve el valor entero de la altura de la imagen
73
+* `pixel(i, j)`       // devuelve el `QRgb` del píxel en la posición `(i,j)`
74
+* `setPixel(i,j, pixel)`   // modifica el valor del píxel en la posición `(i, j)` al valor píxel `QRgb`
75
+
76
+Las siguientes funciones son útiles para trabajar con datos de tipo `QRgb`:
77
+
78
+
79
+* `qRed(pixel)`   // devuelve el tono del color rojo del píxel
80
+* `qGreen(pixel)` // devuelve el tono del color verde del píxel
81
+* `qBlue(pixel)`  // devuelve el tono del color azul del píxel
82
+* `qRgb(int red, int green, int blue)` // devuelve un píxel `QRgb` compuesto de los valores de rojo, verde y azul recibidos.
83
+
84
+
85
+####Ejemplos:
86
+
87
+1. `QRgb myRgb = qRgb(0xff, 0x00, 0xff);`: Asigna a `myRgb` el valor `0xff00ff` que representa el color ![figure2.png](images/figure2.png)
88
+
89
+    Nota que el valor `0xff00ff` representa los valores `0xff`, `0x0`, `0xff`, que corresponden a los componentes rojo, verde y azul de `myRgb`.
90
+
91
+2. Si la siguiente imagen `4 x 4` de píxeles representa el objeto `originalImage`,
92
+
93
+    ![ejemplo.png](images/ejemplo.png)
94
+
95
+  entonces `originalImage.pixel(2,1)` devuelve un valor `rgb` que representa el color azul (`0x0000ff`).
96
+
97
+3. La siguiente instrucción asigna el color rojo al píxel en posición `(2,3)` en la imagen editada:
98
+
99
+  `editedImage.setPixel(2,3,qRgb(0xff,0x00,0x00));`.
100
+
101
+4. La siguiente instrucción le asigna a `greenContent` el valor del tono de verde que contiene el pixel `(1,1)` de  `originalImage`:
102
+
103
+  `int greenContent = qGreen(originalImage.pixel(1,1));`.
104
+
105
+
106
+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`.
107
+
108
+---
109
+
110
+```cpp
111
+#include <QImage>
112
+#include <iostream>
113
+
114
+using namespace std;
115
+int main() {
116
+    QImage myImage(“/Users/rarce/Downloads/chuck.png”);
117
+    QRgb    centralPixel;
118
+
119
+    centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
120
+
121
+    cout    << hex;
122
+
123
+    cout    << “Los componentes rojo, verde y azul del pixel central son: “
124
+        << qRed(centralPixel) << “, “
125
+        << qGreen(centralPixel) << “, “
126
+        << qBlue(centralPixel) << endl;
127
+    return 0;
128
+}
129
+```
130
+
131
+---
132
+
133
+---
134
+
135
+!INCLUDE "../../eip-diagnostic/simple-image-editor/es/diag-simple-image-editor-01.html"
136
+
137
+!INCLUDE "../../eip-diagnostic/simple-image-editor/es/diag-simple-image-editor-02.html"
138
+
139
+---
140
+
141
+---
142
+
143
+
144
+##Sesión de laboratorio:
145
+
146
+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. 
147
+
148
+###Ejercicio 1: Entender el código provisto
149
+
150
+####Instrucciones
151
+
152
+
153
+1. Carga a Qt el proyecto `SimpleImageEditor`  haciendo doble "click" en el archivo `SimpleImageEditor.pro` en el directorio `Documents/eip/Arrays-SimpleImageEditor` de tu computadora. También puedes ir a `http://bitbucket.org/eip-uprrp/arrays-simpleimageeditor` para descargar la carpeta `Arrays-SimpleImageEditor` a tu computadora.
154
+ 
155
+2.  El código que te proveemos crea la interface de la Figura 2. 
156
+
157
+    ---
158
+
159
+    ![figure3.png](images/figure3.png)
160
+
161
+    **Figura 2.** Interface del editor de imágenes.
162
+
163
+    ---
164
+
165
+3. Estarás trabajando con el archivo `filter.cpp`. Estudia la función `HorizontalFlip` del archivo `filter.cpp` para que entiendas su operación.
166
+
167
+    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`?
168
+
169
+4. El código que te proveemos ya tiene programado el funcionamiento de los botones de la interface 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 interface que identifican la imagen original y la imagen procesada. Los botones
170
+
171
+    * `btnLoadImage`
172
+    * `btnSaveImage`
173
+    * `btnInvertThreshold`
174
+    * `btnFlipImageHorizontally`
175
+    * `btnFlipImageVertically`
176
+    * `btnGreyScaleFilter`
177
+    * `btnRevertImage` 
178
+
179
+están conectados a  funciones de modo que cuando se presione el botón de la interface se haga alguna tarea. Por ejemplo, cuando se presiona `LoadImage`, saldrá una ventana para seleccionar el archivo con la imagen para editar, al seleccionar el archivo, se lee y se asigna la imagen al objeto `originalImage`. El deslizador `thresholdSlider` puede asumir valores entre 0 y 255.
180
+
181
+
182
+5. Compila y corre el programa. Prueba los botones `Load New Image` y `Flip Image Horizontally` con las imágenes que trajiste para que valides las operaciones de los botones.
183
+
184
+###Ejercicio 2: Convertir una imagen a colores a una imagen en tonos de gris
185
+
186
+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:
187
+
188
+`gray = (red * 11 + green * 16 + blue * 5)/32 ;`
189
+
190
+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,
191
+
192
+`editedImage.setPixel( i, j, qRgb(gray, gray, gray) )`.
193
+
194
+####Instrucciones
195
+
196
+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. 
197
+
198
+2. Completa la función `GreyScale` en el archivo `filter.cpp` para implementar el algoritmo de tonalidades de gris. La función debe producir un resultado similar al de la Figura 3, en donde la imagen de la izquierda es la imagen original y la de la derecha es la imagen editada.
199
+
200
+    ---
201
+
202
+    ![chuck-color.png](images/chuck-color.png)
203
+    ![chuck-gris.png](images/chuck-gris.png)
204
+
205
+    **Figura 3.** Imagen original e imagen luego de aplicar la función `GreyScale`.
206
+
207
+    ---
208
+
209
+
210
+###Ejercicio 3: Convertir una imagen a colores a una imagen en blanco y negro ("Thresholding")
211
+
212
+"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.
213
+
214
+####Instrucciones
215
+
216
+1. Utilizando pseudocódigo, expresa el algoritmo para "thresholding". Presume que utilizarás el valor del deslizador como umbral.
217
+
218
+2. En el programa, si la caja `chkboxThreshold` está marcada, se hace una invocación a la función `applyThresholdFilter`. La función `applyThresholdFilter` también es invocada cada vez que se cambia el valor del deslizador.
219
+
220
+3. Completa la función `ThresholdFilter` de modo que implemente el algoritmo de "threshold" en la imagen a color utilizando el valor del deslizador como umbral. Si se implementa correctamente, la imagen de la derecha debe ser la imagen original pero en blanco y negro. El valor umbral es un parámetro de la función `ThresholdFilter`. El código provisto en `mainwindow.h` tiene definidas las constantes `BLACK` y `WHITE` con el valor hexadecimal de los colores negro y blanco respectivamente; puedes aprovechar esto y utilizarlas en tu código.
221
+
222
+4. El parámetro booleano `invertColor` tendrá el valor `true` si la opción de invertir los colores fue seleccionada. Escribe código de modo que los colores blanco y negro se inviertan en la imagen si `invertColor` asume el valor `true`.
223
+
224
+5. Prueba tu programa con distintas imágenes y distintos valores de umbral.
225
+
226
+    ---
227
+
228
+    ![chuck-color.png](images/chuck-color.png)
229
+    ![chuck-threshold.png](images/chuck-threshold.png)
230
+
231
+    **Figura 4.** Imagen original e imagen luego de aplicar la función `ThresholdFilter`.
232
+
233
+    ---
234
+
235
+
236
+---
237
+
238
+---
239
+
240
+##Entrega
241
+
242
+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.
243
+
244
+---
245
+
246
+---
247
+
248
+##Apéndice: Buenas prácticas al escribir pseudocódigos
249
+
250
+1. Provee una descripción de los datos de entrada y salida
251
+2. Enumera los pasos
252
+3. Usa estructuras de repetición y decisión comunes: `if, else, for, while`
253
+4. Indenta los bloques de pasos que están dentro de una estructura de repetición o decisión, "Python-style"
254
+5. No necesitas declarar los tipos de las variables pero si debes inicializarlas. Esto es especialmente importante para contadores y acumuladores
255
+6. Recuerda que el propósito de un pseudocódigo es que un humano lo pueda entender.
256
+
257
+**Ejemplo:**
258
+
259
+```
260
+Input: n, a positive integer
261
+Output: true if n is prime, false otherwise
262
+---------------------------------------------------------
263
+1. for i = 3 to n / 2
264
+2.   if n % i == 0:
265
+3.      return false
266
+4. return true
267
+```
268
+
269
+---
270
+
271
+---
272
+
273
+##Referencias
274
+
275
+[1] http://www.willamette.edu/~gorr/classes/GeneralGraphics/imageFormats/24bits.gif
276
+
277
+[2] http://doc.qt.io/qt-4.8/qimage.html.
278
+
279
+
280
+---
281
+
282
+---
283
+
284
+---
285
+
286
+

+ 2
- 559
README.md Vedi File

@@ -1,559 +1,2 @@
1
-[English](#markdown-header-arrays-simple-image-editor) | [Español](#markdown-header-arreglos-editor-de-imagenes-simple)
2
-
3
-# Arreglos - Editor de Imagenes Simple
4
-
5
-![main1.png](images/main1.png)
6
-![main2.png](images/main2.png)
7
-![main3.png](images/main3.png)
8
-
9
-
10
-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. 
11
-
12
-##Objetivos:
13
-
14
-1. Practicar el acceder y manipular datos en un arreglo.
15
-
16
-2. Aplicar ciclos anidados para implementar algoritmos simples de procesamiento de imágenes.
17
-
18
-3. Utilizar expresiones aritméticas para transformar colores de pixeles.
19
-
20
-4. Acceder pixeles en una imagen y descomponerlos en sus componentes rojo, azul y verde.
21
-
22
-
23
-##Pre-Lab:
24
-
25
-Antes de llegar al laboratorio debes:
26
-
27
-1. Conseguir y tener disponible uno o más archivos con una imagen a color en alguno de los siguientes formatos: `tiff, jpg, png`.
28
-
29
-2. Haber repasado los conceptos básicos relacionados a estructuras de repetición y ciclos anidados.
30
-
31
-3. Conocer las funciones básicas de `QImage` para manipular los pixeles de las imágenes. 
32
-
33
-4. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
34
-
35
-5. Haber tomado el quiz Pre-Lab que se encuentra en Moodle.
36
-
37
----
38
-
39
----
40
-
41
-
42
-##Edición de imágenes
43
-
44
-En esta experiencia de laboratorio, trabajarás con varios conceptos y destrezas básicas de edición de imágenes. Te proveemos un interface 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.
45
-
46
-###Píxeles
47
-
48
-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).
49
-
50
----
51
-
52
-![figure1.png](images/figure1.png)
53
-
54
-**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). 
55
-
56
----
57
-
58
-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.
59
-
60
-###Biblioteca
61
-
62
-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.
63
-
64
-El código que te proveemos contiene los siguiente objetos de la clase `QImage`:
65
-
66
-* `originalImage`   // contiene la información de la imagen original que vas a editar
67
-*  `editedImage`  // contendrá la imagen editada
68
-
69
-Los objetos de clase `QImage` tienen los siguiente métodos que serán útiles para la experiencia de laboratorio de hoy:
70
-
71
-
72
-* `width()`      // devuelve el valor entero del ancho de la imagen
73
-* `height()`      // devuelve el valor entero de la altura de la imagen
74
-* `pixel(i, j)`       // devuelve el `QRgb` del píxel en la posición `(i,j)`
75
-* `setPixel(i,j, pixel)`   // modifica el valor del píxel en la posición `(i, j)` al valor píxel `QRgb`
76
-
77
-Las siguientes funciones son útiles para trabajar con datos de tipo `QRgb`:
78
-
79
-
80
-* `qRed(pixel)`   // devuelve el tono del color rojo del píxel
81
-* `qGreen(pixel)` // devuelve el tono del color verde del píxel
82
-* `qBlue(pixel)`  // devuelve el tono del color azul del píxel
83
-* `qRgb(int red, int green, int blue)` // devuelve un píxel `QRgb` compuesto de los valores de rojo, verde y azul recibidos.
84
-
85
-
86
-####Ejemplos:
87
-
88
-1. `QRgb myRgb = qRgb(0xff, 0x00, 0xff);`: Asigna a `myRgb` el valor `0xff00ff` que representa el color ![figure2.png](images/figure2.png)
89
-
90
-    Nota que el valor `0xff00ff` representa los valores `0xff`, `0x0`, `0xff`, que corresponden a los componentes rojo, verde y azul de `myRgb`.
91
-
92
-2. Si la siguiente imagen `4 x 4` de píxeles representa el objeto `originalImage`,
93
-
94
-    ![ejemplo.png](images/ejemplo.png)
95
-
96
-  entonces `originalImage.pixel(2,1)` devuelve un valor `rgb` que representa el color azul (`0x0000ff`).
97
-
98
-3. La siguiente instrucción asigna el color rojo al píxel en posición `(2,3)` en la imagen editada:
99
-
100
-  `editedImage.setPixel(2,3,qRgb(0xff,0x00,0x00));`.
101
-
102
-4. La siguiente instrucción le asigna a `greenContent` el valor del tono de verde que contiene el pixel `(1,1)` de  `originalImage`:
103
-
104
-  `int greenContent = qGreen(originalImage.pixel(1,1));`.
105
-
106
-
107
-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`.
108
-
109
----
110
-
111
-```cpp
112
-#include <QImage>
113
-#include <iostream>
114
-
115
-using namespace std;
116
-int main() {
117
-    QImage myImage(“/Users/rarce/Downloads/chuck.png”);
118
-    QRgb    centralPixel;
119
-
120
-    centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
121
-
122
-    cout    << hex;
123
-
124
-    cout    << “Los componentes rojo, verde y azul del pixel central son: “
125
-        << qRed(centralPixel) << “, “
126
-        << qGreen(centralPixel) << “, “
127
-        << qBlue(centralPixel) << endl;
128
-    return 0;
129
-}
130
-```
131
-
132
----
133
-
134
----
135
-
136
-!INCLUDE "../../eip-diagnostic/simple-image-editor/es/diag-simple-image-editor-01.html"
137
-
138
-!INCLUDE "../../eip-diagnostic/simple-image-editor/es/diag-simple-image-editor-02.html"
139
-
140
----
141
-
142
----
143
-
144
-
145
-##Sesión de laboratorio:
146
-
147
-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. 
148
-
149
-###Ejercicio 1: Entender el código provisto
150
-
151
-####Instrucciones
152
-
153
-
154
-1. Carga a Qt el proyecto `SimpleImageEditor`  haciendo doble "click" en el archivo `SimpleImageEditor.pro` en el directorio `Documents/eip/Arrays-SimpleImageEditor` de tu computadora. También puedes ir a `http://bitbucket.org/eip-uprrp/arrays-simpleimageeditor` para descargar la carpeta `Arrays-SimpleImageEditor` a tu computadora.
155
- 
156
-2.  El código que te proveemos crea la interface de la Figura 2. 
157
-
158
-    ---
159
-
160
-    ![figure3.png](images/figure3.png)
161
-
162
-    **Figura 2.** Interface del editor de imágenes.
163
-
164
-    ---
165
-
166
-3. Estarás trabajando con el archivo `filter.cpp`. Estudia la función `HorizontalFlip` del archivo `filter.cpp` para que entiendas su operación.
167
-
168
-    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`?
169
-
170
-4. El código que te proveemos ya tiene programado el funcionamiento de los botones de la interface 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 interface que identifican la imagen original y la imagen procesada. Los botones
171
-
172
-    * `btnLoadImage`
173
-    * `btnSaveImage`
174
-    * `btnInvertThreshold`
175
-    * `btnFlipImageHorizontally`
176
-    * `btnFlipImageVertically`
177
-    * `btnGreyScaleFilter`
178
-    * `btnRevertImage` 
179
-
180
-están conectados a  funciones de modo que cuando se presione el botón de la interface se haga alguna tarea. Por ejemplo, cuando se presiona `LoadImage`, saldrá una ventana para seleccionar el archivo con la imagen para editar, al seleccionar el archivo, se lee y se asigna la imagen al objeto `originalImage`. El deslizador `thresholdSlider` puede asumir valores entre 0 y 255.
181
-
182
-
183
-5. Compila y corre el programa. Prueba los botones `Load New Image` y `Flip Image Horizontally` con las imágenes que trajiste para que valides las operaciones de los botones.
184
-
185
-###Ejercicio 2: Convertir una imagen a colores a una imagen en tonos de gris
186
-
187
-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:
188
-
189
-`gray = (red * 11 + green * 16 + blue * 5)/32 ;`
190
-
191
-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,
192
-
193
-`editedImage.setPixel( i, j, qRgb(gray, gray, gray) )`.
194
-
195
-####Instrucciones
196
-
197
-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. 
198
-
199
-2. Completa la función `GreyScale` en el archivo `filter.cpp` para implementar el algoritmo de tonalidades de gris. La función debe producir un resultado similar al de la Figura 3, en donde la imagen de la izquierda es la imagen original y la de la derecha es la imagen editada.
200
-
201
-    ---
202
-
203
-    ![chuck-color.png](images/chuck-color.png)
204
-    ![chuck-gris.png](images/chuck-gris.png)
205
-
206
-    **Figura 3.** Imagen original e imagen luego de aplicar la función `GreyScale`.
207
-
208
-    ---
209
-
210
-
211
-###Ejercicio 3: Convertir una imagen a colores a una imagen en blanco y negro ("Thresholding")
212
-
213
-"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.
214
-
215
-####Instrucciones
216
-
217
-1. Utilizando pseudocódigo, expresa el algoritmo para "thresholding". Presume que utilizarás el valor del deslizador como umbral.
218
-
219
-2. En el programa, si la caja `chkboxThreshold` está marcada, se hace una invocación a la función `applyThresholdFilter`. La función `applyThresholdFilter` también es invocada cada vez que se cambia el valor del deslizador.
220
-
221
-3. Completa la función `ThresholdFilter` de modo que implemente el algoritmo de "threshold" en la imagen a color utilizando el valor del deslizador como umbral. Si se implementa correctamente, la imagen de la derecha debe ser la imagen original pero en blanco y negro. El valor umbral es un parámetro de la función `ThresholdFilter`. El código provisto en `mainwindow.h` tiene definidas las constantes `BLACK` y `WHITE` con el valor hexadecimal de los colores negro y blanco respectivamente; puedes aprovechar esto y utilizarlas en tu código.
222
-
223
-4. El parámetro booleano `invertColor` tendrá el valor `true` si la opción de invertir los colores fue seleccionada. Escribe código de modo que los colores blanco y negro se inviertan en la imagen si `invertColor` asume el valor `true`.
224
-
225
-5. Prueba tu programa con distintas imágenes y distintos valores de umbral.
226
-
227
-    ---
228
-
229
-    ![chuck-color.png](images/chuck-color.png)
230
-    ![chuck-threshold.png](images/chuck-threshold.png)
231
-
232
-    **Figura 4.** Imagen original e imagen luego de aplicar la función `ThresholdFilter`.
233
-
234
-    ---
235
-
236
-
237
----
238
-
239
----
240
-
241
-##Entrega
242
-
243
-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.
244
-
245
----
246
-
247
----
248
-
249
-##Apéndice: Buenas prácticas al escribir pseudocódigos
250
-
251
-1. Provee una descripción de los datos de entrada y salida
252
-2. Enumera los pasos
253
-3. Usa estructuras de repetición y decisión comunes: `if, else, for, while`
254
-4. Indenta los bloques de pasos que están dentro de una estructura de repetición o decisión, "Python-style"
255
-5. No necesitas declarar los tipos de las variables pero si debes inicializarlas. Esto es especialmente importante para contadores y acumuladores
256
-6. Recuerda que el propósito de un pseudocódigo es que un humano lo pueda entender.
257
-
258
-**Ejemplo:**
259
-
260
-```
261
-Input: n, a positive integer
262
-Output: true if n is prime, false otherwise
263
----------------------------------------------------------
264
-1. for i = 3 to n / 2
265
-2.   if n % i == 0:
266
-3.      return false
267
-4. return true
268
-```
269
-
270
----
271
-
272
----
273
-
274
-##Referencias
275
-
276
-[1] http://www.willamette.edu/~gorr/classes/GeneralGraphics/imageFormats/24bits.gif
277
-
278
-[2] http://doc.qt.io/qt-4.8/qimage.html.
279
-
280
-
281
----
282
-
283
----
284
-
285
----
286
-
287
-
288
-[English](#markdown-header-arrays-simple-image-editor) | [Español](#markdown-header-arreglos-editor-de-imagenes-simple)
289
-
290
-
291
-# Arrays - Simple Image Editor
292
-
293
-![main1.png](images/main1.png)
294
-![main2.png](images/main2.png)
295
-![main3.png](images/main3.png)
296
-
297
-Arrays help us to store and work with groups of data of the same type. The data is stored in consecutive memory spaces which can be accessed by using the name of the array and indexes or subscripts that indicate the position where the data is stored. Repetition structures provide us a simple way of accessing the data within an array. In today's laboratory experience you will design and implement simple algorithms for image processing to practice the use of nested loops to manipulate bi-dimensional arrays.
298
-
299
-##Objectives
300
-
301
-1. Practice the access and manipulation of data in an array.
302
-
303
-2. Apply nested loops to implement simple image processing algorithms.
304
-
305
-3. Use arithmetic expressions to transform colors in pixels.
306
-
307
-4. Access pixels in an image and break them down into their red, blue, and green components.
308
-
309
-
310
-##Pre-Lab:
311
-
312
-Before coming to the laboratory session you should have:
313
-
314
-1. Acquired one or more files with a colored image in one of the following formats: `tiff, jpg, png`.
315
-
316
-2. Reviewed the basic concepts related to repetition structures and nested loops.
317
-
318
-3. Become familiar with the basic functions in `QImage` to manipulate the pixels in the images.
319
-
320
-4. Studied the concepts and instructions for the laboratory session.
321
-
322
-5. Taken the Pre-Lab quiz available through the course’s Moodle portal.
323
-
324
----
325
-
326
----
327
-
328
-##Image editing
329
-
330
-In this laboratory experience, you will work with various concepts and basic skills of image editing. We have provided a simple graphical user interface that allows the user to load an image and invert it vertically and horizontally. Your task is to create and implement a function to convert the colored image into an image with gray tones, and another function that converts the colored image into a black and white image.
331
-
332
-###Pixels
333
-
334
-The smallest element in an image is called a *pixel*. This unit consists of a single color. Since each color is a combination of tones for the primary red, green and blue colors, it is coded as an unsigned integer whose bytes represent the tones of red, green and blue of the pixel (Figure 1). This combination is called the color's *RGB* which is an acronym for "Red-Green-Blue". For example, a pure red pixel has an RGB representation of `0x00ff0000`, while a white pixel has an RGB representation of `0x00FFFFFF` (since the color white is a combination of tones of red, green and blue in all of their intensity).
335
-
336
----
337
-
338
-![figure1.png](images/figure1.png)
339
-
340
-**Figure 1.** Bit distribution for the tones of red, green and blue in an RGB representation. Each tone can have values between 0x00 (the eight bits in 0) and (0xFF (the 8 bits in 1).
341
-
342
----
343
-
344
-`Qt` uses the `QRgb` type to represent `RGB` values. Using certain functions that are described below we can obtains the red, green and blue components of the `QRgb` value of the pixel and manipulate the images.
345
-
346
-###Library
347
-
348
-In today's laboratory experience you will use the `QImage` class. This class permits access to the data in the pixels of an image to manipulate it. The documentation for the `QImage` class can be found in http://doc.qt.io/qt-4.8/qimage.html.
349
-
350
-The code provided in this project contains the following objects of the `QImage` class:
351
-
352
-* `originalImage`   // contains the information of the original image that you will edit
353
-*  `editedImage`  // will contain the edited image
354
-
355
-The objects of the `QImage` class have the following methods that will be useful for today's laboratory experience:
356
-
357
-* `width()`      // returns the integer value for the image's width
358
-* `height()`      // returns the integer value for the image's height
359
-* `pixel(i, j)`       // returns the `QRgb` for the pixel in position `(i,j)`
360
-* `setPixel(i,j, pixel)`   // modifies the value for the pixel in position `(i,j)` to the value of pixel `QRgb`
361
-
362
-The following functions are useful to work with data of type `QRgb`:
363
-
364
-* `qRed(pixel)`   // returns the tone for the pixel's red color
365
-* `qGreen(pixel)` // returns the tone for the pixel's green color
366
-* `qBlue(pixel)`  // returns the tone for the pixel's blue color
367
-* `qRgb(int red, int green, int blue)` // returns the `QRgb` pixel composed of the red, green and blue values received.
368
-
369
-
370
-####Examples:
371
-
372
-1. `QRgb myRgb = qRgb(0xff, 0x00, 0xff);`: Assigns the value `0xff00ff` to `myRgb` which represents the color ![figure2.jpg](images/figure2.jpg)
373
-
374
-    Notice that the value `0xff00ff` represents the values `0xff`, `0x0`, and `0xff`, that correspond to the red, green and blue components in `myRgb`.
375
-
376
-2. If the following `4 x 4` image of pixels represents the object `originalImage`,
377
-
378
- ![ejemplo.png](images/ejemplo.png)
379
-
380
-then `originalImage.pixel(2,1)` returns the  `rgb` value that represents the color blue ( `0x0000ff`).
381
-
382
-3. The following instruction assigns the color red to the pixel in position `(2,3)` in the edited image:
383
-
384
-`editedImage.setPixel(2,3,qRgb(0xff,0x00,0x00));`.
385
-
386
-4. The following instruction assigns to `greenContent` the value of the green tone that is contained in the pixel `(1,1)` of `originalImage`:
387
-
388
-    `int greenContent = qGreen(originalImage.pixel(1,1));`.
389
-
390
-5. The following program creates an object of the `QImage` class and prints the red, green and blue components of the pixel in the center of the image. The image used is the one specified within the parenthesis during the creation of the object, that is, the file `chuck.png`
391
-
392
----
393
-
394
-```cpp
395
-#include <QImage>
396
-#include <iostream>
397
-
398
-using namespace std;
399
-int main() {
400
-    QImage myImage(“/Users/rarce/Downloads/chuck.png”);
401
-    QRgb    centralPixel;
402
-
403
-    centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
404
-
405
-    cout    << hex;
406
-
407
-    cout    << “The red, green and blue components of the middle pixel are: “
408
-        << qRed(centralPixel) << “, “
409
-        << qGreen(centralPixel) << “, “
410
-        << qBlue(centralPixel) << endl;
411
-    return 0;
412
-}
413
-```
414
-
415
----  
416
-
417
----
418
-
419
-!INCLUDE "../../eip-diagnostic/simple-image-editor/en/diag-simple-image-editor-01.html"
420
-
421
-!INCLUDE "../../eip-diagnostic/simple-image-editor/en/diag-simple-image-editor-02.html"
422
-
423
-
424
----
425
-
426
----
427
-
428
-
429
-##Laboratory Session:
430
-
431
-In today's laboratory experience you will design and implement simple image processing algorithms to practice the use of nested loops and the manipulation of bi-dimensional arrays.
432
-
433
-###Exercise 1: Understand the provided code
434
-
435
-####Instructions
436
-
437
-1. Load the Qt project called `SimpleImageEditor` by double-clicking on the `SimpleImageEditor.pro` file in the `Documents/eip/Arrays-SimpleImageEditor` folder of your computer. You may also go to `http://bitbucket.org/eip-uprrp/arrays-simpleimageeditor` to download the `Arrays-SimpleImageEditor` folder to your computer.
438
-
439
-2. The code that we provide creates the interface in Figure 2.
440
-
441
-    ---
442
-
443
-    ![figure3.png](images/figure3.png)
444
-
445
-    **Figura 2.** Interface del editor de imágenes.
446
-
447
-    ---
448
-
449
-3. You will be working with the `filter.cpp` file. Study the `HorizontalFlip` function in the `filter.cpp` file so you understand how it operates.
450
-
451
-In the following exercises you will be mainly using the objects `originalImage` and `editedImage` of the `QImage` class. What do you think is the purpose for the `pixel` variable?
452
-
453
-4. The provided code already has the the functionality of the buttons in the graphical user interface programmed. You do NOT have to change anything in this code but we provide the following explanations so you can know a little about how the buttons work. In the `mainwindow.cpp` file, the `lblOriginalImage` and `lblEditedImage` objects correspond to the parts of the interface that identify the original image and the processed image. The buttons
454
-
455
-    * `btnLoadImage`
456
-    * `btnSaveImage`
457
-    * `btnInvertThreshold`
458
-    * `btnFlipImageHorizontally`
459
-    * `btnFlipImageVertically`
460
-    * `btnGreyScaleFilter`
461
-    * `btnRevertImage` 
462
-
463
-are connected to functions so when a button in the interface is pressed, a certain task is carried out. For example, when you press the `LoadImage` button, a window will appear for you to select the file with the image you want to edit, which when read, the image is assigned to `originalImage`. The slider `thresholdSlider` can assume values between 0 and 255.
464
-
465
-
466
-5. Compile and run the program. Test the buttons for `Load New Image` and `Flip Image Horizontally` with the images that you brought so you can validate if the buttons are working.
467
-
468
-###Exercise 2: Convert a colored image to an image with gray tones
469
-
470
-Image grayscale is an operation that is used to convert a colored image to an image with only tones of gray. To make this conversion the following formula is used in each pixel:
471
-
472
-`gray = (red * 11 + green * 16 + blue * 5)/32 ;`
473
-
474
-where `red`, `green` and `blue` are the values for the tones of the red, green and blue colors in the pixel of the original colored image, and `gray` will be the assigned color to the red, green, and blue colors in the pixel of the edited image. That is,
475
-
476
-`editedImage.setPixel( i, j, qRgb(gray, gray, gray) )`.
477
-
478
-####Instructions
479
-
480
-1. Using pseudocode, express the algorithm to convert a colored image to an image with only gray tones. The appendix in this document contains some advice about good techniques for writing pseudocode.
481
-
482
-2. Complete the `GreyScale` function in the `filter.cpp` file to implement the grayscale algorithm. The function should produce a result similar to that in Figure 3, where the image on the left is the original image and the one on the right is the edited image.
483
-
484
-    ---
485
-
486
-    ![chuck-color.png](images/chuck-color.png)
487
-    ![chuck-gris.png](images/chuck-gris.png)
488
-
489
-    **Figure 3.** Original image and image after applying the `GreyScale` function.
490
-
491
-    ---
492
-
493
-###Exercise 3: Convert a colored image to a black and white image ("Thresholding")
494
-
495
-Thresholding es an operation that can be used to convert a colored image to an image in black and white. To make this conversion we must decide which colors of the original image will be converted to white pixels and which to black. One simple way of deciding this is to compute the average of the red, green and blue components of each pixel. If the average is smaller than the threshold value, then we change the pixel to black; if not, it's changed to white.
496
-
497
-####Instructions
498
-
499
-1. Using pseudocode, express the thresholding algorithm. Assume that you will use the slider's value as the threshold.
500
-
501
-2. In the program, if the `chkboxThreshold` box is marked, the `applyThresholdFilter` function is invoked. The `applyThresholdFilter` function is also invoked each time that the value of the slider is changed.
502
-
503
-3. Complete the `ThresholdFilter` function so it implements the threshold algorithm in the colored image using the slider's value as the threshold. If the implementation is correct, the image on the right should be the original image but in black and white. The threshold value is a parameter of the `ThresholdFilter` function. The code provided in `mainwindow.h` has the constants `BLACK` and `WHITE` defined with their hexadecimal values; you can take advantage of this and use them in your code.
504
-
505
-4. The boolean parameter `invertColor` will be `true` if the option to invert the colors has been selected. Write the code so that the white and black colors are inverted if `invertColor` is `true`.
506
-
507
-5. Test the program with different images and different threshold values.
508
-
509
-    ---
510
-
511
-    ![chuck-color.png](images/chuck-color.png)
512
-    ![chuck-threshold.png](images/chuck-threshold.png)
513
-
514
-    **Figure 4.** Original image and image after applying the `ThresholdFilter` function.
515
-
516
-    ---
517
-
518
- ---
519
-
520
- ---
521
-
522
-##Deliverables
523
-
524
-Use "Deliverables" in Moodle to upload the `filter.cpp` file that contains the `GreyScale` and `Threshold` functions. Remember to use good programming techniques, include the names of the programmers involved, and to document your program.
525
-
526
----
527
-
528
----
529
-
530
-##Appendix: Good techniques for writing pseudocode
531
-
532
-1. Provide a description of the input and output data
533
-2. Enumerate the steps
534
-3. Use common repetition and decision structures: `if, else, for, while`
535
-4. Indent the blocks of steps that are inside of a decision or repetition structure, "Python-style"
536
-5. You do not need to declare the types of variables but you should initialize them. This is especially important for counters and accumulators
537
-6. Remember that the purpose of pseudocode is so a human can understand it.
538
-
539
-**Example:**
540
-
541
-```
542
-Input: n, a positive integer
543
-Output: true if n is prime, false otherwise
544
----------------------------------------------------------
545
-1. for i = 3 to n / 2
546
-2.   if n % i == 0:
547
-3.      return false
548
-4. return true
549
-```
550
-
551
----
552
-
553
----
554
-
555
-##References
556
-
557
-[1] http://www.willamette.edu/~gorr/classes/GeneralGraphics/imageFormats/24bits.gif
558
-
559
-[2] http://doc.qt.io/qt-4.8/qimage.html.
1
+## [\[English\]](README-en.md) - for README in English
2
+## [\[Spanish\]](README-es.md) - for README in Spanish