Due Friday, March 14 before midnight.
None so far
Your text.
My office hours.
Viewers: you can view the images on our lab machines in at least 3 ways:
Use the "Eye of Gnome" application, which can view many different image formats. Copy the samples, and in the directory where you put them, use commands like
eog saturn200.pgm
Use IrfanView, a Windows application.
There's a free version which you can download. You can
try it out on the lab machines by following the menus:
Applications -> Other -> IrfanView 4.00. It's capable
of editing images too, so it's slower and a bit awkward.
There is an image-editing program under Linux too, known as "The Gimp". Use the command
gimp
with or without filenames on the command-line.
For you Mac OS X users, try this ToyViewer.
Collaboration is not allowed on this assignment. Everyone must submit their own solutions.
All students are required to have the following header comment at the top of their source file(s), both .c and .h. Note that the stuff to the right of the colon in red is information for an imaginary example student on a particular part of an imaginary project. (Your header comment is not expected to have red text, but to replace it with accurate information.) All program files require this header.
/* Project 99 Part 88 (Mogrifier) * * Name: Fleetybelle Screwdriverson * Instructor: Hillbilly Haungs * Section: 11 */
You may not use any libraries other than the
C standard library and the math library. The C standard library includes
the function definitions for all the functions mentioned in
stdio.h, stdlib.h, unistd.h,
ctype.h, string.h, strings.h
and some others, so this should not be a severe restriction.
Your program must conform to your instructor's style rules.
You will be writing a program which reads in ascii art and converts it to an image in the plain PGM format. There is a man page for this ("man pgm") on our lab machines. You may view the PGM images using a variety of free image viewers such as Irfanview or the Gimp. Irfanview is available on the lab machines, and you can also download and install it on home machines. Linux users may prefer to use the Gimp.
Your programs will operate as "filter" programs, which means that they take input from a source file and send output to a destination file, and normally do nothing else. In particular, your program will not greet the user or prompt for input. Normally, running a filter program produces no output on the console at all.
The command-line tokens are always communicated to a C program in
the arguments to the main() function. If the program is
to make use of these, the convention is to use the following header
for the main function:
int
main(int argc, char *argv[])
The first argument is the number of tokens, and the second is an array of pointers to strings, each of which is a token from the command line. There is always at least one entry in the array: the path to your file as given in the command line. If you called it with "./aa2pgm" then that is the content of the first token, dot and slash included.
An example of a program that simply prints its arguments can be found at command.c. Run this program with command-line switches and see how they are communicated to the program.
We will be writing images in the plain PGM format, which is described second in the man page. In general, these files contain a list of grey scale values for each pixel in the image, encoded as ASCII decimal integers.
Please read the man page ("man pgm") for more information about the exact file format.
I will be providing you with a partial solution to the translator program you are to write. I have indicated with the comment "/* ADD CODE HERE */" where you are to add code to complete the program. Here are the files I'm providing you along with a short description:
aa2pgm.c: Contains the main() function and logic flow (function calls) to complete the assignment.
aa2pgm.h: Defines key constants and the PGM header structure.
pgm_font.c: Implementation of the function needed to initalize the PGM font array.
pgm_font.h: Declares the global font array and provides the prototype for the font initialization function.
font.txt: Contains 127 9x11 matrices that define the PGM font. I have supplied many of the characters necessary for almost all of the example ascii art. I will update this array in the future. You are also free to implement your own characters.
Makefile: Makefiles are a great way to organize the compilation and testing of your code. You should use this Makefile throughout your development process. As long as you have this file in the same directory as your code you can type the following commands:
- "make": This will compile your code with all the nccessary flags.
- "make test": This will run your program on all the example ascii files I provided. Note, you can also test your program for individual tests too. Just type make and the name of the test. For example, you can type "make starwars" to run your program on the starwars.ascii file.
- "make clean": This will remove temporary files, your executable, and all ".pgm" files.
$ aa2pgm ascii_file pgm_file font_file
Execute the following handin command making sure to replace -xx with your section number
handin mhaungs Program5-section aa2pgm.c pgm_font.c