README-es.md edited online with Bitbucket

README-es.md

-#Estructuras de repetición - Esteganografía
+# Estructuras de repetición - Esteganografía
 
 ![main1.png](images/main1.png)
 ![main2.png](images/main2.png)
 ![main3.png](images/main3.png)
 
+[Verano 2016 - Ive]
+
 Una de las ventajas de utilizar programas de computadoras es que podemos realizar tareas repetitivas fácilmente. Los ciclos como `for`, `while`, y `do-while` son estructuras de control que nos permiten repetir un conjunto de instrucciones. A estas estructuras también se les llama *estructuras de repetición*.  En la experiencia de laboratorio de hoy completarás una aplicación de esteganografía para practicar el uso de ciclos anidados en la manipulación de arreglos bi-dimensionales.
 
 
-##Objetivos:
+## Objetivos:
 
 1. Aplicar ciclos anidados y estructuras de control para manipular arreglos bi-dimensionales y  extraer mensajes escondidos en imágenes.
 
 3. Utilizar la representación binaria de caracteres.
 
 
-##Pre-Lab:
+## Pre-Lab:
 
 Antes de llegar al laboratorio debes haber:
 
 
 
 
-##Esteganografía
+## Esteganografía
 
 La esteganografía es la ciencia de camuflar la presencia de mensajes ocultos en portadores legítimos (archivos que parecen inofensivos). Esta ciencia ha sido utilizada por delincuentes cibernéticos para ocasionar daños a sistemas de computadoras, y por terroristas para codificar mensajes ocultos en transmisiones de internet. Se dice que Al-Qaeda puede haber utilizado esteganografía para codificar mensajes en imágenes y luego transportarlos por correo electrónico, y posiblemente por USENET, para preparar y ejecutar los ataques terroristas del 11 de septiembre de 2001.
 
 ---
 
 
-##Edición de imágenes
+## Edición de imágenes
 
 En esta experiencia de laboratorio, recuperarás un mensaje secreto que ha sido ocultado en una imagen. Para poder realizar tu tarea debes entender algunos conceptos relacionados a imágenes, conocer métodos de la clase `QImage` de `Qt` y funciones para trabajar con datos de tipo `QRgb`.
 
-###Píxeles
+### 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).
 
 
 En `Qt` se utiliza el tipo `QRgb` para representar valores `RGB`.  Utilizando las funciones que describimos abajo podemos realizar algunas operaciones importantes de análisis de imágenes, tales como determinar el RGB de cada píxel de una imagen, y obtener los componentes rojo, verde y azul del valor `QRgb` del píxel.
 
-###Biblioteca
+### 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.
 
 * `qBlue(pixel)`  // devuelve el tono del color azul del píxel, i.e. un valor entre (0x00 y 0xFF)
 
 
-####Ejemplos:
+#### Ejemplos:
 
 1. Si la siguiente imagen `4 x 4` de píxeles representa el objeto `origImage`,
 
     ![ejemplo.png](images/ejemplo.png)
 
-  entonces `origImage.pixel(2,1)` devuelve un valor `rgb` que representa el color azul (`0x0000ff`).
+    entonces `origImage.pixel(2,1)` devuelve un valor `rgb` que representa el color azul (`0x0000ff`).
 
 2. La siguiente instrucción le asigna a la variable `greenContent` el valor del tono de verde que contiene el píxel `(1,1)` de  `origImage`:
 
-  `int greenContent = qGreen(origImage.pixel(1,1));`.
+    `int greenContent = qGreen(origImage.pixel(1,1));`.
 
 
 3. 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`.
 
----
-
-```cpp
-#include <QImage>
-#include <iostream>
+      #include <QImage>
+      #include <iostream>
 
