User Tools

Site Tools


Sidebar

projects

wcp1 (due 20240828)
wcp2 (due 20240904)
pct0 (bonus; due 20240905)
pct1 (bonus; due 20240905)
pct2 (due 20240905)
abc0 (due 20240906)
gtf0 (due 20240911)
pct3 (bonus; due 20240911)
wcp3 (due 20240911)
dtr0 (due 20240918)
pct4 (due 20240918)
wcp4 (due 20240918)
mmf0 (due 20240926)
pct5 (bonus; due 20240926)
wcp5 (due 20240926)
cnv0 (due 20241002)
gfo0 (due 20241002)
pct6 (due 20241002)
wcp6 (due 20241002)
fwg0 (due 20241009)
pct7 (bonus; due 20241009)
wcp7 (due 20241009)
bwp1 (bonus; due 20241016)
cnv1 (due 20241016)
pct8 (due 20241016)
wcp8 (due 20241016)
fwg1 (due 20241023)
pct9 (bonus; due 20241023)
wcp9 (due 20241023)
fwg2 (due 20241030)
gfo1 (due 20241030)
pctA (due 20241030)
wcpA (due 20241030)
fwg3 (due 20241106)
pctB (bonus; due 20241106)
wcpB (due 20241106)
oop0 (due 20241113)
pctC (due 20241113)
wcpC (due 20241113)
pctD (bonus; due 20241120)
wcpD (bonus; due 20241120)
bwp2 (bonus; due 20241204)
gfo2 (due 20241204)
pctE (bonus; due 20241204)
wcpE (bonus; due 20241204)
EoCE (due 20241216)
haas:fall2024:cprog:projects:gtf0

Corning Community College

CSCS1320 C/C++ Programming

PROJECT: Graphics To Figure-out (GTF0)

OBJECTIVE

As we start our journey into programming, despite not yet having learned much, let us see how our observational and pattern-matching and problem solving skills can still yield productive changes toward the solution of a task.

TASK

You are to modify provided code, once functionality and operations of it are understood, to produce, as image output, a scene containing the following characteristics:

  • confined within a square resolution of at least 1000×1000 pixels
  • contain at least:
    • 1 filled rectangle, no shorter than 32 pixels on any side
    • 1 unfilled rectangle, no shorter than 64 pixels on any side
    • 1 circle, diameter no smaller than 128 pixels
    • 1 ellipse
    • utilize at least 8 uniquely mixed colors
    • NOTE: background not a substitute for required filled rectangle above
  • annotate your image with your initials, ideally in some corner

EDIT

You will want to go here to edit and fill in the various sections of the document:

GTF0

The goal for this project is to observe the skeleton code and understand the functions well enough to meet the project objectives listed at the top of this page. Look at the different functions to divulge information about how this graphics library works and revise the code to meet expectations.

GRABIT

Once you are in your class folder you can make a directory for this project using:

mkdir gtf0

After entering the directory you can retrieve the project files like so:

grabit DESIG gtf0

Where DESIG is your class designation (e.g. cprog).

REPOSITORY STEPS

  • Create a public html directory with the following command
mkdir -p ~/public_html
  • Allow public permissions on the directory with the following
chmod 0711 ~/public_html

BUILD THE CODE

  • While in your gtf0 directory use the make command to build the code
make gtf0

It is also possible to compile manually as such:

gcc -Wall --std=gnu18 -o gtf0 gtf0.c -lgd

gcc is the name of the compiler or collection of compilers used to compile C/C++ code. It can be invoked with the gcc command with flags such as what is shown above.

RUN THE PROGRAM

To run the program you've modified/created, simply invoke it on the command line while in its directory like so:

./gtf0

You should now notice gtf0.png in the directory that you ran the program.

From here, you can move it to your public_html directory for viewing.

VIEW THE IMAGE

  • Using the mv command, move the resulting image from your gtf0 dir to your public html dir
mv gtf0.png ~/public_html
  • To allow public viewing of the image use the chmod command
chmod 0644 ~/public_html/gtf0.png

LIBGD FUNCTIONALITY

MIXING A COLOR
int color = gdImageColorAllocate (gdImagePtr im, int r, int g, int b);

gdImagePtr im is the image the function edits

int r, int g, and int b are the red, green, and blue components of the color. Typically represented as hex values between 0x00 and 0xFF

There are many ways to find a colors hex value, including google's

Official gdImageColorAllocate wiki page

DRAWING A LINE
gdImageLine (image, x1, y1, x2, y2, color);

x1 and y1 are the starting coordinates and x2 and y2 are the ending coordinates

