Craig Evans / Gamepad2

Library for ELEC2645 Gamepad PCB. University of Leeds Version 2 January 2020

Dependents:   ELEC2645_Ticker_WAV ELEC2645_Project_username ELEC2645_Project_el18vgt ELEC2645_Project_el17oc11 ... more

Bitmap.cpp@24:33639c2eacb3, 2020-01-31 (annotated)

Committer:
eencae
Date:
Fri Jan 31 10:49:11 2020 +0000
Revision:
24:33639c2eacb3
Parent:
21:da0b4e14c867 
Updated docs

Who changed what in which revision?

UserRevisionLine numberNew contents of line
eencae 21:da0b4e14c867 1 #include "Bitmap.h"
eencae 21:da0b4e14c867 2
eencae 21:da0b4e14c867 3 #include <iostream>
eencae 21:da0b4e14c867 4
eencae 21:da0b4e14c867 5 #include "N5110.h"
eencae 21:da0b4e14c867 6
eencae 21:da0b4e14c867 7 Bitmap::Bitmap(int const *contents,
eencae 21:da0b4e14c867 8 unsigned int const height,
eencae 21:da0b4e14c867 9 unsigned int const width)
eencae 21:da0b4e14c867 10 :
eencae 21:da0b4e14c867 11 _contents(std::vector<int>(height*width)),
eencae 21:da0b4e14c867 12 _height(height),
eencae 21:da0b4e14c867 13 _width(width)
eencae 21:da0b4e14c867 14 {
eencae 21:da0b4e14c867 15 // Perform a quick sanity check of the dimensions
eencae 21:da0b4e14c867 16 if (_contents.size() != height * width) {
eencae 21:da0b4e14c867 17 std::cerr << "Contents of bitmap has size " << _contents.size()
eencae 21:da0b4e14c867 18 << " pixels, but its dimensions were specified as "
eencae 21:da0b4e14c867 19 << width << " * " << height << " = " << width * height << std::endl;
eencae 21:da0b4e14c867 20 }
eencae 21:da0b4e14c867 21
eencae 21:da0b4e14c867 22 for(unsigned int i = 0; i < height*width; ++i) _contents[i] = contents[i];
eencae 21:da0b4e14c867 23 }
eencae 21:da0b4e14c867 24
eencae 21:da0b4e14c867 25 /**
eencae 21:da0b4e14c867 26 * @returns the value of the pixel at the given position
eencae 21:da0b4e14c867 27 */
eencae 21:da0b4e14c867 28 int Bitmap::get_pixel(unsigned int const row,
eencae 21:da0b4e14c867 29 unsigned int const column) const
eencae 21:da0b4e14c867 30 {
eencae 21:da0b4e14c867 31 // First check that row and column indices are within bounds
eencae 21:da0b4e14c867 32 if(column >= _width || row >= _height)
eencae 21:da0b4e14c867 33 {
eencae 21:da0b4e14c867 34 std::cerr << "The requested pixel with index " << row << "," << column
eencae 21:da0b4e14c867 35 << "is outside the bitmap dimensions: " << _width << ","
eencae 21:da0b4e14c867 36 << _height << std::endl;
eencae 21:da0b4e14c867 37 }
eencae 21:da0b4e14c867 38
eencae 21:da0b4e14c867 39 // Now return the pixel value, using row-major indexing
eencae 21:da0b4e14c867 40 return _contents[row * _width + column];
eencae 21:da0b4e14c867 41 }
eencae 21:da0b4e14c867 42
eencae 21:da0b4e14c867 43 /**
eencae 21:da0b4e14c867 44 * @brief Prints the contents of the bitmap to the terminal
eencae 21:da0b4e14c867 45 */
eencae 21:da0b4e14c867 46 void Bitmap::print() const
eencae 21:da0b4e14c867 47 {
eencae 21:da0b4e14c867 48 for (unsigned int row = 0; row < _height; ++row)
eencae 21:da0b4e14c867 49 {
eencae 21:da0b4e14c867 50 // Print each element of the row
eencae 21:da0b4e14c867 51 for (unsigned int column = 0; column < _width; ++column)
eencae 21:da0b4e14c867 52 {
eencae 21:da0b4e14c867 53 int pixel = get_pixel(row, column);
eencae 21:da0b4e14c867 54 std::cout << pixel;
eencae 21:da0b4e14c867 55 }
eencae 21:da0b4e14c867 56
eencae 21:da0b4e14c867 57 // And then terminate with a new-line character
eencae 21:da0b4e14c867 58 std::cout << std::endl;
eencae 21:da0b4e14c867 59 }
eencae 21:da0b4e14c867 60 }
eencae 21:da0b4e14c867 61
eencae 21:da0b4e14c867 62 /**
eencae 21:da0b4e14c867 63 * @brief Renders the contents of the bitmap onto an N5110 screen
eencae 21:da0b4e14c867 64 *
eencae 21:da0b4e14c867 65 * @param[in] lcd The screen to use for rendering
eencae 21:da0b4e14c867 66 * @param[in] x0 The horizontal position in pixels at which to render the bitmap
eencae 21:da0b4e14c867 67 * @param[in] y0 The vertical position in pixels at which to render the bitmap
eencae 21:da0b4e14c867 68 *
eencae 21:da0b4e14c867 69 * @details Note that x0, y0 gives the location of the top-left of the bitmap on
eencae 21:da0b4e14c867 70 * the screen.
eencae 21:da0b4e14c867 71 * This function only updates the buffer on the screen. You still need
eencae 21:da0b4e14c867 72 * to refresh the screen in order to actually see the bitmap.
eencae 21:da0b4e14c867 73 */
eencae 21:da0b4e14c867 74 void Bitmap::render(N5110 &lcd,
eencae 21:da0b4e14c867 75 unsigned int const x0,
eencae 21:da0b4e14c867 76 unsigned int const y0) const
eencae 21:da0b4e14c867 77 {
eencae 21:da0b4e14c867 78 // Loop through each row of the bitmap image
eencae 21:da0b4e14c867 79 for (unsigned int bitmap_row = 0; bitmap_row < _height; ++bitmap_row)
eencae 21:da0b4e14c867 80 {
eencae 21:da0b4e14c867 81 // Row index on the screen for rendering the row of pixels
eencae 21:da0b4e14c867 82 unsigned int screen_row = y0 + bitmap_row;
eencae 21:da0b4e14c867 83
eencae 21:da0b4e14c867 84 // Render each pixel in the row
eencae 21:da0b4e14c867 85 for (unsigned int bitmap_col = 0; bitmap_col < _width; ++bitmap_col)
eencae 21:da0b4e14c867 86 {
eencae 21:da0b4e14c867 87 // Column index on the screen for rendering this pixel
eencae 21:da0b4e14c867 88 int screen_col = x0 + bitmap_col;
eencae 21:da0b4e14c867 89
eencae 21:da0b4e14c867 90 // Find the required value of the pixel at the given location within
eencae 21:da0b4e14c867 91 // the bitmap data and then write it to the LCD screen
eencae 21:da0b4e14c867 92 int pixel = get_pixel(bitmap_row, bitmap_col);
eencae 21:da0b4e14c867 93 lcd.setPixel(screen_col, screen_row, pixel);
eencae 21:da0b4e14c867 94 }
eencae 21:da0b4e14c867 95 }
eencae 21:da0b4e14c867 96 }