From 1a5b905464c6a53fbbf85dcc3ebf95e5e8f3ce52 Mon Sep 17 00:00:00 2001
From: dm1sh <me@dmitriy.icu>
Date: Thu, 9 Jun 2022 19:56:06 +0300
Subject: [PATCH] Added even more comments and removed useless util functions

---
 App.cpp   | 10 +++++-----
 utils.cpp | 13 ++-----------
 wxw.h     |  1 +
 3 files changed, 8 insertions(+), 16 deletions(-)

diff --git a/App.cpp b/App.cpp
index 3fb5f21..f041f3a 100644
--- a/App.cpp
+++ b/App.cpp
@@ -8,13 +8,13 @@ wxIMPLEMENT_APP(MyApp);
 bool MyApp::OnInit() {
     wxImage::AddHandler(new wxPNGHandler());
 
-    MainFrame* frame = new MainFrame(); // Создаём,
+    MainFrame* frame = new MainFrame(); // Создаём окно игры
 
-    if (argc >= 2 && wxFileExists(argv[1]))
-        frame->layoutPath = argv[1];
+    if (argc >= 2 && wxFileExists(argv[1])) // Если пользователь ввёл какие-то аргументы
+        frame->layoutPath = argv[1]; // считаем, что первый аргумент - путь до файла карты
 
-    frame->Show(true); // показываем
-    SetTopWindow(frame); // и устанавливаем главным окном, а так же выносим вперёд основное окно игры
+    frame->Show(true); // показываем окно
+    SetTopWindow(frame); // и устанавливаем главным, а так же выносим вперёд
 
     return true;
 }
diff --git a/utils.cpp b/utils.cpp
index 7cd0ec3..0ded4c7 100644
--- a/utils.cpp
+++ b/utils.cpp
@@ -2,11 +2,7 @@
 
 wxString LTimeToStr(int time) {
     return wxString::Format(_("%d:%02d:%02d"), time / 3600, (time / 60) % 60,
-                            time % 60);
-}
-
-int upDiv(int a, int b) {
-    return a / b + ((a % b) ? 1 : 0);
+                            time % 60); // переводим количество секунд с начала игры в читабельное время (ч:мм:сс) 
 }
 
 wxString itowxS(int a) {
@@ -14,15 +10,10 @@ wxString itowxS(int a) {
 }
 
 wxString PRemaining(uint8_t remaining) {
-    return wxString::Format("%i%%", remaining * 100 / 144);
+    return wxString::Format("%i%%", remaining * 100 / 144); // делим количество оставшихся камней на их количество и домножаем на 100, чтобы получить проценты
 }
 
 bool isPositive(const wxSize& size) {
     return size.x > 0 && size.y > 0;
 }
 
-void cyclic_shift(std::set<ThreePoint>::iterator& it, const std::set<ThreePoint>& cont) {
-    it++;
-    if (it == cont.end())
-        it = cont.begin();
-}
diff --git a/wxw.h b/wxw.h
index 0fc15a3..436201c 100644
--- a/wxw.h
+++ b/wxw.h
@@ -7,6 +7,7 @@
 #include <wx/wx.h>
 #endif
 
+// переопределяем макрос для преобразования C-строки в UTF-8 wxString
 #ifdef _
 #undef _
 #endif