1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
#ifndef __PICTURE_H__
#define __PICTURE_H__
#include<exception>
#include<string>
/** @defgroup picture Picture Operations
* The collection of all Picture Related commands and operations
* @{
*/
/**
* A pixel structure that respesents a single pixel of an Image.
*/
struct Pixel {
unsigned char R;
unsigned char G;
unsigned char B;
};
/**
* Set the Red channel of the pixel.
*
* @param value Should be between 0->255
*/
void setRed(Pixel& p, int value);
/**
* Set the Green channel of the pixel.
*
* @param value Should be between 0->255
*/
void setGreen(Pixel& p, int value);
/**
* Set the Blue channel of the pixel.
*
* @param value Should be between 0->255
*/
void setBlue(Pixel& p, int value);
/**
* Get the Red value of the given pixel
*/
int getRed(Pixel& p);
/**
* Get the Green value of the given pixel
*/
int getGreen(Pixel& p);
/**
* Get the Blue value of the given pixel
*/
int getBlue(Pixel& p);
/**
* @class Picture
*
* The abstract Picture object that represents a picture taken from a robot.
*
* @author Richard Edwards, John Hoare
*/
class Picture {
public:
/*
* Exception that is thrown if the Picture is indexed out of Bounds
class IndexOutOfBoundsException : public std::exception {
public:
IndexOutOfBoundsException(int width, int height,
int given_width, int given_height);
~IndexOutOfBoundsException() throw();
virtual const char* what() throw();
private:
std::string message;
};
*/
public:
Picture();
Picture(int width, int height);
~Picture();
/**
* @return A pixel struct representing the pixel at x,y
*/
virtual Pixel getPixel(int x, int y)=0;
/**
* Set the value of a pixel at x,y to be the given pixel pix.
*/
virtual void setPixel(int x, int y, Pixel pix)=0;
/**
* Display the picture on the screen.
*/
virtual void show()=0;
/**
* Get a pointer to the underlying memory representing the
* image.
*/
unsigned char * getRawImage();
/**
* Get a "clone" of this picture. A clone is also a copy.
* If you'd like another copy of this picture use this function.
*
*
* Example:
* Picture* pic = robot.takePicture("color");
* Picture* pic2 = pic->clone();
*
* From this you'll have two "copies" of the same picture, so you're
* free to change around "pic" without worry of changing "pic2"
*
* @return A clone of this picture
*/
virtual Picture* clone() = 0;
int getHeight();
int getWidth();
/**
* Load an image from a filename, for now, only jpeg files are
* supported.
*
* @param filename The file to read from.
* @return True if load sucessful, false if fails (for wrong
* colorspace, etc.)
*/
virtual bool loadPicture(const char* filename)=0;
/**
* Save an image to a file, only jpeg files are supported.
* A .jpg will be appended to the given filename.
*
* @param filename The name of the file you save (without the .jpg
* file extention)
*/
virtual void savePicture(const char* filename)=0;
/**
* Static method to print out an error message when a user has
* gone out of bounds.
*/
static void out_of_bounds_error(int width, int height,
int given_width, int given_height);
protected:
unsigned char * image_data;
int width;
int height;
};
// functions added for lab 6 by Nick
int getWidth(Picture *p);
int getHeight(Picture *p);
void show(Picture *p);
Pixel getPixel(Picture *p, int x, int y);
int getPixelValue_grey(Picture *p, int x, int y);
void setPixel(Picture* p, int x, int y, Pixel pix);
void setPixelColor(Picture *p, int x, int y, int R, int G, int B);
Picture* clone(Picture* p);
/// Create a picture object from a saved image
Picture* loadPicture(const char* filename);
/// Load an image into the given Picture object
void loadPicture(Picture * p, const char* filename);
/// Save the Image to a file
void savePicture(Picture * p, const char* filename);
///@}
#endif
|