What was in the book

README-en.md

@@ -1,6 +1,204 @@
-
 #Recursion - Image Scrambler
 
 ![main1.png](images/main1-small.png)
 ![main2.png](images/main2-small.png)
 ![main3.png](images/main3-small.png)
+
+One commonly used programming technique is *recursion*. With this technique, problems are solved 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 practice the definition and implementation of recursive functions to scramble an image and make it incomprehensible.
+
+##Objectives:
+
+1) Define and implement recursive functions.
+
+2) Practice image processing.
+
+3) Practice the use of decision and repetition structures.
+
+##Pre-Lab:
+
+Before arriving at the laboratory you should have:
+
+1) Reviewed the concepts related to recursive functions.
+
+2) Studied the concepts and instructions for the laboratory session.
+
+3) Have taken the Pre-Lab quiz that can be found in Moodle.
+
+---
+
+---
+
+##Scrambling images digitally
+
+When scrambling images digitally we reorder the pixels of the image to break the relation between adjacent pixels, making the original image incomprehensible. This technique is used frequently to cypher images and hide data. [1]
+
+---
+
+![figure1.png](images/figure1.png)
+
+**Figure 1.** The image to the left was cyphered using the image scrambling technique to obtain the image on the right. Taken from [2].
+
+---
+
+There exist many methods that have been proposed to scramble images. In this laboratory experience you will use a simple method that has a natural implementation with recursive functions.
+
+### Scramble it!
+
+The method you will use to scramble the image works by exchanging rectangles of an image a certain number of times, which is established by the *level*. Figure 2 illustrates a *level 1* scramble: the diagonal quadrants are exchanged. Observe Figure 6 as well.
+
+---
+
+![figure2.png](images/figure2.png)
+
+**Figure 2.** Level 1 scramble: (a) is the original image divided in quadrants, (b) is the image after scrambling the first level by exchanging diagonal quadrants.
+
+---
+
+The next level scramble, *level 2*, first exchanges the left and right halves of the image. Afterwards the *level 1* scramble is applied to each quadrant. Observe that the level 1 scramble is applied to each of the four quadrants of the original image.
+
+---
+
+![figure3.png](images/figure3.png)
+
+**Figure 3.** Level 2 scramble: (a) is the original image, (b) is the image after exchanging the left and right halves, (c) is the image after applying a level 1 scramble to each quadrant.
+
+---
+
+**Question:** Which of the following figures (a), (b), (c), (d) represents the result of applying a *level 2* scramble to the following drawing of a penguin?   
+
+---
+
+![figure4.png](images/figure4.png)
+
+
+![figure5.png](images/figure5.png)
+
+---
+
+If we follow the pattern, a *level 3* scramble starts by exchanging the diagonal quadrants. Afterward, a *level 2* scramble is applied to each quadrant: exchange the left and right halves and apply a *level 1* scramble to each new quadrant. Figure 8 shows the process of applying a level 3 scramble.
+
+To scramble an image repeat this process for a certain *level N*. What is the pattern? How would a *level 4* scramble start? In how many quadrants will we have divided the original image after completing the scramble?
+
+The algorithm to scramble that was just described is its own inverse. That is, if you apply the same algorithm to the scrambled image you should obtain the original image.
+
+
+The following figures illustrate the exchanges that are done by level 1, 2 and 3 scrambles. 
+
+---
+
+![figure6.png](images/figure6.png)
+
+**Figure 6.** Level 1 scramble: the diagonal quadrants are exchanged.
+
+---
+
+
+![figure7.png](images/figure7.png)
+
+**Figure 7.** Level 2 scramble: (a) the left and right halves are exhanged, (b) a level 1 scramble is applied to each quadrant.
+
+
+---
+
+![figure8.png](images/figure8.png)
+
+**Figure 8.** Level 3 scramble: (a) the diagonal quadrants are exchanged to then apply a level 2 scramble to each quadrant, (b) the left and right halves are exchanged in each quadrant, (c)  a level 1 scramble is applied in each new quadrant.
+
+
+---
+
+---
+
+## Additional functions provided in the project
+
+The project which you will be working on today contains the `cropSwap` function that implements the functionality of exchanging the pixels contains in two congruent rectangles within an image. Its prototype is: 
+
+```
+void ImageScrambler::cropSwap(QImage &img, int x0, int y0, int x1, int y1, int width, int height );
+```
+
+Its parameters are:
+* `img`: reference to the image that we wish to modify (an object of the `QImage` class)
+* `x0`, `y0`,`x0`, `y0`: coordinates of the upper left corners of the rectangles.
+* `width`, `height`: width and height (in pixels) of the rectangles.
+
+For example, if we wish to exchange the pixels of the upper and lower halves of an image *P* with width 100 and height 150, we invoke the function:
+
+```
+cropSwap(P, 0, 0, 0, 75, 100, 75 );  
+```
+
+
+----
+
+----
+
+## Laboratory Session:
+
+The project `ImageScrambler` contains the skeleton of an application to scramble and unscramble images. In today’s laboratory experience you will work in the `Filter.cpp` file to complete the application.
+
+
+###Exercise 1: Pseudocode for the scrambling function
+
+Write the pseudocode to express the scrambling algorithm described above as a recursive function.
+
+
+###Exercise 2: Recursive function to scramble an image
+
+####Instructions
+
+1) Load the project `ImageScrambler` onto QtCreator by double-clicking on the `ImageScrambler.pro` file in the `Documents/eip/Recursion-ImageScrambler` directory on your computer. You may also go to `http://bitbucket.org/eip-uprrp/recursion-imagescrambler` to download the `Recursion-ImageScrambler` folder to your computer.
+
+2) The code that we provide creates the interface in Figure 9.
+
+---
+
+![figure9.png](images/figure9.png)
+
+**Figure 9.** Interface for the `Image Scrambler` project.
+
+---
+
+The button that says `Scramble Image` is programmed so it invokes a function called `ScramblerFilter`.
+
+3. Complete the function `ScrambleFIlter` contained in the `Filter.cpp` file so it implements the recursive algorithm to scramble images. The function has the following format:
+
+ ```cpp
+QImage ImageScrambler::ScrambleFilter(QImage image, int N, int sx, int sy, int width, int height);
+```
+
+4. Download the image in http://i.imgur.com/ZiJ61Gk.png so you can validate the function you implemented.
+
+---
+
+---
+
+## Deliverables
+
+1. Use “Deliverables 1” in Moodle to upload the file with the pseudocode for the recursive function.
+
+2. Use "Deliverables 2" in Moodle to upload the `Filter.cpp` file that contains the functions you implemented in this laboratory experience. Remember to use good programming techniques, include the names of the programmers involved, and to document your program.
+
+
+---
+
+---
+
+##References
+
+[1]  F. Maleki et al., ‘‘An Image Encryption System by
+Cellular Automata with Memory,’’ Proc. 3rd Int’l
+Conf. Availability, Reliability, and Security, IEEE CS
+Press, 2008, pp. 12661271.
+
+[2] Dalhoum, Abdel Latif Abu, et al. "Digital Image Scrambling Using 2 D Cellular Automata." IEEE MultiMedia 19.4 (2012): 28-36.
+
+[3] http://www.instructables.com/id/Python-Programming-recursion/
+
+
+
+
+
+
+
+