From 7ed23d0c13593ff06631afebdc0b018b899d3c7b Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Wed, 20 Sep 2023 21:17:38 +0200
Subject: [PATCH 01/31] Added sceleton for Sound functionality

---
 res/Sounds/tank_shot.flac | Bin 0 -> 83742 bytes
 src/Sound.cpp             |   0
 src/Sound.hpp             |   0
 3 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 res/Sounds/tank_shot.flac
 create mode 100644 src/Sound.cpp
 create mode 100644 src/Sound.hpp

diff --git a/res/Sounds/tank_shot.flac b/res/Sounds/tank_shot.flac
new file mode 100644
index 0000000000000000000000000000000000000000..1848a00c0fd63f98a106707e9fe16148b50801c5
GIT binary patch
literal 83742
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

literal 0
HcmV?d00001

diff --git a/src/Sound.cpp b/src/Sound.cpp
new file mode 100644
index 0000000..e69de29
diff --git a/src/Sound.hpp b/src/Sound.hpp
new file mode 100644
index 0000000..e69de29

From 70598c566e2f3f3cb48f4a100d190eaf6208b533 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 21 Sep 2023 16:59:18 +0200
Subject: [PATCH 02/31] adapted CMakeLists.txt to sound functionality

---
 CMakeLists.txt | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 45d4e7e..3d18c41 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -48,7 +48,8 @@ add_library(
   src/TracesHandler.cpp
   src/Trace.cpp
   src/Players/DummyPlayer.cpp
-  src/Players/KeyboardPlayer.cpp)
+  src/Players/KeyboardPlayer.cpp
+  src/Sound.cpp)
 
 target_include_directories(tank_bot_fight_lib PRIVATE src)
 
@@ -66,13 +67,13 @@ target_include_directories(tank_bot_fight PRIVATE src)
 
 find_package(
   SFML 2.5.1
-  COMPONENTS graphics
+  COMPONENTS graphics audio
   REQUIRED)
 find_package(range-v3 REQUIRED)
 find_package(Microsoft.GSL CONFIG REQUIRED)
 
 target_link_libraries(tank_bot_fight_lib PUBLIC sfml-graphics ${EXTRA_LIBS}
                                                 Microsoft.GSL::GSL)
-target_link_libraries(tank_bot_fight PRIVATE tank_bot_fight_lib sfml-graphics)
+target_link_libraries(tank_bot_fight PRIVATE tank_bot_fight_lib sfml-graphics sfml-audio)
 
 add_subdirectory(test)

From 9a26461f9ba96f76c9b9616358c335ab504bee14 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 21 Sep 2023 18:40:43 +0200
Subject: [PATCH 03/31] Implemented class Sound

---
 src/Sound.cpp | 21 +++++++++++++++++++++
 src/Sound.hpp | 26 ++++++++++++++++++++++++++
 2 files changed, 47 insertions(+)

diff --git a/src/Sound.cpp b/src/Sound.cpp
index e69de29..a0a5864 100644
--- a/src/Sound.cpp
+++ b/src/Sound.cpp
@@ -0,0 +1,21 @@
+#include "Sound.hpp"
+
+Sound::Sound(std::string file_name) {
+  if (load_from_file(file_name)) {
+    set_buffer();
+  }
+}
+
+Sound::~Sound() {
+  // nothing to do here
+}
+
+void Sound::play() { mSound.play(); }
+
+bool Sound::load_from_file(std::string file_name) {
+  std::string path_to_file = files::asset_path() + "/res/Sound/" + file_name;
+
+  return mBuffer.loadFromFile(path_to_file);
+}
+
+void Sound::set_buffer() { mSound.setBuffer(mBuffer); }
diff --git a/src/Sound.hpp b/src/Sound.hpp
index e69de29..7bc6139 100644
--- a/src/Sound.hpp
+++ b/src/Sound.hpp
@@ -0,0 +1,26 @@
+#pragma once
+#include <SFML/Audio.hpp>
+#include <string>
+
+#include "Files.hpp"
+
+class Sound {
+ private:
+  // sound data is not stored directly in sf::Sound, it is stored in sf::SoundBuffer
+  sf::SoundBuffer mBuffer;
+
+  // load Sound from file (it can be loaded from memory, stream, array of samples, which are 16 bit
+  // integers with sign) MP3 is not supproted due to licensing
+  std::string mPath;
+
+  // to play a sound, sf::Sound instance is needed.
+  sf::Sound mSound;
+
+  bool load_from_file(std::string file_name);
+  void set_buffer();
+
+ public:
+  void play();
+  Sound(std::string path_to_file);
+  ~Sound();
+};

From 0539b3c041065d0b33671152132a5ad65b6f5a24 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Wed, 27 Sep 2023 21:53:09 +0200
Subject: [PATCH 04/31] Implemented tank shot sound

---
 src/Board.cpp            |  5 +++--
 src/Sound.cpp            | 18 +++++++++++++++++-
 src/Sound.hpp            | 13 +++++++++----
 src/Tank/Tank.cpp        | 13 ++++++++-----
 src/Tank/Tank.hpp        |  3 ++-
 src/Tank/TankFactory.cpp |  6 ++++--
 src/Tank/TankFactory.hpp |  4 +++-
 src/Tank/TankTower.cpp   |  6 +++++-
 src/Tank/TankTower.hpp   |  7 +++++--
 src/TankFactory.cpp      |  2 +-
 src/TankFactory.hpp      |  2 +-
 test/CMakeLists.txt      |  1 +
 test/TankTests.cpp       |  4 +++-
 test/TankTowerTests.cpp  |  6 ++++--
 14 files changed, 66 insertions(+), 24 deletions(-)

diff --git a/src/Board.cpp b/src/Board.cpp
index c690121..a716cd0 100644
--- a/src/Board.cpp
+++ b/src/Board.cpp
@@ -16,11 +16,12 @@ Board::Board() : mWindow(sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"), mBackgro
   constexpr float TANK_Y = 50.f;
   constexpr float TANK2_X = WIDTH / 2.0f;
   constexpr float TANK2_Y = 400.0f;
+  Sound tank_shot_sound("tank_shot.flac");
   mWindow.setFramerateLimit(30);
   mKeyboardPlayer =
-      std::make_unique<KeyboardPlayer>(*this, TankFactory::Random(mStore, TANK_X, TANK_Y));
+      std::make_unique<KeyboardPlayer>(*this, TankFactory::Random(mStore, TANK_X, TANK_Y, tank_shot_sound));
   mDummyPlayer =
-      std::make_unique<DummyPlayer>(*this, TankFactory::Random(mStore, TANK2_X, TANK2_Y));
+      std::make_unique<DummyPlayer>(*this, TankFactory::Random(mStore, TANK2_X, TANK2_Y, tank_shot_sound));
   mFont.loadFromFile(files::asset_path() + "DejaVuSans.ttf");
   mText.setFont(mFont);
 }
diff --git a/src/Sound.cpp b/src/Sound.cpp
index a0a5864..4f83411 100644
--- a/src/Sound.cpp
+++ b/src/Sound.cpp
@@ -1,11 +1,27 @@
 #include "Sound.hpp"
 
+Sound::Sound() { /* empty */ }
+
+Sound::Sound(const Sound& sound){
+  mBuffer = sound.mBuffer;
+  mSound = sound.mSound;
+  set_buffer();
+}
+
 Sound::Sound(std::string file_name) {
   if (load_from_file(file_name)) {
     set_buffer();
   }
 }
 
+Sound& Sound::operator=(const Sound& sound)
+{
+  mBuffer = sound.mBuffer;
+  mSound = sound.mSound;
+  set_buffer();
+  return *this;
+}
+
 Sound::~Sound() {
   // nothing to do here
 }
