Corning Community College
ENGR1050 C for Engineers
======Project: VISUALIZATION - FUN WITH FLAGS (fwf0)======
=====Objective=====
To create a program that generates a number of images corresponding to various flags of varying levels of design complexity.
=====Reading=====
In "The C Book", please read through Chapter 7.
=====Background=====
In class we explored the visualization capabilities made available to us with the GD library.
For this project, you will be using that library to render images of various flags.
While you are not restricted to officially recognized country flags, they do offer a great starting point:
* https://www.countries-ofthe-world.com/flags-of-the-world.html
If there is some fictional country, other state/county/canton, or organization symbol you would like to implement instead, you are welcome to (so long as they conform to the difficulty levels specified below).
You are tasked with creating two different flags (from one program), of differing levels of complexity. Namely, one "intermediate" flag, and one "medium" flag.
Difficulties are defined as follows:
====Easy====
An easy-level flag has the following criteria:
* Solid colours, often in bands
* Examples: France, Mali, Belgium
====Intermediate====
Intermediate-level flags are classified as follows:
* At least three distinct colours used on the flag.
* More than one geometric shape utilized on the flag (ie not JUST rectangles/squares).
* Examples: Maldives, Burkina Faso, Burundi
====Medium====
* Three or more colours
* Contains three different geometric shapes (oval(s), triangle(s), star(s), rectangle(s))
* Examples: Malaysia, Algeria, Antigua and Barbuda
====Complex====
* Increased level of detail above that of medium
* Creation utilizes loops
* Examples: USA, Croatia, Philippines
=====Program=====
It is your task to write a program that generate a total of two different flag images, hosted under your lab46 webspace under a **fwf0/** directory, named and accessible as follows:
* fwf0/flag1.png
* fwf0/flag2.png
flag1 is to be in intermediate (or greater) level flag, and flag2 is to be a medium (or greater) level flag.
Opting to do higher difficulties may earn you some bonus points.
=====Specifications=====
Your program should:
* have valid, descriptive variable names of length //no shorter than// 4 symbols
* have consistent, well-defined indentation (no less than 4 spaces per level of indentation)
* all code within the same scope aligned to its indentation level
* have proximal comments explaining your rationale and what is going on, throughout your code
* perform the intended operation, outputting the correct/accurate information in indicated format
* at the end of your main() function, use a single return statement to conclude your code, return a 0 indicating successful operation
Some additional points of consideration:
* Note that the driving variables in your loops need to be at least of type **short int**, otherwise you may get a warning when you compile it.
=====Grabbing project resources=====
I have prepared a **grabit** for resources related to this project. To obtain:
lab46:~/src/c4eng$ grabit c4eng fwf0
make: Entering directory '/var/public/fall2019/c4eng/fwf0'
'/var/public/fall2019/c4eng/fwf0/Makefile' -> '/home/wedge/src/c4eng/fwf0/Makefile'
'/var/public/fall2019/c4eng/fwf0/fwf0.c' -> '/home/wedge/src/c4eng/fwf0/fwf0.c'
make: Leaving directory '/var/public/fall2019/c4eng/fwf0'
lab46:~/src/c4eng$
At which point you can change into the newly created and populated **fwf0** directory.
=====Compiling=====
Since the grabit brought in a Makefile, you can compile your code simply by typing: **make**
Any compiler errors will go into a text file called **errors**
To do a full cleaning, run: **make clean** then **make** (or **make debug**)
If you'd like to see compiler messages as you compile, run: **make debug**
When done and ready to submit, on lab46: **make submit**
=====Submission=====
To successfully complete this project, the following criteria must be met:
* Code must compile cleanly (no notes, warnings, nor errors)
* Output must be correct, and match the form given in the sample output above.
* Code must be nicely and consistently indented
* Code must be well commented
* Do NOT double space your code. Group like statements together.
* Output Formatting (including spacing) of program must conform to the provided output (see above).
* Track/version the source code in a repository
* Submit a copy of your source code to me using the **submit** tool.
To submit this program to me using the **submit** tool, run the following command at your lab46 prompt:
$ submit c4eng fwf0 fwf0.c
Submitting c4eng project "fwf0":
-> fwf0.c(OK)
SUCCESSFULLY SUBMITTED
You should get some sort of confirmation indicating successful submission if all went according to plan. If not, check for typos and or locational mismatches.
What I'll be looking for:
78:fwf0:final tally of results (78/78)
*:fwf0:proper error checking and status reporting performed [13/13]
*:fwf0:correct variable types and name lengths used [13/13]
*:fwf0:proper output formatting per specifications, flag 1 [13/13]
*:fwf0:proper output formatting per specifications, flag 2 [13/13]
*:fwf0:no negative compiler messages for program [13/13]
*:fwf0:code is pushed to lab46 repository [13/13]
Additionally:
* Solutions not abiding by spirit of project will be subject to a 25% overall deduction
* Solutions not utilizing descriptive why and how comments will be subject to a 25% overall deduction
* Solutions not utilizing indentation to promote scope and clarity will be subject to a 25% overall deduction
* Solutions not organized and easy to read are subject to a 25% overall deduction