CMPS-2240 Lab-8
Gordon Griesel
Fall 2024
Write an ARM-32 program to read a PPM file.
Display information about the image.
Get started here...
Get the starting ARM program and files.
note: rename your current Makefile, because it will be overwritten!
$ cd 2240/8
$ mv Makefile xMakefile
$ cp /home/fac/gordon/public_html/224/code/lab8/* .
$ cp lab8.s mylab8.s
The lab8.s program will parse the words in a file.
You will make the program read information from a PPM file.
PPM file format specifications
Sample files
Sample output...
When you first start...
$ make
arm-linux-gnueabi-as lab8.s -o lab8.o
arm-linux-gnueabi-as atoi.s -o atoi.o
arm-linux-gnueabi-as itoa.s -o itoa.o
arm-linux-gnueabi-ld lab8.o atoi.o itoa.o -o lab8
$ ./lab8 test.txt
test.txt
This-is-a-test-file-with-text
line-2
line-3
more
lines
are
here
a
number
is
below
75
end-of-file
is
coming
soon.
PPM file with no comment...
$ make
arm-linux-gnueabi-as mylab8.s -o lab8.o
arm-linux-gnueabi-as atoi.s -o atoi.o
arm-linux-gnueabi-as itoa.s -o itoa.o
arm-linux-gnueabi-ld lab8.o atoi.o itoa.o -o lab8
$ ./lab8 csub.ppm
Reading a file...
This is a PPM file type P3.
Width: 60
Height: 30
Maximum color value: 255
PPM file with a comment...
$ ./lab8 csub-comment.ppm
Reading a file...
This is a PPM file type P3.
Found a comment: this is where the comment will be displayed
Width: 17
Height: 7
Maximum color value: 255
not a PPM file...
$ ./lab8 bad-img.ppm
Reading a file...
This is not a PPM image file!
More info will be here.
Files to be collected at end of lab:
mylab8.s
itoa.s
atoi.s
printf.s
csub.ppm
csub-comment.ppm
bad-img.ppm
Homework is here
----------------
Project Phase-1
Start with your
mylab8.s or your
armquiz8.s program.
Copy your program to:
2240/8/myphase1.s
Add the following features...
1. Handle a comment in a PPM 3 file.
---------------------------------
A comment is a parsed word that begins with a '#' character.
The comment will end with a newline character.
A comment might occur after the P3 but before the max-color value.
You should skip a comment.
Program output will not change when a comment is in the file.
Get your program working with one comment.
Then you may try to get it working with multiple comments anywhere
between the P3 and max-colors as in the file below.
P3
# Created by GIMP version 2.10.38 PNM plug-in
# the width is below
17
# now the height of the image
7
# and now the max-color-value followed by the RGB colors
255
255 255 255 255 255 255 255 255 255
255 255 255 255 255 255 255 255 255
...
The output will not change...
$ ./a.out csub-comments.ppm
Reading a file...
This is a PPM file type P3.
Width: 17
Height: 7
Max color: 255
2. Show the image size in your output.
-----------------------------------
Size is in pixels.
Determine size as width x height.
Sample output:
$ ./a.out csub.ppm
Reading a file...
This is a PPM file type P3.
Width: 17
Height: 7
Max color: 255
Image size in pixels: 119
3. Show the image aspect ratio.
----------------------------
This is an optional feature for extra credit.
Determine the aspect ratio of your image file.
Aspect ratio is width / height.
Compare your aspect ratio to the common aspect ratios below.
Choose the closest match, and display your choice.
Your aspect ratio is: width / height.
Aspect ratio for 9:16 is 9 / 16 = 0.5625
Aspect ratio for 4:5 is 4 / 5 = 0.8
etc.
Compare your aspect ratio to 0.5625, then to 0.8, etc.
Which is closest?
Sample output:
$ ./a.out csub.ppm
Reading a file...
This is a PPM file type P3.
Width: 17
Height: 7
Max color: 255
Image size in pixels: 119
Aspect ratio: 21:9
Project phase-2 begins here.
1. Display a rectangle with the width and height of your image.
-----------------------------------------------------------
Copy your 2240/8/myphase1.s program to 2240/9/myphase2.s
Do your work on Phase-2 in your 9 folder.
You do not yet have to read the image color information.
Write nested loops to display a rectangle width by height.
csub.ppm is 17x7 and will look like this.
**********************************
**********************************
**********************************
**********************************
**********************************
**********************************
**********************************
2. Display image colors as characters.
----------------------------------
This work is in your 2240/9/myphase2.s program.
1. Read the colors in the nested loop used to draw your rectangle.
2. Each color requires 3 calls to parse.
3. Add the 3 color values together.
4. Divide it by 128. ---> (Bit-shift right by 7)
The result will be a value between 0 and 5.
Get the color from a data string that might look like this:
.data
palette: .asciz " .:o#@"
Display your character choice instead of an asterisk.
**********************************
**********************************
**********************************
**********************************
**********************************
**********************************
**********************************
Programs to be collected:
2240/8/myphase1.s
2240/9/myphase2.s
Project phase-3 begins here.
1. Make your myphase3.s program display a P3 or P6 image file.
-----------------------------------------------------------
Copy all your project files to your 2240/c folder on Odin.
Something like this...
/home/fac/gordon/p/2240/lab-setup.sh
cd 2240/c
cp ../8/* .
cp ../9/myphase2.s .
cp myphase2.s myphase3.s
Do your work on all project phases in your 2240/c folder.
Your program should accept a file name at the command-line.
The file can be a PPM image type P3 or type P6.
A P6 file is similar to a P3 file.
The difference is in the list of Red Green Blue colors.
Each color is one byte with a value from 0 to 255.
Your program will determine P3 or P6 at the start, then display the image.
Programs to be collected:
2240/c/myphase1.s
2240/c/myphase2.s
2240/c/myphase3.s