@@ -13,7 +29,7 @@ Sound::~Sound() {
 void Sound::play() { mSound.play(); }
 
 bool Sound::load_from_file(std::string file_name) {
-  std::string path_to_file = files::asset_path() + "/res/Sound/" + file_name;
+  std::string path_to_file = files::asset_path() + "Sounds/" + file_name;
 
   return mBuffer.loadFromFile(path_to_file);
 }
diff --git a/src/Sound.hpp b/src/Sound.hpp
index 7bc6139..d641041 100644
--- a/src/Sound.hpp
+++ b/src/Sound.hpp
@@ -16,11 +16,16 @@ class Sound {
   // to play a sound, sf::Sound instance is needed.
   sf::Sound mSound;
 
-  bool load_from_file(std::string file_name);
-  void set_buffer();
 
  public:
-  void play();
-  Sound(std::string path_to_file);
+  Sound();
+  Sound(const Sound& sound);
+  Sound& operator=(const Sound& sound);
+  
+  Sound(std::string file_name);
   ~Sound();
+  void play();
+  bool load_from_file(std::string file_name);
+  void set_buffer();
+
 };
diff --git a/src/Tank/Tank.cpp b/src/Tank/Tank.cpp
index 1cc5103..3c7dbb8 100644
--- a/src/Tank/Tank.cpp
+++ b/src/Tank/Tank.cpp
@@ -9,14 +9,17 @@
 constexpr int TANK_INITIAL_ROTATION = 180;
 
 Tank::Tank(float x, float y, const TankTextures &textures, std::unique_ptr<Engine> &&engine,
-           const TracesHandlerConfig &traces_handler_config,
+          Sound shot_sound, const TracesHandlerConfig &traces_handler_config,
            const std::chrono::milliseconds &shot_cooldown)
     : mPos({x, y}),
       mBody(textures.mBody),
-      mTower(TankTowerTextures{.mTower = textures.mTower,
-                               .mShotAnimation = textures.mShot,
-                               .mMissile = textures.mMissile},
-             shot_cooldown),
+      mTower(
+          TankTowerTextures{
+              .mTower = textures.mTower,
+              .mShotAnimation = textures.mShot,
+              .mMissile = textures.mMissile},
+          shot_cooldown,
+          shot_sound),
       mEngine(std::move(engine)),
       mTracesHandler(std::make_unique<TracesHandler>(textures.mTracks, mBody.get_sprite(), mPos,
                                                      traces_handler_config)) {
diff --git a/src/Tank/Tank.hpp b/src/Tank/Tank.hpp
index 39d80be..a43eb9f 100644
--- a/src/Tank/Tank.hpp
+++ b/src/Tank/Tank.hpp
@@ -12,6 +12,7 @@
 #include "Tank/TankPart.hpp"
 #include "Tank/TankTower.hpp"
 #include "TracesHandler.hpp"
+#include "Sound.hpp"
 
 struct TankTextures {
   std::reference_wrapper<sf::Texture> mBody;
@@ -24,6 +25,7 @@ struct TankTextures {
 class Tank {
  public:
   Tank(float x, float y, const TankTextures& textures, std::unique_ptr<Engine>&& engine,
+        Sound shot_sound,
        const TracesHandlerConfig& traces_handler_config = {},
        const std::chrono::milliseconds& shot_cooldown = std::chrono::milliseconds{500});
   Tank(const Tank& rhs);
@@ -49,7 +51,6 @@ class Tank {
  private:
   void draw_tracks(sf::RenderWindow& window);
   void update_position();
-
   sf::Vector2f mPos;
   float mCurrentSpeed = 0.0f;
 
diff --git a/src/Tank/TankFactory.cpp b/src/Tank/TankFactory.cpp
index d3a8b87..43a211f 100644
--- a/src/Tank/TankFactory.cpp
+++ b/src/Tank/TankFactory.cpp
@@ -4,8 +4,9 @@
 #include "SquareRootEngine.hpp"
 #include "Tank/Tank.hpp"
 #include "TextureStore.hpp"
+#include "Sound.hpp"
 
-std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, const float y) {
+std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, const float y,  Sound shot_sound) {
   using namespace std::string_literals;
   const sf::IntRect TRACKS_TEXTURE_RECT = {0, 0, 37, 48};
   auto& body_texture = store.get_texture(one_of("tankBody_red.png"s, "tankBody_dark.png"s,
@@ -30,6 +31,7 @@ std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, co
                                              .mTracks = tracks_texture,
                                              .mMissile = missile_texture},
                                 std::make_unique<SquareRootEngine>(
-                                    SquareRootEngineConfig{.mStepCount = 70, .mMaxSpeed = 5.f}),
+                                SquareRootEngineConfig{.mStepCount = 70, .mMaxSpeed = 5.f}),
+                                shot_sound,
                                 TracesHandlerConfig{.mMaxTraceAge = 50, .mDecayRate = 0.1f});
 }
diff --git a/src/Tank/TankFactory.hpp b/src/Tank/TankFactory.hpp
index aa2ac15..eac4efc 100644
--- a/src/Tank/TankFactory.hpp
+++ b/src/Tank/TankFactory.hpp
@@ -3,7 +3,9 @@
 
 class TextureStore;
 class Tank;
+class Sound;
+
 class TankFactory {
  public:
-  [[nodiscard]] static std::unique_ptr<Tank> Random(TextureStore& store, float x, float y);
+  [[nodiscard]] static std::unique_ptr<Tank> Random(TextureStore& store, float x, float y,  Sound shot_sound);
 };
diff --git a/src/Tank/TankTower.cpp b/src/Tank/TankTower.cpp
index e882e8a..2317f15 100644
--- a/src/Tank/TankTower.cpp
+++ b/src/Tank/TankTower.cpp
@@ -10,10 +10,12 @@ constexpr std::chrono::milliseconds SHOT_ANIMATION_DURATION = std::chrono::milli
 constexpr auto SHOT_COOLDOWN = std::chrono::milliseconds{500};
 
 TankTower::TankTower(const TankTowerTextures& textures,
-                     const std::chrono::milliseconds& shot_cooldown)
+                     const std::chrono::milliseconds& shot_cooldown,
+                     Sound shot_sound)
     : mTower(textures.mTower),
       mShotAnimation(textures.mShotAnimation),
       mMissileTexture(textures.mMissile),
+      mShotSound(shot_sound),
       mShotCooldown(shot_cooldown) {}
 
 void TankTower::set_position(const sf::Vector2f& pos) {
@@ -63,11 +65,13 @@ void TankTower::update_shot_time() {
 }
 
 std::optional<Missle> TankTower::shoot() {
+  
   auto now = std::chrono::system_clock::now();
   auto elapsed = std::chrono::duration_cast<std::chrono::milliseconds>(now - mLastShot);
   if (elapsed >= mShotCooldown) {
     mLastShot = std::chrono::system_clock::now();
     mDrawShot = true;
+    mShotSound.play();
     const auto& [x, y] = calculate_shot_position();
     return std::make_optional<Missle>(
         mMissileTexture, MovementState{.mX = x, .mY = y, .mAngle = mTower.get_rotation()});
diff --git a/src/Tank/TankTower.hpp b/src/Tank/TankTower.hpp
index 03be931..e6d5fde 100644
--- a/src/Tank/TankTower.hpp
+++ b/src/Tank/TankTower.hpp
@@ -5,6 +5,7 @@
 
 #include "Missle.hpp"
 #include "SFML/Graphics.hpp"
+#include "Sound.hpp"
 #include "Tank/TankPart.hpp"
 
 struct TankTowerTextures {
@@ -15,7 +16,7 @@ struct TankTowerTextures {
 
 class TankTower {
  public:
-  TankTower(const TankTowerTextures& textures, const std::chrono::milliseconds& shot_cooldown);
+  TankTower(const TankTowerTextures& textures, const std::chrono::milliseconds& shot_cooldown, Sound shot_sound);
 
   void set_position(const sf::Vector2f& pos);
   void set_rotation(float angle);
@@ -27,12 +28,14 @@ class TankTower {
   [[nodiscard]] std::optional<Missle> shoot();
   [[nodiscard]] float get_rotation() const;
 
+  
  private:
   sf::Vector2f calculate_shot_position() const;
   void update_shot_time();
 
   TankPart mTower;
-  TankPart mShotAnimation;
+  TankPart mShotAnimation;  
+  Sound mShotSound;
   std::reference_wrapper<sf::Texture> mMissileTexture;
   std::chrono::time_point<std::chrono::system_clock> mLastShot;
   std::chrono::milliseconds mShotCooldown;
diff --git a/src/TankFactory.cpp b/src/TankFactory.cpp
index 81e3c4e..beb8799 100644
--- a/src/TankFactory.cpp
+++ b/src/TankFactory.cpp
@@ -3,7 +3,7 @@
 #include "Random.hpp"
 #include "SquareRootEngine.hpp"
 
-Tank TankFactory::Random(TextureStore& store, float x, float y) {
+Tank TankFactory::Random(TextureStore& store, float x, float y, Sound& shot_sound) {
   using namespace std::string_literals;
   const sf::IntRect TRACKS_TEXTURE_RECT = {0, 0, 37, 48};
   constexpr int STEP_COUNT = 70;
diff --git a/src/TankFactory.hpp b/src/TankFactory.hpp
index 433279a..7034a00 100644
--- a/src/TankFactory.hpp
+++ b/src/TankFactory.hpp
@@ -4,5 +4,5 @@
 
 class TankFactory {
  public:
-  static Tank Random(TextureStore& store, float x, float y);
+  static Tank Random(TextureStore& store, float x, float y, Sound& shot_sound);
 };
\ No newline at end of file
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
index 7048222..217b12e 100644
--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -39,6 +39,7 @@ target_link_libraries(
   sfml-graphics
   tank_bot_fight_lib
   range-v3::range-v3
+  sfml-audio
 )
 
 include(GoogleTest)
diff --git a/test/TankTests.cpp b/test/TankTests.cpp
index a73c6c4..357c06b 100644
--- a/test/TankTests.cpp
+++ b/test/TankTests.cpp
@@ -5,6 +5,7 @@
 
 #include "SquareRootEngine.hpp"
 #include "Tank/Tank.hpp"
+#include "Sound.hpp"
 #include "TestUtility.hpp"
 #include "TracesHandler.hpp"
 #include "gmock/gmock.h"
@@ -24,6 +25,7 @@ struct TankTestData {
   std::unique_ptr<sf::Texture> mShot{create_dummy_texture()};
   std::unique_ptr<sf::Texture> mTracks{create_dummy_texture()};
   std::unique_ptr<sf::Texture> mMissile{create_dummy_texture()};
+  Sound emptySound;
   TankTextures mTextures{.mBody = *mBody,
                          .mTower = *mTower,
                          .mShot = *mShot,
@@ -35,7 +37,7 @@ struct TankTestData {
       std::shared_ptr<testing::NiceMock<EngineMock>>{}, mEngine.get()};
 
   Tank create_tank(std::unique_ptr<testing::NiceMock<EngineMock>>&& engine) {
-    return {0, 0, mTextures, std::move(engine),
+    return {0, 0, mTextures, std::move(engine), emptySound,
             TracesHandlerConfig{.mMaxTraceAge = 10, .mDecayRate = 0.1f}};
   }
 };
diff --git a/test/TankTowerTests.cpp b/test/TankTowerTests.cpp
index ad0e574..79da99d 100644
--- a/test/TankTowerTests.cpp
+++ b/test/TankTowerTests.cpp
@@ -2,6 +2,7 @@
 
 #include <memory>
 
+#include "Sound.hpp"
 #include "Tank/TankTower.hpp"
 #include "TestUtility.hpp"
 
@@ -12,17 +13,18 @@ class TankTowerTest : public ::testing::Test {
   std::unique_ptr<sf::Texture> mMissileTex{create_dummy_texture()};
   TankTowerTextures mTextures{
       .mTower = *mTowerTex, .mShotAnimation = *mShotTex, .mMissile = *mMissileTex};
+  Sound mShotSound{"tank_shot.flac"};
 };
 
 TEST_F(TankTowerTest, Given0MsCooldown_WhenShotCalled_ThenMissileIsAlwaysReturned) {
-  TankTower mTower{mTextures, std::chrono::milliseconds{0}};
+  TankTower mTower{mTextures, std::chrono::milliseconds{0}, mShotSound};
   EXPECT_TRUE(mTower.shoot());
   EXPECT_TRUE(mTower.shoot());
   EXPECT_TRUE(mTower.shoot());
 }
 
 TEST_F(TankTowerTest, GivenNonZeroCooldown_WhenShotCalled_ThenMissileIsNotAlwaysReturned) {
-  TankTower mTower{mTextures, std::chrono::milliseconds{500}};
+  TankTower mTower{mTextures, std::chrono::milliseconds{500}, mShotSound};
   EXPECT_TRUE(mTower.shoot());
   EXPECT_FALSE(mTower.shoot());
   EXPECT_FALSE(mTower.shoot());

From 492d8ead52541b234fca3d99a8e95c5ca1d7a04e Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Tue, 10 Oct 2023 19:43:01 +0200
Subject: [PATCH 05/31] removed tank_shot.flac

---
 res/Sounds/tank_shot.flac | Bin 83742 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 res/Sounds/tank_shot.flac

diff --git a/res/Sounds/tank_shot.flac b/res/Sounds/tank_shot.flac
deleted file mode 100644
index 1848a00c0fd63f98a106707e9fe16148b50801c5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 83742
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


From 6462307fc4b8e234fa7530f6ad1ca039ec1eb37c Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Tue, 10 Oct 2023 19:49:47 +0200
Subject: [PATCH 06/31] added Sounds to .gitattributes

---
 .gitattributes | 1 +
 Sound/notes.md | 5 +++++
 2 files changed, 6 insertions(+)
 create mode 100644 Sound/notes.md

diff --git a/.gitattributes b/.gitattributes
index cce9987..e26c5d1 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -381,3 +381,4 @@ res/PNG/Retina/specialBarrel7_outline.png filter=lfs diff=lfs merge=lfs -text
 res/Vector/topdownTanks_vector.svg filter=lfs diff=lfs merge=lfs -text
 res/Vector/topdownTanks_vector.swf filter=lfs diff=lfs merge=lfs -text
 res/DejaVuSans.ttf filter=lfs diff=lfs merge=lfs -text
+res/Sounds/tank_shot.flac filter=lfs merge=lfs -text
diff --git a/Sound/notes.md b/Sound/notes.md
new file mode 100644
index 0000000..62d714c
--- /dev/null
+++ b/Sound/notes.md
@@ -0,0 +1,5 @@
+SFML provides two classes for playing audio: sf::Sound and sf::Music. They both provide more or less the same features, the main difference is how they work. 
+
+sf::Sound is a lightweight object that plays loaded audio data from a sf::SoundBuffer. It should be used for small sounds that can fit in memory and should suffer no lag when they are played. Examples are gun shots, foot steps, etc. 
+
+sf::Music doesn't load all the audio data into memory, instead it streams it on the fly from the source file. It is typically used to play compressed music that lasts several minutes, and would otherwise take many seconds to load and eat hundreds of MB in memory.

From ab793671b496b2187d4bab91d63b5dba8ae87fd6 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Tue, 10 Oct 2023 21:27:00 +0200
Subject: [PATCH 07/31] corrections after review

---
 src/Sound.cpp            | 26 ++++++--------------------
 src/Sound.hpp            | 14 ++------------
 src/Tank/Tank.cpp        | 13 +++++--------
 src/Tank/Tank.hpp        |  5 ++---
 src/Tank/TankFactory.cpp |  7 ++++---
 src/Tank/TankFactory.hpp |  3 ++-
 src/Tank/TankTower.cpp   |  4 +---
 src/Tank/TankTower.hpp   |  6 +++---
 src/main.cpp             |  3 +++
 9 files changed, 28 insertions(+), 53 deletions(-)

diff --git a/src/Sound.cpp b/src/Sound.cpp
index 4f83411..617ac13 100644
--- a/src/Sound.cpp
+++ b/src/Sound.cpp
@@ -1,31 +1,19 @@
 #include "Sound.hpp"
 
-Sound::Sound() { /* empty */ }
-
-Sound::Sound(const Sound& sound){
+Sound::Sound(const Sound& sound) {
   mBuffer = sound.mBuffer;
   mSound = sound.mSound;
-  set_buffer();
+  mSound.setBuffer(mBuffer);
 }
 
-Sound::Sound(std::string file_name) {
+Sound::Sound(const std::string& file_name) {
   if (load_from_file(file_name)) {
-    set_buffer();
+    mSound.setBuffer(mBuffer);
+  } else {
+    throw std::runtime_error("couldn't load sound");
   }
 }
 
-Sound& Sound::operator=(const Sound& sound)
-{
-  mBuffer = sound.mBuffer;
-  mSound = sound.mSound;
-  set_buffer();
-  return *this;
-}
-
-Sound::~Sound() {
-  // nothing to do here
-}
-
 void Sound::play() { mSound.play(); }
 
 bool Sound::load_from_file(std::string file_name) {
@@ -33,5 +21,3 @@ bool Sound::load_from_file(std::string file_name) {
 
   return mBuffer.loadFromFile(path_to_file);
 }
-
-void Sound::set_buffer() { mSound.setBuffer(mBuffer); }
diff --git a/src/Sound.hpp b/src/Sound.hpp
index d641041..2707ff6 100644
--- a/src/Sound.hpp
+++ b/src/Sound.hpp
@@ -9,23 +9,13 @@ class Sound {
   // sound data is not stored directly in sf::Sound, it is stored in sf::SoundBuffer
   sf::SoundBuffer mBuffer;
 
-  // load Sound from file (it can be loaded from memory, stream, array of samples, which are 16 bit
-  // integers with sign) MP3 is not supproted due to licensing
-  std::string mPath;
-
   // to play a sound, sf::Sound instance is needed.
   sf::Sound mSound;
 
-
  public:
-  Sound();
   Sound(const Sound& sound);
-  Sound& operator=(const Sound& sound);
-  
-  Sound(std::string file_name);
-  ~Sound();
+
+  Sound(const std::string& file_name);
   void play();
   bool load_from_file(std::string file_name);
-  void set_buffer();
-
 };
diff --git a/src/Tank/Tank.cpp b/src/Tank/Tank.cpp
index 2b33042..c8c24cd 100644
--- a/src/Tank/Tank.cpp
+++ b/src/Tank/Tank.cpp
@@ -9,17 +9,14 @@
 constexpr int TANK_INITIAL_ROTATION = 180;
 
 Tank::Tank(float x, float y, const TankTextures &textures, std::unique_ptr<Engine> &&engine,
-          Sound shot_sound, const TracesHandlerConfig &traces_handler_config,
+           const Sound &shot_sound, const TracesHandlerConfig &traces_handler_config,
            const std::chrono::milliseconds &shot_cooldown)
     : mPos({x, y}),
       mBody(textures.mBody),
-      mTower(
-          TankTowerTextures{
-              .mTower = textures.mTower,
-              .mShotAnimation = textures.mShot,
-              .mMissile = textures.mMissile},
-          shot_cooldown,
-          shot_sound),
+      mTower(TankTowerTextures{.mTower = textures.mTower,
+                               .mShotAnimation = textures.mShot,
+                               .mMissile = textures.mMissile},
+             shot_cooldown, shot_sound),
       mEngine(std::move(engine)),
       mTracesHandler(std::make_unique<TracesHandler>(textures.mTracks, mBody.get_sprite(), mPos,
                                                      traces_handler_config)) {
diff --git a/src/Tank/Tank.hpp b/src/Tank/Tank.hpp
index 1b02bed..4873faf 100644
--- a/src/Tank/Tank.hpp
+++ b/src/Tank/Tank.hpp
@@ -9,11 +9,11 @@
 
 #include "Engine.hpp"
 #include "Missle.hpp"
+#include "Sound.hpp"
 #include "Tank/TankHealthBar.hpp"
 #include "Tank/TankPart.hpp"
 #include "Tank/TankTower.hpp"
 #include "TracesHandler.hpp"
-#include "Sound.hpp"
 
 constexpr int TANK_HEALTH = 100;
 
@@ -28,8 +28,7 @@ struct TankTextures {
 class Tank {
  public:
   Tank(float x, float y, const TankTextures& textures, std::unique_ptr<Engine>&& engine,
-        Sound shot_sound,
-       const TracesHandlerConfig& traces_handler_config = {},
+       const Sound& shot_sound, const TracesHandlerConfig& traces_handler_config = {},
        const std::chrono::milliseconds& shot_cooldown = std::chrono::milliseconds{500});
   Tank(const Tank& rhs);
   Tank(Tank&& rhs) noexcept;
diff --git a/src/Tank/TankFactory.cpp b/src/Tank/TankFactory.cpp
index 43a211f..91086d4 100644
--- a/src/Tank/TankFactory.cpp
+++ b/src/Tank/TankFactory.cpp
@@ -1,12 +1,13 @@
 #include "TankFactory.hpp"
 
 #include "Random.hpp"
+#include "Sound.hpp"
 #include "SquareRootEngine.hpp"
 #include "Tank/Tank.hpp"
 #include "TextureStore.hpp"
-#include "Sound.hpp"
 
-std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, const float y,  Sound shot_sound) {
+std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, const float y,
+                                          const Sound& shot_sound) {
   using namespace std::string_literals;
   const sf::IntRect TRACKS_TEXTURE_RECT = {0, 0, 37, 48};
   auto& body_texture = store.get_texture(one_of("tankBody_red.png"s, "tankBody_dark.png"s,
@@ -31,7 +32,7 @@ std::unique_ptr<Tank> TankFactory::Random(TextureStore& store, const float x, co
                                              .mTracks = tracks_texture,
                                              .mMissile = missile_texture},
                                 std::make_unique<SquareRootEngine>(
-                                SquareRootEngineConfig{.mStepCount = 70, .mMaxSpeed = 5.f}),
+                                    SquareRootEngineConfig{.mStepCount = 70, .mMaxSpeed = 5.f}),
                                 shot_sound,
                                 TracesHandlerConfig{.mMaxTraceAge = 50, .mDecayRate = 0.1f});
 }
diff --git a/src/Tank/TankFactory.hpp b/src/Tank/TankFactory.hpp
index eac4efc..e3b7635 100644
--- a/src/Tank/TankFactory.hpp
+++ b/src/Tank/TankFactory.hpp
@@ -7,5 +7,6 @@ class Sound;
 
 class TankFactory {
  public:
-  [[nodiscard]] static std::unique_ptr<Tank> Random(TextureStore& store, float x, float y,  Sound shot_sound);
+  [[nodiscard]] static std::unique_ptr<Tank> Random(TextureStore& store, float x, float y,
+                                                    const Sound& shot_sound);
 };
diff --git a/src/Tank/TankTower.cpp b/src/Tank/TankTower.cpp
index 6cc083f..cc27301 100644
--- a/src/Tank/TankTower.cpp
+++ b/src/Tank/TankTower.cpp
@@ -11,8 +11,7 @@ constexpr auto SHOT_COOLDOWN = std::chrono::milliseconds{500};
 constexpr unsigned int MISSLE_DAMAGE = 20;
 
 TankTower::TankTower(const TankTowerTextures& textures,
-                     const std::chrono::milliseconds& shot_cooldown,
-                     Sound shot_sound)
+                     const std::chrono::milliseconds& shot_cooldown, const Sound& shot_sound)
     : mTower(textures.mTower),
       mShotAnimation(textures.mShotAnimation),
       mMissileTexture(textures.mMissile),
@@ -66,7 +65,6 @@ void TankTower::update_shot_time() {
 }
 
 std::optional<Missle> TankTower::shoot() {
-  
   auto now = std::chrono::system_clock::now();
   auto elapsed = std::chrono::duration_cast<std::chrono::milliseconds>(now - mLastShot);
   if (elapsed >= mShotCooldown) {
diff --git a/src/Tank/TankTower.hpp b/src/Tank/TankTower.hpp
index e6d5fde..a10ff09 100644
--- a/src/Tank/TankTower.hpp
+++ b/src/Tank/TankTower.hpp
@@ -16,7 +16,8 @@ struct TankTowerTextures {
 
 class TankTower {
  public:
-  TankTower(const TankTowerTextures& textures, const std::chrono::milliseconds& shot_cooldown, Sound shot_sound);
+  TankTower(const TankTowerTextures& textures, const std::chrono::milliseconds& shot_cooldown,
+            const Sound& shot_sound);
 
   void set_position(const sf::Vector2f& pos);
   void set_rotation(float angle);
@@ -28,13 +29,12 @@ class TankTower {
   [[nodiscard]] std::optional<Missle> shoot();
   [[nodiscard]] float get_rotation() const;
 
-  
  private:
   sf::Vector2f calculate_shot_position() const;
   void update_shot_time();
 
   TankPart mTower;
-  TankPart mShotAnimation;  
+  TankPart mShotAnimation;
   Sound mShotSound;
   std::reference_wrapper<sf::Texture> mMissileTexture;
   std::chrono::time_point<std::chrono::system_clock> mLastShot;
diff --git a/src/main.cpp b/src/main.cpp
index c651d5a..f0f8fce 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -1,6 +1,9 @@
+#include <iostream>
+
 #include "Board.hpp"
 
 int main() {
+  std::cout << "t24\n";
   Board b;
   b.run();
   return 0;

From 436776482f2fa71a44a63b5df51d640a9163021c Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 12 Oct 2023 16:51:27 +0200
Subject: [PATCH 08/31] added res/Sounds/

---
 res/Sounds/tank_shot.flac | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 res/Sounds/tank_shot.flac

diff --git a/res/Sounds/tank_shot.flac b/res/Sounds/tank_shot.flac
new file mode 100644
index 0000000..5405716
--- /dev/null
+++ b/res/Sounds/tank_shot.flac
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b8e3647c1d893e8442be08ed05fa9736fda1b41d7ccbca0451232b1a5d2e4047
+size 83742

From 34379e65404dd5e3146ef796d6a257b242530c34 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 12 Oct 2023 17:05:41 +0200
Subject: [PATCH 09/31] Removed notes.md - these were supposed to be my local
 notes

---
 Sound/notes.md | 5 -----
 1 file changed, 5 deletions(-)
 delete mode 100644 Sound/notes.md

diff --git a/Sound/notes.md b/Sound/notes.md
deleted file mode 100644
index 62d714c..0000000
--- a/Sound/notes.md
+++ /dev/null
@@ -1,5 +0,0 @@
-SFML provides two classes for playing audio: sf::Sound and sf::Music. They both provide more or less the same features, the main difference is how they work. 
-
-sf::Sound is a lightweight object that plays loaded audio data from a sf::SoundBuffer. It should be used for small sounds that can fit in memory and should suffer no lag when they are played. Examples are gun shots, foot steps, etc. 
-
-sf::Music doesn't load all the audio data into memory, instead it streams it on the fly from the source file. It is typically used to play compressed music that lasts several minutes, and would otherwise take many seconds to load and eat hundreds of MB in memory.

From f74ae4af26ab339110339e863ed5cd46e8a556d3 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <107147109+bartez33a@users.noreply.github.com>
Date: Thu, 12 Oct 2023 17:27:24 +0200
Subject: [PATCH 10/31] Delete res/Sounds/tank_shot.flac

deleted tank_shot.flac. It should be added via git-lfs
---
 res/Sounds/tank_shot.flac | Bin 83742 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 res/Sounds/tank_shot.flac

diff --git a/res/Sounds/tank_shot.flac b/res/Sounds/tank_shot.flac
deleted file mode 100644
index 1848a00c0fd63f98a106707e9fe16148b50801c5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 83742
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


From 9de4aa88fe01c8fbc88575a933c88d6cab7119c5 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 12 Oct 2023 17:29:07 +0200
Subject: [PATCH 11/31] added default ctor to Sound class to make possible
 compilation of test

---
 src/Sound.hpp | 2 ++
 src/main.cpp  | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Sound.hpp b/src/Sound.hpp
index 2707ff6..df26749 100644
--- a/src/Sound.hpp
+++ b/src/Sound.hpp
@@ -13,6 +13,8 @@ class Sound {
   sf::Sound mSound;
 
  public:
+  // default constructor is needed for testing
+  Sound() = default;
   Sound(const Sound& sound);
 
   Sound(const std::string& file_name);
diff --git a/src/main.cpp b/src/main.cpp
index f0f8fce..7fe506c 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -3,7 +3,7 @@
 #include "Board.hpp"
 
 int main() {
-  std::cout << "t24\n";
+  std::cout << "t245\n";
   Board b;
   b.run();
   return 0;

From b3507c5e4acffbb5e504d3f2156e5327e6ee0993 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 12 Oct 2023 17:39:31 +0200
Subject: [PATCH 12/31] corrected formatting in Board.cpp

---
 src/Board.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Board.cpp b/src/Board.cpp
index 724c6b0..2cb612a 100644
--- a/src/Board.cpp
+++ b/src/Board.cpp
@@ -18,10 +18,10 @@ Board::Board() : mWindow(sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"), mBackgro
   constexpr float TANK2_Y = 400.0f;
   Sound tank_shot_sound("tank_shot.flac");
   mWindow.setFramerateLimit(30);
-  mKeyboardPlayer =
-      std::make_unique<KeyboardPlayer>(*this, TankFactory::Random(mStore, TANK_X, TANK_Y, tank_shot_sound));
-  mDummyPlayer =
-      std::make_unique<DummyPlayer>(*this, TankFactory::Random(mStore, TANK2_X, TANK2_Y, tank_shot_sound));
+  mKeyboardPlayer = std::make_unique<KeyboardPlayer>(
+      *this, TankFactory::Random(mStore, TANK_X, TANK_Y, tank_shot_sound));
+  mDummyPlayer = std::make_unique<DummyPlayer>(
+      *this, TankFactory::Random(mStore, TANK2_X, TANK2_Y, tank_shot_sound));
   mFont.loadFromFile(files::asset_path() + "DejaVuSans.ttf");
   mText.setFont(mFont);
 }

From 12914ddf7d37cb7fcd7d01d22c5638edccf076d7 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <107147109+bartez33a@users.noreply.github.com>
Date: Thu, 12 Oct 2023 20:57:35 +0200
Subject: [PATCH 13/31] Update macos_clang.yaml

added workflow_dispatch
---
 .github/workflows/macos_clang.yaml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/.github/workflows/macos_clang.yaml b/.github/workflows/macos_clang.yaml
index 2c1529c..bbcbfd9 100644
--- a/.github/workflows/macos_clang.yaml
+++ b/.github/workflows/macos_clang.yaml
@@ -6,6 +6,25 @@ on:
   pull_request:
     branches:
       - main
+  workflow_dispatch:
+    inputs:
+      logLevel:
+        description: 'Log level'
+        required: true
+        default: 'warning'
+        type: choice
+        options:
+        - info
+        - warning
+        - debug
+      tags:
+        description: 'Test scenario tags'
+        required: false
+        type: boolean
+      environment:
+        description: 'Environment to run tests against'
+        type: environment
+        required: true
 
 env:
   # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)

From fca57e1da373c7568d9b7a5f8a33b61bef45c67c Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <107147109+bartez33a@users.noreply.github.com>
Date: Thu, 12 Oct 2023 21:02:11 +0200
Subject: [PATCH 14/31] Update macos_clang.yaml

restored to previous state
---
 .github/workflows/macos_clang.yaml | 19 -------------------
 1 file changed, 19 deletions(-)

diff --git a/.github/workflows/macos_clang.yaml b/.github/workflows/macos_clang.yaml
index bbcbfd9..2c1529c 100644
--- a/.github/workflows/macos_clang.yaml
+++ b/.github/workflows/macos_clang.yaml
@@ -6,25 +6,6 @@ on:
   pull_request:
     branches:
       - main
-  workflow_dispatch:
-    inputs:
-      logLevel:
-        description: 'Log level'
-        required: true
-        default: 'warning'
-        type: choice
-        options:
-        - info
-        - warning
-        - debug
-      tags:
-        description: 'Test scenario tags'
-        required: false
-        type: boolean
-      environment:
-        description: 'Environment to run tests against'
-        type: environment
-        required: true
 
 env:
   # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)

From 93161fc104863fe1365f98541693c7f918d8e812 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 12 Oct 2023 21:21:39 +0200
Subject: [PATCH 15/31] formatted TankTests.cpp

---
 test/TankTests.cpp | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/test/TankTests.cpp b/test/TankTests.cpp
index 4acbf05..3fc604c 100644
--- a/test/TankTests.cpp
+++ b/test/TankTests.cpp
@@ -3,9 +3,9 @@
 #include <SFML/Graphics.hpp>
 #include <utility>
 
+#include "Sound.hpp"
 #include "SquareRootEngine.hpp"
 #include "Tank/Tank.hpp"
-#include "Sound.hpp"
 #include "TestUtility.hpp"
 #include "TracesHandler.hpp"
 #include "gmock/gmock.h"
@@ -39,7 +39,10 @@ struct TankTestData {
   unsigned int health = 100;
 
   Tank create_tank(std::unique_ptr<testing::NiceMock<EngineMock>>&& engine) {
-    return {0, 0, mTextures, std::move(engine),
+    return {0,
+            0,
+            mTextures,
+            std::move(engine),
             emptySound,
             TracesHandlerConfig{.mMaxTraceAge = 10, .mDecayRate = 0.1f},
             shot_cooldown};

From 3b3ffcf840fc04f6436b8464402c2be62da7e0ac Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Sat, 14 Oct 2023 16:43:23 +0200
Subject: [PATCH 16/31] corrected main.cpp added .editorconfig to gitignore

---
 .gitignore   | 1 +
 src/main.cpp | 3 ---
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/.gitignore b/.gitignore
index 7e10ffd..51ceb82 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 **/.DS_Store
+.editorconfig
 .vscode
 .cache
 build
diff --git a/src/main.cpp b/src/main.cpp
index 7fe506c..c651d5a 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -1,9 +1,6 @@
-#include <iostream>
-
 #include "Board.hpp"
 
 int main() {
-  std::cout << "t245\n";
   Board b;
   b.run();
   return 0;

From 1cf7a47820d2c3c9aa1b26e0c0e5d8c80efcb3ee Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Wed, 18 Oct 2023 16:29:24 +0200
Subject: [PATCH 17/31] Created skeleton for GameManager, MainMenu, added Notes

- created class GameManager
- created class MainMenu
- created Notes about SFML
---
 Notes/SFML notes.md | 13 +++++++++++++
 Notes/sf::event.md  | 27 +++++++++++++++++++++++++++
 src/Board.cpp       |  3 ++-
 src/Board.hpp       |  4 ++--
 src/GameManager.cpp |  3 +++
 src/GameManager.hpp | 27 +++++++++++++++++++++++++++
 src/MainMenu.h      |  3 +++
 src/main.cpp        |  6 +++---
 8 files changed, 80 insertions(+), 6 deletions(-)
 create mode 100644 Notes/SFML notes.md
 create mode 100644 Notes/sf::event.md
 create mode 100644 src/GameManager.cpp
 create mode 100644 src/GameManager.hpp
 create mode 100644 src/MainMenu.h

diff --git a/Notes/SFML notes.md b/Notes/SFML notes.md
new file mode 100644
index 0000000..fca3871
--- /dev/null
+++ b/Notes/SFML notes.md	
@@ -0,0 +1,13 @@
+### SFML notes
+
+# sf::Window - okienko gry, 
+posiada metody, np.:
+- pollEvent, ktora zwraca sf::Event do obslugi eventow jak np. wejścia z klawiatury, myszy.
+- waitEvent
+
+# sf::Event - UWAGA - jest to unia. 
+Różne metody mogą być wykorzystywane w innym czasie (zależnie czym aktualnie jest instancja sf::Event) 
+
+# only pollEvent and waitEvent produce valid events! 
+any attempt to use sf::Event which was not returned by successful call to any of these functions will result in undefined behavior.
+
diff --git a/Notes/sf::event.md b/Notes/sf::event.md
new file mode 100644
index 0000000..7760ad4
--- /dev/null
+++ b/Notes/sf::event.md
@@ -0,0 +1,27 @@
+### sf::Event
+
+# typical usage of sf::Event
+
+sf::Event event;
+
+// while there are pending events...
+while (window.pollEvent(event))
+{
+    // check the type of the event...
+    switch (event.type)
+    {
+        // window closed
+        case sf::Event::Closed:
+            window.close();
+            break;
+
+        // key pressed
+        case sf::Event::KeyPressed:
+            ...
+            break;
+
+        // we don't process other types of events
+        default:
+            break;
+    }
+}
\ No newline at end of file
diff --git a/src/Board.cpp b/src/Board.cpp
index 2cb612a..191d7fa 100644
--- a/src/Board.cpp
+++ b/src/Board.cpp
@@ -11,7 +11,8 @@
 #include "Tank/TankFactory.hpp"
 #include "TracesHandler.hpp"
 
-Board::Board() : mWindow(sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"), mBackground(mStore) {
+Board::Board(sf::RenderWindow window)
+    : mWindow{window}(sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"), mBackground(mStore) {
   constexpr float TANK_X = WIDTH / 2.0f;
   constexpr float TANK_Y = 50.f;
   constexpr float TANK2_X = WIDTH / 2.0f;
diff --git a/src/Board.hpp b/src/Board.hpp
index 3d102db..347f7ae 100644
--- a/src/Board.hpp
+++ b/src/Board.hpp
@@ -10,7 +10,7 @@
 
 class Board {
  public:
-  Board();
+  Board(sf::RenderWindow window);
 
   void register_missile(const Missle& missile);
   void run();
@@ -22,7 +22,7 @@ class Board {
   void draw();
 
   TextureStore mStore;
-  sf::RenderWindow mWindow;
+  sf::RenderWindow& mWindow;
   Background mBackground;
   std::unique_ptr<KeyboardPlayer> mKeyboardPlayer;
   std::unique_ptr<DummyPlayer> mDummyPlayer;
diff --git a/src/GameManager.cpp b/src/GameManager.cpp
new file mode 100644
index 0000000..661b620
--- /dev/null
+++ b/src/GameManager.cpp
@@ -0,0 +1,3 @@
+#include "GameManager.hpp"
+
+GameManager() : mWindow;
\ No newline at end of file
diff --git a/src/GameManager.hpp b/src/GameManager.hpp
new file mode 100644
index 0000000..9229ca8
--- /dev/null
+++ b/src/GameManager.hpp
@@ -0,0 +1,27 @@
+#pragma once
+
+#include <SFML/Graphics.hpp>
+
+#include "Board.hpp"
+
+enum class GameManagerState {
+  MainMenu,
+  Started,
+  Exit,
+};
+
+class GameManager {
+ public:
+  GameManager();
+
+ private:
+  // objects
+  GameManagerState mGameManagerState = GameManagerState::MainMenu;
+  sf::RenderWindow mWindow;
+  Board board;
+
+  // methods
+  void start();
+  void transitState(GameManagerState desired_state);
+  void exit;
+}
\ No newline at end of file
diff --git a/src/MainMenu.h b/src/MainMenu.h
new file mode 100644
index 0000000..7acca6d
--- /dev/null
+++ b/src/MainMenu.h
@@ -0,0 +1,3 @@
+#pragma once
+
+class MainMenu {}
\ No newline at end of file
diff --git a/src/main.cpp b/src/main.cpp
index c651d5a..9bfe774 100644
--- a/src/main.cpp
+++ b/src/main.cpp
@@ -1,7 +1,7 @@
-#include "Board.hpp"
+#include "GameManager.hpp"
 
 int main() {
-  Board b;
-  b.run();
+  GameManager gm{};
+  gm.start();
   return 0;
 }

From 3a8e3d0ec9a139a4ebce308aeb64071358376914 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Sat, 21 Oct 2023 19:31:00 +0200
Subject: [PATCH 18/31] Added more notes

---
 Notes/Graphics module/drawing 2D stuff.md | 143 ++++++++++++++++++
 Notes/Graphics module/sprites_textures.md | 176 ++++++++++++++++++++++
 Notes/Window module/OpenGL in SFML.md     |  82 ++++++++++
 Notes/{ => Window module}/SFML notes.md   |   0
 Notes/Window module/inputs.md             |  95 ++++++++++++
 Notes/Window module/sf::event.md          |  60 ++++++++
 Notes/sf::event.md                        |  27 ----
 7 files changed, 556 insertions(+), 27 deletions(-)
 create mode 100644 Notes/Graphics module/drawing 2D stuff.md
 create mode 100644 Notes/Graphics module/sprites_textures.md
 create mode 100644 Notes/Window module/OpenGL in SFML.md
 rename Notes/{ => Window module}/SFML notes.md (100%)
 create mode 100644 Notes/Window module/inputs.md
 create mode 100644 Notes/Window module/sf::event.md
 delete mode 100644 Notes/sf::event.md

diff --git a/Notes/Graphics module/drawing 2D stuff.md b/Notes/Graphics module/drawing 2D stuff.md
new file mode 100644
index 0000000..ba3358d
--- /dev/null
+++ b/Notes/Graphics module/drawing 2D stuff.md	
@@ -0,0 +1,143 @@
+### Drawing 2D stuff
+
+## Introduction
+ As you learnt in the previous tutorials, SFML's window module provides an easy way to open an OpenGL window and handle its events, but it doesn't help when it comes to drawing something. The only option which is left to you is to use the powerful, yet complex and low level OpenGL API.
+
+Fortunately, SFML provides a graphics module which will help you draw 2D entities in a much simpler way than with OpenGL. 
+
+## The drawing window
+To draw the entities provided by the graphics module, you must use a specialized window class: `sf::RenderWindow`. This class is derived from `sf::Window`, and inherits all its functions. Everything that you've learnt about sf::Window (creation, event handling, controlling the framerate, mixing with OpenGL, etc.) is applicable to `sf::RenderWindow` as well.
+
+On top of that, `sf::RenderWindow` adds high-level functions to help you draw things easily. 
+In this tutorial we'll focus on two of these functions: 
+- clear and 
+- draw. 
+They are as simple as their name implies: 
+- clear clears the whole window with the chosen color, and 
+- draw draws whatever object you pass to it.
+
+Here is what a typical main loop looks like with a render window: 
+
+#include <SFML/Graphics.hpp>
+
+int main()
+{
+    // create the window
+    sf::RenderWindow window(sf::VideoMode(800, 600), "My window");
+
+    // run the program as long as the window is open
+    while (window.isOpen())
+    {
+        // check all the window's events that were triggered since the last iteration of the loop
+        sf::Event event;
+        while (window.pollEvent(event))
+        {
+            // "close requested" event: we close the window
+            if (event.type == sf::Event::Closed)
+                window.close();
+        }
+
+        // clear the window with black color
+        window.clear(sf::Color::Black);
+
+        // draw everything here...
+        // window.draw(...);
+
+        // end the current frame
+        window.display();
+    }
+
+    return 0;
+}
+
+Calling clear before drawing anything is mandatory, otherwise the contents from previous frames will be present behind anything you draw. 
+The only exception is when you cover the entire window with what you draw, so that no pixel is not drawn to. In this case you can avoid calling clear (although it won't have a noticeable impact on performance).
+
+Calling display is also mandatory, it takes what was drawn since the last call to display and displays it on the window. Indeed, things are not drawn directly to the window, but to a hidden buffer. This buffer is then copied to the window when you call display -- this is called double-buffering.
+
+This clear/draw/display cycle is the only good way to draw things. Don't try other strategies, such as keeping pixels from the previous frame, "erasing" pixels, or drawing once and calling display multiple times. You'll get strange results due to double-buffering.
+Modern graphics hardware and APIs are really made for repeated clear/draw/display cycles where everything is completely refreshed at each iteration of the main loop. Don't be scared to draw 1000 sprites 60 times per second, you're far below the millions of triangles that your computer can handle.
+
+## What can I draw now?
+Now that you have a main loop which is ready to draw, let's see what, and how, you can actually draw there.
+
+SFML provides four kinds of drawable entities: three of them are ready to be used (sprites, text and shapes), the last one is the building block that will help you create your own drawable entities (vertex arrays).
+
+Although they share some common properties, each of these entities come with their own nuances and are therefore explained in dedicated tutorials.
+
+## Off-screen drawing
+SFML also provides a way to draw to a texture instead of directly to a window. 
+To do so, use a `sf::RenderTexture` instead of a `sf::RenderWindow`. 
+It has the same functions for drawing, inherited from their common base: `sf::RenderTarget`.
+
+
+// create a 500x500 render-texture
+sf::RenderTexture renderTexture;
+if (!renderTexture.create(500, 500))
+{
+    // error...
+}
+
+// drawing uses the same functions
+renderTexture.clear();
+renderTexture.draw(sprite); // or any other drawable
+renderTexture.display();
+
+// get the target texture (where the stuff has been drawn)
+const sf::Texture& texture = renderTexture.getTexture();
+
+// draw it to the window
+sf::Sprite sprite(texture);
+window.draw(sprite);
+
+
+The getTexture function returns a read-only texture, which means that you can only use it, not modify it. If you need to modify it before using it, you can copy it to your own sf::Texture instance and modify that instead.
+
+sf::RenderTexture also has the same functions as sf::RenderWindow for handling views and OpenGL (see the corresponding tutorials for more details). If you use OpenGL to draw to the render-texture, you can request creation of a depth buffer by using the third optional argument of the create function.
+
+renderTexture.create(500, 500, true); // enable depth buffer
+
+## Drawing from threads
+SFML supports multi-threaded drawing, and you don't even have to do anything to make it work. 
+The only thing to remember is to deactivate a window before using it in another thread. 
+That's because a window (more precisely its OpenGL context) cannot be active in more than one thread at the same time.
+
+void renderingThread(sf::RenderWindow* window)
+{
+    // activate the window's context
+    window->setActive(true);
+
+    // the rendering loop
+    while (window->isOpen())
+    {
+        // draw...
+
+        // end the current frame
+        window->display();
+    }
+}
+
+int main()
+{
+    // create the window (remember: it's safer to create it in the main thread due to OS limitations)
+    sf::RenderWindow window(sf::VideoMode(800, 600), "OpenGL");
+
+    // deactivate its OpenGL context
+    window.setActive(false);
+
+    // launch the rendering thread
+    sf::Thread thread(&renderingThread, &window);
+    thread.launch();
+
+    // the event/logic/whatever loop
+    while (window.isOpen())
+    {
+        ...
+    }
+
+    return 0;
+}
+
+As you can see, you don't even need to bother with the activation of the window in the rendering thread, SFML does it automatically for you whenever it needs to be done.
+
+Remember to always create the window and handle its events in the main thread for maximum portability. This is explained in the window tutorial. 
\ No newline at end of file
diff --git a/Notes/Graphics module/sprites_textures.md b/Notes/Graphics module/sprites_textures.md
new file mode 100644
index 0000000..8298bff
--- /dev/null
+++ b/Notes/Graphics module/sprites_textures.md	
@@ -0,0 +1,176 @@
+### Sprites and textures
+
+Most (if not all) of you are already familiar with these two very common objects, so let's define them very briefly.
+
+A texture is an image. But we call it "texture" because it has a very specific role: being mapped to a 2D entity.
+
+A sprite is nothing more than a textured rectangle. 
+
+## Loading a texture
+
+Before creating any sprite, we need a valid texture. The class that encapsulates textures in SFML is, surprisingly, `sf::Texture`. 
+Since the only role of a texture is to be loaded and mapped to graphical entities, almost all its functions are about loading and updating it.
+
+The most common way of loading a texture is from an image file on disk, which is done with the loadFromFile function.
+
+sf::Texture texture;
+if (!texture.loadFromFile("image.png"))
+{
+    // error...
+}
+
+# The loadFromFile function can sometimes fail with no obvious reason`. 
+First, check the error message that SFML prints to the standard output (check the console). 
+If the message is "unable to open file", make sure that the working directory (which is the directory that any file path will be interpreted relative to) is what you think it is: 
+When you run the application from your desktop environment, the working directory is the executable folder. 
+However, when you launch your program from your IDE (Visual Studio, Code::Blocks, ...) the working directory might sometimes be set to the project directory instead. 
+This can usually be changed quite easily in the project settings.
+
+You can also load an image file from memory (loadFromMemory), 
+from a custom input stream (loadFromStream), or 
+from an image that has already been loaded (loadFromImage). 
+The latter loads the texture from an sf::Image, which is a utility class that helps store and manipulate image data (modify pixels, create transparency channel, etc.). 
+The pixels of an sf::Image stay in system memory, which ensures that operations on them will be as fast as possible, in contrast to the pixels of a texture which reside in video memory and are therefore slow to retrieve or update but very fast to draw.
+
+SFML supports most common image file formats. The full list is available in the API documentation.
+
+All these loading functions have an optional argument, which can be used if you want to load a smaller part of the image.
+
+
+// load a 32x32 rectangle that starts at (10, 10)
+if (!texture.loadFromFile("image.png", sf::IntRect(10, 10, 32, 32)))
+{
+    // error...
+}
+
+
+The sf::IntRect class is a simple utility type that represents a rectangle. Its constructor takes the coordinates of the top-left corner, and the size of the rectangle.
+
+If you don't want to load a texture from an image, but instead want to update it directly from an array of pixels, you can create it empty and update it later:
+
+// create an empty 200x200 texture
+if (!texture.create(200, 200))
+{
+    // error...
+}
+
+Note that the contents of the texture are undefined at this point.
+
+To update the pixels of an existing texture, you have to use the update function. It has overloads for many kinds of data sources:
+
+// update a texture from an array of pixels
+sf::Uint8* pixels = new sf::Uint8[width * height * 4]; // * 4 because pixels have 4 components (RGBA)
+...
+texture.update(pixels);
+
+// update a texture from a sf::Image
+sf::Image image;
+...
+texture.update(image);
+
+// update the texture from the current contents of the window
+sf::RenderWindow window;
+...
+texture.update(window);
+
+
+These examples all assume that the source is of the same size as the texture. If this is not the case, i.e. if you want to update only a part of the texture, you can specify the coordinates of the sub-rectangle that you want to update. You can refer to the documentation for further details.
+
+Additionally, a texture has two properties that change how it is rendered.
+
+The first property allows one to smooth the texture. Smoothing a texture makes pixel boundaries less visible (but the image a little more blurry), which can be desirable if it is up-scaled.
+
+`texture.setSmooth(true);`
+
+Since smoothing samples from adjacent pixels in the texture as well, it can lead to the unwanted side effect of factoring in pixels outside the selected texture area. This can happen when your sprite is located at non-integer coordinates.
+
+The second property allows a texture to be repeatedly tiled within a single sprite.
+
+`texture.setRepeated(true);`
+
+This only works if your sprite is configured to show a rectangle which is larger than the texture, otherwise this property has no effect. 
+
+
+
+## Ok, can I have my sprite now?
+
+Yes, you can now create your sprite.
+
+sf::Sprite sprite;
+sprite.setTexture(texture);
+
+... and finally draw it.
+
+// inside the main loop, between window.clear() and window.display()
+window.draw(sprite);
+
+If you don't want your sprite to use the entire texture, you can set its texture rectangle.
+
+sprite.setTextureRect(sf::IntRect(10, 10, 32, 32));
+
+You can also change the color of a sprite. The color that you set is modulated (multiplied) with the texture of the sprite. This can also be used to change the global transparency (alpha) of the sprite.
+
+sprite.setColor(sf::Color(0, 255, 0)); // green
+sprite.setColor(sf::Color(255, 255, 255, 128)); // half transparent
+
+
+Sprites can also be transformed: They have a position, an orientation and a scale.
+
+// position
+sprite.setPosition(sf::Vector2f(10.f, 50.f)); // absolute position
+sprite.move(sf::Vector2f(5.f, 10.f)); // offset relative to the current position
+
+// rotation
+sprite.setRotation(90.f); // absolute angle
+sprite.rotate(15.f); // offset relative to the current angle
+
+// scale
+sprite.setScale(sf::Vector2f(0.5f, 2.f)); // absolute scale factor
+sprite.scale(sf::Vector2f(1.5f, 3.f)); // factor relative to the current scale
+
+By default, the origin for these three transformations is the top-left corner of the sprite. If you want to set the origin to a different point (for example the center of the sprite, or another corner), you can use the setOrigin function.
+
+sprite.setOrigin(sf::Vector2f(25.f, 25.f));
+
+Since transformation functions are common to all SFML entities, they are explained in a separate tutorial: Transforming entities.
+
+## The white square problem
+
+You successfully loaded a texture, constructed a sprite correctly, and... all you see on your screen now is a white square. What happened?
+
+This is a common mistake. When you set the texture of a sprite, all it does internally is store a pointer to the texture instance. Therefore, if the texture is destroyed or moves elsewhere in memory, the sprite ends up with an invalid texture pointer.
+
+This problem occurs when you write this kind of function:
+
+sf::Sprite loadSprite(std::string filename)
+{
+    sf::Texture texture;
+    texture.loadFromFile(filename);
+
+    return sf::Sprite(texture);
+} // error: the texture is destroyed here
+
+`You must correctly manage the lifetime of your textures and make sure that they live as long as they are used by any sprite.` 
+
+## The importance of using as few textures as possible
+Using as few textures as possible is a good strategy, and the reason is simple: Changing the current texture is an expensive operation for the graphics card. Drawing many sprites that use the same texture will yield the best performance.
+
+Additionally, using a single texture allows you to group static geometry into a single entity (you can only use one texture per draw call), which will be much faster to draw than a set of many entities. Batching static geometry involves other classes and is therefore beyond the scope of this tutorial, for further details see the vertex array tutorial.
+
+Try to keep this in mind when you create your animation sheets or your tilesets: Use as little textures as possible.
+
+## Using sf::Texture with OpenGL code
+If you're using OpenGL rather than the graphics entities of SFML, you can still use sf::Texture as a wrapper around an OpenGL texture object and use it along with the rest of your OpenGL code.
+
+To bind a sf::Texture for drawing (basically glBindTexture), you call the bind static function:
+
+sf::Texture texture;
+...
+
+// bind the texture
+sf::Texture::bind(&texture);
+
+// draw your textured OpenGL entity here...
+
+// bind no texture
+sf::Texture::bind(NULL);
diff --git a/Notes/Window module/OpenGL in SFML.md b/Notes/Window module/OpenGL in SFML.md
new file mode 100644
index 0000000..1c7cc80
--- /dev/null
+++ b/Notes/Window module/OpenGL in SFML.md	
@@ -0,0 +1,82 @@
+### OpenGL in SFML
+
+As you know, one of the most important features of OpenGL is portability. But OpenGL alone won't be enough to create complete programs: you need a window, a rendering context, user input, etc. You would have no choice but to write OS-specific code to handle this stuff on your own. That's where the sfml-window module comes into play. Let's see how it allows you to play with OpenGL. 
+
+# Including and linking OpenGL
+
+OpenGL headers are not the same on every OS. Therefore, SFML provides an "abstract" header that takes care of including the right file for you.
+
+`#include <SFML/OpenGL.hpp>`
+
+This header includes OpenGL functions, and nothing else. People sometimes think that SFML automatically includes OpenGL extension headers because SFML loads extensions itself, but it's an implementation detail. From the user's point of view, OpenGL extension loading must be handled like any other external library.
+
+You will then need to link your program to the OpenGL library. Unlike what it does with the headers, SFML can't provide a unified way of linking OpenGL. Therefore, you need to know which library to link to according to what operating system you're using ("opengl32" on Windows, "GL" on Linux, etc.).
+
+OpenGL functions start with the "gl" prefix. Remember this when you get linker errors, it will help you find which library you forgot to link. 
+
+## Creating an OpenGL window
+
+Since SFML is based on OpenGL, its windows are ready for OpenGL calls without any extra effort.
+
+sf::Window window(sf::VideoMode(800, 600), "OpenGL");
+
+// it works out of the box
+glEnable(GL_TEXTURE_2D);
+...
+
+
+## A typical OpenGL-with-SFML program
+
+ Here is what a complete OpenGL program would look like with SFML:
+
+#include <SFML/Window.hpp>
+#include <SFML/OpenGL.hpp>
+
+int main()
+{
+    // create the window
+    sf::Window window(sf::VideoMode(800, 600), "OpenGL", sf::Style::Default, sf::ContextSettings(32));
+    window.setVerticalSyncEnabled(true);
+
+    // activate the window
+    window.setActive(true);
+
+    // load resources, initialize the OpenGL states, ...
+
+    // run the main loop
+    bool running = true;
+    while (running)
+    {
+        // handle events
+        sf::Event event;
+        while (window.pollEvent(event))
+        {
+            if (event.type == sf::Event::Closed)
+            {
+                // end the program
+                running = false;
+            }
+            else if (event.type == sf::Event::Resized)
+            {
+                // adjust the viewport when the window is resized
+                glViewport(0, 0, event.size.width, event.size.height);
+            }
+        }
+
+        // clear the buffers
+        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
+
+        // draw...
+
+        // end the current frame (internally swaps the front and back buffers)
+        window.display();
+    }
+
+    // release resources...
+
+    return 0;
+}
+
+Here we don't use window.isOpen() as the condition of the main loop, because we need the window to remain open until the program ends, so that we still have a valid OpenGL context for the last iteration of the loop and the cleanup code.
+
+Don't hesitate to have a look at the "OpenGL" and "Window" examples in the SFML SDK if you have further problems, they are more complete and most likely contain solutions to your problems. 
\ No newline at end of file
diff --git a/Notes/SFML notes.md b/Notes/Window module/SFML notes.md
similarity index 100%
rename from Notes/SFML notes.md
rename to Notes/Window module/SFML notes.md
diff --git a/Notes/Window module/inputs.md b/Notes/Window module/inputs.md
new file mode 100644
index 0000000..d33e37e
--- /dev/null
+++ b/Notes/Window module/inputs.md	
@@ -0,0 +1,95 @@
+### Inputs -> keyboard, mouse, joystick
+
+This tutorial explains how to access global input devices: keyboard, mouse and joysticks. This must not be confused with events. 
+Real-time input allows you to query the global state of keyboard, mouse and joysticks at any time ("is this button currently pressed?", "where is the mouse currently?") while events notify you when something happens ("this button was pressed", "the mouse has moved"). 
+
+
+## Keyboard
+The class that provides access to the keyboard state is sf::Keyboard. It contains two overloads of the same function, isKeyPressed, which checks the current state of a key (pressed or released). It is a static function, so you don't need to instantiate sf::Keyboard to use it. 
+
+This function directly reads the keyboard state, ignoring the focus state of your window. This means that isKeyPressed may return true, even if your window is inactive. 
+
+if (sf::Keyboard::isKeyPressed(sf::Keyboard::Left))
+{
+    // left key is pressed: move our character
+    character.move(-1.f, 0.f);
+}
+
+ Key codes are defined in the sf::Keyboard::Key enum.
+
+if (sf::Keyboard::isKeyPressed(sf::Keyboard::Scan::Right))
+{
+    // right key is pressed: move our character
+    character.move(1.f, 0.f);
+}
+
+Scancodes are defined in the sf::Keyboard::Scancode enum. 
+
+## Mouse
+ The class that provides access to the mouse state is sf::Mouse. Like its friend sf::Keyboard, sf::Mouse only contains static functions and is not meant to be instantiated (SFML only handles a single mouse for the time being).
+
+You can check if buttons are pressed:
+
+if (sf::Mouse::isButtonPressed(sf::Mouse::Left))
+{
+    // left mouse button is pressed: shoot
+    gun.fire();
+}
+
+Mouse button codes are defined in the sf::Mouse::Button enum. SFML supports up to 5 buttons: left, right, middle (wheel), and two additional buttons whatever they may be. 
+
+ You can also get and set the current position of the mouse, either relative to the desktop or to a window:
+
+// get the global mouse position (relative to the desktop)
+sf::Vector2i globalPosition = sf::Mouse::getPosition();
+
+// get the local mouse position (relative to a window)
+sf::Vector2i localPosition = sf::Mouse::getPosition(window); // window is a sf::Window
+
+// set the mouse position globally (relative to the desktop)
+sf::Mouse::setPosition(sf::Vector2i(10, 50));
+
+// set the mouse position locally (relative to a window)
+sf::Mouse::setPosition(sf::Vector2i(10, 50), window); // window is a sf::Window
+
+There is no function for reading the current state of the mouse wheel. Since the wheel can only be moved relatively, it has no absolute state that can be queried. By looking at a key you can tell whether it's pressed or released. By looking at the mouse cursor you can tell where it is located on the screen. However, looking at the mouse wheel doesn't tell you which "tick" it is on. You can only be notified when it moves (MouseWheelScrolled event). 
+
+
+## Joystick
+The class that provides access to the joysticks' states is sf::Joystick. Like the other classes in this tutorial, it only contains static functions.
+
+Joysticks are identified by their index (0 to 7, since SFML supports up to 8 joysticks). Therefore, the first argument of every function of sf::Joystick is the index of the joystick that you want to query. 
+
+ You can check whether a joystick is connected or not:
+
+if (sf::Joystick::isConnected(0))
+{
+    // joystick number 0 is connected
+    ...
+}
+
+You can also get the capabilities of a connected joystick:
+
+// check how many buttons joystick number 0 has
+unsigned int buttonCount = sf::Joystick::getButtonCount(0);
+
+// check if joystick number 0 has a Z axis
+bool hasZ = sf::Joystick::hasAxis(0, sf::Joystick::Z);
+
+Joystick axes are defined in the sf::Joystick::Axis enum. Since buttons have no special meaning, they are simply numbered from 0 to 31.
+
+Finally, you can query the state of a joystick's axes and buttons as well:
+
+// is button 1 of joystick number 0 pressed?
+if (sf::Joystick::isButtonPressed(0, 1))
+{
+    // yes: shoot!
+    gun.fire();
+}
+
+// what's the current position of the X and Y axes of joystick number 0?
+float x = sf::Joystick::getAxisPosition(0, sf::Joystick::X);
+float y = sf::Joystick::getAxisPosition(0, sf::Joystick::Y);
+character.move(x, y);
+
+Joystick states are automatically updated when you check for events. If you don't check for events, or need to query a joystick state (for example, checking which joysticks are connected) before starting your game loop, you'll have to manually call the sf::Joystick::update() function yourself to make sure that the joystick states are up to date. 
\ No newline at end of file
diff --git a/Notes/Window module/sf::event.md b/Notes/Window module/sf::event.md
new file mode 100644
index 0000000..9f7adc0
--- /dev/null
+++ b/Notes/Window module/sf::event.md	
@@ -0,0 +1,60 @@
+### sf::Event
+
+# typical usage of sf::Event
+
+sf::Event event;
+
+// while there are pending events...
+while (window.pollEvent(event))
+{
+    // check the type of the event...
+    switch (event.type)
+    {
+        // window closed
+        case sf::Event::Closed:
+            window.close();
+            break;
+
+        // key pressed
+        case sf::Event::KeyPressed:
+            ...
+            break;
+
+        // we don't process other types of events
+        default:
+            break;
+    }
+}
+
+# The Closed event
+The sf::Event::Closed event is triggered when the user wants to close the window, through any of the possible methods.
+The event only represent a close request, the window is not closed yet when the event is received.
+
+We can save current state of game and close window.
+
+# The Resized event
+The sf::Event::Resized event is triggered when the window is resized (by user or e.g. calling window.setSize).
+
+# The LostFocus and GainedFocus events
+The sf::Event::LostFocus and sf::Event::GainedFocus events are triggered when the window loses/gains focus, which happens when the user switches the currently active window.
+When the window is out of focus, it doesn't receive keyboard events.
+
+ There's no member associated with these events in the sf::Event union.
+
+if (event.type == sf::Event::LostFocus)
+    myGame.pause();
+
+if (event.type == sf::Event::GainedFocus)
+    myGame.resume();
+
+# Other event such as keyboard or mouse input.
+https://www.sfml-dev.org/tutorials/2.6/window-events.php
+
+
+## Keyboard input tips
+ Sometimes, people try to react to KeyPressed events directly to implement smooth movement. Doing so will not produce the expected effect, because when you hold a key you only get a few events (remember, the repeat delay). To achieve smooth movement with events, you must use a boolean that you set on KeyPressed and clear on KeyReleased; you can then move (independently of events) as long as the boolean is set.
+The other (easier) solution to produce smooth movement is to use real-time keyboard input with sf::Keyboard (see the dedicated tutorial). 
+
+ Scancodes are unique values for each physical key on a keyboard, regardless of the language or layout, whereas key codes represent keys based on the user's chosen layout. For instance, the Z key is in the bottom row to the left of the X key on a US layout. Referring to the scancode for Z would identify this physical key location on any keyboard. However, on a German layout, the same physical key is labeled Y. Thus, using the key code for Y can lead to different physical key locations, depending on the chosen layout.
+
+It is strongly recommended to use scancodes over key codes if the physical location of the keys is more important than the key values that depend on the keyboard layout, such as using WASD keys for movement. 
\ No newline at end of file
diff --git a/Notes/sf::event.md b/Notes/sf::event.md
deleted file mode 100644
index 7760ad4..0000000
--- a/Notes/sf::event.md
+++ /dev/null
@@ -1,27 +0,0 @@
-### sf::Event
-
-# typical usage of sf::Event
-
-sf::Event event;
-
-// while there are pending events...
-while (window.pollEvent(event))
-{
-    // check the type of the event...
-    switch (event.type)
-    {
-        // window closed
-        case sf::Event::Closed:
-            window.close();
-            break;
-
-        // key pressed
-        case sf::Event::KeyPressed:
-            ...
-            break;
-
-        // we don't process other types of events
-        default:
-            break;
-    }
-}
\ No newline at end of file

From 6786c7e1549f03bd124618740474a58ff5d7e9e1 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 18:07:22 +0200
Subject: [PATCH 19/31] Created classes Button, MenuLevel

- created classes Button, MenuLevel
- modified class MainMenu
- modified class Board
---
 src/Board.cpp       | 41 +++++++++++---------------------
 src/Board.hpp       |  4 ++--
 src/Button.cpp      |  6 +++++
 src/Button.hpp      | 24 +++++++++++++++++++
 src/GameManager.cpp | 57 ++++++++++++++++++++++++++++++++++++++++++++-
 src/GameManager.hpp |  7 +++---
 src/MainMenu.cpp    |  9 +++++++
 src/MainMenu.h      | 42 ++++++++++++++++++++++++++++++++-
 src/MenuLevel.cpp   |  1 +
 src/MenuLevel.hpp   | 15 ++++++++++++
 10 files changed, 172 insertions(+), 34 deletions(-)
 create mode 100644 src/Button.cpp
 create mode 100644 src/Button.hpp
 create mode 100644 src/MainMenu.cpp
 create mode 100644 src/MenuLevel.cpp
 create mode 100644 src/MenuLevel.hpp

diff --git a/src/Board.cpp b/src/Board.cpp
index 191d7fa..e12e79f 100644
--- a/src/Board.cpp
+++ b/src/Board.cpp
@@ -11,8 +11,7 @@
 #include "Tank/TankFactory.hpp"
 #include "TracesHandler.hpp"
 
-Board::Board(sf::RenderWindow window)
-    : mWindow{window}(sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"), mBackground(mStore) {
+Board::Board(sf::RenderWindow& window) : mWindow{window}, mBackground(mStore) {
   constexpr float TANK_X = WIDTH / 2.0f;
   constexpr float TANK_Y = 50.f;
   constexpr float TANK2_X = WIDTH / 2.0f;
@@ -30,7 +29,6 @@ Board::Board(sf::RenderWindow window)
 void Board::register_missile(const Missle& missile) { mMissles.push_back(missile); }
 
 void Board::draw() {
-  mWindow.clear();
   mBackground.draw(mWindow);
   if (mKeyboardPlayer) {
     mKeyboardPlayer->draw(mWindow);
@@ -42,34 +40,23 @@ void Board::draw() {
     missle.draw(mWindow);
   }
   display_speed();
-  mWindow.display();
 }
 
-void Board::run() {
-  while (mWindow.isOpen()) {
-    sf::Event event{};
-    while (mWindow.pollEvent(event)) {
-      if (event.type == sf::Event::Closed) {
-        mWindow.close();
-      }
+void Board::play(const sf::Event& event) {
+  if (mKeyboardPlayer) {
+    mKeyboardPlayer->handle_events(event);
+  }
 
-      if (event.type == sf::Event::KeyPressed && event.key.code == sf::Keyboard::Escape) {
-        mWindow.close();
-      }
-      if (mKeyboardPlayer) {
-        mKeyboardPlayer->handle_events(event);
-      }
-    }
-    if (mDummyPlayer) {
-      mDummyPlayer->update();
-    }
-    if (mKeyboardPlayer) {
-      mKeyboardPlayer->update();
-    }
-    draw();
-    remove_missles();
-    update_players();
+  if (mDummyPlayer) {
+    mDummyPlayer->update();
+  }
+
+  if (mKeyboardPlayer) {
+    mKeyboardPlayer->update();
   }
+  draw();
+  remove_missles();
+  update_players();
 }
 
 void Board::display_speed() {
diff --git a/src/Board.hpp b/src/Board.hpp
index 347f7ae..8a0686d 100644
--- a/src/Board.hpp
+++ b/src/Board.hpp
@@ -10,10 +10,10 @@
 
 class Board {
  public:
-  Board(sf::RenderWindow window);
+  Board(sf::RenderWindow& window);
 
   void register_missile(const Missle& missile);
-  void run();
+  void play(const sf::Event& event);
 
  private:
   void remove_missles();
diff --git a/src/Button.cpp b/src/Button.cpp
new file mode 100644
index 0000000..7751999
--- /dev/null
+++ b/src/Button.cpp
@@ -0,0 +1,6 @@
+#include "Button.hpp"
+
+Button::Button(std::string text, void (*callback)(void), LevelOfMenu* nextLevel = nullptr)
+    : mText{text}, mCallback{callback}, mNextLevel{nextLevel} {}
+
+bool Button::is_clicked(const sf::Event& event){};
\ No newline at end of file
diff --git a/src/Button.hpp b/src/Button.hpp
new file mode 100644
index 0000000..2119c72
--- /dev/null
+++ b/src/Button.hpp
@@ -0,0 +1,24 @@
+#pragma once
+
+#include <SFML/Graphics.hpp>
+#include <string>
+#include <vector>
+
+#include "MenuLevel.hpp"
+
+using point_t = sf::Vector2u;
+
+class Button {
+  std::string mText;
+  MenuLevel* mNextLevel;
+  point_t mTopLeft;
+  unsigned int mWidth;
+  unsigned int mHeight;
+
+  void (*mCallback)(void);
+
+ public:
+  Button(std::string text, void (*callback)(void), MenuLevel* nextLevel = nullptr);
+
+  bool is_clicked(const sf::Event& event);
+};
\ No newline at end of file
diff --git a/src/GameManager.cpp b/src/GameManager.cpp
index 661b620..e00a92f 100644
--- a/src/GameManager.cpp
+++ b/src/GameManager.cpp
@@ -1,3 +1,58 @@
 #include "GameManager.hpp"
 
-GameManager() : mWindow;
\ No newline at end of file
+#include "Size.hpp"
+
+GameManager::GameManager()
+    : mWindow{sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"}, mBoard{mWindow} {}
+
+void GameManager::start() {
+  while (mWindow.isOpen()) {
+    // check all the window's events that were triggered since the last iteration of the loop
+    sf::Event event;
+    while (mWindow.pollEvent(event)) {
+      // "close requested" event: we close the window
+      if (event.type == sf::Event::Closed) {
+        mGameManagerState = GameManagerState::Exit;
+      }
+      if (event.type == sf::Event::KeyPressed && event.key.code == sf::Keyboard::Escape) {
+        mGameManagerState = GameManagerState::Exit;
+      }
+    }
+
+    // clear the window with black color
+    mWindow.clear(sf::Color::Black);
+
+    performStateMachine(event);
+
+    // end the current frame
+    mWindow.display();
+  }
+}
+#include <iostream>
+void GameManager::performStateMachine(const sf::Event& event) {
+  switch (mGameManagerState) {
+    case GameManagerState::MainMenu:
+      [this]() {
+        std::string input;
+        std::cout << "Welcome to the game!\n";
+        std::cout << "1. Play\n2. Exit\nSelect: ";
+        std::cin >> input;
+        switch (input[0]) {
+          case '1':
+            mGameManagerState = GameManagerState::Started;
+            break;
+          case '2':
+            mGameManagerState = GameManagerState::Exit;
+            break;
+        }
+      }();
+
+      break;
+    case GameManagerState::Started:
+      mBoard.play(event);
+      break;
+    case GameManagerState::Exit:
+      mWindow.close();
+      break;
+  }
+}
diff --git a/src/GameManager.hpp b/src/GameManager.hpp
index 9229ca8..cb8c970 100644
--- a/src/GameManager.hpp
+++ b/src/GameManager.hpp
@@ -18,10 +18,11 @@ class GameManager {
   // objects
   GameManagerState mGameManagerState = GameManagerState::MainMenu;
   sf::RenderWindow mWindow;
-  Board board;
+  Board mBoard;
 
   // methods
+ public:
   void start();
   void transitState(GameManagerState desired_state);
-  void exit;
-}
\ No newline at end of file
+  void performStateMachine(const sf::Event& event);
+};
\ No newline at end of file
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
new file mode 100644
index 0000000..7c480cd
--- /dev/null
+++ b/src/MainMenu.cpp
@@ -0,0 +1,9 @@
+#include "MainMenu.h"
+
+void MainMenu::process_and_draw(const sf::Event& event) {
+  // process inputs
+
+  // draw menu
+
+  // perform actions
+}
diff --git a/src/MainMenu.h b/src/MainMenu.h
index 7acca6d..367d7fa 100644
--- a/src/MainMenu.h
+++ b/src/MainMenu.h
@@ -1,3 +1,43 @@
 #pragma once
+#include <SFML/Graphics.hpp>
 
-class MainMenu {}
\ No newline at end of file
+// Item: Level
+// Level --> Items
+// Level contain items. each item contain pointer to next and previous level
+
+// MainMenu: Start, Options, Exit
+// Start: --> start game
+// Options --> back.
+// Exit --> exit.
+
+void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
+void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
+void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
+
+extern LevelOfMenu options;
+
+// menu objects
+LevelOfMenu main_menu{{
+                          {"Start", main_menu_start_callback, nullptr},
+                          {"Options", main_menu_options_callback, &options},
+                          {"Exit" main_menu_exit_callback, nullptr},
+                      },
+                      nullptr};
+
+void options_back_callback(void){std::cout << "Options: back clicked\n"}
+
+LevelOfMenu options{{"Back", options_back_callback}, &main_menu};
+
+class MainMenu {
+ public:
+  MainMenu(sf::Window& window, std::initializer_list<LevelOfMenu*> menuLevelPtrs,
+           LevelOfMenu* currentLevel = nullptr)
+      : mWindow{window}, mCurrentLevel{currentLevel} {}
+
+  void process_and_draw(const sf::Event& event);
+
+ private:
+  sf::Window& mWindow;
+  std::vector<LevelOfMenu*> mMenuLevelPtrs;
+  LevelOfMenu* mCurrentLevel = nullptr;
+};
\ No newline at end of file
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
new file mode 100644
index 0000000..a9f59ab
--- /dev/null
+++ b/src/MenuLevel.cpp
@@ -0,0 +1 @@
+#include "MenuLevel.hpp"
\ No newline at end of file
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
new file mode 100644
index 0000000..70e4b36
--- /dev/null
+++ b/src/MenuLevel.hpp
@@ -0,0 +1,15 @@
+#pragma once
+
+#include <string>
+#include <vector>
+
+#include "Button.hpp"
+
+class MenuLevel {
+  std::vector<Button> mButtons;
+  MenuLevel* mPrevLevel;
+
+ public:
+  MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr)
+      : mButtons{buttons}, mPrevLevel{prevLevel} {}
+};
\ No newline at end of file

From 510ca1a47ef184260f738ed4849d3154f8950dbe Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 18:09:14 +0200
Subject: [PATCH 20/31] - added MainMenu, Button and MenuLevel to CMakeLists

---
 CMakeLists.txt | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 1597dc3..86e8f03 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -50,7 +50,11 @@ add_library(
   src/Trace.cpp
   src/Players/DummyPlayer.cpp
   src/Players/KeyboardPlayer.cpp
-  src/Sound.cpp)
+  src/Sound.cpp
+  src/GameManager.cpp
+  src/MenuLevel.cpp
+  src/Button.cpp
+  )
 
 target_include_directories(tank_bot_fight_lib PRIVATE src)
 

From aaaa3090269cfd14bccd18b5b2a275471ea5fbc5 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 18:09:59 +0200
Subject: [PATCH 21/31] - added SFML Notes

- added Text_fonts notes
- added Graphics module - Shapes - notes
---
 Notes/Graphics module/Shapes.md | 217 ++++++++++++++++++++++++++++++++
 Notes/Text_fonts.md             |  93 ++++++++++++++
 2 files changed, 310 insertions(+)
 create mode 100644 Notes/Graphics module/Shapes.md
 create mode 100644 Notes/Text_fonts.md

diff --git a/Notes/Graphics module/Shapes.md b/Notes/Graphics module/Shapes.md
new file mode 100644
index 0000000..02fda9b
--- /dev/null
+++ b/Notes/Graphics module/Shapes.md	
@@ -0,0 +1,217 @@
+### Shapes
+
+## Introduction
+SFML provides a set of classes that represent simple shape entities. Each type of shape is a separate class, but they all derive from the same base class so that they have access to the same subset of common features. Each class then adds its own specifics: a radius property for the circle class, a size for the rectangle class, points for the polygon class, etc.
+
+
+## Common shape properties
+
+# Transformation (position, rotation, scale)
+These properties are common to all the SFML graphical classes, so they are explained in a separate tutorial: Transforming entities.
+
+# Color
+One of the basic properties of a shape is its color. You can change with the setFillColor function.
+
+
+sf::CircleShape shape(50.f);
+
+// set the shape color to green
+shape.setFillColor(sf::Color(100, 250, 50));
+
+
+# Outline
+Shapes can have an outline. You can set the thickness and color of the outline with the setOutlineThickness and setOutlineColor functions.
+
+
+sf::CircleShape shape(50.f);
+shape.setFillColor(sf::Color(150, 50, 250));
+
+// set a 10-pixel wide orange outline
+shape.setOutlineThickness(10.f);
+shape.setOutlineColor(sf::Color(250, 150, 100));
+
+
+
+By default, the outline is extruded outwards from the shape (e.g. if you have a circle with a radius of 10 and an outline thickness of 5, the total radius of the circle will be 15). You can make it extrude towards the center of the shape instead, by setting a negative thickness.
+
+To disable the outline, set its thickness to 0. If you only want the outline, you can set the fill color to `sf::Color::Transparent`.
+
+# Texture
+
+Shapes can also be textured, just like sprites. To specify a part of the texture to be mapped to the shape, you must use the setTextureRect function. It takes the texture rectangle to map to the bounding rectangle of the shape. This method doesn't offer maximum flexibility, but it is much easier to use than individually setting the texture coordinates of each point of the shape.
+
+
+sf::CircleShape shape(50);
+
+// map a 100x100 textured rectangle to the shape
+shape.setTexture(&texture); // texture is a sf::Texture
+shape.setTextureRect(sf::IntRect(10, 10, 100, 100));
+
+
+
+Note that the outline is not textured.
+It is important to know that the texture is modulated (multiplied) with the shape's fill color. If its fill color is sf::Color::White, the texture will appear unmodified.
+To disable texturing, call setTexture(NULL).
+
+
+
+# Drawing a shape
+Drawing a shape is as simple as drawing any other SFML entity:
+
+window.draw(shape);
+
+# Built-in shape types
+- Rectangles
+To draw rectangles, you can use the `sf::RectangleShape` class. 
+It has a single attribute: The size of the rectangle.
+
+// define a 120x50 rectangle
+sf::RectangleShape rectangle(sf::Vector2f(120.f, 50.f));
+
+// change the size to 100x100
+rectangle.setSize(sf::Vector2f(100.f, 100.f));
+
+- Circles
+Circles are represented by the `sf::CircleShape` class. 
+It has two attributes: The radius and the number of sides. The number of sides is an optional attribute, it allows you to adjust the "quality" of the circle: Circles have to be approximated by polygons with many sides (the graphics card is unable to draw a perfect circle directly), and this attribute defines how many sides your circle approximation will have. If you draw small circles, you'll probably only need a few sides. If you draw big circles, or zoom on regular circles, you'll most likely need more sides.
+
+
+// define a circle with radius = 200
+sf::CircleShape circle(200.f);
+
+// change the radius to 40
+circle.setRadius(40.f);
+
+// change the number of sides (points) to 100
+circle.setPointCount(100);
+
+
+- Regular polygons
+There's no dedicated class for regular polygons, in fact you can represent a regular polygon with any number of sides using the `sf::CircleShape` class: Since circles are approximated by polygons with many sides, you just have to play with the number of sides to get the desired polygons. 
+A `sf::CircleShape` with 3 points is a triangle, 
+with 4 points it's a square, etc.
+
+
+// define a triangle
+sf::CircleShape triangle(80.f, 3);
+
+// define a square
+sf::CircleShape square(80.f, 4);
+
+// define an octagon
+sf::CircleShape octagon(80.f, 8);
+
+
+
+- Convex shapes
+The sf::ConvexShape class is the ultimate shape class: It allows you to define any convex shape. SFML is unable to draw concave shapes. If you need to draw a concave shape, you'll have to split it into multiple convex polygons.
+
+To construct a convex shape, you must first set the number of points it should have and then define the points.
+
+// create an empty shape
+sf::ConvexShape convex;
+
+// resize it to 5 points
+convex.setPointCount(5);
+
+// define the points
+convex.setPoint(0, sf::Vector2f(0.f, 0.f));
+convex.setPoint(1, sf::Vector2f(150.f, 10.f));
+convex.setPoint(2, sf::Vector2f(120.f, 90.f));
+convex.setPoint(3, sf::Vector2f(30.f, 100.f));
+convex.setPoint(4, sf::Vector2f(0.f, 50.f));
+
+The order in which you define the points is very important. They must all be defined either in clockwise or counter-clockwise order. If you define them in an inconsistent order, the shape will be constructed incorrectly.
+- A convex shape
+
+Although the name of sf::ConvexShape implies that it should only be used to represent convex shapes, its requirements are a little more relaxed. In fact, the only requirement that your shape must meet is that if you went ahead and drew lines from its center of gravity to all of its points, these lines must be drawn in the same order. You are not allowed to "jump behind a previous line". Internally, convex shapes are automatically constructed using triangle fans, so if your shape is representable by a triangle fan, you can use sf::ConvexShape. With this relaxed definition, you can draw stars using sf::ConvexShape for example.
+- Lines
+
+There's no shape class for lines. The reason is simple: If your line has a thickness, it is a rectangle. If it doesn't, it can be drawn with a line primitive.
+
+Line with thickness:
+
+sf::RectangleShape line(sf::Vector2f(150.f, 5.f));
+line.rotate(45.f);
+
+A line shape drawn as a rectangle
+
+Line without thickness:
+
+sf::Vertex line[] =
+{
+    sf::Vertex(sf::Vector2f(10.f, 10.f)),
+    sf::Vertex(sf::Vector2f(150.f, 150.f))
+};
+
+window.draw(line, 2, sf::Lines);
+
+A line shape drawn as a primitive
+
+To learn more about vertices and primitives, you can read the tutorial on vertex arrays.
+Custom shape types
+
+You can extend the set of shape classes with your own shape types. To do so, you must derive from sf::Shape and override two functions:
+
+    getPointCount: return the number of points in the shape
+    getPoint: return a point of the shape
+
+You must also call the update() protected function whenever any point in your shape changes, so that the base class is informed and can update its internal geometry.
+
+Here is a complete example of a custom shape class: EllipseShape.
+
+class EllipseShape : public sf::Shape
+{
+public :
+
+    explicit EllipseShape(const sf::Vector2f& radius = sf::Vector2f(0.f, 0.f)) :
+    m_radius(radius)
+    {
+        update();
+    }
+
+    void setRadius(const sf::Vector2f& radius)
+    {
+        m_radius = radius;
+        update();
+    }
+
+    const sf::Vector2f& getRadius() const
+    {
+        return m_radius;
+    }
+
+    virtual std::size_t getPointCount() const
+    {
+        return 30; // fixed, but could be an attribute of the class if needed
+    }
+
+    virtual sf::Vector2f getPoint(std::size_t index) const
+    {
+        static const float pi = 3.141592654f;
+
+        float angle = index * 2 * pi / getPointCount() - pi / 2;
+        float x = std::cos(angle) * m_radius.x;
+        float y = std::sin(angle) * m_radius.y;
+
+        return sf::Vector2f(m_radius.x + x, m_radius.y + y);
+    }
+
+private :
+
+    sf::Vector2f m_radius;
+};
+
+An ellipse shape
+Antialiased shapes
+
+There's no option to anti-alias a single shape. To get anti-aliased shapes (i.e. shapes with smoothed edges), you have to enable anti-aliasing globally when you create the window, with the corresponding attribute of the sf::ContextSettings structure.
+
+sf::ContextSettings settings;
+settings.antialiasingLevel = 8;
+
+sf::RenderWindow window(sf::VideoMode(800, 600), "SFML shapes", sf::Style::Default, settings);
+
+Aliased vs antialiased shape
+
+Remember that anti-aliasing availability depends on the graphics card: It might not support it, or have it forced to disabled in the driver settings. 
\ No newline at end of file
diff --git a/Notes/Text_fonts.md b/Notes/Text_fonts.md
new file mode 100644
index 0000000..bd32869
--- /dev/null
+++ b/Notes/Text_fonts.md
@@ -0,0 +1,93 @@
+### Text and fonts
+
+## Loading a font
+Before drawing any text, you need to have an available font, just like any other program that prints text. Fonts are encapsulated in the `sf::Font` class, which provides three main features: 
+loading a font, getting glyphs (i.e. visual characters) from it, and reading its attributes. 
+In a typical program, you'll only have to make use of the first feature, loading the font, so let's focus on that first.
+
+The most common way of loading a font is from a file on disk, which is done with the loadFromFile function.
+
+sf::Font font;
+if (!font.loadFromFile("arial.ttf"))
+{
+    // error...
+}
+
+Note that SFML won't load your system fonts automatically, i.e. font.loadFromFile("Courier New") won't work. Firstly, because SFML requires file names, not font names, and secondly because SFML doesn't have magical access to your system's font folder. If you want to load a font, you will need to include the font file with your application, just like every other resource (images, sounds, ...).
+
+The loadFromFile function can sometimes fail with no obvious reason. First, check the error message that SFML prints to the standard output (check the console). If the message is "unable to open file", make sure that the working directory (which is the directory that any file path will be interpreted relative to) is what you think it is: When you run the application from your desktop environment, the working directory is the executable folder. However, when you launch your program from your IDE (Visual Studio, Code::Blocks, ...) the working directory might sometimes be set to the project directory instead. This can usually be changed quite easily in the project settings.
+
+You can also load a font file from memory (loadFromMemory), or from a custom input stream (loadFromStream).
+
+SFML supports most common font formats. The full list is available in the API documentation.
+
+That's all you need to do. Once your font is loaded, you can start drawing text.
+
+## Drawing text
+To draw text, you will be using the `sf::Text` class. It's very simple to use:
+
+sf::Text text;
+
+// select the font
+text.setFont(font); // font is a sf::Font
+
+// set the string to display
+text.setString("Hello world");
+
+// set the character size
+text.setCharacterSize(24); // in pixels, not points!
+
+// set the color
+text.setFillColor(sf::Color::Red);
+
+// set the text style
+text.setStyle(sf::Text::Bold | sf::Text::Underlined);
+
+...
+
+// inside the main loop, between window.clear() and window.display()
+window.draw(text);
+
+[Drawing text]
+
+Text can also be transformed: They have a position, an orientation and a scale. The functions involved are the same as for the sf::Sprite class and other SFML entities. They are explained in the Transforming entities tutorial.
+
+## How to avoid problems with non-ASCII characters?
+
+Handling non-ASCII characters (such as accented European, Arabic, or Chinese characters) correctly can be tricky. It requires a good understanding of the various encodings involved in the process of interpreting and drawing your text. To avoid having to bother with these encodings, there's a simple solution: Use wide literal strings.
+
+text.setString(L"יטאח");
+
+It is this simple "L" prefix in front of the string that makes it work by telling the compiler to produce a wide string. Wide strings are a strange beast in C++: the standard doesn't say anything about their size (16-bit? 32-bit?), nor about the encoding that they use (UTF-16? UTF-32?). However we know that on most platforms, if not all, they'll produce Unicode strings, and SFML knows how to handle them correctly.
+
+Note that the C++11 standard supports new character types and prefixes to build UTF-8, UTF-16 and UTF-32 string literals, but SFML doesn't support them yet.
+
+It may seem obvious, but you also have to make sure that the font that you use contains the characters that you want to draw. Indeed, fonts don't contain glyphs for all possible characters (there are more than 100000 in the Unicode standard!), and an Arabic font won't be able to display Japanese text, for example.
+
+
+## Making your own text class
+If sf::Text is too limited, or if you want to do something else with pre-rendered glyphs, sf::Font provides everything that you need.
+
+You can retrieve the texture which contains all the pre-rendered glyphs of a certain size:
+
+const sf::Texture& texture = font.getTexture(characterSize);
+
+It is important to note that glyphs are added to the texture when they are requested. There are so many characters (remember, more than 100000) that they can't all be generated when you load the font. Instead, they are rendered on the fly when you call the getGlyph function (see below).
+
+To do something meaningful with the font texture, you must get the texture coordinates of glyphs that are contained in it:
+
+sf::Glyph glyph = font.getGlyph(character, characterSize, bold);
+
+character is the UTF-32 code of the character whose glyph that you want to get. You must also specify the character size, and whether you want the bold or the regular version of the glyph.
+
+The sf::Glyph structure contains three members:
+
+    textureRect contains the texture coordinates of the glyph within the texture
+    bounds contains the bounding rectangle of the glyph, which helps position it relative to the baseline of the text
+    advance is the horizontal offset to apply to get the starting position of the next glyph in the text
+
+You can also get some of the font's other metrics, such as the kerning between two characters or the line spacing (always for a certain character size):
+
+int lineSpacing = font.getLineSpacing(characterSize);
+
+int kerning = font.getKerning(character1, character2, characterSize);

From f32aeb493702d4f548bc81f7b5fb0b8a9e9120f9 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 18:14:30 +0200
Subject: [PATCH 22/31] - Corrected skeleton of Button and MenuLevel

---
 src/Button.cpp    | 2 +-
 src/MenuLevel.cpp | 5 ++++-
 src/MenuLevel.hpp | 3 +--
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index 7751999..d4bc9e8 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -1,6 +1,6 @@
 #include "Button.hpp"
 
-Button::Button(std::string text, void (*callback)(void), LevelOfMenu* nextLevel = nullptr)
+Button::Button(std::string text, void (*callback)(void), MenuLevel* nextLevel = nullptr)
     : mText{text}, mCallback{callback}, mNextLevel{nextLevel} {}
 
 bool Button::is_clicked(const sf::Event& event){};
\ No newline at end of file
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
index a9f59ab..52e89fe 100644
--- a/src/MenuLevel.cpp
+++ b/src/MenuLevel.cpp
@@ -1 +1,4 @@
-#include "MenuLevel.hpp"
\ No newline at end of file
+#include "MenuLevel.hpp"
+
+MenuLevel::MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr)
+    : mButtons{buttons}, mPrevLevel{prevLevel} {}
\ No newline at end of file
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
index 70e4b36..9055cfc 100644
--- a/src/MenuLevel.hpp
+++ b/src/MenuLevel.hpp
@@ -10,6 +10,5 @@ class MenuLevel {
   MenuLevel* mPrevLevel;
 
  public:
-  MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr)
-      : mButtons{buttons}, mPrevLevel{prevLevel} {}
+  MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr);
 };
\ No newline at end of file

From 1baaa1d78a31cc13c039740cd8299fb38ca50c63 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 20:27:09 +0200
Subject: [PATCH 23/31] - Corrected implementation of skeleton

---
 src/Button.cpp    |  4 ++--
 src/Button.hpp    | 12 ++++++++----
 src/MainMenu.cpp  | 20 ++++++++++++++++++++
 src/MainMenu.h    | 38 +++++++-------------------------------
 src/MenuLevel.cpp |  3 +--
 src/MenuLevel.hpp |  4 +++-
 6 files changed, 41 insertions(+), 40 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index d4bc9e8..d160eaa 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -1,6 +1,6 @@
 #include "Button.hpp"
 
-Button::Button(std::string text, void (*callback)(void), MenuLevel* nextLevel = nullptr)
-    : mText{text}, mCallback{callback}, mNextLevel{nextLevel} {}
+Button::Button(std::string text, void (*callback)(void), Button_type button_type)
+    : mText{text}, mCallback{callback}, mButtonType{button_type} {}
 
 bool Button::is_clicked(const sf::Event& event){};
\ No newline at end of file
diff --git a/src/Button.hpp b/src/Button.hpp
index 2119c72..aa3098c 100644
--- a/src/Button.hpp
+++ b/src/Button.hpp
@@ -8,17 +8,21 @@
 
 using point_t = sf::Vector2u;
 
+enum class Button_type { Clickable, Not_clickable };
+
+class MenuLevel;
+
 class Button {
   std::string mText;
-  MenuLevel* mNextLevel;
   point_t mTopLeft;
   unsigned int mWidth;
   unsigned int mHeight;
-
   void (*mCallback)(void);
+  MenuLevel* mNextLevel;
+  Button_type mButtonType;
 
  public:
-  Button(std::string text, void (*callback)(void), MenuLevel* nextLevel = nullptr);
-
+  Button(std::string text, void (*callback)(void),
+         Button_type button_type = Button_type::Not_clickable);
   bool is_clicked(const sf::Event& event);
 };
\ No newline at end of file
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
index 7c480cd..0e22a92 100644
--- a/src/MainMenu.cpp
+++ b/src/MainMenu.cpp
@@ -1,5 +1,25 @@
 #include "MainMenu.h"
 
+void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
+void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
+void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
+
+void options_back_callback(void) { std::cout << "Options: back clicked\n"; }
+
+// button -> text, callback, clickable, nextLevel
+
+extern MenuLevel options;
+
+MenuLevel main_menu{{{"Start", main_menu_start_callback, Button_type::Clickable},
+                     {"Options", main_menu_options_callback, Button_type::Clickable},
+                     {"Exit", main_menu_exit_callback, Button_type::Clickable}}};
+
+MenuLevel options{{"Back", options_back_callback, Button_type::Clickable}};
+
+MainMenu::MainMenu(sf::Window& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
+                   MenuLevel* current_level)
+    : mWindow{window}, mCurrentLevel{current_level} {}
+
 void MainMenu::process_and_draw(const sf::Event& event) {
   // process inputs
 
diff --git a/src/MainMenu.h b/src/MainMenu.h
index 367d7fa..e6d8383 100644
--- a/src/MainMenu.h
+++ b/src/MainMenu.h
@@ -1,43 +1,19 @@
 #pragma once
 #include <SFML/Graphics.hpp>
+#include <iostream>
 
-// Item: Level
-// Level --> Items
-// Level contain items. each item contain pointer to next and previous level
-
-// MainMenu: Start, Options, Exit
-// Start: --> start game
-// Options --> back.
-// Exit --> exit.
-
-void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
-void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
-void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
-
-extern LevelOfMenu options;
-
-// menu objects
-LevelOfMenu main_menu{{
-                          {"Start", main_menu_start_callback, nullptr},
-                          {"Options", main_menu_options_callback, &options},
-                          {"Exit" main_menu_exit_callback, nullptr},
-                      },
-                      nullptr};
-
-void options_back_callback(void){std::cout << "Options: back clicked\n"}
-
-LevelOfMenu options{{"Back", options_back_callback}, &main_menu};
+#include "Button.hpp"
+#include "MenuLevel.hpp"
 
 class MainMenu {
  public:
-  MainMenu(sf::Window& window, std::initializer_list<LevelOfMenu*> menuLevelPtrs,
-           LevelOfMenu* currentLevel = nullptr)
-      : mWindow{window}, mCurrentLevel{currentLevel} {}
+  MainMenu(sf::Window& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
+           MenuLevel* current_level);
 
   void process_and_draw(const sf::Event& event);
 
  private:
   sf::Window& mWindow;
-  std::vector<LevelOfMenu*> mMenuLevelPtrs;
-  LevelOfMenu* mCurrentLevel = nullptr;
+  std::vector<MenuLevel*> mMenuLevelPtrs;
+  MenuLevel* mCurrentLevel = nullptr;
 };
\ No newline at end of file
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
index 52e89fe..b5a37e6 100644
--- a/src/MenuLevel.cpp
+++ b/src/MenuLevel.cpp
@@ -1,4 +1,3 @@
 #include "MenuLevel.hpp"
 
-MenuLevel::MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr)
-    : mButtons{buttons}, mPrevLevel{prevLevel} {}
\ No newline at end of file
+MenuLevel::MenuLevel(std::initializer_list<Button> buttons) : mButtons{buttons} {}
\ No newline at end of file
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
index 9055cfc..7e64a97 100644
--- a/src/MenuLevel.hpp
+++ b/src/MenuLevel.hpp
@@ -5,10 +5,12 @@
 
 #include "Button.hpp"
 
+class Button;
+
 class MenuLevel {
   std::vector<Button> mButtons;
   MenuLevel* mPrevLevel;
 
  public:
-  MenuLevel(std::initializer_list<Button> buttons, MenuLevel* prevLevel = nullptr);
+  MenuLevel(std::initializer_list<Button> buttons);
 };
\ No newline at end of file

From 510f69752ada6418ddc91fd17588ac5689d61368 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 20:42:32 +0200
Subject: [PATCH 24/31] - Added MainMenu to CMakeLists

---
 CMakeLists.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 86e8f03..ec1e962 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -51,6 +51,7 @@ add_library(
   src/Players/DummyPlayer.cpp
   src/Players/KeyboardPlayer.cpp
   src/Sound.cpp
+  src/MainMenu.cpp
   src/GameManager.cpp
   src/MenuLevel.cpp
   src/Button.cpp

From 39e81d73273ee1b43ac7aa8eeb8db4dd7c75941f Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 26 Oct 2023 20:42:54 +0200
Subject: [PATCH 25/31] - Improvements

---
 src/Button.cpp      |  5 +++--
 src/Button.hpp      |  2 +-
 src/GameManager.cpp | 20 +++++++++++++++++++-
 src/GameManager.hpp |  2 ++
 src/MainMenu.cpp    | 20 ++------------------
 src/MainMenu.h      |  4 ++--
 6 files changed, 29 insertions(+), 24 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index d160eaa..0f17cde 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -1,6 +1,7 @@
 #include "Button.hpp"
 
-Button::Button(std::string text, void (*callback)(void), Button_type button_type)
-    : mText{text}, mCallback{callback}, mButtonType{button_type} {}
+Button::Button(std::string text, void (*callback)(void), Button_type button_type,
+               MenuLevel* next_level)
+    : mText{text}, mCallback{callback}, mButtonType{button_type}, mNextLevel{next_level} {}
 
 bool Button::is_clicked(const sf::Event& event){};
\ No newline at end of file
diff --git a/src/Button.hpp b/src/Button.hpp
index aa3098c..82b6615 100644
--- a/src/Button.hpp
+++ b/src/Button.hpp
@@ -23,6 +23,6 @@ class Button {
 
  public:
   Button(std::string text, void (*callback)(void),
-         Button_type button_type = Button_type::Not_clickable);
+         Button_type button_type = Button_type::Not_clickable, MenuLevel* next_level = nullptr);
   bool is_clicked(const sf::Event& event);
 };
\ No newline at end of file
diff --git a/src/GameManager.cpp b/src/GameManager.cpp
index e00a92f..b8e0fec 100644
--- a/src/GameManager.cpp
+++ b/src/GameManager.cpp
@@ -2,8 +2,26 @@
 
 #include "Size.hpp"
 
+void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
+void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
+void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
+
+void options_back_callback(void) { std::cout << "Options: back clicked\n"; }
+
+// button -> text, callback, clickable, nextLevel
+
+extern MenuLevel options;
+
+MenuLevel main_menu{{{"Start", main_menu_start_callback, Button_type::Clickable, nullptr},
+                     {"Options", main_menu_options_callback, Button_type::Clickable, &options},
+                     {"Exit", main_menu_exit_callback, Button_type::Clickable, nullptr}}};
+
+MenuLevel options{{"Back", options_back_callback, Button_type::Clickable, &main_menu}};
+
 GameManager::GameManager()
-    : mWindow{sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"}, mBoard{mWindow} {}
+    : mWindow{sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"},
+      mBoard{mWindow},
+      mMainMenu{mWindow, {&main_menu, &options}, &main_menu} {}
 
 void GameManager::start() {
   while (mWindow.isOpen()) {
diff --git a/src/GameManager.hpp b/src/GameManager.hpp
index cb8c970..f7b9bb6 100644
--- a/src/GameManager.hpp
+++ b/src/GameManager.hpp
@@ -3,6 +3,7 @@
 #include <SFML/Graphics.hpp>
 
 #include "Board.hpp"
+#include "MainMenu.h"
 
 enum class GameManagerState {
   MainMenu,
@@ -18,6 +19,7 @@ class GameManager {
   // objects
   GameManagerState mGameManagerState = GameManagerState::MainMenu;
   sf::RenderWindow mWindow;
+  MainMenu mMainMenu;
   Board mBoard;
 
   // methods
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
index 0e22a92..87b9c36 100644
--- a/src/MainMenu.cpp
+++ b/src/MainMenu.cpp
@@ -1,24 +1,8 @@
 #include "MainMenu.h"
 
-void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
-void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
-void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
-
-void options_back_callback(void) { std::cout << "Options: back clicked\n"; }
-
-// button -> text, callback, clickable, nextLevel
-
-extern MenuLevel options;
-
-MenuLevel main_menu{{{"Start", main_menu_start_callback, Button_type::Clickable},
-                     {"Options", main_menu_options_callback, Button_type::Clickable},
-                     {"Exit", main_menu_exit_callback, Button_type::Clickable}}};
-
-MenuLevel options{{"Back", options_back_callback, Button_type::Clickable}};
-
-MainMenu::MainMenu(sf::Window& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
+MainMenu::MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
                    MenuLevel* current_level)
-    : mWindow{window}, mCurrentLevel{current_level} {}
+    : mWindow{window}, mMenuLevelPtrs{menu_level_ptrs}, mCurrentLevel{current_level} {}
 
 void MainMenu::process_and_draw(const sf::Event& event) {
   // process inputs
diff --git a/src/MainMenu.h b/src/MainMenu.h
index e6d8383..6a8a0d1 100644
--- a/src/MainMenu.h
+++ b/src/MainMenu.h
@@ -7,13 +7,13 @@
 
 class MainMenu {
  public:
-  MainMenu(sf::Window& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
+  MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
            MenuLevel* current_level);
 
   void process_and_draw(const sf::Event& event);
 
  private:
-  sf::Window& mWindow;
+  sf::RenderWindow& mWindow;
   std::vector<MenuLevel*> mMenuLevelPtrs;
   MenuLevel* mCurrentLevel = nullptr;
 };
\ No newline at end of file

From b427c5ba2dcfb25003503199ce93fa331e05a678 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 2 Nov 2023 18:38:20 +0100
Subject: [PATCH 26/31] Added MenuItem base class for Button class

- added MenuItem base class for Button class
- added MenuItem.cpp to CMakeLists
---
 CMakeLists.txt   |  1 +
 src/MenuItem.cpp |  3 +++
 src/MenuItem.hpp | 10 ++++++++++
 3 files changed, 14 insertions(+)
 create mode 100644 src/MenuItem.cpp
 create mode 100644 src/MenuItem.hpp

diff --git a/CMakeLists.txt b/CMakeLists.txt
index ec1e962..102f88f 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -55,6 +55,7 @@ add_library(
   src/GameManager.cpp
   src/MenuLevel.cpp
   src/Button.cpp
+  src/MenuItem.cpp
   )
 
 target_include_directories(tank_bot_fight_lib PRIVATE src)
diff --git a/src/MenuItem.cpp b/src/MenuItem.cpp
new file mode 100644
index 0000000..eadca8b
--- /dev/null
+++ b/src/MenuItem.cpp
@@ -0,0 +1,3 @@
+#include "MenuItem.hpp"
+
+MenuItem::MenuItem(sf::Vector2f position) : mPosition{position} {}
\ No newline at end of file
diff --git a/src/MenuItem.hpp b/src/MenuItem.hpp
new file mode 100644
index 0000000..cdfaaff
--- /dev/null
+++ b/src/MenuItem.hpp
@@ -0,0 +1,10 @@
+#pragma once
+
+#include <SFML/Graphics.hpp>
+
+class MenuItem {
+  sf::Vector2f mPosition;
+
+ public:
+  MenuItem(sf::Vector2f position);
+};
\ No newline at end of file

From 9ebe97e76418341fe392f34d80b1b426405ca3a7 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 2 Nov 2023 18:59:24 +0100
Subject: [PATCH 27/31] Adapted to MenuItem class

---
 src/Button.cpp      | 30 ++++++++++++++++++++++++++----
 src/Button.hpp      | 20 ++++++++++++--------
 src/GameManager.cpp | 21 ++++++++++++++++-----
 src/MainMenu.cpp    |  1 +
 src/MenuItem.hpp    |  1 +
 src/MenuLevel.cpp   | 42 +++++++++++++++++++++++++++++++++++++++++-
 src/MenuLevel.hpp   |  2 ++
 7 files changed, 99 insertions(+), 18 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index 0f17cde..cb79699 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -1,7 +1,29 @@
 #include "Button.hpp"
 
-Button::Button(std::string text, void (*callback)(void), Button_type button_type,
-               MenuLevel* next_level)
-    : mText{text}, mCallback{callback}, mButtonType{button_type}, mNextLevel{next_level} {}
+Button::Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
+               void (*callback)(void), MenuLevel* next_level)
+    : mText{text},
+      mCallback{callback},
+      MenuItem{top_left_corner},
+      mWidth{width},
+      mHeight{height},
+      mNextLevel{next_level} {}
 
-bool Button::is_clicked(const sf::Event& event){};
\ No newline at end of file
+bool Button::is_clicked(const sf::Event& event) {}
+
+void Button::draw(sf::RenderWindow& window) {
+  sf::RectangleShape rectangle(sf::Vector2f(mWidth, mHeight));
+
+  if (mIsSelected) {
+    rectangle.setOutlineThickness(10.0f);
+    rectangle.setOutlineColor(sf::Color(255, 0, 0));
+  } else {
+    rectangle.setOutlineThickness(0.0f);
+  }
+  rectangle.move(mPosition);
+  window.draw(rectangle);
+}
+
+void Button::select() { mIsSelected = true; }
+
+void Button::deselect() { mIsSelected = false; }
\ No newline at end of file
diff --git a/src/Button.hpp b/src/Button.hpp
index 82b6615..71f0646 100644
--- a/src/Button.hpp
+++ b/src/Button.hpp
@@ -4,25 +4,29 @@
 #include <string>
 #include <vector>
 
+#include "MenuItem.hpp"
 #include "MenuLevel.hpp"
 
-using point_t = sf::Vector2u;
-
-enum class Button_type { Clickable, Not_clickable };
+using point_t = sf::Vector2f;
 
 class MenuLevel;
 
-class Button {
+class Button : MenuItem {
   std::string mText;
-  point_t mTopLeft;
   unsigned int mWidth;
   unsigned int mHeight;
+
   void (*mCallback)(void);
+
+  bool mIsSelected = false;
+
   MenuLevel* mNextLevel;
-  Button_type mButtonType;
 
  public:
-  Button(std::string text, void (*callback)(void),
-         Button_type button_type = Button_type::Not_clickable, MenuLevel* next_level = nullptr);
+  Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
+         void (*callback)(void), MenuLevel* next_level = nullptr);
   bool is_clicked(const sf::Event& event);
+  void draw(sf::RenderWindow& window);
+  void select();
+  void deselect();
 };
\ No newline at end of file
diff --git a/src/GameManager.cpp b/src/GameManager.cpp
index b8e0fec..2fe7139 100644
--- a/src/GameManager.cpp
+++ b/src/GameManager.cpp
@@ -12,11 +12,20 @@ void options_back_callback(void) { std::cout << "Options: back clicked\n"; }
 
 extern MenuLevel options;
 
-MenuLevel main_menu{{{"Start", main_menu_start_callback, Button_type::Clickable, nullptr},
-                     {"Options", main_menu_options_callback, Button_type::Clickable, &options},
-                     {"Exit", main_menu_exit_callback, Button_type::Clickable, nullptr}}};
+const unsigned int buttonWidth = WIDTH / 5;
+const unsigned int buttonHeight = HEIGHT / 10;
+constexpr unsigned int verticalSpacing = 20;
 
-MenuLevel options{{"Back", options_back_callback, Button_type::Clickable, &main_menu}};
+MenuLevel main_menu{
+    {{"Start", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 1), buttonWidth,
+      buttonHeight, main_menu_start_callback, nullptr},
+     {"Options", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 3),
+      buttonWidth, buttonHeight, main_menu_options_callback, &options},
+     {"Exit", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 5), buttonWidth,
+      buttonHeight, main_menu_exit_callback, nullptr}}};
+
+MenuLevel options{{"Back", point_t(WIDTH / 2 - buttonWidth, 2 * buttonHeight + 20), buttonWidth,
+                   buttonHeight, options_back_callback, &main_menu}};
 
 GameManager::GameManager()
     : mWindow{sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"},
@@ -50,6 +59,8 @@ void GameManager::start() {
 void GameManager::performStateMachine(const sf::Event& event) {
   switch (mGameManagerState) {
     case GameManagerState::MainMenu:
+      mMainMenu.process_and_draw(event);
+      /*
       [this]() {
         std::string input;
         std::cout << "Welcome to the game!\n";
@@ -64,7 +75,7 @@ void GameManager::performStateMachine(const sf::Event& event) {
             break;
         }
       }();
-
+      */
       break;
     case GameManagerState::Started:
       mBoard.play(event);
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
index 87b9c36..a186168 100644
--- a/src/MainMenu.cpp
+++ b/src/MainMenu.cpp
@@ -6,6 +6,7 @@ MainMenu::MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> m
 
 void MainMenu::process_and_draw(const sf::Event& event) {
   // process inputs
+  mCurrentLevel->draw(mWindow, event);
 
   // draw menu
 
diff --git a/src/MenuItem.hpp b/src/MenuItem.hpp
index cdfaaff..520248b 100644
--- a/src/MenuItem.hpp
+++ b/src/MenuItem.hpp
@@ -3,6 +3,7 @@
 #include <SFML/Graphics.hpp>
 
 class MenuItem {
+ protected:
   sf::Vector2f mPosition;
 
  public:
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
index b5a37e6..6899d8c 100644
--- a/src/MenuLevel.cpp
+++ b/src/MenuLevel.cpp
@@ -1,3 +1,43 @@
 #include "MenuLevel.hpp"
 
-MenuLevel::MenuLevel(std::initializer_list<Button> buttons) : mButtons{buttons} {}
\ No newline at end of file
+MenuLevel::MenuLevel(std::initializer_list<Button> buttons) : mButtons{buttons} {}
+
+void MenuLevel::draw(sf::RenderWindow& window, const sf::Event& event) {
+  // process input
+  static sf::Keyboard::Key lastPressedKey;
+  if (event.type == sf::Event::KeyPressed) {
+    if (lastPressedKey != event.key.code) {
+      if (event.key.code == sf::Keyboard::Up) {
+        mSelectedButton--;
+        if (mSelectedButton < 0) {
+          mSelectedButton = mButtons.size() - 1;
+        }
+      }
+
+      if (event.key.code == sf::Keyboard::Down) {
+        mSelectedButton++;
+        if (mSelectedButton >= mButtons.size()) {
+          mSelectedButton = 0;
+        }
+      }
+    }
+
+    lastPressedKey = event.key.code;
+  } else if (event.type == sf::Event::KeyReleased) {
+    lastPressedKey = sf::Keyboard::Unknown;
+  }
+
+  // select button
+  for (int i = 0; i < mButtons.size(); ++i) {
+    if (i == mSelectedButton) {
+      mButtons[i].select();
+    } else {
+      mButtons[i].deselect();
+    }
+  }
+
+  // draw buttons
+  for (auto& button : mButtons) {
+    button.draw(window);
+  }
+}
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
index 7e64a97..5d6bada 100644
--- a/src/MenuLevel.hpp
+++ b/src/MenuLevel.hpp
@@ -10,7 +10,9 @@ class Button;
 class MenuLevel {
   std::vector<Button> mButtons;
   MenuLevel* mPrevLevel;
+  int mSelectedButton = 0;
 
  public:
   MenuLevel(std::initializer_list<Button> buttons);
+  void draw(sf::RenderWindow&, const sf::Event& event);
 };
\ No newline at end of file

From 106b9cf67cc635d30b2a08a883e0183e9f9b7a9c Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 2 Nov 2023 20:09:58 +0100
Subject: [PATCH 28/31] Renamed MainMenu.h to MainMenu.hpp

---
 src/{MainMenu.h => MainMenu.hpp} | 1 +
 1 file changed, 1 insertion(+)
 rename src/{MainMenu.h => MainMenu.hpp} (96%)

diff --git a/src/MainMenu.h b/src/MainMenu.hpp
similarity index 96%
rename from src/MainMenu.h
rename to src/MainMenu.hpp
index 6a8a0d1..e374663 100644
--- a/src/MainMenu.h
+++ b/src/MainMenu.hpp
@@ -16,4 +16,5 @@ class MainMenu {
   sf::RenderWindow& mWindow;
   std::vector<MenuLevel*> mMenuLevelPtrs;
   MenuLevel* mCurrentLevel = nullptr;
+  sf::Font mFont;
 };
\ No newline at end of file

From aa48ccffc2a58bbfbcb490a43c5625567b0b3b90 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Thu, 2 Nov 2023 20:11:49 +0100
Subject: [PATCH 29/31] Added text to Button

---
 src/Button.cpp      | 20 +++++++++++++++-----
 src/Button.hpp      |  9 +++------
 src/GameManager.hpp |  2 +-
 src/MainMenu.cpp    | 11 ++++++++---
 src/MenuLevel.cpp   |  8 +++++---
 src/MenuLevel.hpp   |  3 ++-
 6 files changed, 34 insertions(+), 19 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index cb79699..fda7d0c 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -2,28 +2,38 @@
 
 Button::Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
                void (*callback)(void), MenuLevel* next_level)
-    : mText{text},
+    : mTextContent{text},
       mCallback{callback},
       MenuItem{top_left_corner},
       mWidth{width},
       mHeight{height},
       mNextLevel{next_level} {}
 
-bool Button::is_clicked(const sf::Event& event) {}
-
-void Button::draw(sf::RenderWindow& window) {
+void Button::draw(sf::RenderWindow& window, const sf::Font& font) {
+  // draw rectangle
   sf::RectangleShape rectangle(sf::Vector2f(mWidth, mHeight));
 
+  // draw rectangle outline
   if (mIsSelected) {
     rectangle.setOutlineThickness(10.0f);
     rectangle.setOutlineColor(sf::Color(255, 0, 0));
   } else {
     rectangle.setOutlineThickness(0.0f);
   }
+
+  // set text
+  mText.setFont(font);
+  mText.setCharacterSize(24);
+  mText.setColor(sf::Color::Red);
+  mText.setString(mTextContent);
+
+  // move objects in window and draw
   rectangle.move(mPosition);
   window.draw(rectangle);
+  mText.move(mPosition);
+  window.draw(mText);
 }
 
 void Button::select() { mIsSelected = true; }
 
-void Button::deselect() { mIsSelected = false; }
\ No newline at end of file
+void Button::deselect() { mIsSelected = false; }
diff --git a/src/Button.hpp b/src/Button.hpp
index 71f0646..bc4834f 100644
--- a/src/Button.hpp
+++ b/src/Button.hpp
@@ -12,21 +12,18 @@ using point_t = sf::Vector2f;
 class MenuLevel;
 
 class Button : MenuItem {
-  std::string mText;
+  std::string mTextContent;
+  sf::Text mText;
   unsigned int mWidth;
   unsigned int mHeight;
-
   void (*mCallback)(void);
-
   bool mIsSelected = false;
-
   MenuLevel* mNextLevel;
 
  public:
   Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
          void (*callback)(void), MenuLevel* next_level = nullptr);
-  bool is_clicked(const sf::Event& event);
-  void draw(sf::RenderWindow& window);
+  void draw(sf::RenderWindow& window, const sf::Font& font);
   void select();
   void deselect();
 };
\ No newline at end of file
diff --git a/src/GameManager.hpp b/src/GameManager.hpp
index f7b9bb6..4e09d74 100644
--- a/src/GameManager.hpp
+++ b/src/GameManager.hpp
@@ -3,7 +3,7 @@
 #include <SFML/Graphics.hpp>
 
 #include "Board.hpp"
-#include "MainMenu.h"
+#include "MainMenu.hpp"
 
 enum class GameManagerState {
   MainMenu,
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
index a186168..7633cb6 100644
--- a/src/MainMenu.cpp
+++ b/src/MainMenu.cpp
@@ -1,14 +1,19 @@
-#include "MainMenu.h"
+#include "MainMenu.hpp"
+
+#include "Files.hpp"
 
 MainMenu::MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
                    MenuLevel* current_level)
-    : mWindow{window}, mMenuLevelPtrs{menu_level_ptrs}, mCurrentLevel{current_level} {}
+    : mWindow{window}, mMenuLevelPtrs{menu_level_ptrs}, mCurrentLevel{current_level} {
+  mFont.loadFromFile(files::asset_path() + "DejaVuSans.ttf");
+}
 
 void MainMenu::process_and_draw(const sf::Event& event) {
   // process inputs
-  mCurrentLevel->draw(mWindow, event);
+  mCurrentLevel->processEvents(event);
 
   // draw menu
+  mCurrentLevel->draw(mWindow, mFont);
 
   // perform actions
 }
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
index 6899d8c..62f2575 100644
--- a/src/MenuLevel.cpp
+++ b/src/MenuLevel.cpp
@@ -2,7 +2,7 @@
 
 MenuLevel::MenuLevel(std::initializer_list<Button> buttons) : mButtons{buttons} {}
 
-void MenuLevel::draw(sf::RenderWindow& window, const sf::Event& event) {
+void MenuLevel::processEvents(const sf::Event& event) {
   // process input
   static sf::Keyboard::Key lastPressedKey;
   if (event.type == sf::Event::KeyPressed) {
@@ -26,8 +26,10 @@ void MenuLevel::draw(sf::RenderWindow& window, const sf::Event& event) {
   } else if (event.type == sf::Event::KeyReleased) {
     lastPressedKey = sf::Keyboard::Unknown;
   }
+}
 
-  // select button
+void MenuLevel::draw(sf::RenderWindow& window, const sf::Font& font) {
+  // select button - draw outline
   for (int i = 0; i < mButtons.size(); ++i) {
     if (i == mSelectedButton) {
       mButtons[i].select();
@@ -38,6 +40,6 @@ void MenuLevel::draw(sf::RenderWindow& window, const sf::Event& event) {
 
   // draw buttons
   for (auto& button : mButtons) {
-    button.draw(window);
+    button.draw(window, font);
   }
 }
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
index 5d6bada..d6179b2 100644
--- a/src/MenuLevel.hpp
+++ b/src/MenuLevel.hpp
@@ -14,5 +14,6 @@ class MenuLevel {
 
  public:
   MenuLevel(std::initializer_list<Button> buttons);
-  void draw(sf::RenderWindow&, const sf::Event& event);
+  void draw(sf::RenderWindow&, const sf::Font& font);
+  void processEvents(const sf::Event& event);
 };
\ No newline at end of file

From 98edbb37c33af779923c05759b5053f0173a5feb Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <bartez33a@gmail.com>
Date: Sat, 4 Nov 2023 14:58:02 +0100
Subject: [PATCH 30/31] Improved implementation

---
 src/Button.cpp      | 23 +++++++++++---
 src/Button.hpp      | 21 ++++++++-----
 src/GameManager.cpp | 76 +++++++++++++++++++++++++--------------------
 src/GameManager.hpp | 14 ++++++---
 src/MainMenu.cpp    |  8 +++--
 src/MainMenu.hpp    |  1 -
 src/MenuItem.hpp    |  6 ++--
 src/MenuLevel.cpp   | 26 +++++++++++++---
 src/MenuLevel.hpp   | 14 ++++++---
 9 files changed, 124 insertions(+), 65 deletions(-)

diff --git a/src/Button.cpp b/src/Button.cpp
index fda7d0c..f3b0aed 100644
--- a/src/Button.cpp
+++ b/src/Button.cpp
@@ -1,12 +1,14 @@
 #include "Button.hpp"
 
-Button::Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
-               void (*callback)(void), MenuLevel* next_level)
+Button::Button(std::string text, sf::Vector2f top_left_corner, unsigned int width,
+               unsigned int height, void (*callback)(void), ButtonType button_type,
+               MenuLevel* next_level)
     : mTextContent{text},
       mCallback{callback},
       MenuItem{top_left_corner},
       mWidth{width},
       mHeight{height},
+      mButtonType{button_type},
       mNextLevel{next_level} {}
 
 void Button::draw(sf::RenderWindow& window, const sf::Font& font) {
@@ -28,12 +30,25 @@ void Button::draw(sf::RenderWindow& window, const sf::Font& font) {
   mText.setString(mTextContent);
 
   // move objects in window and draw
-  rectangle.move(mPosition);
+  rectangle.setPosition(mPosition);
   window.draw(rectangle);
-  mText.move(mPosition);
+
+  // center text
+  mText.setOrigin(mText.getGlobalBounds().getSize() / 2.f + mText.getLocalBounds().getPosition());
+  mText.setPosition(rectangle.getPosition() + (rectangle.getSize() / 2.f));
   window.draw(mText);
 }
 
 void Button::select() { mIsSelected = true; }
 
 void Button::deselect() { mIsSelected = false; }
+
+void Button::click() {
+  if (mButtonType == ButtonType::Callback && mIsSelected) {
+    mCallback();
+  }
+}
+
+ButtonType Button::get_button_type() const { return mButtonType; }
+
+MenuLevel* Button::get_next_level() const { return mNextLevel; }
diff --git a/src/Button.hpp b/src/Button.hpp
index bc4834f..14bae50 100644
--- a/src/Button.hpp
+++ b/src/Button.hpp
@@ -7,11 +7,22 @@
 #include "MenuItem.hpp"
 #include "MenuLevel.hpp"
 
-using point_t = sf::Vector2f;
+enum class ButtonType { Callback, LevelChanger };
 
 class MenuLevel;
 
 class Button : MenuItem {
+ public:
+  Button(std::string text, sf::Vector2f top_left_corner, unsigned int width, unsigned int height,
+         void (*callback)(void), ButtonType button_type, MenuLevel* next_level = nullptr);
+  void draw(sf::RenderWindow& window, const sf::Font& font);
+  void select();
+  void deselect();
+  void click();
+  ButtonType get_button_type() const;
+  MenuLevel* get_next_level() const;
+
+ private:
   std::string mTextContent;
   sf::Text mText;
   unsigned int mWidth;
@@ -19,11 +30,5 @@ class Button : MenuItem {
   void (*mCallback)(void);
   bool mIsSelected = false;
   MenuLevel* mNextLevel;
-
- public:
-  Button(std::string text, point_t top_left_corner, unsigned int width, unsigned int height,
-         void (*callback)(void), MenuLevel* next_level = nullptr);
-  void draw(sf::RenderWindow& window, const sf::Font& font);
-  void select();
-  void deselect();
+  ButtonType mButtonType;
 };
\ No newline at end of file
diff --git a/src/GameManager.cpp b/src/GameManager.cpp
index 2fe7139..f8ce6c6 100644
--- a/src/GameManager.cpp
+++ b/src/GameManager.cpp
@@ -2,14 +2,21 @@
 
 #include "Size.hpp"
 
-void main_menu_start_callback(void) { std::cout << "Start clicked!\n"; }
-void main_menu_options_callback(void) { std::cout << "Options clicked!\n"; }
-void main_menu_exit_callback(void) { std::cout << "Exit clicked!\n"; }
+// define static variables
+bool GameManager::request_state_change = false;
+GameManagerState GameManager::desired_state = GameManagerState::InvalidState;
 
-void options_back_callback(void) { std::cout << "Options: back clicked\n"; }
-
-// button -> text, callback, clickable, nextLevel
+// Button callbacks:
+void main_menu_start_callback(void) {
+  GameManager::request_state_change = true;
+  GameManager::desired_state = GameManagerState::Started;
+}
+void main_menu_exit_callback(void) {
+  GameManager::request_state_change = true;
+  GameManager::desired_state = GameManagerState::Exit;
+}
 
+// define menus
 extern MenuLevel options;
 
 const unsigned int buttonWidth = WIDTH / 5;
@@ -17,15 +24,15 @@ const unsigned int buttonHeight = HEIGHT / 10;
 constexpr unsigned int verticalSpacing = 20;
 
 MenuLevel main_menu{
-    {{"Start", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 1), buttonWidth,
-      buttonHeight, main_menu_start_callback, nullptr},
-     {"Options", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 3),
-      buttonWidth, buttonHeight, main_menu_options_callback, &options},
-     {"Exit", point_t((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 5), buttonWidth,
-      buttonHeight, main_menu_exit_callback, nullptr}}};
+    {{"Start", sf::Vector2f((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 1),
+      buttonWidth, buttonHeight, main_menu_start_callback, ButtonType::Callback, nullptr},
+     {"Options", sf::Vector2f((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 3),
+      buttonWidth, buttonHeight, nullptr, ButtonType::LevelChanger, &options},
+     {"Exit", sf::Vector2f((WIDTH - buttonWidth) / 2, verticalSpacing + buttonHeight * 5),
+      buttonWidth, buttonHeight, main_menu_exit_callback, ButtonType::Callback, nullptr}}};
 
-MenuLevel options{{"Back", point_t(WIDTH / 2 - buttonWidth, 2 * buttonHeight + 20), buttonWidth,
-                   buttonHeight, options_back_callback, &main_menu}};
+MenuLevel options{{"Back", sf::Vector2f(WIDTH / 2 - buttonWidth, 2 * buttonHeight + 20),
+                   buttonWidth, buttonHeight, nullptr, ButtonType::LevelChanger, &main_menu}};
 
 GameManager::GameManager()
     : mWindow{sf::VideoMode(WIDTH, HEIGHT), "TankBotFight"},
@@ -34,10 +41,8 @@ GameManager::GameManager()
 
 void GameManager::start() {
   while (mWindow.isOpen()) {
-    // check all the window's events that were triggered since the last iteration of the loop
     sf::Event event;
     while (mWindow.pollEvent(event)) {
-      // "close requested" event: we close the window
       if (event.type == sf::Event::Closed) {
         mGameManagerState = GameManagerState::Exit;
       }
@@ -55,27 +60,11 @@ void GameManager::start() {
     mWindow.display();
   }
 }
-#include <iostream>
+
 void GameManager::performStateMachine(const sf::Event& event) {
   switch (mGameManagerState) {
     case GameManagerState::MainMenu:
       mMainMenu.process_and_draw(event);
-      /*
-      [this]() {
-        std::string input;
-        std::cout << "Welcome to the game!\n";
-        std::cout << "1. Play\n2. Exit\nSelect: ";
-        std::cin >> input;
-        switch (input[0]) {
-          case '1':
-            mGameManagerState = GameManagerState::Started;
-            break;
-          case '2':
-            mGameManagerState = GameManagerState::Exit;
-            break;
-        }
-      }();
-      */
       break;
     case GameManagerState::Started:
       mBoard.play(event);
@@ -84,4 +73,25 @@ void GameManager::performStateMachine(const sf::Event& event) {
       mWindow.close();
       break;
   }
+
+  // check if state change is requested
+  if (request_state_change) {
+    request_state_change = false;
+    transitState();
+  }
+}
+
+void GameManager::transitState() {
+  switch (mGameManagerState) {
+    case GameManagerState::MainMenu:
+      if (desired_state == GameManagerState::Started) {
+        mGameManagerState = GameManagerState::Started;
+      } else if (desired_state == GameManagerState::Exit) {
+        mGameManagerState = GameManagerState::Exit;
+      }
+      break;
+    case GameManagerState::Started:
+      // TODO -> pause game
+      break;
+  }
 }
diff --git a/src/GameManager.hpp b/src/GameManager.hpp
index 4e09d74..dd61d5f 100644
--- a/src/GameManager.hpp
+++ b/src/GameManager.hpp
@@ -9,11 +9,15 @@ enum class GameManagerState {
   MainMenu,
   Started,
   Exit,
+  InvalidState,
 };
 
 class GameManager {
  public:
   GameManager();
+  void start();
+  void performStateMachine(const sf::Event& event);
+  void transitState();
 
  private:
   // objects
@@ -21,10 +25,10 @@ class GameManager {
   sf::RenderWindow mWindow;
   MainMenu mMainMenu;
   Board mBoard;
+  static bool request_state_change;
+  static GameManagerState desired_state;
 
-  // methods
- public:
-  void start();
-  void transitState(GameManagerState desired_state);
-  void performStateMachine(const sf::Event& event);
+  // friends: buttons' callbacks
+  friend void main_menu_start_callback(void);
+  friend void main_menu_exit_callback(void);
 };
\ No newline at end of file
diff --git a/src/MainMenu.cpp b/src/MainMenu.cpp
index 7633cb6..2dd4f44 100644
--- a/src/MainMenu.cpp
+++ b/src/MainMenu.cpp
@@ -9,11 +9,15 @@ MainMenu::MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> m
 }
 
 void MainMenu::process_and_draw(const sf::Event& event) {
+  // check if menu should be changed
+  if (mCurrentLevel->is_level_change_requested()) {
+    mCurrentLevel->reset_level_request();
+    mCurrentLevel = mCurrentLevel->get_next_level();
+  }
+
   // process inputs
   mCurrentLevel->processEvents(event);
 
   // draw menu
   mCurrentLevel->draw(mWindow, mFont);
-
-  // perform actions
 }
diff --git a/src/MainMenu.hpp b/src/MainMenu.hpp
index e374663..017cdf3 100644
--- a/src/MainMenu.hpp
+++ b/src/MainMenu.hpp
@@ -9,7 +9,6 @@ class MainMenu {
  public:
   MainMenu(sf::RenderWindow& window, std::initializer_list<MenuLevel*> menu_level_ptrs,
            MenuLevel* current_level);
-
   void process_and_draw(const sf::Event& event);
 
  private:
diff --git a/src/MenuItem.hpp b/src/MenuItem.hpp
index 520248b..1bfa3a2 100644
--- a/src/MenuItem.hpp
+++ b/src/MenuItem.hpp
@@ -3,9 +3,9 @@
 #include <SFML/Graphics.hpp>
 
 class MenuItem {
- protected:
-  sf::Vector2f mPosition;
-
  public:
   MenuItem(sf::Vector2f position);
+
+ protected:
+  sf::Vector2f mPosition;
 };
\ No newline at end of file
diff --git a/src/MenuLevel.cpp b/src/MenuLevel.cpp
index 62f2575..31206da 100644
--- a/src/MenuLevel.cpp
+++ b/src/MenuLevel.cpp
@@ -3,7 +3,7 @@
 MenuLevel::MenuLevel(std::initializer_list<Button> buttons) : mButtons{buttons} {}
 
 void MenuLevel::processEvents(const sf::Event& event) {
-  // process input
+  // process keyboard inputs
   static sf::Keyboard::Key lastPressedKey;
   if (event.type == sf::Event::KeyPressed) {
     if (lastPressedKey != event.key.code) {
@@ -20,16 +20,25 @@ void MenuLevel::processEvents(const sf::Event& event) {
           mSelectedButton = 0;
         }
       }
+
+      if (event.key.code == sf::Keyboard::Enter) {
+        if (mButtons.size()) {
+          if (mButtons[mSelectedButton].get_button_type() == ButtonType::Callback) {
+            mButtons[mSelectedButton].click();
+          } else if (mButtons[mSelectedButton].get_button_type() == ButtonType::LevelChanger) {
+            mNextLevel = mButtons[mSelectedButton].get_next_level();
+            mRequestLevelChange = true;
+          }
+        }
+      }
     }
 
     lastPressedKey = event.key.code;
   } else if (event.type == sf::Event::KeyReleased) {
     lastPressedKey = sf::Keyboard::Unknown;
   }
-}
 
-void MenuLevel::draw(sf::RenderWindow& window, const sf::Font& font) {
-  // select button - draw outline
+  // process button selection
   for (int i = 0; i < mButtons.size(); ++i) {
     if (i == mSelectedButton) {
       mButtons[i].select();
@@ -37,8 +46,15 @@ void MenuLevel::draw(sf::RenderWindow& window, const sf::Font& font) {
       mButtons[i].deselect();
     }
   }
+}
+
+bool MenuLevel::is_level_change_requested() const { return mRequestLevelChange; }
+
+MenuLevel* MenuLevel::get_next_level() const { return mNextLevel; }
 
-  // draw buttons
+void MenuLevel::reset_level_request() { mRequestLevelChange = false; }
+
+void MenuLevel::draw(sf::RenderWindow& window, const sf::Font& font) {
   for (auto& button : mButtons) {
     button.draw(window, font);
   }
diff --git a/src/MenuLevel.hpp b/src/MenuLevel.hpp
index d6179b2..25051e3 100644
--- a/src/MenuLevel.hpp
+++ b/src/MenuLevel.hpp
@@ -8,12 +8,18 @@
 class Button;
 
 class MenuLevel {
-  std::vector<Button> mButtons;
-  MenuLevel* mPrevLevel;
-  int mSelectedButton = 0;
-
  public:
   MenuLevel(std::initializer_list<Button> buttons);
   void draw(sf::RenderWindow&, const sf::Font& font);
   void processEvents(const sf::Event& event);
+  bool is_level_change_requested() const;
+  MenuLevel* get_next_level() const;
+  void reset_level_request();
+
+ private:
+  std::vector<Button> mButtons;
+  int mSelectedButton = 0;
+  bool mIsClicked = false;
+  bool mRequestLevelChange = false;
+  MenuLevel* mNextLevel;
 };
\ No newline at end of file

From 9b4665a4f587ca49b21a6434d966cf5c9dbb4de8 Mon Sep 17 00:00:00 2001
From: Bartosz Rozenkop <107147109+bartez33a@users.noreply.github.com>
Date: Sat, 11 Nov 2023 14:13:43 +0100
Subject: [PATCH 31/31] Delete Notes directory

---
 Notes/Graphics module/Shapes.md           | 217 ----------------------
 Notes/Graphics module/drawing 2D stuff.md | 143 --------------
 Notes/Graphics module/sprites_textures.md | 176 ------------------
 Notes/Text_fonts.md                       |  93 ----------
 Notes/Window module/OpenGL in SFML.md     |  82 --------
 Notes/Window module/SFML notes.md         |  13 --
 Notes/Window module/inputs.md             |  95 ----------
 Notes/Window module/sf::event.md          |  60 ------
 8 files changed, 879 deletions(-)
 delete mode 100644 Notes/Graphics module/Shapes.md
 delete mode 100644 Notes/Graphics module/drawing 2D stuff.md
 delete mode 100644 Notes/Graphics module/sprites_textures.md
 delete mode 100644 Notes/Text_fonts.md
 delete mode 100644 Notes/Window module/OpenGL in SFML.md
 delete mode 100644 Notes/Window module/SFML notes.md
 delete mode 100644 Notes/Window module/inputs.md
 delete mode 100644 Notes/Window module/sf::event.md

diff --git a/Notes/Graphics module/Shapes.md b/Notes/Graphics module/Shapes.md
deleted file mode 100644
index 02fda9b..0000000
--- a/Notes/Graphics module/Shapes.md	
+++ /dev/null
@@ -1,217 +0,0 @@
-### Shapes
-
-## Introduction
-SFML provides a set of classes that represent simple shape entities. Each type of shape is a separate class, but they all derive from the same base class so that they have access to the same subset of common features. Each class then adds its own specifics: a radius property for the circle class, a size for the rectangle class, points for the polygon class, etc.
-
-
-## Common shape properties
-
-# Transformation (position, rotation, scale)
-These properties are common to all the SFML graphical classes, so they are explained in a separate tutorial: Transforming entities.
-
-# Color
-One of the basic properties of a shape is its color. You can change with the setFillColor function.
-
-
-sf::CircleShape shape(50.f);
-
-// set the shape color to green
-shape.setFillColor(sf::Color(100, 250, 50));
-
-
-# Outline
-Shapes can have an outline. You can set the thickness and color of the outline with the setOutlineThickness and setOutlineColor functions.
-
-
-sf::CircleShape shape(50.f);
-shape.setFillColor(sf::Color(150, 50, 250));
-
-// set a 10-pixel wide orange outline
-shape.setOutlineThickness(10.f);
-shape.setOutlineColor(sf::Color(250, 150, 100));
-
-
-
-By default, the outline is extruded outwards from the shape (e.g. if you have a circle with a radius of 10 and an outline thickness of 5, the total radius of the circle will be 15). You can make it extrude towards the center of the shape instead, by setting a negative thickness.
-
-To disable the outline, set its thickness to 0. If you only want the outline, you can set the fill color to `sf::Color::Transparent`.
-
-# Texture
-
-Shapes can also be textured, just like sprites. To specify a part of the texture to be mapped to the shape, you must use the setTextureRect function. It takes the texture rectangle to map to the bounding rectangle of the shape. This method doesn't offer maximum flexibility, but it is much easier to use than individually setting the texture coordinates of each point of the shape.
-
-
-sf::CircleShape shape(50);
-
-// map a 100x100 textured rectangle to the shape
-shape.setTexture(&texture); // texture is a sf::Texture
-shape.setTextureRect(sf::IntRect(10, 10, 100, 100));
-
-
-
-Note that the outline is not textured.
-It is important to know that the texture is modulated (multiplied) with the shape's fill color. If its fill color is sf::Color::White, the texture will appear unmodified.
-To disable texturing, call setTexture(NULL).
-
-
-
-# Drawing a shape
-Drawing a shape is as simple as drawing any other SFML entity:
-
-window.draw(shape);
-
-# Built-in shape types
-- Rectangles
-To draw rectangles, you can use the `sf::RectangleShape` class. 
-It has a single attribute: The size of the rectangle.
-
-// define a 120x50 rectangle
-sf::RectangleShape rectangle(sf::Vector2f(120.f, 50.f));
-
-// change the size to 100x100
-rectangle.setSize(sf::Vector2f(100.f, 100.f));
-
-- Circles
-Circles are represented by the `sf::CircleShape` class. 
-It has two attributes: The radius and the number of sides. The number of sides is an optional attribute, it allows you to adjust the "quality" of the circle: Circles have to be approximated by polygons with many sides (the graphics card is unable to draw a perfect circle directly), and this attribute defines how many sides your circle approximation will have. If you draw small circles, you'll probably only need a few sides. If you draw big circles, or zoom on regular circles, you'll most likely need more sides.
-
-
-// define a circle with radius = 200
-sf::CircleShape circle(200.f);
-
-// change the radius to 40
-circle.setRadius(40.f);
-
-// change the number of sides (points) to 100
-circle.setPointCount(100);
-
-
-- Regular polygons
-There's no dedicated class for regular polygons, in fact you can represent a regular polygon with any number of sides using the `sf::CircleShape` class: Since circles are approximated by polygons with many sides, you just have to play with the number of sides to get the desired polygons. 
-A `sf::CircleShape` with 3 points is a triangle, 
-with 4 points it's a square, etc.
-
-
-// define a triangle
-sf::CircleShape triangle(80.f, 3);
-
-// define a square
-sf::CircleShape square(80.f, 4);
-
-// define an octagon
-sf::CircleShape octagon(80.f, 8);
-
-
-
-- Convex shapes
-The sf::ConvexShape class is the ultimate shape class: It allows you to define any convex shape. SFML is unable to draw concave shapes. If you need to draw a concave shape, you'll have to split it into multiple convex polygons.
-
-To construct a convex shape, you must first set the number of points it should have and then define the points.
-
-// create an empty shape
-sf::ConvexShape convex;
-
-// resize it to 5 points
-convex.setPointCount(5);
-
-// define the points
-convex.setPoint(0, sf::Vector2f(0.f, 0.f));
-convex.setPoint(1, sf::Vector2f(150.f, 10.f));
-convex.setPoint(2, sf::Vector2f(120.f, 90.f));
-convex.setPoint(3, sf::Vector2f(30.f, 100.f));
-convex.setPoint(4, sf::Vector2f(0.f, 50.f));
-
-The order in which you define the points is very important. They must all be defined either in clockwise or counter-clockwise order. If you define them in an inconsistent order, the shape will be constructed incorrectly.
-- A convex shape
-
-Although the name of sf::ConvexShape implies that it should only be used to represent convex shapes, its requirements are a little more relaxed. In fact, the only requirement that your shape must meet is that if you went ahead and drew lines from its center of gravity to all of its points, these lines must be drawn in the same order. You are not allowed to "jump behind a previous line". Internally, convex shapes are automatically constructed using triangle fans, so if your shape is representable by a triangle fan, you can use sf::ConvexShape. With this relaxed definition, you can draw stars using sf::ConvexShape for example.
-- Lines
-
-There's no shape class for lines. The reason is simple: If your line has a thickness, it is a rectangle. If it doesn't, it can be drawn with a line primitive.
-
-Line with thickness:
-
-sf::RectangleShape line(sf::Vector2f(150.f, 5.f));
-line.rotate(45.f);
-
-A line shape drawn as a rectangle
-
-Line without thickness:
-
-sf::Vertex line[] =
-{
-    sf::Vertex(sf::Vector2f(10.f, 10.f)),
-    sf::Vertex(sf::Vector2f(150.f, 150.f))
-};
-
-window.draw(line, 2, sf::Lines);
-
-A line shape drawn as a primitive
-
-To learn more about vertices and primitives, you can read the tutorial on vertex arrays.
-Custom shape types
-
-You can extend the set of shape classes with your own shape types. To do so, you must derive from sf::Shape and override two functions:
-
-    getPointCount: return the number of points in the shape
-    getPoint: return a point of the shape
-
-You must also call the update() protected function whenever any point in your shape changes, so that the base class is informed and can update its internal geometry.
-
-Here is a complete example of a custom shape class: EllipseShape.
-
-class EllipseShape : public sf::Shape
-{
-public :
-
-    explicit EllipseShape(const sf::Vector2f& radius = sf::Vector2f(0.f, 0.f)) :
-    m_radius(radius)
-    {
-        update();
-    }
-
-    void setRadius(const sf::Vector2f& radius)
-    {
-        m_radius = radius;
-        update();
-    }
-
-    const sf::Vector2f& getRadius() const
-    {
-        return m_radius;
-    }
-
-    virtual std::size_t getPointCount() const
-    {
-        return 30; // fixed, but could be an attribute of the class if needed
-    }
-
-    virtual sf::Vector2f getPoint(std::size_t index) const
-    {
-        static const float pi = 3.141592654f;
-
-        float angle = index * 2 * pi / getPointCount() - pi / 2;
-        float x = std::cos(angle) * m_radius.x;
-        float y = std::sin(angle) * m_radius.y;
-
-        return sf::Vector2f(m_radius.x + x, m_radius.y + y);
-    }
-
-private :
-
-    sf::Vector2f m_radius;
-};
-
-An ellipse shape
-Antialiased shapes
-
-There's no option to anti-alias a single shape. To get anti-aliased shapes (i.e. shapes with smoothed edges), you have to enable anti-aliasing globally when you create the window, with the corresponding attribute of the sf::ContextSettings structure.
-
-sf::ContextSettings settings;
-settings.antialiasingLevel = 8;
-
-sf::RenderWindow window(sf::VideoMode(800, 600), "SFML shapes", sf::Style::Default, settings);
-
-Aliased vs antialiased shape
-
-Remember that anti-aliasing availability depends on the graphics card: It might not support it, or have it forced to disabled in the driver settings. 
\ No newline at end of file
diff --git a/Notes/Graphics module/drawing 2D stuff.md b/Notes/Graphics module/drawing 2D stuff.md
deleted file mode 100644
index ba3358d..0000000
--- a/Notes/Graphics module/drawing 2D stuff.md	
+++ /dev/null
@@ -1,143 +0,0 @@
-### Drawing 2D stuff
-
-## Introduction
- As you learnt in the previous tutorials, SFML's window module provides an easy way to open an OpenGL window and handle its events, but it doesn't help when it comes to drawing something. The only option which is left to you is to use the powerful, yet complex and low level OpenGL API.
-
-Fortunately, SFML provides a graphics module which will help you draw 2D entities in a much simpler way than with OpenGL. 
-
-## The drawing window
-To draw the entities provided by the graphics module, you must use a specialized window class: `sf::RenderWindow`. This class is derived from `sf::Window`, and inherits all its functions. Everything that you've learnt about sf::Window (creation, event handling, controlling the framerate, mixing with OpenGL, etc.) is applicable to `sf::RenderWindow` as well.
-
-On top of that, `sf::RenderWindow` adds high-level functions to help you draw things easily. 
-In this tutorial we'll focus on two of these functions: 
-- clear and 
-- draw. 
-They are as simple as their name implies: 
-- clear clears the whole window with the chosen color, and 
-- draw draws whatever object you pass to it.
-
-Here is what a typical main loop looks like with a render window: 
-
-#include <SFML/Graphics.hpp>
-
-int main()
-{
-    // create the window
-    sf::RenderWindow window(sf::VideoMode(800, 600), "My window");
-
-    // run the program as long as the window is open
-    while (window.isOpen())
-    {
-        // check all the window's events that were triggered since the last iteration of the loop
-        sf::Event event;
-        while (window.pollEvent(event))
-        {
-            // "close requested" event: we close the window
-            if (event.type == sf::Event::Closed)
-                window.close();
-        }
-
-        // clear the window with black color
-        window.clear(sf::Color::Black);
-
-        // draw everything here...
-        // window.draw(...);
-
-        // end the current frame
-        window.display();
-    }
-
-    return 0;
-}
-
-Calling clear before drawing anything is mandatory, otherwise the contents from previous frames will be present behind anything you draw. 
-The only exception is when you cover the entire window with what you draw, so that no pixel is not drawn to. In this case you can avoid calling clear (although it won't have a noticeable impact on performance).
-
-Calling display is also mandatory, it takes what was drawn since the last call to display and displays it on the window. Indeed, things are not drawn directly to the window, but to a hidden buffer. This buffer is then copied to the window when you call display -- this is called double-buffering.
-
-This clear/draw/display cycle is the only good way to draw things. Don't try other strategies, such as keeping pixels from the previous frame, "erasing" pixels, or drawing once and calling display multiple times. You'll get strange results due to double-buffering.
-Modern graphics hardware and APIs are really made for repeated clear/draw/display cycles where everything is completely refreshed at each iteration of the main loop. Don't be scared to draw 1000 sprites 60 times per second, you're far below the millions of triangles that your computer can handle.
-
-## What can I draw now?
-Now that you have a main loop which is ready to draw, let's see what, and how, you can actually draw there.
-
-SFML provides four kinds of drawable entities: three of them are ready to be used (sprites, text and shapes), the last one is the building block that will help you create your own drawable entities (vertex arrays).
-
-Although they share some common properties, each of these entities come with their own nuances and are therefore explained in dedicated tutorials.
-
-## Off-screen drawing
-SFML also provides a way to draw to a texture instead of directly to a window. 
-To do so, use a `sf::RenderTexture` instead of a `sf::RenderWindow`. 
-It has the same functions for drawing, inherited from their common base: `sf::RenderTarget`.
-
-
-// create a 500x500 render-texture
-sf::RenderTexture renderTexture;
-if (!renderTexture.create(500, 500))
-{
-    // error...
-}
-
-// drawing uses the same functions
-renderTexture.clear();
-renderTexture.draw(sprite); // or any other drawable
-renderTexture.display();
-
-// get the target texture (where the stuff has been drawn)
-const sf::Texture& texture = renderTexture.getTexture();
-
-// draw it to the window
-sf::Sprite sprite(texture);
-window.draw(sprite);
-
-
-The getTexture function returns a read-only texture, which means that you can only use it, not modify it. If you need to modify it before using it, you can copy it to your own sf::Texture instance and modify that instead.
-
-sf::RenderTexture also has the same functions as sf::RenderWindow for handling views and OpenGL (see the corresponding tutorials for more details). If you use OpenGL to draw to the render-texture, you can request creation of a depth buffer by using the third optional argument of the create function.
-
-renderTexture.create(500, 500, true); // enable depth buffer
-
-## Drawing from threads
-SFML supports multi-threaded drawing, and you don't even have to do anything to make it work. 
-The only thing to remember is to deactivate a window before using it in another thread. 
-That's because a window (more precisely its OpenGL context) cannot be active in more than one thread at the same time.
-
-void renderingThread(sf::RenderWindow* window)
-{
-    // activate the window's context
-    window->setActive(true);
-
-    // the rendering loop
-    while (window->isOpen())
-    {
-        // draw...
-
-        // end the current frame
-        window->display();
-    }
-}
-
-int main()
-{
-    // create the window (remember: it's safer to create it in the main thread due to OS limitations)
-    sf::RenderWindow window(sf::VideoMode(800, 600), "OpenGL");
-
-    // deactivate its OpenGL context
-    window.setActive(false);
-
-    // launch the rendering thread
-    sf::Thread thread(&renderingThread, &window);
-    thread.launch();
-
-    // the event/logic/whatever loop
-    while (window.isOpen())
-    {
-        ...
-    }
-
-    return 0;
-}
-
-As you can see, you don't even need to bother with the activation of the window in the rendering thread, SFML does it automatically for you whenever it needs to be done.
-
-Remember to always create the window and handle its events in the main thread for maximum portability. This is explained in the window tutorial. 
\ No newline at end of file
diff --git a/Notes/Graphics module/sprites_textures.md b/Notes/Graphics module/sprites_textures.md
deleted file mode 100644
index 8298bff..0000000
--- a/Notes/Graphics module/sprites_textures.md	
+++ /dev/null
@@ -1,176 +0,0 @@
-### Sprites and textures
-
-Most (if not all) of you are already familiar with these two very common objects, so let's define them very briefly.
-
-A texture is an image. But we call it "texture" because it has a very specific role: being mapped to a 2D entity.
-
-A sprite is nothing more than a textured rectangle. 
-
-## Loading a texture
-
-Before creating any sprite, we need a valid texture. The class that encapsulates textures in SFML is, surprisingly, `sf::Texture`. 
-Since the only role of a texture is to be loaded and mapped to graphical entities, almost all its functions are about loading and updating it.
-
-The most common way of loading a texture is from an image file on disk, which is done with the loadFromFile function.
-
-sf::Texture texture;
-if (!texture.loadFromFile("image.png"))
-{
-    // error...
-}
-
-# The loadFromFile function can sometimes fail with no obvious reason`. 
-First, check the error message that SFML prints to the standard output (check the console). 
-If the message is "unable to open file", make sure that the working directory (which is the directory that any file path will be interpreted relative to) is what you think it is: 
-When you run the application from your desktop environment, the working directory is the executable folder. 
-However, when you launch your program from your IDE (Visual Studio, Code::Blocks, ...) the working directory might sometimes be set to the project directory instead. 
-This can usually be changed quite easily in the project settings.
-
-You can also load an image file from memory (loadFromMemory), 
-from a custom input stream (loadFromStream), or 
-from an image that has already been loaded (loadFromImage). 
-The latter loads the texture from an sf::Image, which is a utility class that helps store and manipulate image data (modify pixels, create transparency channel, etc.). 
-The pixels of an sf::Image stay in system memory, which ensures that operations on them will be as fast as possible, in contrast to the pixels of a texture which reside in video memory and are therefore slow to retrieve or update but very fast to draw.
-
-SFML supports most common image file formats. The full list is available in the API documentation.
-
-All these loading functions have an optional argument, which can be used if you want to load a smaller part of the image.
-
-
-// load a 32x32 rectangle that starts at (10, 10)
-if (!texture.loadFromFile("image.png", sf::IntRect(10, 10, 32, 32)))
-{
-    // error...
-}
-
-
-The sf::IntRect class is a simple utility type that represents a rectangle. Its constructor takes the coordinates of the top-left corner, and the size of the rectangle.
-
-If you don't want to load a texture from an image, but instead want to update it directly from an array of pixels, you can create it empty and update it later:
-
-// create an empty 200x200 texture
-if (!texture.create(200, 200))
-{
-    // error...
-}
-
-Note that the contents of the texture are undefined at this point.
-
-To update the pixels of an existing texture, you have to use the update function. It has overloads for many kinds of data sources:
-
-// update a texture from an array of pixels
-sf::Uint8* pixels = new sf::Uint8[width * height * 4]; // * 4 because pixels have 4 components (RGBA)
-...
-texture.update(pixels);
-
-// update a texture from a sf::Image
-sf::Image image;
-...
-texture.update(image);
-
-// update the texture from the current contents of the window
-sf::RenderWindow window;
-...
-texture.update(window);
-
-
-These examples all assume that the source is of the same size as the texture. If this is not the case, i.e. if you want to update only a part of the texture, you can specify the coordinates of the sub-rectangle that you want to update. You can refer to the documentation for further details.
-
-Additionally, a texture has two properties that change how it is rendered.
-
-The first property allows one to smooth the texture. Smoothing a texture makes pixel boundaries less visible (but the image a little more blurry), which can be desirable if it is up-scaled.
-
-`texture.setSmooth(true);`
-
-Since smoothing samples from adjacent pixels in the texture as well, it can lead to the unwanted side effect of factoring in pixels outside the selected texture area. This can happen when your sprite is located at non-integer coordinates.
-
-The second property allows a texture to be repeatedly tiled within a single sprite.
-
-`texture.setRepeated(true);`
-
-This only works if your sprite is configured to show a rectangle which is larger than the texture, otherwise this property has no effect. 
-
-
-
-## Ok, can I have my sprite now?
-
-Yes, you can now create your sprite.
-
-sf::Sprite sprite;
-sprite.setTexture(texture);
-
-... and finally draw it.
-
-// inside the main loop, between window.clear() and window.display()
-window.draw(sprite);
-
-If you don't want your sprite to use the entire texture, you can set its texture rectangle.
-
-sprite.setTextureRect(sf::IntRect(10, 10, 32, 32));
-
-You can also change the color of a sprite. The color that you set is modulated (multiplied) with the texture of the sprite. This can also be used to change the global transparency (alpha) of the sprite.
-
-sprite.setColor(sf::Color(0, 255, 0)); // green
-sprite.setColor(sf::Color(255, 255, 255, 128)); // half transparent
-
-
-Sprites can also be transformed: They have a position, an orientation and a scale.
-
-// position
-sprite.setPosition(sf::Vector2f(10.f, 50.f)); // absolute position
-sprite.move(sf::Vector2f(5.f, 10.f)); // offset relative to the current position
-
-// rotation
-sprite.setRotation(90.f); // absolute angle
-sprite.rotate(15.f); // offset relative to the current angle
-
-// scale
-sprite.setScale(sf::Vector2f(0.5f, 2.f)); // absolute scale factor
-sprite.scale(sf::Vector2f(1.5f, 3.f)); // factor relative to the current scale
-
-By default, the origin for these three transformations is the top-left corner of the sprite. If you want to set the origin to a different point (for example the center of the sprite, or another corner), you can use the setOrigin function.
-
-sprite.setOrigin(sf::Vector2f(25.f, 25.f));
-
-Since transformation functions are common to all SFML entities, they are explained in a separate tutorial: Transforming entities.
-
-## The white square problem
-
-You successfully loaded a texture, constructed a sprite correctly, and... all you see on your screen now is a white square. What happened?
-
-This is a common mistake. When you set the texture of a sprite, all it does internally is store a pointer to the texture instance. Therefore, if the texture is destroyed or moves elsewhere in memory, the sprite ends up with an invalid texture pointer.
-
-This problem occurs when you write this kind of function:
-
-sf::Sprite loadSprite(std::string filename)
-{
-    sf::Texture texture;
-    texture.loadFromFile(filename);
-
-    return sf::Sprite(texture);
-} // error: the texture is destroyed here
-
-`You must correctly manage the lifetime of your textures and make sure that they live as long as they are used by any sprite.` 
-
-## The importance of using as few textures as possible
-Using as few textures as possible is a good strategy, and the reason is simple: Changing the current texture is an expensive operation for the graphics card. Drawing many sprites that use the same texture will yield the best performance.
-
-Additionally, using a single texture allows you to group static geometry into a single entity (you can only use one texture per draw call), which will be much faster to draw than a set of many entities. Batching static geometry involves other classes and is therefore beyond the scope of this tutorial, for further details see the vertex array tutorial.
-
-Try to keep this in mind when you create your animation sheets or your tilesets: Use as little textures as possible.
-
-## Using sf::Texture with OpenGL code
-If you're using OpenGL rather than the graphics entities of SFML, you can still use sf::Texture as a wrapper around an OpenGL texture object and use it along with the rest of your OpenGL code.
-
-To bind a sf::Texture for drawing (basically glBindTexture), you call the bind static function:
-
-sf::Texture texture;
-...
-
-// bind the texture
-sf::Texture::bind(&texture);
-
-// draw your textured OpenGL entity here...
-
-// bind no texture
-sf::Texture::bind(NULL);
diff --git a/Notes/Text_fonts.md b/Notes/Text_fonts.md
deleted file mode 100644
index bd32869..0000000
--- a/Notes/Text_fonts.md
+++ /dev/null
@@ -1,93 +0,0 @@
-### Text and fonts
-
-## Loading a font
-Before drawing any text, you need to have an available font, just like any other program that prints text. Fonts are encapsulated in the `sf::Font` class, which provides three main features: 
-loading a font, getting glyphs (i.e. visual characters) from it, and reading its attributes. 
-In a typical program, you'll only have to make use of the first feature, loading the font, so let's focus on that first.
-
-The most common way of loading a font is from a file on disk, which is done with the loadFromFile function.
-
-sf::Font font;
-if (!font.loadFromFile("arial.ttf"))
-{
-    // error...
-}
-
-Note that SFML won't load your system fonts automatically, i.e. font.loadFromFile("Courier New") won't work. Firstly, because SFML requires file names, not font names, and secondly because SFML doesn't have magical access to your system's font folder. If you want to load a font, you will need to include the font file with your application, just like every other resource (images, sounds, ...).
-
-The loadFromFile function can sometimes fail with no obvious reason. First, check the error message that SFML prints to the standard output (check the console). If the message is "unable to open file", make sure that the working directory (which is the directory that any file path will be interpreted relative to) is what you think it is: When you run the application from your desktop environment, the working directory is the executable folder. However, when you launch your program from your IDE (Visual Studio, Code::Blocks, ...) the working directory might sometimes be set to the project directory instead. This can usually be changed quite easily in the project settings.
-
-You can also load a font file from memory (loadFromMemory), or from a custom input stream (loadFromStream).
-
-SFML supports most common font formats. The full list is available in the API documentation.
-
-That's all you need to do. Once your font is loaded, you can start drawing text.
-
-## Drawing text
-To draw text, you will be using the `sf::Text` class. It's very simple to use:
-
-sf::Text text;
-
-// select the font
-text.setFont(font); // font is a sf::Font
-
-// set the string to display
-text.setString("Hello world");
-
-// set the character size
-text.setCharacterSize(24); // in pixels, not points!
-
-// set the color
-text.setFillColor(sf::Color::Red);
-
-// set the text style
-text.setStyle(sf::Text::Bold | sf::Text::Underlined);
-
-...
-
-// inside the main loop, between window.clear() and window.display()
-window.draw(text);
-
-[Drawing text]
-
-Text can also be transformed: They have a position, an orientation and a scale. The functions involved are the same as for the sf::Sprite class and other SFML entities. They are explained in the Transforming entities tutorial.
-
-## How to avoid problems with non-ASCII characters?
-
-Handling non-ASCII characters (such as accented European, Arabic, or Chinese characters) correctly can be tricky. It requires a good understanding of the various encodings involved in the process of interpreting and drawing your text. To avoid having to bother with these encodings, there's a simple solution: Use wide literal strings.
-
-text.setString(L"יטאח");
-
-It is this simple "L" prefix in front of the string that makes it work by telling the compiler to produce a wide string. Wide strings are a strange beast in C++: the standard doesn't say anything about their size (16-bit? 32-bit?), nor about the encoding that they use (UTF-16? UTF-32?). However we know that on most platforms, if not all, they'll produce Unicode strings, and SFML knows how to handle them correctly.
-
-Note that the C++11 standard supports new character types and prefixes to build UTF-8, UTF-16 and UTF-32 string literals, but SFML doesn't support them yet.
-
-It may seem obvious, but you also have to make sure that the font that you use contains the characters that you want to draw. Indeed, fonts don't contain glyphs for all possible characters (there are more than 100000 in the Unicode standard!), and an Arabic font won't be able to display Japanese text, for example.
-
-
-## Making your own text class
-If sf::Text is too limited, or if you want to do something else with pre-rendered glyphs, sf::Font provides everything that you need.
-
-You can retrieve the texture which contains all the pre-rendered glyphs of a certain size:
-
-const sf::Texture& texture = font.getTexture(characterSize);
-
-It is important to note that glyphs are added to the texture when they are requested. There are so many characters (remember, more than 100000) that they can't all be generated when you load the font. Instead, they are rendered on the fly when you call the getGlyph function (see below).
-
-To do something meaningful with the font texture, you must get the texture coordinates of glyphs that are contained in it:
-
-sf::Glyph glyph = font.getGlyph(character, characterSize, bold);
-
-character is the UTF-32 code of the character whose glyph that you want to get. You must also specify the character size, and whether you want the bold or the regular version of the glyph.
-
-The sf::Glyph structure contains three members:
-
-    textureRect contains the texture coordinates of the glyph within the texture
-    bounds contains the bounding rectangle of the glyph, which helps position it relative to the baseline of the text
-    advance is the horizontal offset to apply to get the starting position of the next glyph in the text
-
-You can also get some of the font's other metrics, such as the kerning between two characters or the line spacing (always for a certain character size):
-
-int lineSpacing = font.getLineSpacing(characterSize);
-
-int kerning = font.getKerning(character1, character2, characterSize);
diff --git a/Notes/Window module/OpenGL in SFML.md b/Notes/Window module/OpenGL in SFML.md
deleted file mode 100644
index 1c7cc80..0000000
--- a/Notes/Window module/OpenGL in SFML.md	
+++ /dev/null
@@ -1,82 +0,0 @@
-### OpenGL in SFML
-
-As you know, one of the most important features of OpenGL is portability. But OpenGL alone won't be enough to create complete programs: you need a window, a rendering context, user input, etc. You would have no choice but to write OS-specific code to handle this stuff on your own. That's where the sfml-window module comes into play. Let's see how it allows you to play with OpenGL. 
-
-# Including and linking OpenGL
-
-OpenGL headers are not the same on every OS. Therefore, SFML provides an "abstract" header that takes care of including the right file for you.
-
-`#include <SFML/OpenGL.hpp>`
-
-This header includes OpenGL functions, and nothing else. People sometimes think that SFML automatically includes OpenGL extension headers because SFML loads extensions itself, but it's an implementation detail. From the user's point of view, OpenGL extension loading must be handled like any other external library.
-
-You will then need to link your program to the OpenGL library. Unlike what it does with the headers, SFML can't provide a unified way of linking OpenGL. Therefore, you need to know which library to link to according to what operating system you're using ("opengl32" on Windows, "GL" on Linux, etc.).
-
-OpenGL functions start with the "gl" prefix. Remember this when you get linker errors, it will help you find which library you forgot to link. 
-
-## Creating an OpenGL window
-
-Since SFML is based on OpenGL, its windows are ready for OpenGL calls without any extra effort.
-
-sf::Window window(sf::VideoMode(800, 600), "OpenGL");
-
-// it works out of the box
-glEnable(GL_TEXTURE_2D);
-...
-
-
-## A typical OpenGL-with-SFML program
-
- Here is what a complete OpenGL program would look like with SFML:
-
-#include <SFML/Window.hpp>
-#include <SFML/OpenGL.hpp>
-
-int main()
-{
-    // create the window
-    sf::Window window(sf::VideoMode(800, 600), "OpenGL", sf::Style::Default, sf::ContextSettings(32));
-    window.setVerticalSyncEnabled(true);
-
-    // activate the window
-    window.setActive(true);
-
-    // load resources, initialize the OpenGL states, ...
-
-    // run the main loop
-    bool running = true;
-    while (running)
-    {
-        // handle events
-        sf::Event event;
-        while (window.pollEvent(event))
-        {
-            if (event.type == sf::Event::Closed)
-            {
-                // end the program
-                running = false;
-            }
-            else if (event.type == sf::Event::Resized)
-            {
-                // adjust the viewport when the window is resized
-                glViewport(0, 0, event.size.width, event.size.height);
-            }
-        }
-
-        // clear the buffers
-        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
-
-        // draw...
-
-        // end the current frame (internally swaps the front and back buffers)
-        window.display();
-    }
-
-    // release resources...
-
-    return 0;
-}
-
-Here we don't use window.isOpen() as the condition of the main loop, because we need the window to remain open until the program ends, so that we still have a valid OpenGL context for the last iteration of the loop and the cleanup code.
-
-Don't hesitate to have a look at the "OpenGL" and "Window" examples in the SFML SDK if you have further problems, they are more complete and most likely contain solutions to your problems. 
\ No newline at end of file
diff --git a/Notes/Window module/SFML notes.md b/Notes/Window module/SFML notes.md
deleted file mode 100644
index fca3871..0000000
--- a/Notes/Window module/SFML notes.md	
+++ /dev/null
@@ -1,13 +0,0 @@
-### SFML notes
-
-# sf::Window - okienko gry, 
-posiada metody, np.:
-- pollEvent, ktora zwraca sf::Event do obslugi eventow jak np. wejścia z klawiatury, myszy.
-- waitEvent
-
-# sf::Event - UWAGA - jest to unia. 
-Różne metody mogą być wykorzystywane w innym czasie (zależnie czym aktualnie jest instancja sf::Event) 
-
-# only pollEvent and waitEvent produce valid events! 
-any attempt to use sf::Event which was not returned by successful call to any of these functions will result in undefined behavior.
-
diff --git a/Notes/Window module/inputs.md b/Notes/Window module/inputs.md
deleted file mode 100644
index d33e37e..0000000
--- a/Notes/Window module/inputs.md	
+++ /dev/null
@@ -1,95 +0,0 @@
-### Inputs -> keyboard, mouse, joystick
-
-This tutorial explains how to access global input devices: keyboard, mouse and joysticks. This must not be confused with events. 
-Real-time input allows you to query the global state of keyboard, mouse and joysticks at any time ("is this button currently pressed?", "where is the mouse currently?") while events notify you when something happens ("this button was pressed", "the mouse has moved"). 
-
-
-## Keyboard
-The class that provides access to the keyboard state is sf::Keyboard. It contains two overloads of the same function, isKeyPressed, which checks the current state of a key (pressed or released). It is a static function, so you don't need to instantiate sf::Keyboard to use it. 
-
-This function directly reads the keyboard state, ignoring the focus state of your window. This means that isKeyPressed may return true, even if your window is inactive. 
-
-if (sf::Keyboard::isKeyPressed(sf::Keyboard::Left))
-{
-    // left key is pressed: move our character
-    character.move(-1.f, 0.f);
-}
-
- Key codes are defined in the sf::Keyboard::Key enum.
-
-if (sf::Keyboard::isKeyPressed(sf::Keyboard::Scan::Right))
-{
-    // right key is pressed: move our character
-    character.move(1.f, 0.f);
-}
-
-Scancodes are defined in the sf::Keyboard::Scancode enum. 
-
-## Mouse
- The class that provides access to the mouse state is sf::Mouse. Like its friend sf::Keyboard, sf::Mouse only contains static functions and is not meant to be instantiated (SFML only handles a single mouse for the time being).
-
-You can check if buttons are pressed:
-
-if (sf::Mouse::isButtonPressed(sf::Mouse::Left))
-{
-    // left mouse button is pressed: shoot
-    gun.fire();
-}
-
-Mouse button codes are defined in the sf::Mouse::Button enum. SFML supports up to 5 buttons: left, right, middle (wheel), and two additional buttons whatever they may be. 
-
- You can also get and set the current position of the mouse, either relative to the desktop or to a window:
-
-// get the global mouse position (relative to the desktop)
-sf::Vector2i globalPosition = sf::Mouse::getPosition();
-
-// get the local mouse position (relative to a window)
-sf::Vector2i localPosition = sf::Mouse::getPosition(window); // window is a sf::Window
-
-// set the mouse position globally (relative to the desktop)
-sf::Mouse::setPosition(sf::Vector2i(10, 50));
-
-// set the mouse position locally (relative to a window)
-sf::Mouse::setPosition(sf::Vector2i(10, 50), window); // window is a sf::Window
-
-There is no function for reading the current state of the mouse wheel. Since the wheel can only be moved relatively, it has no absolute state that can be queried. By looking at a key you can tell whether it's pressed or released. By looking at the mouse cursor you can tell where it is located on the screen. However, looking at the mouse wheel doesn't tell you which "tick" it is on. You can only be notified when it moves (MouseWheelScrolled event). 
-
-
-## Joystick
-The class that provides access to the joysticks' states is sf::Joystick. Like the other classes in this tutorial, it only contains static functions.
-
-Joysticks are identified by their index (0 to 7, since SFML supports up to 8 joysticks). Therefore, the first argument of every function of sf::Joystick is the index of the joystick that you want to query. 
-
- You can check whether a joystick is connected or not:
-
-if (sf::Joystick::isConnected(0))
-{
-    // joystick number 0 is connected
-    ...
-}
-
-You can also get the capabilities of a connected joystick:
-
-// check how many buttons joystick number 0 has
-unsigned int buttonCount = sf::Joystick::getButtonCount(0);
-
-// check if joystick number 0 has a Z axis
-bool hasZ = sf::Joystick::hasAxis(0, sf::Joystick::Z);
-
-Joystick axes are defined in the sf::Joystick::Axis enum. Since buttons have no special meaning, they are simply numbered from 0 to 31.
-
-Finally, you can query the state of a joystick's axes and buttons as well:
-
-// is button 1 of joystick number 0 pressed?
-if (sf::Joystick::isButtonPressed(0, 1))
-{
-    // yes: shoot!
-    gun.fire();
-}
-
-// what's the current position of the X and Y axes of joystick number 0?
-float x = sf::Joystick::getAxisPosition(0, sf::Joystick::X);
-float y = sf::Joystick::getAxisPosition(0, sf::Joystick::Y);
-character.move(x, y);
-
-Joystick states are automatically updated when you check for events. If you don't check for events, or need to query a joystick state (for example, checking which joysticks are connected) before starting your game loop, you'll have to manually call the sf::Joystick::update() function yourself to make sure that the joystick states are up to date. 
\ No newline at end of file
diff --git a/Notes/Window module/sf::event.md b/Notes/Window module/sf::event.md
deleted file mode 100644
index 9f7adc0..0000000
--- a/Notes/Window module/sf::event.md	
+++ /dev/null
@@ -1,60 +0,0 @@
-### sf::Event
-
-# typical usage of sf::Event
-
-sf::Event event;
-
-// while there are pending events...
-while (window.pollEvent(event))
-{
-    // check the type of the event...
-    switch (event.type)
-    {
-        // window closed
-        case sf::Event::Closed:
-            window.close();
-            break;
-
-        // key pressed
-        case sf::Event::KeyPressed:
-            ...
-            break;
-
-        // we don't process other types of events
-        default:
-            break;
-    }
-}
-
-# The Closed event
-The sf::Event::Closed event is triggered when the user wants to close the window, through any of the possible methods.
-The event only represent a close request, the window is not closed yet when the event is received.
-
-We can save current state of game and close window.
-
-# The Resized event
-The sf::Event::Resized event is triggered when the window is resized (by user or e.g. calling window.setSize).
-
-# The LostFocus and GainedFocus events
-The sf::Event::LostFocus and sf::Event::GainedFocus events are triggered when the window loses/gains focus, which happens when the user switches the currently active window.
-When the window is out of focus, it doesn't receive keyboard events.
-
- There's no member associated with these events in the sf::Event union.
-
-if (event.type == sf::Event::LostFocus)
-    myGame.pause();
-
-if (event.type == sf::Event::GainedFocus)
-    myGame.resume();
-
-# Other event such as keyboard or mouse input.
-https://www.sfml-dev.org/tutorials/2.6/window-events.php
-
-
-## Keyboard input tips
- Sometimes, people try to react to KeyPressed events directly to implement smooth movement. Doing so will not produce the expected effect, because when you hold a key you only get a few events (remember, the repeat delay). To achieve smooth movement with events, you must use a boolean that you set on KeyPressed and clear on KeyReleased; you can then move (independently of events) as long as the boolean is set.
-The other (easier) solution to produce smooth movement is to use real-time keyboard input with sf::Keyboard (see the dedicated tutorial). 
-
- Scancodes are unique values for each physical key on a keyboard, regardless of the language or layout, whereas key codes represent keys based on the user's chosen layout. For instance, the Z key is in the bottom row to the left of the X key on a US layout. Referring to the scancode for Z would identify this physical key location on any keyboard. However, on a German layout, the same physical key is labeled Y. Thus, using the key code for Y can lead to different physical key locations, depending on the chosen layout.
-
-It is strongly recommended to use scancodes over key codes if the physical location of the keys is more important than the key values that depend on the keyboard layout, such as using WASD keys for movement. 
\ No newline at end of file