DRAWING A RECTANGLE
gdImageRectangle (gdImagePtr im, int x1, int y1, int x2, int y2, int color);

gdImagePtr im is the image the function edits

int x1 is the left bound

int y1 is the upper bound

int x2 is the right bound

int y2 is the lower bound

int color is the color the rectangle is drawn as

Official gdImageRectangle wiki page

FILLING AN ENCLOSED SPACE
gdImageFill (gdImagePtr im, int x, int y, int color);

gdImagePtr im is the image the function edits

int x and int y are the coordinates the fill propagates from

int color is the color that is drawn as

Official gdImageFill wiki page

DRAWING A FILLED RECTANGLE
gdImageFilledRectangle (gdImagePtr im, int x1, int y1, int x2, int y2, int color);

gdImagePtr im is the image the function edits

int x1 is the left bound

int y1 is the upper bound

int x2 is the right bound

int y2 is the lower bound

int color is the color the rectangle is drawn as

Official gdImageFilledRectangle wiki page

DRAWING A CIRCLE
gdImageEllipse (gdImagePtr im, int mx, int my, int w, int h, int color);

gdImagePtr im is the image the function edits

int mx and int my is the coordinates of the circle center

int w is the horizontal diameter of the circle

int h is the vertical diameter of the circle

w and h must be the same to create a circle

int color is the color the circle is drawn as

Official gdImageEllipse wiki page

DRAWING A Ellipse
gdImageEllipse (gdImagePtr im, int mx, int my, int w, int h, int color);

gdImagePtr im is the image the function edits

int mx and int my is the coordinates of the ellipse center

int w is the horizontal diameter of the ellipse

int h is the vertical diameter of the ellipse

int color is the color the ellipse is drawn as

Official gdImageEllipse wiki page

 

SUBMISSION

To be successful in this project, the following criteria (or their equivalent) must be met:

  • Project must be submit on time, by the deadline.
    • Late submissions will lose 33% credit per day, with the submission window closing on the 3rd day following the deadline.
  • All code must compile cleanly (no warnings or errors)
    • Compile with the -Wall and --std=gnu18 compiler flags
    • all requested functionality must conform to stated requirements (either on this document or in a comment banner in source code files themselves).
  • Executed programs must display in a manner similar to provided output
    • output formatted, where applicable, must match that of project requirements
  • Processing must be correct based on input given and output requested
  • Output, if applicable, must be correct based on values input
  • Code must be nicely and consistently indented
  • Code must be consistently written, to strive for readability from having a consistent style throughout
  • Code must be commented
    • Any “to be implemented” comments MUST be removed
      • these “to be implemented” comments, if still present at evaluation time, will result in points being deducted.
      • Sufficient comments explaining the point of provided logic MUST be present
  • No global variables (without instructor approval), no goto statements, no explicit calling of main()!
  • Track/version the source code in your lab46 semester repository
  • Submit a copy of your source code to me using the submit tool (make submit on lab46 will do this) by the deadline.

Submit Tool Usage

Let's say you have completed work on the project, and are ready to submit, you would do the following:

lab46:~/src/SEMESTER/DESIG/PROJECT$ submit DESIG PROJECT file1 file2 file3 ... fileN

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.

RUBRIC

I'll be evaluating the project based on the following criteria:

39:gtf0:final tally of results (39/39)
*:gtf0:modified code appropriately to accomplish task [13/13]
*:gtf0:image elements abide by project specifications [13/13]
*:gtf0:removed unused code [13/13]

Pertaining to the collaborative authoring of project documentation

  • each class member is to participate in the contribution of relevant information and formatting of the documentation
    • minimal member contributions consist of:
      • near the class average edits (a value of at least four productive edits)
      • near the average class content change average (a value of at least 256 bytes (absolute value of data content change))
      • near the class total content contribution average (a value of at least 1kiB)
      • no zero-sum commits (adding in one commit then later removing in its entirety for the sake of satisfying edit requirements)
    • adding and formatting data in an organized fashion, aiming to create an informative and readable document that anyone in the class can reference
    • content contributions will be factored into a documentation coefficient, a value multiplied against your actual project submission to influence the end result:
      • no contributions, co-efficient is 0.50
      • less than minimum contributions is 0.75
      • met minimum contribution threshold is 1.00

Additionally

  • Solutions not abiding by spirit of project will be subject to a 50% 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 or otherwise maintaining consistency in code style and presentation will be subject to a 25% overall deduction
  • Solutions not organized and easy to read (assume a terminal at least 90 characters wide, 40 characters tall) are subject to a 25% overall deduction
haas/fall2024/cprog/projects/gtf0.txt · Last modified: 2024/09/14 11:34 by 127.0.0.1