-using namespace std;
-int main() {
-    QImage myImage(“/Users/rarce/Downloads/chuck.png”);
-    QRgb    centralPixel;
+      using namespace std;
+      int main() {
+         QImage myImage(“/Users/rarce/Downloads/chuck.png”);
+         QRgb    centralPixel;
 
-    centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
+         centralPixel = myImage.pixel(myImage.width() / 2, myImage.height() / 2);
 
-    cout    << hex;
+         cout << hex;
 
-    cout    << “Los componentes rojo, verde y azul del pixel central son: “
-        << qRed(centralPixel) << “, “
-        << qGreen(centralPixel) << “, “
-        << qBlue(centralPixel) << endl;
-    return 0;
-}
-```
+         cout << “Los componentes rojo, verde y azul del pixel central son: “
+              << qRed(centralPixel) << “, “
+              << qGreen(centralPixel) << “, “
+              << qBlue(centralPixel) << endl;
+         return 0;
+      }
 
 
-###Empotrando un mensaje en una imagen
+### Empotrando un mensaje en una imagen
 
 Uno de los métodos más simples para esconder un mensaje en una imagen es codificando el mensaje en los bits menos significativos de los componentes de los colores de los píxeles de la imagen. Este método esconde el mensaje en la imagen eficientemente porque el efecto al cambiar el bit menos significativo en un color de 8 bits es casi imperceptible para el ojo humano.
 
 
 El primer paso sería obtener la representación ASCII del mensaje. Los bits de la representación ASCII son los bits que codificaremos en los colores de los píxeles. La representación ASCII de "Dog" es:
 
-
-```
-"Dog"  = 01000100 01101111 01100111
-```
+`"Dog"  = 01000100 01101111 01100111`
 
 El código `01000100` corresponde a la `D`, y así sucesivamente.
 
 El proceso de codificación es más fácil de entender si separamos los bits en grupos de tres (un bit por cada componente del RGB):
 
-```
-"Dog"  = 010 001 000 110 111 101 100 111
-```
+`"Dog"  = 010 001 000 110 111 101 100 111`
 
 Ahora, comenzamos a recorrer la imagen píxel por píxel, empotrando en cada píxel tres bits del código ASCII (un bit en cada componente de color del píxel). Por ejemplo, empotraríamos  `010` en el primer píxel, `001` en el segundo, y así sucesivamente.
 
 Pregunta: 
 ¿Qué mensaje está escondido (usando la técnica del bit menos significativo) en una imagen cuyos primeros 8 píxeles son:
 
-
-```
-0x545554 0x666667 0x444544 0x333232
-0xff0000 0x0100ff 0x00ff00 0x10aaba 
-```
+`0x545554 0x666667 0x444544 0x333232 0xff0000 0x0100ff 0x00ff00 0x10aaba`
 
 Explica tu respuesta.
 
 
 ---
 
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-01.html"
-<br>
-
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-02.html"
-<br>
-
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-03.html"
-<br>
 
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-04.html"
+!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-05.html"
 <br>
 
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-05.html"
-<br>
-
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-06.html"
-<br>
-
-!INCLUDE "../../eip-diagnostic/steganography/es/diag-steganography-07.html"
-<br>
 
 ---
 
 ---
 
 
-##Sesión de laboratorio:
+## Sesión de laboratorio:
 
 En la experiencia de laboratorio de hoy completarás una aplicación de esteganografía para extraer mensajes ocultos en imágenes.
 
-###Ejercicio 1: Extraer el mensaje binario
+### Ejercicio 1 - Extraer el mensaje binario
 
-####Instrucciones
+#### Instrucciones:
 
 
 1) Carga a QtCreator el proyecto `Steganography` haciendo doble "click" en el archivo `Steganography.pro` en el directorio `Documents/eip/Repetitions-Steganography` de tu computadora. También puedes ir a `http://bitbucket.org/eip-uprrp/repetitions-steganography` para descargar la carpeta `Repetitions-Steganography` a tu computadora.
 Para poder implementar el algoritmo de extracción del mensaje, debes entender cómo fue empotrado el mensaje. Si es necesario, repasa la sección “Empotrando un mensaje en una imagen”.
 
 
-###Ejercicio 2: Interpretar el mensaje
+### Ejercicio 2 - Interpretar el mensaje
 
-####Instrucciones
+#### Instrucciones:
 
 
 1. Completa la función `binaryStringToMessage` que recibe el "string" de `0`'s y `1`'s extraido de la imagen para que devuelva el mensaje oculto. Puedes aprovechar la función `binStringToChar` para convertir "substrings" de 8 `0`'s y `1`'s en el caracter que le corresponde.