Project A2 20141 - OOP344
- 1 Introduction
- 2 Spec Code Amendments
- 3 The Big Picture
The basic information of A2 is on the BTP300 site linked here. A number of issues have been identified within the assignment spec and so a series of amendments is required in order for the spec to produce a correct assignment. The amendments are listed here. In addition, we are also listing a number of clarifications and suggestions that you may find helpful while implementing this assignment. Those will follow the spec code amendments.
Spec Code Amendments
- Instead of #defining NULL in cfg.h, you should #include <cstdlib> at the top of cfg.h. eg:
#ifndef __CFG_H__ #define __CFG_H__ #include <cstdlib> ... #endif
Functions to be updated
The following functions should be made public or protected:
Functions to be removed
The following two functions should be removed from the specification completely. Let me be extra clear: DO NOT PUT THEM IN YOUR CFrame HEADER, DO NOT CODE THEM, DO NOT USE THEM!
Functions to be Updated
- The function CField::edit currently accepts 4 parameters and is not virtual.
It should be updated as follows to be consistent with its child classes:
- pure virtual
- should not accept any parameters
- should return int (it already does)
Functions to be Removed
The following functions are a bit awkward. Remove them. See the Functions to be Added section for a better design.
- void** data()
- const void* pdata() const
Functions to be Added
These functions act as setters/getters to CField's internal data member. Code them so that other classes can obtain or update the data member. Make these public.
- void* data() const
- void data(void*)
Both constructors should accept a bool* and NOT a bool for insert mode. Updated descriptions follow:
Receives 8 values.
- bool* - the insert mode for the line field
Receives 7 values.
- bool* - the insert mode for the line field
The Big Picture
This assignment is about creating a basic console GUI system. It is meant to show the student how OOP can be used effectively to design a system. The basic setup for this system are the 6 classes iFrame, CFrame, CField, CLabel, CLine, CButton and the supplemental class CDialog provided already implemented as a part of the spec. Let's look at the role of each of these.
iFrame is an interface class that describes a widget that has a frame. We can easily spot interface classes by looking for the "i" at the beginning of their name. A widget is basically a window component such as a label, a button, a field, or even a full window. Since iFrame is an interface, iFrame's job is to declare the set of functionality that every framed object can publicly perform. We call this type of design design by contract because we can think of any class derived from iFrame to be contractually obligated to fulfill what iFrame has promised.
iFrame's contract consists of a set of pure virtual functions that any concrete deriving class must implement. In this case, iFrame declares that any object instanced from it can draw itself, hide itself, and move.
CFrame inherits from iFrame and implements iFrame's core responsibilities. The "C" in CFrame stands for "concrete" (even though it is technically abstract! More on this later). In this system, CFrame is the parent class of all other deriving classes (CDialog, CField) and the ancestor of the other three (CLabel, CLine, CButton).
CFrame is responsible for common communication with the underlying console including:
- Clearing a portion of the screen (draw)
- Optionally drawing a border/frame while doing this
- Restoring a section of a cleared portion of the screen or in its entirety (hide)
- Storing attributes and providing functionality for retrieving the basic state of the frame including:
- Whether it is in fullscreen mode
- Whether it is bordered
- Relative top left row/top left column
- Absolute top left row/top left column
- Width/height of the frame, including the frame/border
- This should be the width/height of the screen if the frame is in fullscreen
CField inherits from CFrame and implements some of the functionalities common to most widgets eg buttons, fields, and labels. It also propagates a contract of its own. This is to allow container objects to work with more derived objects (CLine, CLabel, CButton) without needing to know their exact class.
CField's contract consists of functions that could be used to query the capabilities of an object derived from CField and to perform the basic actions typically required from a window component. These functions are all pure virtual. The functions are as follows:
- void draw(int)
- int edit() [mentioned above]
- bool editable() const
- void set(const void*)
CField is responsible for implementing the data setter/getter.
A CLabel is an uneditable line of text to be displayed somewhere on the screen. It inherits from CField.
A CLine is an editable line of text. It inherits from CField. CLine should use the