Table of Contents

PROJECT

PROJECT: Design A Picture (dap0)

Objective

To adapt and experiment with a program that generates an image.

Also to start some time-sensitive activities to ensure ground is broken on the project before the day it is due (see submission rubric below)

Abstraction

As an exercise in toning your abstraction abilities (literally seeing one thing, but understanding and using it as something else), there will be a number of 'generic' terms used throughout this (and other) documents throughout the course, requiring you to substitute in the pertinent information (else face confusion or error).

Some examples:

  • yourusername - where you see this (likely in a config file or command-line argument), you are NOT to literally type in y-o-u-r-u-s-e-r-n-a-m-e, but instead, substitute in YOUR lab46 username.
  • desig - different classes have different class designations. To make one universal document pertinent to ALL classes, specific examples will instead use 'desig', where you must substitute in the class desig of the class YOU are taking and acting upon in that moment. Example class desigs:
    • c4eng - ENGR1050 “C for Engineers”
    • cprog - CSCS1320 “C/C++ Programming”
    • unix - CSCS1730 “UNIX/Linux Fundamentals”
    • data - CSCS2320 “Data Structures”
    • discrete - CSCS2330 “Discrete Structures”
    • comporg - CSCS2650 “Computer Organization”
    • sysprog - CSCS2730 “Systems Programming”

This sort of abstraction is very similar to that we will find in our utilization of variables in programming, where we can have a “name”, but the data associated with it can change based on various conditions.

Do not be a literalist computer! Start to exercise your abstraction abilities.

2024/01/29 11:37

Locational Awareness

This document is written with TWO locations in mind:

  • lab46 (the system you may retrieve resources and SUBMIT projects)
    • identified in examples with the use of the lab46:~$ prompt
  • your pi (the system you will transfer resources to/from, and WORK ON/COMPLETE projects)
    • identified in examples with the use of the yourpi:~$ prompt

There are commands you can ONLY run on one system or the other. Pay attention to any prompt cues in the given examples (or section headings, context of language leading up to any examples).

For example:

  • YOU cannot install software on lab46. You don't have access.
  • projects CANNOT be SUBMITTED on your pi.

Please pay attention to your prompt, so you can perform the needed activity on the correct system.

2024/01/29 11:37

Background

For this project, you will be using a graphics design library to render the indicated image.

Program

It is your task to write a program that generates an image according to the following specifications:

The program will be an exercise in exploration: you will be given some example code that does something. You should poke at it to gain deeper understanding. Then you will, taking out the demo graphics, implement the needed steps to generate your intended picture.

On your pi/system

Develop and test this program on your pi. Only when done, verify that it compiles on lab46.

To utilize the needed functionality for this project, you will need to ensure you have the following packages installed:

And any related packages that may be needed to support this endeavour.

Specifications

Your program should:

Grabbing project resources

I have prepared a grabit for resources related to this project. To obtain:

lab46:~/src/SEMESTER/desig$ grabit desig dap0
make: Entering directory '/var/public/SEMESTER/desig/dap0'
'/var/public/SEMESTER/desig/dap0/Makefile' -> '/home/user/src/SEMESTER/desig/dap0/Makefile'
'/var/public/SEMESTER/desig/dap0/dap0.c|py' -> '/home/user/src/SEMESTER/desig/dap0/dap0.c|py'
make: Leaving directory '/var/public/SEMESTER/desig/dap0'
lab46:~/src/SEMESTER/desig$ 

At which point you can change into the newly created and populated dap0 directory.

Be sure to add, commit, and push this to your lab46 clone of your repository.

Then, on your pi/system, pull and update to get the files available there.

Compiling

Since the grabit brought in a Makefile, if your code needs compiling you can compile your code simply by typing: make

You can run the program with: make run

If on lab46, you can get the image copied into your web space (under the dap0/ subdirectory) by running: make install

When done and ready to submit, on lab46: make submit

Restrictions

To ensure a level playing field (should some happen to have some programming experience), I would like to restrict you from using:

Strategy

As with any process you are looking to describe or automate (in this case, both), if YOU do not personally understand or appreciate the steps involved, you are going to have a hard time communicating a proficient list of instructions to the computer to carry out.

So, the FIRST order of business would be to, BY HAND, ON A SHEET OF GRAPH PAPER (consider this your PROTOTYPE):

How to view the picture

Depending on your computing setup, choose the most practical means of viewing your program's image output:

Raspberry Pi/system desktop

You've got a monitor and keyboard hooked up to your pi/system that you are using (preferred method for class).

Open a file browser, web browser, or image viewer and navigate to/open up your dap0.png image in your ~/src/SEMESTER/desig/dap0/ directory.

Rinse and repeat as you go through revisions.

Raspberry Pi/system command-line via SSH/MOSH

You don't have a monitor, so you are logging into your pi/system remotely (doable, and good intra-system practice)

We start by running a successfully-compiled dap0:

yourpi:~/src/SEMESTER/desig/dap0$ make run

… which will produce an image (dap0.png); You want to put this in your web space (with the proper permissions set), so you can view it in a web browser:

yourpi:~/src/SEMESTER/desig/dap0$ ssh yourusername@lab46.g7n.org "mkdir -p ~/public_html/dap0"
yourpi:~/src/SEMESTER/desig/dap0$ scp dap0.png yourusername@lab46.g7n.org:public_html/dap0/

Note that you will be prompted for your lab46 password.

Then over on lab46, run this:

lab46:~$ chmod 0644 ~/public_html/dap0/dap0.png

Then, point a web browser at the following URL:

NOTE: sometimes the web browser caches previous results, you may have to refresh a few times on revisions to get changes to manifest.

Submission

To successfully complete this project, the following criteria must be met:

To submit this program to me using the submit tool, run the following command at your lab46 prompt:

lab46:~/src/SEMESTER/DESIG/dap0$ make submit

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:

26:dap0:final tally of results (26/26)
*:dap0:post picture of prototype to #desig discord channel [6/6] 
*:dap0:grabit the code on lab46 by Sunday before deadline [4/4]
*:dap0:code is pushed to lab46 semester repository [6/6]
*:dap0:no negative compiler/interpreter messages for program [4/4]
*:dap0:proper output formatting per specifications [6/6]

Additionally: