添加部分代码注释

Author: andrewbytecoder

README.md

@@ -1,2 +1,2 @@
 # fireshot
-fireshot 是一款优秀的跨平台截图工具
+fireshot 是一款优秀的跨平台截图工具，项目来自于flameshot的魔改

src/CMakeLists.txt

@@ -66,9 +66,6 @@ endif ()
 target_sources(
         fireshot
         PRIVATE
-        # ${CMAKE_CURRENT_SOURCE_DIR}/../external/Qt-Color-Widgets/src/QtColorWidgets/color_utils.cpp
-        # ${CMAKE_CURRENT_SOURCE_DIR}/../external/Qt-Color-Widgets/src/QtColorWidgets/color_wheel.cpp
-        # ${CMAKE_CURRENT_SOURCE_DIR}/../external/Qt-Color-Widgets/include/QtColorWidgets/color_wheel.hpp
         ${CMAKE_CURRENT_SOURCE_DIR}/../data/graphics.qrc
         ${CMAKE_CURRENT_SOURCE_DIR}/../data/flameshot.rc # windows binary icon resource file
         ${QM_FILES}

src/core/flameshot.cpp

@@ -35,8 +35,6 @@ Flameshot::Flameshot()
 {
     QString StyleSheet = CaptureButton::globalStyleSheet();
     qApp->setStyleSheet(StyleSheet);
-
-
 }
 
 Flameshot* Flameshot::instance()
@@ -51,32 +49,17 @@ CaptureWidget* Flameshot::gui(const CaptureRequest& req)
         return nullptr;
     }
 
+    // 创建截图主窗口
     if (nullptr == m_captureWindow) {
-        // TODO is this unnecessary now?
-        int timeout = 5000; // 5 seconds
-        const int delay = 100;
-        QWidget* modalWidget = nullptr;
-        for (; timeout >= 0; timeout -= delay) {
-            modalWidget = qApp->activeModalWidget();
-            if (nullptr == modalWidget) {
-                break;
-            }
-            modalWidget->close();
-            modalWidget->deleteLater();
-            QThread::msleep(delay);
-        }
-        if (0 == timeout) {
-            QMessageBox::warning(
-              nullptr, tr("Error"), tr("Unable to close active modal widgets"));
-            return nullptr;
-        }
-
+        // 截图并将图片显示成半透明状态，全部都在截图窗口中实现
         m_captureWindow = new CaptureWidget(req);
 
 #ifdef Q_OS_WIN
         m_captureWindow->show();
 #else
+      // 在linux上必须使用 fullscreen 否则截图之后效果是一个已经缩小的图片来编辑
         m_captureWindow->showFullScreen();
+
 #endif
         return m_captureWindow;
     } else {
@@ -204,6 +187,7 @@ QVersionNumber Flameshot::getVersion()
  * @brief Prompt the user to resolve config errors if necessary.
  * @return Whether errors were resolved.
  */
+ //
 bool Flameshot::resolveAnyConfigErrors()
 {
     bool resolved = true;
@@ -344,6 +328,3 @@ bool Flameshot::haveExternalWidget()
 {
     return m_haveExternalWidget;
 }
-
-// STATIC ATTRIBUTES
-Flameshot::Origin Flameshot::m_origin = Flameshot::DAEMON;

src/core/flameshot.h

@@ -59,10 +59,9 @@ public slots:
     Flameshot();
     bool resolveAnyConfigErrors();
 
-    // class members
-    static Origin m_origin;
     bool m_haveExternalWidget;
 
+    // 用来操作激凸的主界面
     QPointer<CaptureWidget> m_captureWindow;
     QPointer<InfoWindow> m_infoWindow;
     QPointer<CaptureLauncher> m_launcherWindow;

src/tools/capturecontext.h

@@ -11,11 +11,11 @@
 
 struct CaptureContext
 {
-    // screenshot with modifications
+    // 叠加效果之后的图片
     QPixmap screenshot;
-    // unmodified screenshot
+    // 没有经过任何编辑的原始图片
     QPixmap origScreenshot;
-    // Selection area
+    // 选择的区域
     QRect selection;
     // Selected tool color
     QColor color;

src/widgets/capture/capturewidget.cpp

@@ -1,13 +1,3 @@
-// SPDX-License-Identifier: GPL-3.0-or-later
-// SPDX-FileCopyrightText: 2017-2019 Alejandro Sirgo Rica & Contributors
-
-// Based on Lightscreen areadialog.cpp, Copyright 2017  Christian Kaiser
-// <[email protected]> released under the GNU GPL2
-// <https://www.gnu.org/licenses/gpl-2.0.txt>
-
-// Based on KDE's KSnapshot regiongrabber.cpp, revision 796531, Copyright 2007
-// Luca Gugelmann <[email protected]> released under the GNU LGPL
-// <http://www.gnu.org/licenses/old-licenses/library.txt>
 
 #include "capturewidget.h"
 #include "abstractlogger.h"
@@ -74,6 +64,7 @@ CaptureWidget::CaptureWidget(const CaptureRequest& req,
   , m_startMove(false)
 
 {
+    // 获取当前应用能够撤销的次数
     m_undoStack.setUndoLimit(ConfigHandler().undoLimit());
     m_context.circleCount = 1;