ELEC2645 (2018/19) / Mbed 2 deprecated el17m2h_public

Dependencies:   mbed

Doodler/Doodler.h

Committer:
el17m2h
Date:
2019-05-08
Revision:
29:15e9640646b7
Parent:
26:d16a5b1e0ace
Child:
32:83f410c433c2

File content as of revision 29:15e9640646b7:

#ifndef DOODLER_H
#define DOODLER_H

#include "mbed.h"
#include "N5110.h"
#include "Gamepad.h"

/** Doodler's class
@brief Class for the doodler
@author Melissa Hartmann
@date May 2019
*/
class Doodler
{
public:
    Doodler();
    ~Doodler();
    /**
    @brief Defines the initial position of the doodler
    @param float position_x uses float since the velocity will be added, which is not an integer.
    @param float position_y uses float since the velocity will be added, which is not an integer.
    @param double velocity_y needs to be double in order for it to decelerate to a small value that
    approaches zero.
    @details The intial position of the doodler is at the centre of the screen and the values are
    gotten from the Engine class. It also defines the gravity as a positive vale greater than 1
    and the up object as a negative vale less than 1.
    */
    void init(float position_x, float position_y, double velocity_y);

    /**
    @brief Prints the doodler into the LCD screen
    @param N5110 &lcd
    @details The function draws a sprite of 13 x 15 bits that shows the image of the doodler
    */
    void draw(N5110 &lcd);

    /**
    @brief Updates the position of the doodler
    @param Direction d is gotten from the user input of the joystick and determines the movement of
    the doodler in the x-direction. It moves left/right if the joystick directs left/right at an angle
    or not.
    @param float mag is used to accelerate the movement of the doodler in the x-direction since it
    moves 5 frames * the magnitude of the joystick.
    @details The function checks the doodler does not leave the screen rectangle (30 x 83) in the
    x-direction and checks the direction of the velocity to keep adding or substructing a value in
    the y-direction (depending on if it is jumping or falling)
    */
    void update(Direction d, float mag);

    /**
    @brief Function to check the doodler's y-coodinate velocity
    @details The function checks the current velocity of the doodler and depending on its direction
    (positive or negative) it will decide if the doodler's updated velocity will remain the same or
    change direction (jump). If the velocity is positive, it means it is currently jumping, so it
    should continue doing so but in a decreasing velocity (decelerating), which is why it is
    multiplied times the _up constant (value less than 1). If the velocity is negative it means
    it is falling downwards and increasing in velocity (accelerating). This is done by multiplying the
    current velocity by the gravity constant value (greater than 1). Finally, if the velocity is 0, it
    means it has completely decelerated upwards and so it should begin to fall. To do so, the velocity
    is given the value of gravity (which is a positive value).
    */
    void check_velocity();

    /**
    @brief Returns the current doodler's velocity in the x-axis
    @details Gets the current value in the doodler's class for the doodler's velocity in the x-axis
    */
    float get_velocity_x();

    /**
    @brief Returns the current doodler's velocity in the y-axis
    @details Gets the current value in the doodler's class for the doodler's velocity in the y-axis. It is a
    double value since the y-velocity is a double type.
    */
    double get_velocity_y();

    /**
    @brief Returns the current doodler's position in the x-axis
    @details Gets the current value in the doodler's class for the doodler's position in the x-axis
    */
    float get_position_x();

    /**
    @brief Returns the current doodler's position in the y-axis
    @details Gets the current value in the doodler's class for the doodler's position in the y-axis
    */
    float get_position_y();

    /**
    @brief Sets the doodler's velocity in the Doodler's class to equal the inputed parameters
    @param float vel_x
    @param float vel_y
    @details The function sets the doodler's velocity in the doodler's class by making the current
    velocity equal to the inputed parameters
    */
    void set_velocity(float vel_x, double vel_y);

    /**
    @brief Sets the doodler's position in the Doodler's class to equal the inputed parameters
    @param float pos_x
    @param float pos_y
    @details The function sets the doodler's position in the doodler's class by making the current
    position equal the inputed parameters
    */
    void set_position(float pos_x, float pos_y);

private:
    float _position_x;
    float _position_y;
    float _velocity_x;
    double _velocity_y;
    double _gravity;
    double _up;
};
#endif