Description
fundamental software engineering skill is the design, implementation, and testing of a software component that must be integrated into a larger software product. In order to do this, the software component must conform to a previously agreed upon interface format. As part of this assignment, you will practice this skill by writing several functions that will be integrated into a larger software product provided by the instructor. Along the way you will review basic C++ programming and Linux file management skills required for successful completion of CPE 212.
Project01 Overview
For this project, you will complete the provided partial C++ program by implementing six functions that perform simple image processing operations on images stored as 10×10, two dimensional arrays of integers. The image processing operations are:
- Get Next Image
- Horizontal Flip
- Vertical Flip
- Transpose
- Rotate 90° Clockwise
- Rotate 90° Counter Clockwise
You must implement each of these operations as a C++ function. Your code for the six functions above must appear in the file named project01.cpp in order to compile correctly. Remember, spelling and capitalization count in Linux/C++.
The function main() has already been implemented for you to provide a common way for everyone to test their code. The function main() will scan a sample input file and perform the requested series of image processing operations by invoking your functions as needed.
Prototypes for the six functions are already provided for you in main.cpp (do not modify main.cpp !!!). All program output is performed by the code in the main.cpp file – do not include any output statements in the file project01.cpp
The interfaces to each of these functions you must write are described in detail on subsequent pages and in the prototypes listed within main.cpp
Step #1 – Unzipping Project Materials on blackhawk
Use the Chrome/Firefox/Safari browser to access Canvas and download the Project01_Materials.zip file into your Project01 directory. At terminal window prompt, use the unzip utility to uncompress the files. For example, to unzip the files into your current directory:
unzip Project01_Materials.zip
Since this project is worth three points, you have been given three input files to test your program.
Step #2 – Create Function Stubs for the Missing Support Functions
Open a Linux terminal window and navigate to the directory containing the Project01 materials downloaded from Canvas (you should be there already if you just completed Step #1 above).
Use the following command to create the file project01.cpp by typing the following at the Linux prompt. Linux is case sensitive so pay attention to upper versus lower case letters. gedit project01.cpp &
This command starts the gedit text editor running as a background process ( & ). With the editor running in the background, you may use the same terminal window to compile and test your program. Place function stubs for the functions listed above in the file project01.cpp and save the file.
In the terminal window, compile your program by typing the word make at the prompt and press the Enter key. If you see error messages, use the text editor to make corrections to the function stubs and switch back to the terminal window to type make again to recompile your program. Once your program compiles, you may execute it by typing: ./project01 inputfilename
Now that your program compiles and executes using function stubs, you may implement and test your solution function by function. Start with the functions associated with opening files and loading data.
Running the Sample Solution on blackhawk [shows the desired output for specified input file] The best description of what your code should do is the Sample Solution for the project.
Run the sample solution by typing the following at blackhawk terminal window command prompt where inputfilename is the name of one of the provided input files (for example, p01input1.txt).
/home/work/cpe212/project01/p01 inputfilename
è Your current working directory must contain the input files for this to work. ç
Running the Preview Script on blackhawk [analyzes outputs for all provided input files]
Run the preview script by typing the following in a blackhawk terminal window command prompt
/home/work/cpe212data/project01/preview01.bash
This script will run both the Sample Solution AND your project01 executable program on the complete set of input files, and it compares the outputs of the two programs line by line to identify errors in your program’s outputs. Make sure that the output of your program exactly matches the output of the Sample Solution.
- To use the preview script, your executable must be on blackhawk
- The sample input files must be in your current working directory BEFORE you execute the preview script!!!
Project01 Hints
Use the function prototypes appearing in main.cpp to create a file named project01.cpp that contains empty function definitions. Be sure that you can successfully use make to compile this skeleton solution before adding any additional code.
The GetNextImage function is critical – if this function does not work, then your project will fail every test. Make sure that GetNextImage works before continuing with any other functions.
After GetNextImage, implement the simplest operations FlipHorizontal, FlipVertical, and Transpose one at a time, testing each with the appropriate input file. Rotations may be implemented by combinations of the three simplest operations.
struct Record // Structured data type for storing one line of image data from file
{ int digit; // Digit read from file int image[MAXROWS][MAXCOLS]; // Pixel data read from file };
Project 01 Function Specifications void GetNextImage(ifstream& datastream, int counters[], Record& data)
// Reads digit and image data from datastream object storing values in data parameter
// Updates histogram counters to reflect specific digit input from file
// Note: Correct operation of this function is critical!! If one cannot correctly // load images into the array from the file, then one cannot test the // image processing operations and your code will fail every test!
void Transpose(int image[MAXROWS][MAXCOLS]);
// Transpose() – must flip the image across the primary diagonal row = column as // with a matrix transpose
// Parameter image is a two-dimensional array of integers representing the image
void FlipHorizontal(int image[MAXROWS][MAXCOLS]);
// FlipHorizontal() – must flip the image horizontally. For example,
// column zero exchanged with column N-1, column one exchanged with column N-2, etc.
// Parameter image is a two-dimensional array of integers representing the image
void FlipVertical(int image[MAXROWS][MAXCOLS]);
// FlipVertical() – must flip the image Vertically. For example,
// row zero exchanged with row N-1, row one exchanged with row N-2, etc.
// Parameter image is a two-dimensional array of integers representing the image
void RotateCW(int image[MAXROWS][MAXCOLS]);
// RotateCW() – must rotate the image 90 degrees clockwise.
// Parameter image is a two-dimensional array of integers representing the image
void RotateCCW(int image[MAXROWS][MAXCOLS]);
// RotateCCW() – must rotate the image 90 degrees counter clockwise.
// Parameter image is a two-dimensional array of integers representing the image Hint: Rotations may be achieved by combining the other operations.
Project01 Sample Input File (p01input1.txt)
| # p01input1.txt — Test of Transpose Image | ç # designates a comment | |||||
| [ smalldata.csv
|
ç Open specified image data file | |||||
| # Draw Bars
b 1
|
ç b designates drawbar command | |||||
| # Print Original Image p
# Draw Bars b 1
|
ç p designates print image command | |||||
| # Test Transpose Image t | ç t designates transpose command | |||||
# Print Image p
# Close file
]
One Line from Data File (smalldata.csv) (first integer is digit depicted by pixels – 24×24 array)
7,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,84,185,159,151,60,36,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,222,254,254,254,254,241,198,198,198,198,198,198,198,19
8,170,52,0,0,0,0,0,0,0,0,0,0,0,0,67,114,72,114,163,227,254,225,254,254,254,250,229,254,254,140
,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,17,66,14,67,67,67,59,21,236,254,106,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,83,253,209,18,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,22,233,255,83,0,0,0,0,0,0,0
,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,129,254,238,44,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,59,249,2
54,62,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,133,254,187,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
,0,0,0,0,9,205,248,58,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,126,254,182,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,75,251,240,57,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,19,221,254,166,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,203,254,219,35,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,38,254,254,77,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,31,224,254,115,1,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,133,254,254,52,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,61,242,254,254,52,0
,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,121,254,254,219,40,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
,0,0,121,254,207,18,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
