fix: fix invalid install for UNIX app icon

Also use git version of aqtinstall for Qt 6.11.0+ for Windows
miurahr/aqtinstall#1007

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# .git-blame-ignore-revs
+# CR LF to LF
+ed5a6023326fd2ab420ded76976501be33e0b389

.gitattributes

@@ -0,0 +1,5 @@
+*.txt    text eol=lf
+*.cpp    text eol=lf
+*.h      text eol=lf
+*.ui     text eol=lf
+*.qml    text eol=lf

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+ko_fi: blumia
+custom: ["https://blumia.itch.io/pineapple-pictures"]

.github/workflows/macos.yml

@@ -1,6 +1,6 @@
 name: macOS CI
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
   build:
@@ -8,12 +8,38 @@ jobs:
     runs-on: macos-latest
 
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v6
-    - name: Install Qt
+    - name: Install uv
-      uses: jurplel/install-qt-action@v2
+      uses: astral-sh/setup-uv@v6
       with:
-        version: '5.15.2'
+        enable-cache: true
-    - name: Run a qt project
+    - name: Install MetaGlot
+      run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v4
+      with:
+        version: '6.11.2'
+        modules: 'qtimageformats'
+        cache: true
+    - name: Install Conan and Dependencies
+      id: conan
+      working-directory: ./
+      shell: bash
       run: |
-        cmake ./
+        pip3 install wheel setuptools
-        make
+        pip3 install conan --upgrade
+        conan --version
+        conan profile detect
+        conan install --requires=exiv2/0.28.3 --generator CMakeDeps --generator CMakeToolchain --build=missing
+    - name: Build
+      run: |
+        cmake . -DTRANSLATION_RESOURCE_EMBEDDING=ON --preset conan-release
+        cmake --build --preset conan-release
+    - name: Deploy
+      run: |
+        macdeployqt ./ppic.app -dmg
+        ls
+    - uses: actions/upload-artifact@v6
+      with:
+        name: "macos-bundle"
+        path: "*.dmg"

.github/workflows/reuse-check.yml

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2022 Free Software Foundation Europe e.V. <https://fsfe.org>
+#
+# SPDX-License-Identifier: CC0-1.0
+
+name: REUSE Compliance Check
+
+on: [push, pull_request]
+
+jobs:
+  reuse-compliance-check:
+    runs-on: ubuntu-latest
+    steps: 
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: REUSE Compliance Check
+      uses: fsfe/reuse-action@v5

.github/workflows/ubuntu.yml

@@ -1,30 +1,34 @@
-name: Ubuntu 20.04 CI
+name: Ubuntu CI
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
-  build:
+  ubuntu-24-04-build:
-
+    runs-on: ubuntu-24.04
-    runs-on: ubuntu-20.04
-
     steps:
-    - uses: actions/checkout@v1
+      - uses: actions/checkout@v6
-    - name: Get build dept.
+      - name: Install uv
-      run: |
+        uses: astral-sh/setup-uv@v6
-        sudo apt update
+        with:
-        sudo apt install cmake qtbase5-dev libqt5svg5-dev qttools5-dev libexiv2-dev
+          enable-cache: true
-    - name: Build it
+      - name: Install MetaGlot
-      run: |
+        run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
-        mkdir build
+      - name: Get build dept.
-        cd build
+        run: |
-        cmake ../
+          sudo apt update
-        make
+          sudo apt install cmake qt6-base-dev qt6-svg-dev qt6-tools-dev libexiv2-dev
-        cpack -G DEB
+      - name: Build it
-    - name: Try install it
+        run: |
-      run: |
+          mkdir build
-        cd build
+          cd build
-        sudo apt install ./*.deb
+          cmake ../
-    - uses: actions/upload-artifact@v2
+          make
-      with:
+          cpack -G DEB
-        name: ubuntu-20.04-deb-package
+      - name: Try install it
-        path: build/*.deb
+        run: |
+          cd build
+          sudo apt install ./*.deb
+      - uses: actions/upload-artifact@v6
+        with:
+          name: ubuntu-24.04-deb-package
+          path: build/*.deb

.github/workflows/windows.yml

@@ -0,0 +1,108 @@
+name: Windows CI
+
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  msvc-cmake-build:
+
+    strategy:
+      matrix:
+        include:
+          - qt_ver: '6.11.2'
+            vs: '2022'
+            aqt_arch: 'win64_msvc2022_64'
+            msvc_arch: 'x64'
+
+    runs-on: windows-2022
+
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+      with:
+        enable-cache: true
+    - name: Install MetaGlot
+      run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v4
+      with:
+        arch: ${{ matrix.aqt_arch }}
+        version: ${{ matrix.qt_ver }}
+        modules: 'qtimageformats'
+        cache: true
+        # we need this until miurahr/aqtinstall#1007 ships 3.3.1 for Qt >= 6.11.0 for Windows.
+        aqtsource: 'aqtinstall @ git+https://github.com/miurahr/aqtinstall@16db45a70b5905ad596941b223469bc86a56901a'
+    - name: Build
+      shell: cmd
+      run: |
+        :: ------ env ------
+        set PWD=%cd%
+        set VS=${{ matrix.vs }}
+        set VCVARS="C:\Program Files (x86)\Microsoft Visual Studio\%VS%\Enterprise\VC\Auxiliary\Build\vcvarsall.bat"
+        if not exist %VCVARS% set VCVARS="C:\Program Files\Microsoft Visual Studio\%VS%\Enterprise\VC\Auxiliary\Build\vcvarsall.bat"
+        call %VCVARS% ${{ matrix.msvc_arch }}
+        :: ------ dep ------
+        set CMAKE_PREFIX_PATH=%PWD%/dependencies_bin
+        mkdir dependencies_src
+        echo ::group::===== exiv2 =====
+        curl -fsSL -o exiv2_bin.zip https://github.com/Exiv2/exiv2/releases/download/v0.28.7/exiv2-0.28.7-2022msvc-AMD64.zip
+        7z x exiv2_bin.zip -y
+        ren .\exiv2-0.28.7-2022msvc-AMD64 dependencies_bin
+        echo ::endgroup::
+        echo ::group::===== zlib =====
+        curl -fsSL -o zlib_src.zip https://github.com/madler/zlib/releases/download/v1.3.2/zlib132.zip
+        7z x zlib_src.zip -y -o"dependencies_src"
+        ren .\dependencies_src\zlib-1.3.2 zlib || goto :error
+        cmake ./dependencies_src/zlib -Bbuild_dependencies/zlib -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/zlib --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== AOM for libavif AVI decoding support =====
+        git clone -q -b v3.13.1 --depth 1 https://aomedia.googlesource.com/aom dependencies_src/aom
+        cmake ./dependencies_src/aom -Bbuild_dependencies/aom -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DENABLE_DOCS=OFF -DBUILD_SHARED_LIBS=ON -DAOM_TARGET_CPU=generic -DENABLE_TESTS=OFF -DENABLE_TESTDATA=OFF -DENABLE_TOOLS=OFF -DENABLE_EXAMPLES=0 || goto :error
+        cmake --build build_dependencies/aom --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== libavif =====
+        curl -fsSL -o libavif-v1_3_0.zip https://github.com/AOMediaCodec/libavif/archive/v1.3.0.zip
+        7z x libavif-v1_3_0.zip -y -o"dependencies_src"
+        ren .\dependencies_src\libavif-1.3.0 libavif || goto :error
+        cmake ./dependencies_src/libavif -Bbuild_dependencies/libavif -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DAVIF_CODEC_AOM=SYSTEM -DAVIF_CODEC_AOM_DECODE=ON -DAVIF_CODEC_AOM_ENCODE=ON -DAVIF_LIBYUV=LOCAL
+        cmake --build build_dependencies/libavif --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== expat =====
+        curl -fsSL -o expat_src.zip https://github.com/libexpat/libexpat/archive/R_2_7_3.zip
+        7z x expat_src.zip -y -o"dependencies_src"
+        ren .\dependencies_src\libexpat-R_2_7_3 expat || goto :error
+        cmake ./dependencies_src/expat/expat -Bbuild_dependencies/expat -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/expat --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== ECM =====
+        git clone -q https://invent.kde.org/frameworks/extra-cmake-modules.git dependencies_src/extra-cmake-modules
+        cmake .\dependencies_src\extra-cmake-modules -Bbuild_dependencies/extra-cmake-modules -DCMAKE_INSTALL_PREFIX="dependencies_bin" -DBUILD_TESTING=OFF || goto :error
+        cmake --build build_dependencies/extra-cmake-modules --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== KArchive =====
+        git clone -q https://invent.kde.org/frameworks/karchive.git dependencies_src/karchive
+        cmake .\dependencies_src\karchive -Bbuild_dependencies/karchive -DBUILD_TESTING=OFF -DWITH_LIBZSTD=OFF -DWITH_BZIP2=OFF -DWITH_LIBLZMA=OFF -DCMAKE_INSTALL_PREFIX="dependencies_bin" || goto :error
+        cmake --build build_dependencies/karchive --config Release --target=install || goto :error
+        echo ::endgroup::
+        echo ::group::===== KImageFormats =====
+        git clone -q https://invent.kde.org/frameworks/kimageformats.git dependencies_src/kimageformats
+        cmake .\dependencies_src\kimageformats -Bbuild_dependencies/kimageformats -DBUILD_TESTING=OFF -DKDE_INSTALL_QTPLUGINDIR=%QT_ROOT_DIR%\plugins || goto :error
+        cmake --build build_dependencies/kimageformats --config Release --target=install || goto :error
+        echo ::endgroup::
+        :: ------ app ------
+        echo ::group::===== App (Build'n'Install) =====
+        cmake -Bbuild .
+        cmake --build build --config Release
+        cmake --install build --config Release --prefix "%PWD%\build"
+        echo ::endgroup::
+        :: ------ pkg ------
+        windeployqt --verbose=2 --no-compiler-runtime --no-quick-import --no-translations --no-network --no-opengl-sw --no-system-d3d-compiler --no-system-dxc-compiler --skip-plugin-types tls,networkinformation build\bin\ppic.exe
+        robocopy ./dependencies_bin/bin build/bin *.dll
+        if ErrorLevel 8 (exit /B 1)
+        copy LICENSE build\bin
+        exit /B 0
+    - uses: actions/upload-artifact@v6
+      with:
+        name: "windows-msvc${{ matrix.vs }}-qt${{ matrix.qt_ver }}-cmake-package"
+        path: build/bin/*

.gitignore

@@ -2,8 +2,21 @@
 *.user
 *.user.*
 
+# Why, macOS, why?
+.DS_Store
+
 # Translation files
 *.qm
+*.mo
 
 # Generic Build Dir
 [Bb]uild/
+cmake-build-*/
+
+# IDE/Editor config folders
+.vscode/
+.idea/
+.qtcreator/
+
+# Clangd cache
+.cache/

CMakeLists.txt

@@ -1,42 +1,50 @@
-project (pineapple-pictures)
+# SPDX-FileCopyrightText: 2022 - 2025 Gary Wang <git@blumia.net>
+#
+# SPDX-License-Identifier: MIT
 
-cmake_minimum_required (VERSION 3.9.5)
+cmake_minimum_required(VERSION 3.16)
 
-list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/cmake)
+project(pineapple-pictures VERSION 1.6.0) # don't forget to update NEWS file and AppStream metadata.
 
-include (GNUInstallDirs)
+include(GNUInstallDirs)
-include (FeatureSummary)
+include(FeatureSummary)
-
-set (CMAKE_AUTOMOC ON)
-set (CMAKE_AUTORCC ON)
-set (QT_MINIMUM_VERSION "5.10")
 
 option (EXIV2_METADATA_SUPPORT "Better image metadata support via libexiv2" ON)
+option (TRANSLATION_RESOURCE_EMBEDDING "Embedding .qm translation files inside resource" OFF)
 
-find_package(Qt5 ${QT_MINIMUM_VERSION} CONFIG REQUIRED Widgets Svg LinguistTools)
+set (CMAKE_CXX_STANDARD 17)
+set (CMAKE_CXX_STANDARD_REQUIRED ON)
+set (CMAKE_AUTOMOC ON)
+set (CMAKE_AUTORCC ON)
+set (CMAKE_AUTOUIC ON)
+
+find_package(QT NAMES Qt6 REQUIRED COMPONENTS Core)
+
+set (QT_MINIMUM_VERSION "6.5")
+
+find_package(Qt${QT_VERSION_MAJOR} ${QT_MINIMUM_VERSION} REQUIRED
+    COMPONENTS Widgets Svg SvgWidgets LinguistTools
+    OPTIONAL_COMPONENTS DBus
+)
 
 if (EXIV2_METADATA_SUPPORT)
-    find_package(LibExiv2)
+    find_package(exiv2)
-    set_package_properties(LibExiv2 PROPERTIES
+    set_package_properties(exiv2 PROPERTIES
         URL "https://www.exiv2.org"
         DESCRIPTION "image metadata support"
-        TYPE OPTIONAL
+        TYPE RECOMMENDED
         PURPOSE "Bring better image metadata support"
     )
 endif ()
 
-#LibExiv2_FOUND
 set (PPIC_CPP_FILES
     app/main.cpp
-    app/framelesswindow.cpp
     app/mainwindow.cpp
     app/actionmanager.cpp
     app/graphicsview.cpp
     app/graphicsscene.cpp
     app/bottombuttongroup.cpp
     app/navigatorview.cpp
-    app/opacityhelper.cpp
-    app/toolbutton.cpp
     app/settings.cpp
     app/settingsdialog.cpp
     app/aboutdialog.cpp
@@ -44,18 +52,19 @@ set (PPIC_CPP_FILES
     app/metadatadialog.cpp
     app/exiv2wrapper.cpp
     app/playlistmanager.cpp
+    app/fileopeneventhandler.cpp
+    app/playlistscout.cpp
+    app/playlistscouts/qtscout.cpp
+    app/playlistscouts/explorerscout.cpp
 )
 
 set (PPIC_HEADER_FILES
-    app/framelesswindow.h
     app/mainwindow.h
     app/actionmanager.h
     app/graphicsview.h
     app/graphicsscene.h
     app/bottombuttongroup.h
     app/navigatorview.h
-    app/opacityhelper.h
-    app/toolbutton.h
     app/settings.h
     app/settingsdialog.h
     app/aboutdialog.h
@@ -63,6 +72,17 @@ set (PPIC_HEADER_FILES
     app/metadatadialog.h
     app/exiv2wrapper.h
     app/playlistmanager.h
+    app/fileopeneventhandler.h
+    app/playlistscout.h
+    app/playlistscouts/qtscout.h
+    app/playlistscouts/explorerscout.h
+)
+
+set (PPIC_UI_FILES
+    app/settingsdialog.ui
+    app/aboutdialog.ui
+    app/metadatadialog.ui
+    app/mainwindow.ui
 )
 
 set (PPIC_QRC_FILES
@@ -76,46 +96,85 @@ set (PPIC_RC_FILES
 set (EXE_NAME ppic)
 
 # Translation
-file (GLOB PPIC_TS_FILES app/translations/*.ts)
+file (GLOB PPIC_TS_FILES locales/app/*.ts)
 set (PPIC_CPP_FILES_FOR_I18N ${PPIC_CPP_FILES})
 
-qt5_create_translation(PPIC_QM_FILES ${PPIC_CPP_FILES_FOR_I18N} ${PPIC_TS_FILES})
+find_program (UV_EXECUTABLE uv)
+if (NOT UV_EXECUTABLE)
+    message (FATAL_ERROR "uv is required to run the metaglot tool, install it from https://docs.astral.sh/uv/")
+endif ()
 
 if (WIN32)
-    list(APPEND PPIC_RC_FILES assets/pineapple-pictures.rc)
+    set (PPIC_RC_TEMPLATE_FILE ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc.in)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render rc
+                --manifest ${CMAKE_SOURCE_DIR}/dist/pineapple-pictures.rc.in.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/winrc/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/pineapple-pictures.rc.in.liquid
+                --output ${PPIC_RC_TEMPLATE_FILE}
+        RESULT_VARIABLE METAGLOT_RESULT
+    )
+    if (NOT METAGLOT_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate pineapple-pictures.rc.in via MetaGlot (exit code: ${METAGLOT_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
+    configure_file (${PPIC_RC_TEMPLATE_FILE} ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc @ONLY)
+    list (APPEND PPIC_RC_FILES ${CMAKE_CURRENT_BINARY_DIR}/pineapple-pictures.rc)
 endif ()
 
 add_executable (${EXE_NAME}
     ${PPIC_HEADER_FILES}
     ${PPIC_CPP_FILES}
+    ${PPIC_UI_FILES}
     ${PPIC_QRC_FILES}
     ${PPIC_RC_FILES}
-    ${PPIC_QM_FILES}
 )
 
-target_link_libraries (${EXE_NAME} Qt5::Widgets Qt5::Svg)
+set(ADD_TRANSLATIONS_ADDITIONAL_ARGS)
 
-if (LibExiv2_FOUND)
+if (Qt6_VERSION VERSION_GREATER_EQUAL "6.9.0")
-    message(INFO ${LibExiv2_INCLUDE_DIRS})
+    set(ADD_TRANSLATIONS_ADDITIONAL_ARGS MERGE_QT_TRANSLATIONS)
-    target_include_directories(${EXE_NAME}
+endif()
-    PRIVATE
+
-        ${LibExiv2_INCLUDE_DIRS}
+if (TRANSLATION_RESOURCE_EMBEDDING)
-    )
+    qt_add_translations(${EXE_NAME} ${ADD_TRANSLATIONS_ADDITIONAL_ARGS} TS_FILES ${PPIC_TS_FILES})
+else()
+    qt_add_translations(${EXE_NAME} ${ADD_TRANSLATIONS_ADDITIONAL_ARGS} TS_FILES ${PPIC_TS_FILES} QM_FILES_OUTPUT_VARIABLE PPIC_QM_FILES)
+endif()
+
+# YYC MARK:
+# This is essential, otherwise Qt UIC generated UI header file
+# can not find our header files if there are custom widgets inside UI file.
+target_include_directories(${EXE_NAME} PRIVATE app/)
+
+target_sources(${EXE_NAME} PRIVATE ${PPIC_QM_FILES})
+
+target_link_libraries (${EXE_NAME} Qt${QT_VERSION_MAJOR}::Widgets Qt${QT_VERSION_MAJOR}::Svg Qt${QT_VERSION_MAJOR}::SvgWidgets)
+
+if (exiv2_FOUND)
+    if(NOT TARGET Exiv2::exiv2lib AND TARGET exiv2lib)
+        # for exiv2 0.27.x and (macOS?) conan build
+        add_library(Exiv2::exiv2lib ALIAS exiv2lib)
+    endif()
     target_link_libraries (${EXE_NAME}
-        LibExiv2::LibExiv2
+        Exiv2::exiv2lib
     )
     target_compile_definitions(${EXE_NAME} PRIVATE
-        HAVE_EXIV2_VERSION="${LibExiv2_VERSION}"
+        HAVE_EXIV2_VERSION="${exiv2_VERSION}"
     )
 endif ()
 
+if (TARGET Qt6::DBus)
+    target_link_libraries (${EXE_NAME}
+        Qt${QT_VERSION_MAJOR}::DBus
+    )
+    target_compile_definitions(${EXE_NAME} PRIVATE
+        HAVE_QTDBUS
+    )
+endif()
+
 # Extra build settings
 if (WIN32)
-    set_property (
-        TARGET ${EXE_NAME}
-        PROPERTY WIN32_EXECUTABLE true
-    )
-
     target_compile_definitions(${EXE_NAME} PRIVATE
         FLAG_PORTABLE_MODE_SUPPORT=1
     )
@@ -146,6 +205,7 @@ macro (ppic_set_version_via_describe _describe_long)
 endmacro ()
 
 # Version setup
+target_compile_definitions(${EXE_NAME} PRIVATE PPIC_VERSION_STRING="${CMAKE_PROJECT_VERSION}")
 if (EXISTS "${CMAKE_SOURCE_DIR}/.git")
     find_package(Git)
     set_package_properties(Git PROPERTIES TYPE OPTIONAL PURPOSE "Determine exact build version.")
@@ -163,53 +223,81 @@ if (EXISTS "${CMAKE_SOURCE_DIR}/.git")
     endif ()
 endif ()
 
-# Helper macros for install settings
-macro (ppic_convert_to_relative_path _var)
-    # Make sure _var is a relative path
-    if (IS_ABSOLUTE "${${_var}}")
-        file (RELATIVE_PATH ${_var} "${CMAKE_INSTALL_PREFIX}" "${${_var}}")
-    endif ()
-endmacro ()
-
 # Install settings
 if (WIN32)
-    # FIXME: try to avoid install to a "bin" subfolder under windows...
+    set_target_properties(${EXE_NAME} PROPERTIES
-    #        when fixed, don't forget to update the CI config file...
+        WIN32_EXECUTABLE TRUE
-    set (BIN_INSTALL_DIR "") # seems useless, don't know why...
+    )
+elseif (APPLE)
+    set_source_files_properties(dist/sarasacw-picture.icns PROPERTIES
+        MACOSX_PACKAGE_LOCATION "Resources"
+    )
+    target_sources(${EXE_NAME} PUBLIC dist/sarasacw-picture.icns)
+    # See https://cmake.org/cmake/help/v3.15/prop_tgt/MACOSX_BUNDLE_INFO_PLIST.html
+    set_target_properties(${EXE_NAME} PROPERTIES
+        MACOSX_BUNDLE TRUE
+        MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/dist/MacOSXBundleInfo.plist.in
+        MACOSX_BUNDLE_BUNDLE_NAME "Pineapple Pictures"
+        MACOSX_BUNDLE_GUI_IDENTIFIER net.blumia.pineapple-pictures
+        MACOSX_BUNDLE_ICON_FILE sarasacw-picture.icns # contains the .icns file name, *without* the path.
+        MACOSX_BUNDLE_BUNDLE_VERSION ${PROJECT_VERSION}
+        MACOSX_BUNDLE_SHORT_VERSION_STRING ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}
+    )
 elseif (UNIX)
     if (CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
         set(CMAKE_INSTALL_PREFIX /usr)
     endif ()
 
-    set (BIN_INSTALL_DIR "${CMAKE_INSTALL_BINDIR}") # relative, usually "bin"
-    ppic_convert_to_relative_path(BIN_INSTALL_DIR)
-    set (LIB_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}") # "lib" or "lib64"
-    ppic_convert_to_relative_path(LIB_INSTALL_DIR)
-
     # install icon
     install (
-        FILES assets/icons/app-icon.svg
+        DIRECTORY dist/freedesktop-icons/
-        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor/48x48/apps"
+        DESTINATION "${CMAKE_INSTALL_DATADIR}/icons/hicolor"
-        RENAME pineapple-pictures.svg
     )
 
-    # install shortcut
+    # generate and install desktop entry file
+    set (PPIC_DESKTOP_FILE ${CMAKE_CURRENT_BINARY_DIR}/net.blumia.pineapple-pictures.desktop)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render desktop
+                --manifest ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.desktop.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/desktop/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.desktop.liquid
+                --output ${PPIC_DESKTOP_FILE}
+        RESULT_VARIABLE METAGLOT_DESKTOP_RESULT
+    )
+    if (NOT METAGLOT_DESKTOP_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate net.blumia.pineapple-pictures.desktop via MetaGlot (exit code: ${METAGLOT_DESKTOP_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
     install (
-        FILES dist/net.blumia.pineapple-pictures.desktop
+        FILES ${PPIC_DESKTOP_FILE}
         DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/applications"
     )
 
-    # install app metadata file for appstream (and some other stuff using this metadata like snapcraft)
+    # generate and install app metadata file for appstream (and some other stuff using this metadata like snapcraft)
+    set (PPIC_METAINFO_FILE ${CMAKE_CURRENT_BINARY_DIR}/net.blumia.pineapple-pictures.metainfo.xml)
+    execute_process (
+        COMMAND ${UV_EXECUTABLE} tool run metaglot render appstream
+                --manifest ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.metainfo.xml.toml
+                --po ${CMAKE_SOURCE_DIR}/locales/appstream/*.po
+                --template ${CMAKE_SOURCE_DIR}/dist/net.blumia.pineapple-pictures.metainfo.xml.liquid
+                --output ${PPIC_METAINFO_FILE}
+        RESULT_VARIABLE METAGLOT_METAINFO_RESULT
+    )
+    if (NOT METAGLOT_METAINFO_RESULT EQUAL 0)
+        message (FATAL_ERROR "Failed to generate net.blumia.pineapple-pictures.metainfo.xml via MetaGlot (exit code: ${METAGLOT_METAINFO_RESULT}). If it is not installed yet, run: uv tool install git+https://github.com/SarasasChipWorkshop/metaglot.git")
+    endif ()
+
     install (
-        FILES dist/appstream/net.blumia.pineapple-pictures.metainfo.xml
+        FILES ${PPIC_METAINFO_FILE}
         DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/metainfo"
     )
 endif()
 
 set (INSTALL_TARGETS_DEFAULT_ARGS
-    RUNTIME DESTINATION ${BIN_INSTALL_DIR}
+    BUNDLE DESTINATION .
-    LIBRARY DESTINATION ${LIB_INSTALL_DIR}
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
-    ARCHIVE DESTINATION ${LIB_INSTALL_DIR} COMPONENT Devel
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR} COMPONENT Devel
 )
 
 install (
@@ -217,20 +305,25 @@ install (
     ${INSTALL_TARGETS_DEFAULT_ARGS}
 )
 
-if (WIN32)
+if (TRANSLATION_RESOURCE_EMBEDDING)
+    target_compile_definitions(${EXE_NAME}
+        PRIVATE TRANSLATION_RESOURCE_EMBEDDING
+    )
+elseif (WIN32)
     set (QM_FILE_INSTALL_DIR "${CMAKE_INSTALL_BINDIR}/translations")
-else ()
+else()
     set (QM_FILE_INSTALL_DIR "${CMAKE_INSTALL_FULL_DATADIR}/pineapple-pictures/translations")
     target_compile_definitions(${EXE_NAME}
-        PRIVATE QM_FILE_INSTALL_DIR=${QM_FILE_INSTALL_DIR}
+        PRIVATE QM_FILE_INSTALL_ABSOLUTE_DIR=${QM_FILE_INSTALL_DIR}
     )
-endif ()
+endif()
-
-install (
-    FILES ${PPIC_QM_FILES}
-    DESTINATION ${QM_FILE_INSTALL_DIR}
-)
 
+if (DEFINED QM_FILE_INSTALL_DIR)
+    install(
+        FILES ${PPIC_QM_FILES}
+        DESTINATION ${QM_FILE_INSTALL_DIR}
+    )
+endif()
 feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
 
 # CPACK: General Settings
@@ -245,8 +338,8 @@ elseif (APPLE)
     # ...
 elseif (UNIX)
     set (CPACK_SYSTEM_NAME "${CMAKE_SYSTEM_NAME}-${CMAKE_SYSTEM_PROCESSOR}")
-    set (CPACK_DEBIAN_PACKAGE_SHILIBDEPS ON)
+    set (CPACK_DEBIAN_PACKAGE_SHLIBDEPS ON)
-    set (CPACK_DEBIAN_PACKAGE_RECOMMENDS "kimageformat-plugins")
+    set (CPACK_DEBIAN_PACKAGE_RECOMMENDS "kimageformat6-plugins")
 endif()
 
 include(CPack)

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 BLumia
+Copyright (c) 2026 BLumia
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSES/CC0-1.0.txt

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

LICENSES/MIT.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NEWS

@@ -0,0 +1,301 @@
+Version 1.6.0
+~~~~~~~~~~~~~
+Released: 2026-08-22
+
+Features:
+ * Allow dragging window from titlebar to move window when maximized
+ * Add an option to show/hide bird-eye view
+
+Bugfixes:
+ * Maximize the window when the image size matches the screen size
+ * Fix window might stuck when drag move on some ill-formed window manager
+ * Make titlebar respect RTL layout
+
+Miscellaneous:
+ * Update translations
+ * Update Qt version to 6.11.2 for Windows and macOS pre-built binaries
+
+Contributors:
+ Tech-Tac, Heimen Stoffels (vistaus), VenusGirl, Oğuz Ersen
+
+Version 1.5.0
+~~~~~~~~~~~~~
+Released: 2026-07-04
+
+Features:
+ * Introduced an optional titlebar that display file name and allows drag and double-click to move and toggle maximize state
+ * Windows: Now the application will use the system's built-in animation for open window animation
+
+Bugfixes:
+ * Show empty url list should also reset window title to blank
+
+Miscellaneous:
+ * Update translations
+ * Add vcs-browser link to AppStream metadata
+
+Contributors:
+ Heimen Stoffels (vistaus), VenusGirl (VenusGirl)
+
+Version 1.4.1
+~~~~~~~~~~~~~
+Released: 2026-04-05
+
+Miscellaneous:
+ * Update translations
+ * Update Qt version to 6.10.3 for Windows and macOS pre-built binaries
+
+Contributors:
+ Heimen Stoffels (vistaus), Loc Huynh (hthienloc)
+
+Version 1.4.0
+~~~~~~~~~~~~~
+Released: 2026-02-11
+
+Features:
+ * Action to save image as new file with different format
+ * Add Vietnamese and Slovenian translation
+
+Miscellaneous:
+ * Update copyright year to 2026
+ * Update translations
+ * Update Qt version to 6.10.2 for Windows and macOS pre-built binaries
+
+Contributors:
+ Loc Huynh, Sabri Ünal, VenusGirl, Andrej Poženel, Andrey
+
+Version 1.3.0
+~~~~~~~~~~~~~
+Released: 2025-12-20
+
+Features:
+ * New option to limit SVG support to SVG Tiny 1.2 standard
+ * Windows: ship tools and configurations that help user associate image files to this program
+
+Bugfixes:
+ * Fix window not appear at the screen that the mouse cursor is at
+ * Fix Windows prebuilt binary having AVIF plugin included but not actually support it
+
+Miscellaneous:
+ * CPack DEB: will now recommend "kimageformat6-plugins" instead of the KF5 version
+ * Update translations
+ * Update exiv2 version for Windows binary build
+
+Contributors:
+ VenusGirl, Andrey
+
+Version 1.2.1
+~~~~~~~~~~~~~
+Released: 2025-11-22
+
+Bugfixes:
+ * Fix incorrect color when display some CMYK images.
+
+Miscellaneous:
+ * Now use Qt 6.10.1 for pre-built binary
+ * Update README description and AppStream metainfo
+ * Update translations
+ * Update libavif, AOM and expat version for Windows binary build
+
+Contributors:
+ albanobattistella
+
+Version 1.2.0
+~~~~~~~~~~~~~
+Released: 2025-09-21
+
+Features:
+ * Long image mode that detect extra wide image and auto fit by its thin side
+ * Windows: Add product version to binary metadata / resource file
+
+Miscellaneous:
+ * Update translations
+ * Update libavif version for Windows binary build
+
+Contributors:
+ Heimen Stoffels, albanobattistella, Sabri Ünal
+
+Version 1.1.1
+~~~~~~~~~~~~~
+Released: 2025-08-02
+
+Features:
+ * Click dock icon should show window when it's hidden on macOS
+
+Bugfixes:
+ * Ensure "Fit by Width" position the view to the beginning of the image
+
+Miscellaneous:
+ * Update translations
+ * Update Exiv2 version for Windows binary build
+
+Contributors:
+ Heimen Stoffels, VenusGirl, தமிழ்நேரம்
+
+Version 1.1.0
+~~~~~~~~~~~~~
+Released: 2025-07-06
+
+Features:
+ * New option to disable built-in close window animation
+ * New option to disable gallery looping
+ * Support load m3u8 as image gallery playlist
+
+Miscellaneous:
+ * Drop Qt 5 support
+
+Contributors:
+ Heimen Stoffels, albanobattistella, தமிழ்நேரம்
+
+Version 1.0.0
+~~~~~~~~~~~~~
+Released: 2025-05-03
+
+Features:
+ * Support enforces windowed mode on start-up
+ * Reload image automatically when current image gets updated
+
+Bugfixes:
+ * Display correct text language on macOS
+
+Miscellaneous:
+ * Use native text for shortcut editor's label
+ * Display native commandline message when possible
+ * Merge Qt translations into app applications as well
+
+Contributors:
+ Heimen Stoffels, albanobattistella, mmahhi
+
+Version 0.9.2
+~~~~~~~~~~~~~
+Released: 2025-03-05
+
+Bugfixes:
+ * Refer to the right exiv2 CMake module so it can be found on Linux
+
+Miscellaneous:
+ * Convert DEP5 to REUSE.toml for better REUSE compliance
+ * Update translations
+
+Contributors:
+ Pino Toscano, TamilNeram
+
+Version 0.9.1
+~~~~~~~~~~~~~
+Released: 2025-01-25
+
+Features:
+ * Option to double-click to fullscreen
+ * Build-time option to embed translation resources
+
+Bugfixes:
+ * Fix window size not adjusted when open file on macOS
+ * Should center window according to available screen geometry
+
+Miscellaneous:
+ * Change close window bahavior on macOS
+ * Update translations
+
+Contributors:
+ albanobattistella, Sabri Ünal
+
+Version 0.9.0
+~~~~~~~~~~~~~
+Released: 2024-12-08
+
+Features:
+ * Support custom shortcuts for existing actions
+ * Actions for frame-by-frame animated image playback support
+
+Miscellaneous:
+ * Initial macOS bundle support
+ * bump minimum required CMake version to 3.16
+ * Update translations
+
+Contributors:
+ albanobattistella, VenusGirl, gallegonovato, Sabri Ünal
+
+Version 0.8.2.1
+~~~~~~~~~~~~~
+Released: 2024-10-27
+
+Bugfixes:
+ * Cannot load translations caused by a change in 0.8.2
+
+Version 0.8.2
+~~~~~~~~~~~~~
+Released: 2024-10-26
+
+Features:
+ * New option to allow use light-color checkerboard by default
+
+Contributors:
+ albanobattistella, mmahhi, gallegonovato
+
+Version 0.8.1
+~~~~~~~~~~~~~
+Released: 2024-08-25
+
+Features:
+ * New command line option to list all supported formats
+
+Contributors:
+ albanobattistella, mmahhi, ovl-1, gallegonovato, Oğuz Ersen
+
+Version 0.8.0
+~~~~~~~~~~~~~
+Released: 2024-06-29
+
+Features:
+ * Support move image file to trash
+
+Contributors:
+ albanobattistella, mmahhi, gallegonovato, Oğuz Ersen
+
+Version 0.7.4
+~~~~~~~~~~~~~
+Released: 2024-04-04
+
+Features:
+ * Add some icons for corresponding menu actions
+
+Contributors:
+ Reza Almanda, mmahhi, Oğuz Ersen, volkov, Сергій
+
+Version 0.7.3
+~~~~~~~~~~~~~
+Released: 2023-10-24
+
+Features:
+ * Add "Keep transformation" to menu
+
+Contributors:
+ mmahhi, VenusGirl, albanobattistella, gallegonovato, Heimen Stoffels
+
+Version 0.7.2
+~~~~~~~~~~~~~
+Released: 2023-08-27
+
+Features:
+ * Add an option in setting dialog to tweak the High-DPI scaling rounding policy (might only works in Qt 6 build)
+
+Bugfixes:
+ * Remove image size limit for Qt 6 build
+ * Fix application icon install location under Linux
+
+Contributors:
+ Heimen Stoffels, Andrey, Dan, gallegonovato, albanobattistella, Sabri Ünal
+
+Version 0.7.1
+~~~~~~~~~~~~~
+Released: 2023-07-08
+
+Features:
+ * TIF and TIFF format files in the same folder will now be automatically added to the gallery
+ * Built-in window resizing now also supports Linux desktop. (macOS might also works as well)
+
+Bugfixes:
+ * Settings dialog will automatedly use a suitable size instead of a hard-coded one
+ * Fix default configuration file location under Linux. (was `~/.config/config.ini`, now it's `~/.config/Pineapple Pictures/config.ini`)
+
+Contributors:
+ yyc12345

README.md

@@ -1,35 +1,59 @@
-Yet another image viewer.
+# Sarasas Chip Workshop Picture
 
-|CI|Build Status|
+Yet another legacy Windows Photo Viewer with cross-platform support.
-|---|---|
-|Windows Build|[![Windows build status](https://ci.appveyor.com/api/projects/status/dbd8clww3cit6oa0/branch/master?svg=true)](https://ci.appveyor.com/project/BLumia/pineapplepictures/branch/master)|
-|macOS Build|![macOS CI](https://github.com/BLumia/pineapple-pictures/workflows/macOS%20CI/badge.svg)|
-|Ubuntu 20.04 Build|![Ubuntu 20.04 CI](https://github.com/BLumia/pineapple-pictures/workflows/Ubuntu%2020.04%20CI/badge.svg)|
 
-![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
+> [!IMPORTANT]
+> SarasaCW Picture are still in refactoring. Please do not use it until this message removes.
 
 ## Summary
 
-Pineapple Pictures is a lightweight image viewer that allows you view JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, AVIF and some other frequently used image formats files quickly and easily, and also provide a Stay-on-Top window setting that allows you pin the window so you can use it to pin a reference image at the top and then you can work with other software.
+Sarasas Chip Workshop Picture (abbr. SarasaCW Picture) is a lightweight image viewer that has cross-platform support and similar user interface about legacy Windows Photo Viewer. It allows you view JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, HDR, AVIF and some other frequently used image formats files quickly and easily without changing your long-term Windows usage experience.
+
+SarasaCW Picture is the **hard fork** of [Pineapple Pictures](https://github.com/BLumia/pineapple-pictures) since Pineapple Pictures 1.4.1 version.
+
+<!--
+
+|CI|Build Status|
+|---|---|
+|Windows Build|[![Windows CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml)|
+|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
+|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
+
+![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
 
 ## Get it!
 
- - [GitHub Release Page](https://github.com/BLumia/pineapple-pictures/releases)
+### Maintained by the original author
- - [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
- - Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
- - Debian (since bullseye) or Ubuntu (since 21.04): `sudo apt install pineapple-pictures`
- - [Itch.io Store](https://blumia.itch.io/pineapple-pictures)
 
-## Help Translation!
+- [GitHub Release Page](https://github.com/BLumia/pineapple-pictures/releases)
+- [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
+- Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
+- [Itch.io Store](https://blumia.itch.io/pineapple-pictures)
+
+### Maintained by contributors / certain distro's package maintainers
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/pineapple-pictures.svg?columns=4)](https://repology.org/project/pineapple-pictures/versions)
+
+## Contribution
+
+Beside feedback and code contribution, other contributions are also welcome!
+
+### Help Translation!
 
 [Translate this project on Weblate!](https://hosted.weblate.org/projects/pineapple-pictures/)
 
+### Funding
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/blumia)
+
+[![Afdian](https://static.afdiancdn.com/static/img/logo/logo.png)Afdian](https://afdian.com/a/BLumia)
+
 ## Build it manually:
 
 Current state, we need:
 
  - `cmake`: as the build system.
- - `qt5` with `qt5-svg` and `qt5-tools`: since the app is using Qt.
+ - `qt6` with `qt6-svg` and `qt6-tools`: since the app is using Qt.
  - `libexiv2`: able to display more image metadata. (optional, but recommended)
 
 Then we can build it with any proper c++ compiler like g++ or msvc.
@@ -48,28 +72,13 @@ The project will try to build with `exiv2` when it's available at build time, if
 
 Image formats supports rely on Qt's imageformats plugins, just get the plugins you need from your distro's package manager will be fine. For Windows user, you may need build and install the imageformats plugin manually, read the content below.
 
-### Linux
+It's possible to build it under Windows, Linux, macOS, and maybe other desktop platforms that Qt is ported to. For platform specific build instructions, please read the [related wiki page](https://github.com/BLumia/pineapple-pictures/wiki/Platform-Specific-Build-Instructions).
 
-Just normal build process as other program will be fine. Nothing special ;)
+> [!NOTE]
-
+> Although there is a `pineapple-pictures.pro` file which can be used for QMake build, it's only for testing purpose and it doesn't have `exiv2` support included. Using QMake to build this project is NOT supported, please use CMake if possible.
-For Archlinux there are also a [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=pineapple-pictures-git) you can use.
-
-For packaging to debian-based distro, the `CMakeLists.txt` provides some cpack configurations for generating a `.deb` package. After the build process, use `cpack -G DEB` to generate the package. You can also take `.github/workflows/ubuntu.yml` as a reference.
-
-For this project, `DEB` is the only supported cpack generator in current state, feel free to submit a PR if you like improving `cpack` support for this project.
-
-### Windows
-
-The normal build steps for Linux is also applied to Windows, but since Windows doesn't have a decent package manager, so if you need any other image formats support other than the supported formats which Qt provided, you need to get and build these imageformats plugins manually and vendor it. It's optional and can be skipped if you don't need extra image formats support.
-
-For the Windows binary I provided, kimageformats plugin is used (for formats like kra, xcf, psd and etc.). You can take `appveyor.yml` as a reference to learn what I did when building the Windows binary.
-
-[KDE Craft](https://community.kde.org/Craft) environment also can be used to build and package this program. I did also created a blueprint for building this project that you can found it at [here](https://github.com/BearKidsTeam/craft-shmooprint-bkt). It's not the way I used to create the release binary, but still worth trying.
-
-### macOS
-
-I don't have a mac, so no support at all. There is also a GitHub Action (see `.github/workflows/macos.yml`) running macOS build though so at least it can build. Feel free to submit a PR if you would like to give some love to the macOS build ;P
 
 ## License
 
 Pineapple Pictures as a whole is licensed under MIT license. Individual files may have a different, but compatible license.
+
+-->

README.zh_CN.md

@@ -1,35 +1,62 @@
+# Sarasas Chip Workshop 照片查看器
+
+简单轻量的、具有跨平台支持的、经典样式的 Windows 照片查看器。
+
+> [!IMPORTANT]
+> SarasaCW 照片查看器还在重构中。在这条信息被移除之前请不要使用它。
+
+## 简介
+
+Sarasas Chip Workshop 照片查看器（简称 SarasaCW 照片查看器）是一个轻量级的图片查看器。支持跨平台。界面风格类似于经典的 Windows 照片查看器。它可以让你快速轻松地浏览 JPEG、PNG、GIF、SVG、PSD、KRA、XCF、TGA、HDR、AVIF 以及其他一些常用的图片格式，且无需改变你长期的 Windows 使用习惯。
+
+SarasaCW 照片查看器是[菠萝看图](https://github.com/BLumia/pineapple-pictures)的**硬分叉**，该分叉自菠萝看图 1.4.1 版本开始。
+
+<!--
+
 简单轻量的跨平台看图工具。
 
 |CI|构建状态|
 |---|---|
-|Windows Build|[![Windows build status](https://ci.appveyor.com/api/projects/status/dbd8clww3cit6oa0/branch/master?svg=true)](https://ci.appveyor.com/project/BLumia/pineapplepictures/branch/master)|
+|Windows Build|[![Windows CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/windows.yml)|
-|macOS Build|![macOS CI](https://github.com/BLumia/pineapple-pictures/workflows/macOS%20CI/badge.svg)|
+|macOS Build|[![macOS CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/macos.yml)|
-|Ubuntu 20.04 Build|![Ubuntu 20.04 CI](https://github.com/BLumia/pineapple-pictures/workflows/Ubuntu%2020.04%20CI/badge.svg)|
+|Ubuntu Build|[![Ubuntu CI](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml/badge.svg)](https://github.com/BLumia/pineapple-pictures/actions/workflows/ubuntu.yml)|
 
 ![Pineapple Pictures - Main Window](https://repository-images.githubusercontent.com/211888654/e8697600-e370-11eb-9b2a-b71e05262954)
 
-## 简介
-
-菠萝看图是一个轻量图像查看器，允许你简单快捷的查看 JPEG, PNG, GIF, SVG, PSD, KRA, XCF, TGA, AVIF 等常用格式的图像文件，并提供了置顶窗口的选项以便你在使用其它软件时也可以将参考图片固定在顶端。
-
 ## 立即获取!
 
- - [GitHub Release 页面](https://github.com/BLumia/pineapple-pictures/releases) | [gitee 发布页面](https://gitee.com/blumia/pineapple-pictures/releases)
+### 由原作者维护
- - [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
- - Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
- - Debian (自 bullseye 起) 或 Ubuntu (自 21.04 起): `sudo apt install pineapple-pictures`
- - [Itch.io 商店](https://blumia.itch.io/pineapple-pictures)
 
-## 帮助翻译!
+- [GitHub Release 页面](https://github.com/BLumia/pineapple-pictures/releases)
+- [SourceForge](https://sourceforge.net/projects/pineapple-pictures/)
+- Archlinux AUR: [pineapple-pictures](https://aur.archlinux.org/packages/pineapple-pictures/) | [pineapple-pictures-git](https://aur.archlinux.org/packages/pineapple-pictures-git/)
+- [Itch.io 商店](https://blumia.itch.io/pineapple-pictures)
+- Flatpak (于 FlatHub): [net.blumia.pineapple-pictures](https://flathub.org/apps/net.blumia.pineapple-pictures) *([我应当使用 flatpak 版吗？](https://github.com/BLumia/pineapple-pictures/wiki/Container%E2%80%90based-Packaging-Solutions-Support))*
+
+### 由贡献者/对应发行版的打包人员维护
+
+[![打包状态](https://repology.org/badge/vertical-allrepos/pineapple-pictures.svg?columns=4)](https://repology.org/project/pineapple-pictures/versions)
+
+## 参与贡献
+
+除了参与反馈和代码贡献外，也欢迎各种类型的贡献！
+
+### 帮助翻译!
 
 [在 Weblate 上帮助此项目翻译到更多语言!](https://hosted.weblate.org/projects/pineapple-pictures/)
 
+### 打赏
+
+[![Afdian](https://static.afdiancdn.com/static/img/logo/logo.png)Afdian | 爱发电](https://afdian.com/a/BLumia)
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/blumia)
+
 ## 手动构建步骤:
 
 当前状态，我们需要先确保如下依赖可用:
 
  - `cmake`: 我们所使用的构建系统
- - 包含 `qt5-svg` 与 `qt5-tools` 组件的 `qt5`: 此应用基于 Qt
+ - 包含 `qt6-svg` 与 `qt6-tools` 组件的 `qt6`: 此应用基于 Qt
  - `libexiv2`: 用以获取和显示更多的图像元信息（可选，推荐）
 
 然后我们就可以使用任何常规的 c++ 编译器如 g++ 或 msvc 来进行构建了
@@ -48,28 +75,13 @@ $ cmake --build . # 如果你使用 Makefile 作为 CMake 生成器，也可以
 
 此应用的图片格式支持依赖于 Qt 的 imageformats 插件，直接从您所用的发行版获取对应的图像格式插件即可。对于 Windows 用户，您可能需要手动构建和使用图像格式插件。下方给出了进一步的说明。
 
-### Linux
+在 Windows、Linux 以及 macOS 系统均可构建此应用，其它有移植 Qt 支持的平台也可能可以进行构建。若要了解一些平台相关的构建指引，请参阅[相关的 Wiki 页面](https://github.com/BLumia/pineapple-pictures/wiki/Platform-Specific-Build-Instructions)。
 
-常规的构建步骤即可完成构建，不需要额外的处理步骤 ;)
+> [!NOTE]
-
+> 尽管存在一个可用于 QMake 构建的 `pineapple-pictures.pro` 文件，但其仅供简单测试所用且其并不包含 `exiv2` 支持。使用 QMake 构建此项目是 **不受支持** 的，请尽可能考虑使用 CMake。
-对于 Archlinux 发行版的用户，这里还有一个 [PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=pineapple-pictures-git) 可供使用和参考。
-
-对于在基于 debian 的发行版中进行打包的需求， `CMakeLists.txt` 已经提供了一些基本的 cpack 配置以便生成一个有效的 `.deb` 软件包。在构建步骤完毕后，使用 `cpack -G DEB` 即可生成 DEB 软件包。您也可以参考 `.github/workflows/ubuntu.yml` 来查看当前正在使用的 CI 配置是如何进行打包的。
-
-目前，`DEB` 是当前唯一受到直接支持的 cpack 生成目标。若希望为此项目添加其它的 cpack 目标支持，欢迎发起合并请求。
-
-### Windows
-
-上述的构建步骤在 Windows 中也适用，但由于 Windows 中不具备类如大多 Linux 发行版中所提供的方便的软件包管理机制，故如果您需要任何 Qt 官方支持之外的图像格式例如 psd，xcf，kra 等格式的支持，你就可能需要自行获取并构建对应的 imageformats 插件，并在您最终生成的可执行文件中一并提供这些插件。若您不需要这些额外的图像格式支持，这个步骤也可以直接跳过。
-
-我们所提供的预编译好的 Windows 程序包含了 kimageformats 插件来提供额外（kra, xcf, psd 等）格式的支持。您可以参考 `appveyor.yml` 来查看我们是如何构建并打包 Windows 可执行程序的。
-
-[KDE Craft](https://community.kde.org/Craft) 环境也可以被用来构建此应用程序。我也创建了一个蓝图来进行此项目的构建和打包，可参见[这里](https://github.com/BearKidsTeam/craft-shmooprint-bkt)。尽管这不是我用于构建发布二进制所使用的方案，但仍值得一试。
-
-### macOS
-
-由于我没有 mac 设备，故 macOS 暂时不受任何支持。不过我们目前有一个 GitHub Action 来执行 macOS 环境下的构建（见 `.github/workflows/macos.yml`）所以至少 macOS 下是可以顺利进行构建的。如果您想完善对 macOS 的支持，也欢迎您创建合并请求 ;P
 
 ## 许可协议
 
 菠萝看图整体使用 MIT 协议进行发布。项目所随的部分源文件可能具备不同但与之兼容的许可协议。
+
+-->

REUSE.toml

@@ -0,0 +1,39 @@
+version = 1
+SPDX-PackageName = "Pineapple Pictures"
+SPDX-PackageDownloadLocation = "https://github.com/BLumia/pineapple-pictures"
+
+[[annotations]]
+path = [".gitattributes", ".git-blame-ignore-revs", ".gitignore", "appveyor.yml", ".github/**"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "None"
+SPDX-License-Identifier = "CC0-1.0"
+
+[[annotations]]
+path = ["README**.md", "NEWS", "assets/**.rc.in", "assets/**.qrc", "dist/appstream/**", "dist/**.in", "dist/**.desktop", "dist/**.rc.in.toml", "dist/**.rc.in.liquid"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "None"
+SPDX-License-Identifier = "CC0-1.0"
+
+[[annotations]]
+path = ["locales/app/**.ts", "locales/winrc/**", "assets/plain/translators.html"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "Translators from hosted.weblate.org"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "tool/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 yyc12345"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "assets/icons/**.svg"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 Gary Wang"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "assets/icons/app-icon.**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2020 Lovelyblack"
+SPDX-License-Identifier = "MIT"

app/aboutdialog.cpp

@@ -1,164 +1,96 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #include "aboutdialog.h"
+#include "ui_aboutdialog.h"
 
-#include <QAbstractButton>
-#include <QDialogButtonBox>
-#include <QTextBrowser>
-#include <QTabWidget>
-#include <QVBoxLayout>
 #include <QApplication>
-#include <QLabel>
-#include <QPushButton>
 #include <QFile>
 
+using namespace Qt::Literals::StringLiterals;
+
+static QString loadEmbeddedHtml(QString&& path) {
+    QFile htmlFile(path);
+    bool canOpenFile = htmlFile.open(QIODevice::ReadOnly);
+    QByteArray htmlRawContent = canOpenFile ? htmlFile.readAll() : QByteArrayLiteral("");
+    return QString::fromUtf8(htmlRawContent);
+}
+
 AboutDialog::AboutDialog(QWidget *parent)
-    : QDialog(parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::AboutDialog))
-    , m_tabWidget(new QTabWidget)
-    , m_buttonBox(new QDialogButtonBox)
-    , m_helpTextEdit(new QTextBrowser)
-    , m_aboutTextEdit(new QTextBrowser)
-    , m_specialThanksTextEdit(new QTextBrowser)
-    , m_licenseTextEdit(new QTextBrowser)
-    , m_3rdPartyLibsTextEdit(new QTextBrowser)
 {
-    this->setWindowTitle(tr("About"));
+    ui->setupUi(this);
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 
-    const QStringList helpStr {
+    // blumia: Chain two arg() here since it seems lupdate will remove one of them if we use
-        QStringLiteral("<p>%1</p>").arg(tr("Launch application with image file path as argument to load the file.")),
+    //         the old `arg(QCoreApp::translate(), tr())` way, but it's worth to mention
-        QStringLiteral("<p>%1</p>").arg(tr("Drag and drop image file onto the window is also supported.")),
+    //         `arg(QCoreApp::translate(), this->tr())` works, but lupdate will complain about the usage.
-        QStringLiteral("<p>%1</p>").arg(tr("None of the operations in this application will alter the pictures on disk.")),
+    const QString HELP_HTML = loadEmbeddedHtml(u":/htmls/help.html"_s)
-        QStringLiteral("<p>%1</p>").arg(tr("Context menu option explanation:")),
+        .arg(tr("General Help"))
-        QStringLiteral("<ul>"),
+        .arg(tr("Launch application with image file path as argument to load the file."))
-        // blumia: Chain two arg() here since it seems lupdate will remove one of them if we use
+        .arg(tr("Passing in a single image file will load all the images in that directory and start viewing from that image."))
-        //         the old `arg(QCoreApp::translate(), tr())` way, but it's worth to mention
+        .arg(tr("Passing in multiple image files lets you view them one by one."))
-        //         `arg(QCoreApp::translate(), this->tr())` works, but lupdate will complain about the usage.
+        .arg(tr("Drag and drop image file onto the window is also supported."))
-        QStringLiteral("<li><b>%1</b>:<br/>%2</li>")
+        .arg(tr("None of the operations in this application will alter the pictures on disk."))
-                .arg(QCoreApplication::translate("MainWindow", "Stay on top"))
+        .arg(tr("Context Menu Help"))
-                .arg(tr("Make window stay on top of all other windows.")),
+        .arg(tr("Keep transformation", "The same meaning of MainWindow's Keep transformation."))
-        QStringLiteral("<li><b>%1</b>:<br/>%2</li>")
+        .arg(tr("Avoid resetting the zoom/rotation/flip state that was applied to the image view when switching between images."))
-                .arg(QCoreApplication::translate("MainWindow", "Protected mode"))
+        .arg(tr("Checkerboard", "The same meaning of MainWindow's Checkerboard."))
-                .arg(tr("Avoid close window accidentally. (eg. by double clicking the window)")),
+        .arg(tr("Checkerboard light and dark theme can be adjusted in the configuration window, or easily switch it by holding Shift and clicking the button."));
-        QStringLiteral("</ul>")
-    };
 
-    const QStringList aboutStr {
+    const QString APP_NAME_ARG = qApp->applicationDisplayName();
-        QStringLiteral("<center><img width='128' height='128' src=':/icons/app-icon.svg'/><br/>"),
+    const QString APP_VERSION_ARG =
-        qApp->applicationDisplayName(),
 #ifdef GIT_DESCRIBE_VERSION_STRING
-        (QStringLiteral("<br/>") + tr("Version: %1").arg(GIT_DESCRIBE_VERSION_STRING)),
+        GIT_DESCRIBE_VERSION_STRING;
+#else
+        qApp->applicationVersion();
 #endif // GIT_DESCRIBE_VERSION_STRING
-        QStringLiteral("<hr/>"),
+    const QString QT_VERSION_ARG = QT_VERSION_STR;
-        tr("Copyright (c) 2020 %1").arg(QStringLiteral("<a href='https://github.com/BLumia'>@BLumia</a>")),
+    const QString QT_ARCH_ARG = QSysInfo::buildCpuArchitecture();
-        QStringLiteral("<br/>"),
+    const QString ABOUT_HTML = loadEmbeddedHtml(u":/htmls/about.html"_s)
-        tr("Logo designed by %1").arg(QStringLiteral("<a href='https://github.com/Lovelyblack'>@Lovelyblack</a>")),
+        .arg(APP_NAME_ARG)
-        QStringLiteral("<hr/>"),
+        .arg(tr("Version: %1").arg(APP_VERSION_ARG))
-        tr("Built with Qt %1 (%2)").arg(QT_VERSION_STR, QSysInfo::buildCpuArchitecture()),
+        .arg(tr("Upstream author"))
-        QStringLiteral("<br/><a href='%1'>%2</a>").arg("https://github.com/BLumia/pineapple-pictures", tr("Source code")),
+        .arg(tr("Hard fork author"))
-        QStringLiteral("</center>")
+        .arg(tr("Logo designer"))
-    };
+        .arg(tr("Built with Qt %1 (%2)").arg(QT_VERSION_ARG).arg(QT_ARCH_ARG))
+        .arg(tr("Source code"));
 
-    QFile translaterHtml(":/plain/translators.html");
+    const QString SPECIAL_THANKS_HTML = loadEmbeddedHtml(u":/htmls/special-thanks.html"_s)
-    bool canOpenFile = translaterHtml.open(QIODevice::ReadOnly);
+        .arg(tr("Contributors"))
-    const QByteArray & translatorList = canOpenFile ? translaterHtml.readAll() : "";
+        .arg(tr("List of contributors on GitHub"))
+        .arg(tr("Thanks to all people who contributed to this project."))
+        .arg(tr("Translators"))
+        .arg(tr("I would like to thank the following people who volunteered to translate this application."));
 
-    const QStringList specialThanksStr {
+    const QString LICENSE_HTML = loadEmbeddedHtml(u":/htmls/license.html"_s)
-        QStringLiteral("<h1 align='center'>%1</h1><a href='%2'>%3</a><p>%4</p>").arg(
+        .arg(tr("License"))
-            tr("Contributors"),
+        .arg(tr("This application is released under the MIT License."))
-            QStringLiteral("https://github.com/BLumia/pineapple-pictures/graphs/contributors"),
+        .arg(tr("License Verbatim Copy"));
-            tr("List of contributors on GitHub"),
-            tr("Thanks to all people who contributed to this project.")
-        ),
 
-        QStringLiteral("<h1 align='center'>%1</h1><p>%2</p>%3").arg(
+    const QString THIRD_PARTY_LIBS_HTML = loadEmbeddedHtml(u":/htmls/third-party-libs.html"_s)
-            tr("Translators"),
+        .arg(tr("Third-party Libraries"))
-            tr("I would like to thank the following people who volunteered to translate this application."),
+        .arg(tr("This application is built on the following free software libraries.", "Free as in freedom"))
-            translatorList
+        .arg(tr("Some of them are optional and might not be included with this distribution depending on the build environment."));
-        )
-    };
 
-    const QStringList licenseStr {
+    ui->m_helpTextEdit->setHtml(HELP_HTML);
-        QStringLiteral("<h1 align='center'><b>%1</b></h1>").arg(tr("Your Rights")),
+    ui->m_aboutTextEdit->setHtml(ABOUT_HTML);
-        QStringLiteral("<p>%1</p><p>%2</p><ul><li>%3</li><li>%4</li><li>%5</li><li>%6</li></ul>").arg(
+    ui->m_specialThanksTextEdit->setHtml(SPECIAL_THANKS_HTML);
-            tr("%1 is released under the MIT License."), // %1
+    ui->m_licenseTextEdit->setHtml(LICENSE_HTML);
-            tr("This license grants people a number of freedoms:"), // %2
+    ui->m_3rdPartyLibsTextEdit->setHtml(THIRD_PARTY_LIBS_HTML);
-            tr("You are free to use %1, for any purpose"), // %3
-            tr("You are free to distribute %1"), // %4
-            tr("You can study how %1 works and change it"), // %5
-            tr("You can distribute changed versions of %1") // %6
-        ).arg(QStringLiteral("<i>%1</i>")),
-        QStringLiteral("<p>%1</p>").arg(tr("The MIT license guarantees you this freedom. Nobody is ever permitted to take it away.")),
-        QStringLiteral("<hr/><pre>%2</pre>")
-    };
 
-    const QString mitLicense(QStringLiteral(R"(Expat/MIT License
+    connect(ui->m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](QAbstractButton * btn){
-
+        Q_UNUSED(btn)
-Copyright (c) 2020 BLumia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-)"));
-
-    const QStringList thirdPartyLibsStr {
-        QStringLiteral("<h1 align='center'><b>%1</b></h1>").arg(tr("Third-party Libraries used by %1")),
-        tr("%1 is built on the following free software libraries:", "Free as in freedom"),
-        QStringLiteral("<ul>"),
-#ifdef HAVE_EXIV2_VERSION
-        QStringLiteral("<li><a href='%1'>%2</a>: %3</li>").arg("https://www.exiv2.org/", "Exiv2", "GPLv2"),
-#endif // EXIV2_VERSION
-        QStringLiteral("<li><a href='%1'>%2</a>: %3</li>").arg("https://www.qt.io/", "Qt", "GPLv2 + GPLv3 + LGPLv2.1 + LGPLv3"),
-        QStringLiteral("</ul>")
-    };
-
-    m_helpTextEdit->setText(helpStr.join('\n'));
-
-    m_aboutTextEdit->setText(aboutStr.join('\n'));
-    m_aboutTextEdit->setOpenExternalLinks(true);
-
-    m_specialThanksTextEdit->setText(specialThanksStr.join('\n'));
-    m_specialThanksTextEdit->setOpenExternalLinks(true);
-
-    m_licenseTextEdit->setText(licenseStr.join('\n').arg(qApp->applicationDisplayName(), mitLicense));
-
-    m_3rdPartyLibsTextEdit->setText(thirdPartyLibsStr.join('\n').arg(QStringLiteral("<i>%1</i>").arg(qApp->applicationDisplayName())));
-    m_3rdPartyLibsTextEdit->setOpenExternalLinks(true);
-
-    m_tabWidget->addTab(m_helpTextEdit, tr("&Help"));
-    m_tabWidget->addTab(m_aboutTextEdit, tr("&About"));
-    m_tabWidget->addTab(m_specialThanksTextEdit, tr("&Special Thanks"));
-    m_tabWidget->addTab(m_licenseTextEdit, tr("&License"));
-    m_tabWidget->addTab(m_3rdPartyLibsTextEdit, tr("&Third-party Libraries"));
-
-    m_buttonBox->setStandardButtons(QDialogButtonBox::Close);
-    connect(m_buttonBox, QOverload<QAbstractButton *>::of(&QDialogButtonBox::clicked), this, [this](){
         this->close();
     });
 
-    setLayout(new QVBoxLayout);
-
-    layout()->addWidget(m_tabWidget);
-    layout()->addWidget(m_buttonBox);
-
     setMinimumSize(361, 161); // not sure why it complain "Unable to set geometry"
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 }
 
 AboutDialog::~AboutDialog()
 {
-
+    delete ui;
 }
 
 QSize AboutDialog::sizeHint() const

app/aboutdialog.h

@@ -1,12 +1,16 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef ABOUTDIALOG_H
 #define ABOUTDIALOG_H
 
 #include <QDialog>
 
 QT_BEGIN_NAMESPACE
-class QTextBrowser;
+namespace Ui {
-class QTabWidget;
+class AboutDialog;
-class QDialogButtonBox;
+}
 QT_END_NAMESPACE
 
 class AboutDialog : public QDialog
@@ -19,14 +23,7 @@ public:
     QSize sizeHint() const override;
 
 private:
-    QTabWidget * m_tabWidget = nullptr;
+    QT_PREPEND_NAMESPACE(Ui::AboutDialog) *ui;
-    QDialogButtonBox * m_buttonBox = nullptr;
-
-    QTextBrowser * m_helpTextEdit = nullptr;
-    QTextBrowser * m_aboutTextEdit = nullptr;
-    QTextBrowser * m_specialThanksTextEdit = nullptr;
-    QTextBrowser * m_licenseTextEdit = nullptr;
-    QTextBrowser * m_3rdPartyLibsTextEdit = nullptr;
 };
 
 #endif // ABOUTDIALOG_H

app/aboutdialog.ui

@@ -0,0 +1,106 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>AboutDialog</class>
+ <widget class="QDialog" name="AboutDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>About</string>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>361</width>
+    <height>161</height>
+   </size>
+  </property>
+  <layout class="QVBoxLayout" name="verticalLayout">
+   <item>
+    <widget class="QTabWidget" name="m_tabWidget">
+     <property name="currentIndex">
+      <number>0</number>
+     </property>
+     <widget class="QWidget" name="helpTab">
+      <attribute name="title">
+       <string>&amp;Help</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="helpTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_helpTextEdit">
+          <property name="openExternalLinks">
+           <bool>false</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="aboutTab">
+      <attribute name="title">
+       <string>&amp;About</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="aboutTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_aboutTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="specialThanksTab">
+      <attribute name="title">
+       <string>&amp;Special Thanks</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="specialThanksTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_specialThanksTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="licenseTab">
+      <attribute name="title">
+       <string>&amp;License</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="licenseTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_licenseTextEdit">
+          <property name="openExternalLinks">
+           <bool>false</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+     <widget class="QWidget" name="thirdPartyLibsTab">
+      <attribute name="title">
+       <string>&amp;Third-party Libraries</string>
+      </attribute>
+      <layout class="QVBoxLayout" name="thirdPartyLibsTabLayout">
+       <item>
+         <widget class="QTextBrowser" name="m_3rdPartyLibsTextEdit">
+          <property name="openExternalLinks">
+           <bool>true</bool>
+          </property>
+         </widget>
+       </item>
+      </layout>
+     </widget>
+    </widget>
+   </item>
+   <item>
+    <widget class="QDialogButtonBox" name="m_buttonBox">
+     <property name="standardButtons">
+      <set>QDialogButtonBox::Close</set>
+     </property>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/actionmanager.cpp

@@ -1,118 +1,208 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "actionmanager.h"
 
+#include "settings.h"
 #include "mainwindow.h"
+#include "playlistmanager.h"
+#include "graphicsview.h"
+#include "graphicsscene.h"
 
-#include <QCoreApplication>
+#include <QGuiApplication>
+#include <QSvgRenderer>
+#include <QPainter>
 
-#define ICON_NAME(name)\
+static QIcon loadHidpiIcon(const QString &resp, QSize sz = QSize(32, 32))
-    QStringLiteral(":/icons/" #name "")
-
-#define SETUP_NEW_ACTION(window, action)\
-    action->setObjectName(QString::fromUtf8( #action ));\
-    window->addAction(action);
-
-#define CREATE_NEW_ACTION(window, action)\
-    action = new QAction(window);\
-    SETUP_NEW_ACTION(window, action)
-
-#define CREATE_NEW_ICON_ACTION(window, action, iconname)\
-    action = new QAction(QIcon(ICON_NAME(iconname)), QString(), window);\
-    SETUP_NEW_ACTION(window, action)
-
-ActionManager::ActionManager()
 {
-
+    QPixmap pm = QPixmap(resp);
-}
+    pm.scaled(sz * qApp->devicePixelRatio(), Qt::KeepAspectRatio);
-
+    pm.setDevicePixelRatio(qApp->devicePixelRatio());
-ActionManager::~ActionManager()
+    return QIcon(pm);
-{
-
 }
 
 void ActionManager::setupAction(MainWindow *mainWindow)
 {
-    CREATE_NEW_ICON_ACTION(mainWindow, actionActualSize, zoom-original);
+    // region: Action and Its Icon Creation
-    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleMaximize, view-fullscreen);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomIn, zoom-in);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomOut, zoom-out);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionToggleCheckerboard, view-background-checkerboard);
-    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateClockwise, object-rotate-right);
 
-    CREATE_NEW_ACTION(mainWindow, actionPrevPicture);
+    // Declare some convenient macros and lambdas.
-    CREATE_NEW_ACTION(mainWindow, actionNextPicture);
+
+    #define ICON_NAME(name)\
+        QStringLiteral(":/icons/" #name ".png")
+
+    #define ACTION_NAME(s) QStringLiteral(STRIFY(s))
+    #define STRIFY(s) #s
+
+    auto create_action = [] (QWidget *w, QAction **a, QString i, QString an, bool iconFromTheme = false) {
+        *a = new QAction(w);
+        if (!i.isNull())
+            (*a)->setIcon(iconFromTheme ? QIcon::fromTheme(i) : loadHidpiIcon(i));
+        (*a)->setObjectName(an);
+        w->addAction(*a);
+    };
+
+    /// This macro for register normal action.
+    #define CREATE_NEW_ACTION(w, a) create_action(w, &a, QString(), ACTION_NAME(a))
+    /// This macro for register Qt theme action.
+    #define CREATE_NEW_THEMEICON_ACTION(w, a, i) create_action(w, &a, QLatin1String(STRIFY(i)), ACTION_NAME(a), true)
+    /// This macro for register action with our custom icon.
+    #define CREATE_NEW_ICON_ACTION(w, a, i) create_action(w, &a, ICON_NAME(i), ACTION_NAME(a), false)
 
-    CREATE_NEW_ACTION(mainWindow, actionOpen);
-    CREATE_NEW_ACTION(mainWindow, actionHorizontalFlip);
-    CREATE_NEW_ACTION(mainWindow, actionFitInView);
-    CREATE_NEW_ACTION(mainWindow, actionFitByWidth);
     CREATE_NEW_ACTION(mainWindow, actionCopyPixmap);
     CREATE_NEW_ACTION(mainWindow, actionCopyFilePath);
-    CREATE_NEW_ACTION(mainWindow, actionPaste);
+
-    CREATE_NEW_ACTION(mainWindow, actionToggleStayOnTop);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionPrevPicture, go-previous);
-    CREATE_NEW_ACTION(mainWindow, actionToggleProtectMode);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionNextPicture, go-next);
+
+    CREATE_NEW_ICON_ACTION(mainWindow, actionActualSize, fit-to-size);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFitToScreen, fit-to-screen);
+    CREATE_NEW_ACTION(mainWindow, actionFitByWidth);
+    CREATE_NEW_ACTION(mainWindow, actionFitByHeight);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomIn, zoom-in);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionZoomOut, zoom-out);
+
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipHorizontal, flip-horizontal);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionFlipVertical, flip-vertical);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateClockwise, rotate-right);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionRotateCounterClockwise, rotate-left);
+
+    CREATE_NEW_ACTION(mainWindow, actionToggleAvoidResetTransform);
+    CREATE_NEW_ACTION(mainWindow, actionToggleCheckerboard);
+    CREATE_NEW_ACTION(mainWindow, actionTogglePauseAnimation);
+    CREATE_NEW_ACTION(mainWindow, actionAnimationNextFrame);
+
+    CREATE_NEW_ACTION(mainWindow, actionTrash/*, edit-delete*/);
+    CREATE_NEW_ACTION(mainWindow, actionLocateInFileManager/*, system-file-manager*/);
+    CREATE_NEW_ICON_ACTION(mainWindow, actionProperties, image-info);
+
     CREATE_NEW_ACTION(mainWindow, actionSettings);
-    CREATE_NEW_ACTION(mainWindow, actionHelp);
+    CREATE_NEW_ACTION(mainWindow, actionHelp/*, system-help*/);
-    CREATE_NEW_ACTION(mainWindow, actionProperties);
-    CREATE_NEW_ACTION(mainWindow, actionQuitApp);
 
-    retranslateUi(mainWindow);
+    // Remove convenient macros
 
-    QMetaObject::connectSlotsByName(mainWindow);
+    #undef CREATE_NEW_ICON_ACTION
-}
+    #undef CREATE_NEW_THEMEICON_ACTION
+    #undef CREATE_NEW_ACTION
 
-void ActionManager::retranslateUi(MainWindow *mainWindow)
+    #undef STRIFY
-{
+    #undef ACTION_NAME
-    Q_UNUSED(mainWindow);
+    #undef ICON_NAME
 
-    actionOpen->setText(QCoreApplication::translate("MainWindow", "&Open...", nullptr));
+    // endregion
 
-    actionActualSize->setText(QCoreApplication::translate("MainWindow", "Actual size", nullptr));
+    // region: Setup Checkable Action
-    actionToggleMaximize->setText(QCoreApplication::translate("MainWindow", "Toggle maximize", nullptr));
+
-    actionZoomIn->setText(QCoreApplication::translate("MainWindow", "Zoom in", nullptr));
+    actionToggleAvoidResetTransform->setCheckable(true);
-    actionZoomOut->setText(QCoreApplication::translate("MainWindow", "Zoom out", nullptr));
+    actionToggleCheckerboard->setCheckable(true);
-    actionToggleCheckerboard->setText(QCoreApplication::translate("MainWindow", "Toggle Checkerboard", nullptr));
+    actionTogglePauseAnimation->setCheckable(true);
-    actionRotateClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate right", nullptr));
+
+    // endregion
+
+    // region: Action Translatable Text Setup
+
+    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
+    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
 
     actionPrevPicture->setText(QCoreApplication::translate("MainWindow", "Previous image", nullptr));
     actionNextPicture->setText(QCoreApplication::translate("MainWindow", "Next image", nullptr));
 
-    actionHorizontalFlip->setText(QCoreApplication::translate("MainWindow", "Flip &Horizontally", nullptr));
+    actionActualSize->setText(QCoreApplication::translate("MainWindow", "Actual size", nullptr));
-    actionFitInView->setText("Fit in view"); // TODO: what should it called?
+    actionFitToScreen->setText(QCoreApplication::translate("MainWindow", "Fit to screen", nullptr));
-    actionFitByWidth->setText("Fit by width"); // TODO: what should it called?
+    actionFitByWidth->setText(QCoreApplication::translate("MainWindow", "Fit by width", nullptr));
-    actionCopyPixmap->setText(QCoreApplication::translate("MainWindow", "Copy P&ixmap", nullptr));
+    actionFitByHeight->setText(QCoreApplication::translate("MainWindow", "Fit by height", nullptr));
-    actionCopyFilePath->setText(QCoreApplication::translate("MainWindow", "Copy &File Path", nullptr));
+    actionZoomIn->setText(QCoreApplication::translate("MainWindow", "Zoom in", nullptr));
-    actionPaste->setText(QCoreApplication::translate("MainWindow", "&Paste", nullptr));
+    actionZoomOut->setText(QCoreApplication::translate("MainWindow", "Zoom out", nullptr));
-    actionToggleStayOnTop->setText(QCoreApplication::translate("MainWindow", "Stay on top", nullptr));
+
-    actionToggleProtectMode->setText(QCoreApplication::translate("MainWindow", "Protected mode", nullptr));
+    actionFlipHorizontal->setText(QCoreApplication::translate("MainWindow", "Flip &Horizontally", nullptr));
+    actionFlipVertical->setText(QCoreApplication::translate("MainWindow", "Flip &Vertically", nullptr));
+    actionRotateClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate right", nullptr));
+    actionRotateCounterClockwise->setText(QCoreApplication::translate("MainWindow", "Rotate left", nullptr));
+
+    actionToggleAvoidResetTransform->setText(QCoreApplication::translate("MainWindow", "Keep transformation", "The 'transformation' means the flip/rotation status that currently applied to the image view"));
+    actionToggleCheckerboard->setText(QCoreApplication::translate("MainWindow", "Toggle Checkerboard", nullptr));
+    actionTogglePauseAnimation->setText(QCoreApplication::translate("MainWindow", "Pause/Resume Animation", nullptr));
+    actionAnimationNextFrame->setText(QCoreApplication::translate("MainWindow", "Animation Go to Next Frame", nullptr));
+
+    actionTrash->setText(QCoreApplication::translate("MainWindow", "Move to Trash", nullptr));
+#ifdef Q_OS_WIN
+    actionLocateInFileManager->setText(
+        QCoreApplication::translate(
+            "MainWindow", "Show in File Explorer",
+            "File Explorer is the name of explorer.exe under Windows"
+            )
+        );
+#else
+    actionLocateInFileManager->setText(QCoreApplication::translate("MainWindow", "Show in directory", nullptr));
+#endif // Q_OS_WIN
+    actionProperties->setText(QCoreApplication::translate("MainWindow", "Properties", nullptr));
+
     actionSettings->setText(QCoreApplication::translate("MainWindow", "Configure...", nullptr));
     actionHelp->setText(QCoreApplication::translate("MainWindow", "Help", nullptr));
-    actionProperties->setText(QCoreApplication::translate("MainWindow", "Properties", nullptr));
+    // endregion
-    actionQuitApp->setText(QCoreApplication::translate("MainWindow", "Quit", nullptr));
+
+    QMetaObject::connectSlotsByName(mainWindow);
 }
 
 void ActionManager::setupShortcuts()
 {
-    actionOpen->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_O));
+    actionCopyPixmap->setShortcut(QKeySequence::Copy);
-    actionActualSize->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_0));
+
-    actionZoomIn->setShortcut(QKeySequence(QKeySequence::ZoomIn));
-    actionZoomOut->setShortcut(QKeySequence(QKeySequence::ZoomOut));
     actionPrevPicture->setShortcuts({
-        QKeySequence(Qt::Key_PageUp),
         QKeySequence(Qt::Key_Left),
+        QKeySequence(Qt::Key_PageUp),
     });
     actionNextPicture->setShortcuts({
-        QKeySequence(Qt::Key_PageDown),
         QKeySequence(Qt::Key_Right),
+        QKeySequence(Qt::Key_PageDown),
     });
-    actionHorizontalFlip->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_R));
+
-    actionCopyPixmap->setShortcut(QKeySequence(QKeySequence::Copy));
+    actionActualSize->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_0));
-    actionPaste->setShortcut(QKeySequence::Paste);
+    actionZoomIn->setShortcut(QKeySequence::ZoomIn);
-    actionHelp->setShortcut(QKeySequence::HelpContents);
+    actionZoomOut->setShortcut(QKeySequence::ZoomOut);
-    actionSettings->setShortcut(QKeySequence::Preferences);
+
+    actionTrash->setShortcut(QKeySequence::Delete);
     actionProperties->setShortcut(QKeySequence(Qt::CTRL | Qt::Key_I));
-    actionQuitApp->setShortcuts({
+
-        QKeySequence(Qt::Key_Space),
+    actionSettings->setShortcut(QKeySequence::Preferences);
-        QKeySequence(Qt::Key_Escape)
+    actionHelp->setShortcut(QKeySequence::HelpContents);
-    });
+}
+
+void ActionManager::updateActionState(PlaylistManager* pm, GraphicsView* gv)
+{
+    const auto* gs = gv->scene();
+    const auto* settings = Settings::instance();
+
+    // Update copy actions
+    bool canCopy = pm->currentIndex().has_value();
+    actionCopyPixmap->setEnabled(canCopy);
+    actionCopyFilePath->setEnabled(canCopy);
+
+    // Update Prev/Next Picture State
+    const int galleryFileCount = pm->totalCount();
+    const bool loopGallery = settings->loopGallery();
+    actionPrevPicture->setEnabled(galleryFileCount > 1 && (loopGallery || !pm->isFirstIndex()));
+    actionNextPicture->setEnabled(galleryFileCount > 1 && (loopGallery || !pm->isLastIndex()));
+
+    // Update Avoid Reset Transform
+    actionToggleAvoidResetTransform->setChecked(gv->isAvoidResetTransform());
+    // Update Checkerboard
+    actionToggleCheckerboard->setChecked(gv->isCheckerboard());
+    // Update Animation Graphics Action
+    bool canPauseAnimation = gs->canPauseAnimation();
+    actionTogglePauseAnimation->setEnabled(canPauseAnimation);
+    if (canPauseAnimation) {
+        actionTogglePauseAnimation->setChecked(gs->isPauseAnimation());
+    } else {
+        actionTogglePauseAnimation->setChecked(false);
+    }
+    bool canSkipAnimation = gs->canSkipAnimationFrame();
+    actionAnimationNextFrame->setEnabled(canSkipAnimation);
+
+    // Update trash, located in explorer and properties.
+    bool hasLoadedFile = pm->currentIndex().has_value();
+    actionTrash->setEnabled(hasLoadedFile);
+    actionLocateInFileManager->setEnabled(hasLoadedFile);
+    actionProperties->setEnabled(hasLoadedFile);
 }
 

app/actionmanager.h

@@ -1,45 +1,60 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef ACTIONMANAGER_H
 #define ACTIONMANAGER_H
 
 #include <QAction>
 
 class MainWindow;
+class PlaylistManager;
+class GraphicsView;
 
+/// Action Manager is separated from Main Window
+/// to manage all actions specifically.
 class ActionManager
 {
 public:
-    ActionManager();
+    explicit ActionManager() = default;
-    ~ActionManager();
+    ~ActionManager() = default;
 
     void setupAction(MainWindow * mainWindow);
-    void retranslateUi(MainWindow *MainWindow);
     void setupShortcuts();
 
-public:
+public slots:
-    QAction *actionOpen;
+    void updateActionState(PlaylistManager* pm, GraphicsView* gv);
 
-    QAction *actionActualSize;
+public:
-    QAction *actionToggleMaximize;
+    QAction *actionCopyPixmap;
-    QAction *actionZoomIn;
+    QAction *actionCopyFilePath;
-    QAction *actionZoomOut;
-    QAction *actionToggleCheckerboard;
-    QAction *actionRotateClockwise;
 
     QAction *actionPrevPicture;
     QAction *actionNextPicture;
 
-    QAction *actionHorizontalFlip;
+    QAction *actionActualSize;
-    QAction *actionFitInView;
+    QAction *actionFitToScreen;
     QAction *actionFitByWidth;
-    QAction *actionCopyPixmap;
+    QAction *actionFitByHeight;
-    QAction *actionCopyFilePath;
+    QAction *actionZoomIn;
-    QAction *actionPaste;
+    QAction *actionZoomOut;
-    QAction *actionToggleStayOnTop;
+
-    QAction *actionToggleProtectMode;
+    QAction *actionFlipHorizontal;
+    QAction *actionFlipVertical;
+    QAction *actionRotateClockwise;
+    QAction *actionRotateCounterClockwise;
+
+    QAction *actionToggleAvoidResetTransform;
+    QAction *actionToggleCheckerboard;
+    QAction *actionTogglePauseAnimation;
+    QAction *actionAnimationNextFrame;
+
+    QAction *actionTrash;
+    QAction *actionLocateInFileManager;
+    QAction *actionProperties;
+
     QAction *actionSettings;
     QAction *actionHelp;
-    QAction *actionProperties;
-    QAction *actionQuitApp;
 };
 
 #endif // ACTIONMANAGER_H

app/bottombuttongroup.cpp

@@ -1,55 +1,45 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "bottombuttongroup.h"
 
-#include "opacityhelper.h"
-
-#include <functional>
-
 #include <QToolButton>
 #include <QVBoxLayout>
 #include <QDebug>
 
-BottomButtonGroup::BottomButtonGroup(const std::vector<QAction *> &actionList, QWidget *parent)
+BottomButtonGroup::BottomButtonGroup(QWidget *parent)
     : QGroupBox (parent)
-    , m_opacityHelper(new OpacityHelper(this))
 {
     QHBoxLayout * mainLayout = new QHBoxLayout(this);
     mainLayout->setSizeConstraint(QLayout::SetFixedSize);
     this->setLayout(mainLayout);
     this->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Minimum);
-    this->setStyleSheet("BottomButtonGroup {"
+    this->setStyleSheet(R"#(
-                        "border: 1px solid gray;"
+BottomButtonGroup {
-                        "border-top-left-radius: 10px;"
+    border-style: none;
-                        "border-top-right-radius: 10px;"
+    background: transparent;
-                        "border-style: none;"
+}
-                        "background-color:rgba(0,0,0,120)"
+QToolButton {
-                        "}"
+    background: transparent;
-                        "QToolButton {"
+    border-style: none;
-                        "background:transparent;"
+}
-                        "}"
+)#");
-                        "QToolButton:!focus {"
+}
-                        "border-style: none;"
-                        "}");
 
-    auto newActionBtn = [this](QAction * action) -> QToolButton * {
+void BottomButtonGroup::addActions(const std::vector<QAction *> & actionList) {
+    for (QAction * action : actionList) {
+        // Create button
         QToolButton * btn = new QToolButton(this);
         btn->setDefaultAction(action);
-        btn->setIconSize(QSize(40, 40));
+        btn->setIconSize(QSize(32, 32));
         btn->setFixedSize(40, 40);
-        return btn;
+        // Add button
-    };
+        layout()->addWidget(btn);
-
-    for (QAction * action : actionList) {
-        addButton(newActionBtn(action));
     }
-}
-
-void BottomButtonGroup::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}
-
-void BottomButtonGroup::addButton(QAbstractButton *button)
-{
-    layout()->addWidget(button);
     updateGeometry();
 }
+
+void BottomButtonGroup::addAction(QAction* action) {
+    addActions({action});
+}

app/bottombuttongroup.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef BOTTOMBUTTONGROUP_H
 #define BOTTOMBUTTONGROUP_H
 
@@ -6,18 +10,14 @@
 #include <QAbstractButton>
 #include <QGroupBox>
 
-class OpacityHelper;
 class BottomButtonGroup : public QGroupBox
 {
     Q_OBJECT
 public:
-    explicit BottomButtonGroup(const std::vector<QAction *> & actionList, QWidget *parent = nullptr);
+    explicit BottomButtonGroup(QWidget *parent = nullptr);
 
-    void setOpacity(qreal opacity, bool animated = true);
+    void addActions(const std::vector<QAction *> & actionList);
-    void addButton(QAbstractButton *button);
+    void addAction(QAction* action);
-
-private:
-    OpacityHelper * m_opacityHelper;
 };
 
 #endif // BOTTOMBUTTONGROUP_H

app/exiv2wrapper.cpp

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "exiv2wrapper.h"
 
 #ifdef HAVE_EXIV2_VERSION
@@ -23,6 +27,7 @@ Exiv2Wrapper::~Exiv2Wrapper()
 
 }
 
+#ifdef HAVE_EXIV2_VERSION // stupid AppleClang...
 template<typename Collection, typename Iterator>
 void Exiv2Wrapper::cacheSection(Collection collection)
 {
@@ -31,16 +36,27 @@ void Exiv2Wrapper::cacheSection(Collection collection)
     for (; it != end; ++it) {
         QString key = QString::fromUtf8(it->key().c_str());
         if (it->tagName().substr(0, 2) == "0x") continue;
-        QString label = QString::fromLocal8Bit(it->tagLabel().c_str());
+        // We might get exceptions like "No namespace info available for XMP prefix `Item'"
-        std::ostringstream stream;
+        // when trying to get tagLabel() data from a Xmpdatum if the tag is not common-used.
-        stream << *it;
+        // We don't care for those rare tags so let's just use a try-cache...
-        QString value = QString::fromUtf8(stream.str().c_str());
+        try {
-        m_metadataValue.insert(key, value);
+            QString label = QString::fromLocal8Bit(it->tagLabel().c_str());
-        m_metadataLabel.insert(key, label);
+            std::ostringstream stream;
-
+            stream << *it;
-        qDebug() << key << label << value;
+            QString value = QString::fromUtf8(stream.str().c_str());
+            m_metadataValue.insert(key, value);
+            m_metadataLabel.insert(key, label);
+            qDebug() << key << label << value;
+#if EXIV2_TEST_VERSION(0, 28, 0)
+        } catch (Exiv2::Error & err) {
+#else // 0.27.x
+        } catch (Exiv2::AnyError & err) {
+#endif // EXIV2_TEST_VERSION(0, 28, 0)
+            qWarning() << "Error loading key" << key << ":" << err.what();
+        }
     }
 }
+#endif // HAVE_EXIV2_VERSION
 
 bool Exiv2Wrapper::load(const QString &filePath)
 {

app/exiv2wrapper.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef EXIV2WRAPPER_H
 #define EXIV2WRAPPER_H
 

app/fileopeneventhandler.cpp

@@ -0,0 +1,22 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#include "fileopeneventhandler.h"
+
+#include <QFileOpenEvent>
+
+FileOpenEventHandler::FileOpenEventHandler(QObject *parent)
+    : QObject(parent)
+{
+}
+
+bool FileOpenEventHandler::eventFilter(QObject *obj, QEvent *event)
+{
+    if (event->type() == QEvent::FileOpen) {
+        QFileOpenEvent *fileOpenEvent = static_cast<QFileOpenEvent *>(event);
+        emit fileOpen(fileOpenEvent->url());
+        return true;
+    }
+    return QObject::eventFilter(obj, event);
+}

app/fileopeneventhandler.h

@@ -0,0 +1,21 @@
+// SPDX-FileCopyrightText: 2024 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QObject>
+
+class FileOpenEventHandler : public QObject
+{
+    Q_OBJECT
+
+public:
+    explicit FileOpenEventHandler(QObject *parent = nullptr);
+
+protected:
+    bool eventFilter(QObject *obj, QEvent *event) override;
+
+signals:
+    void fileOpen(const QUrl &url);
+};

app/framelesswindow.cpp

@@ -1,119 +0,0 @@
-#include "framelesswindow.h"
-
-#include <QApplication>
-#include <QVBoxLayout>
-
-#ifdef _WIN32
-#include <windows.h>
-#endif // _WIN32
-
-FramelessWindow::FramelessWindow(QWidget *parent)
-    : QWidget(parent)
-    , m_centralLayout(new QVBoxLayout(this))
-{
-    // We should use Qt::WindowMinMaxButtonsHint here but there is a bug in Qt
-    // that will make pressing Meta+Up cause the app fullscreen under Windows,
-    // so for now we only use the Qt::WindowMinimizeButtonHint flag here.
-    // https://bugreports.qt.io/browse/QTBUG-91226
-    this->setWindowFlags(Qt::Window | Qt::FramelessWindowHint | Qt::WindowMinimizeButtonHint);
-
-    m_centralLayout->setContentsMargins(QMargins());
-}
-
-void FramelessWindow::setCentralWidget(QWidget *widget)
-{
-    if (m_centralWidget) {
-        m_centralLayout->removeWidget(m_centralWidget);
-        m_centralWidget->deleteLater();
-    }
-
-    m_centralLayout->addWidget(widget);
-    m_centralWidget = widget;
-}
-
-bool FramelessWindow::nativeEvent(const QByteArray &eventType, void *message, NATIVE_RESULT *result)
-{
-#ifdef _WIN32
-    // https://stackoverflow.com/questions/43505580/qt-windows-resizable-frameless-window
-    // Too lazy to do this now.. just stackoverflow it and did a copy and paste..
-    Q_UNUSED(eventType)
-    MSG* msg = static_cast<MSG*>(message);
-
-    if (msg->message == WM_NCHITTEST) {
-        if (isMaximized()) {
-            return false;
-        }
-
-        *result = 0;
-        const LONG borderWidth = 8;
-        RECT winrect;
-        GetWindowRect(reinterpret_cast<HWND>(winId()), &winrect);
-
-        // must be short to correctly work with multiple monitors (negative coordinates)
-        short x = msg->lParam & 0x0000FFFF;
-        short y = (msg->lParam & 0xFFFF0000) >> 16;
-
-        bool resizeWidth = minimumWidth() != maximumWidth();
-        bool resizeHeight = minimumHeight() != maximumHeight();
-        if (resizeWidth) {
-            //left border
-            if (x >= winrect.left && x < winrect.left + borderWidth) {
-                *result = HTLEFT;
-            }
-            //right border
-            if (x < winrect.right && x >= winrect.right - borderWidth) {
-                *result = HTRIGHT;
-            }
-        }
-        if (resizeHeight) {
-            //bottom border
-            if (y < winrect.bottom && y >= winrect.bottom - borderWidth) {
-                *result = HTBOTTOM;
-            }
-            //top border
-            if (y >= winrect.top && y < winrect.top + borderWidth) {
-                *result = HTTOP;
-            }
-        }
-        if (resizeWidth && resizeHeight) {
-            //bottom left corner
-            if (x >= winrect.left && x < winrect.left + borderWidth &&
-                    y < winrect.bottom && y >= winrect.bottom - borderWidth)
-            {
-                *result = HTBOTTOMLEFT;
-            }
-            //bottom right corner
-            if (x < winrect.right && x >= winrect.right - borderWidth &&
-                    y < winrect.bottom && y >= winrect.bottom - borderWidth)
-            {
-                *result = HTBOTTOMRIGHT;
-            }
-            //top left corner
-            if (x >= winrect.left && x < winrect.left + borderWidth &&
-                    y >= winrect.top && y < winrect.top + borderWidth)
-            {
-                *result = HTTOPLEFT;
-            }
-            //top right corner
-            if (x < winrect.right && x >= winrect.right - borderWidth &&
-                    y >= winrect.top && y < winrect.top + borderWidth)
-            {
-                *result = HTTOPRIGHT;
-            }
-        }
-
-        if (*result != 0)
-            return true;
-
-        QWidget *action = QApplication::widgetAt(QCursor::pos());
-        if (action == this) {
-            *result = HTCAPTION;
-            return true;
-        }
-    }
-
-    return false;
-#else
-    return QWidget::nativeEvent(eventType, message, result);
-#endif // _WIN32
-}

app/framelesswindow.h

@@ -1,32 +0,0 @@
-#ifndef FRAMELESSWINDOW_H
-#define FRAMELESSWINDOW_H
-
-#include <QWidget>
-
-#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-    typedef qintptr NATIVE_RESULT;
-#else
-    typedef long NATIVE_RESULT;
-#endif // QT_VERSION_CHECK(6, 0, 0)
-
-QT_BEGIN_NAMESPACE
-class QVBoxLayout;
-QT_END_NAMESPACE
-
-class FramelessWindow : public QWidget
-{
-    Q_OBJECT
-public:
-    explicit FramelessWindow(QWidget *parent = nullptr);
-
-    void setCentralWidget(QWidget * widget);
-
-protected:
-    bool nativeEvent(const QByteArray& eventType, void* message, NATIVE_RESULT* result) override;
-
-private:
-    QVBoxLayout * m_centralLayout = nullptr;
-    QWidget * m_centralWidget = nullptr; // just a pointer, doesn't take the ownership.
-};
-
-#endif // FRAMELESSWINDOW_H

app/graphicsscene.cpp

@@ -1,15 +1,51 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "graphicsscene.h"
 
+#include "settings.h"
+
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
+#include <QGuiApplication>
 #include <QGraphicsSceneMouseEvent>
 #include <QMimeData>
 #include <QDebug>
 #include <QGraphicsItem>
 #include <QUrl>
 #include <QGraphicsSvgItem>
+#include <QSvgRenderer>
 #include <QMovie>
-#include <QLabel>
 #include <QPainter>
 
+static const QColor& ColorSchemaToTextForeground(Qt::ColorScheme colorScheme) {
+    // YYC MARK:
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+        static QColor WHITE = QColor("White");
+        return WHITE;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        static QColor BLACK = QColor("Black");
+        return BLACK;
+    }
+}
+
 class PGraphicsPixmapItem : public QGraphicsPixmapItem
 {
 public:
@@ -17,10 +53,26 @@ public:
         : QGraphicsPixmapItem(pixmap, parent)
     {}
 
+    enum { Type = UserType + 1 };
+    int type() const override { return Type; }
+
     void setScaleHint(float scaleHint) {
         m_scaleHint = scaleHint;
     }
 
+    const QPixmap & scaledPixmap(float scaleHint) {
+        if (qFuzzyCompare(scaleHint, m_cachedScaleHint)) return m_cachedPixmap;
+        QSizeF resizedScale(boundingRect().size());
+        resizedScale *= scaleHint;
+        QPixmap && sourcePixmap = pixmap();
+        m_cachedPixmap = sourcePixmap.scaled(
+             resizedScale.toSize() * sourcePixmap.devicePixelRatioF(),
+             Qt::KeepAspectRatio,
+             Qt::SmoothTransformation);
+        m_cachedScaleHint = scaleHint;
+        return m_cachedPixmap;
+    }
+
     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,
                QWidget *widget) override
     {
@@ -28,24 +80,57 @@ public:
             return QGraphicsPixmapItem::paint(painter, option, widget);
         } else {
 //            painter->setRenderHints(QPainter::Antialiasing);
-            QSizeF resizedScale(boundingRect().size());
-            resizedScale *= m_scaleHint;
             painter->drawPixmap(QRectF(offset(), boundingRect().size()).toRect(),
-                                pixmap().scaled(resizedScale.toSize(),
+                                scaledPixmap(m_scaleHint));
-                                                Qt::KeepAspectRatio,
-                                                Qt::SmoothTransformation)
-                                );
         }
     }
 
 private:
     float m_scaleHint = 1;
+    float m_cachedScaleHint = -1;
+    QPixmap m_cachedPixmap;
+};
+
+class PGraphicsMovieItem : public QGraphicsItem
+{
+public:
+    PGraphicsMovieItem(QGraphicsItem *parent = nullptr) : QGraphicsItem(parent) {}
+
+    enum { Type = UserType + 2 };
+    int type() const override { return Type; }
+
+    void setMovie(QMovie* movie) {
+        if (m_movie) m_movie->disconnect();
+        m_movie.reset(movie);
+        m_movie->connect(m_movie.data(), &QMovie::updated, [this](){
+            this->update();
+        });
+    }
+
+    QRectF boundingRect() const override {
+        if (m_movie) { return m_movie->frameRect(); }
+        else { return QRectF(); }
+    }
+
+    void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget) override {
+        if (m_movie) {
+            painter->drawPixmap(m_movie->frameRect(), m_movie->currentPixmap(), m_movie->frameRect());
+        }
+    }
+
+    inline QMovie * movie() const {
+        return m_movie.data();
+    }
+
+private:
+    QScopedPointer<QMovie> m_movie;
 };
 
 GraphicsScene::GraphicsScene(QObject *parent)
     : QGraphicsScene(parent)
 {
-    showText(tr("Drag image here"));
+    showText(tr("Drag image here", "The same meaning of MainWindow's hint."));
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsScene::updateStyle);
 }
 
 GraphicsScene::~GraphicsScene()
@@ -67,7 +152,7 @@ void GraphicsScene::showText(const QString &text)
 {
     this->clear();
     QGraphicsTextItem * textItem = this->addText(text);
-    textItem->setDefaultTextColor(QColor("White"));
+    textItem->setDefaultTextColor(ColorSchemaToTextForeground(qGuiApp->styleHints()->colorScheme()));
     m_theThing = textItem;
     this->setSceneRect(m_theThing->boundingRect());
 }
@@ -75,7 +160,15 @@ void GraphicsScene::showText(const QString &text)
 void GraphicsScene::showSvg(const QString &filepath)
 {
     this->clear();
-    QGraphicsSvgItem * svgItem = new QGraphicsSvgItem(filepath);
+    QGraphicsSvgItem * svgItem = new QGraphicsSvgItem();
+    QSvgRenderer * render = new QSvgRenderer(svgItem);
+#if QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+    if (Settings::instance()->svgTiny12Only()) {
+        render->setOptions(QtSvg::Tiny12FeaturesOnly);
+    }
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+    render->load(filepath);
+    svgItem->setSharedRenderer(render);
     this->addItem(svgItem);
     m_theThing = svgItem;
     this->setSceneRect(m_theThing->boundingRect());
@@ -84,14 +177,14 @@ void GraphicsScene::showSvg(const QString &filepath)
 void GraphicsScene::showAnimated(const QString &filepath)
 {
     this->clear();
-    QLabel * label = new QLabel;
+
-    QMovie * movie = new QMovie(filepath, QByteArray(), label);
+    PGraphicsMovieItem * animatedItem = new PGraphicsMovieItem();
-    label->setStyleSheet("background-color:rgba(225,255,255,0);");
+    QMovie * movie = new QMovie(filepath);
-    label->setMovie(movie);
-    this->addWidget(label);
     movie->start();
-    m_theThing = this->addRect(QRect(QPoint(0, 0), label->sizeHint()),
+    animatedItem->setMovie(movie);
-                               QPen(Qt::transparent));
+    this->addItem(animatedItem);
+    m_theThing = animatedItem;
+
     this->setSceneRect(m_theThing->boundingRect());
 }
 
@@ -107,6 +200,59 @@ bool GraphicsScene::trySetTransformationMode(Qt::TransformationMode mode, float
     return false;
 }
 
+/// Fetch graphics item as our custom animated item.
+/// Return nullptr means this item is not animated item.
+static PGraphicsMovieItem* fetchAnimatedItem(QGraphicsItem *item) {
+    return qgraphicsitem_cast<PGraphicsMovieItem *>(item);
+}
+
+bool GraphicsScene::canPauseAnimation() const {
+    return fetchAnimatedItem(m_theThing) != nullptr;
+}
+
+bool GraphicsScene::isPauseAnimation() const {
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+    if (animatedItem != nullptr) {
+        return animatedItem->movie()->state() == QMovie::Paused;
+    } else {
+        return false;
+    }
+}
+
+bool GraphicsScene::togglePauseAnimation()
+{
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+    if (animatedItem != nullptr) {
+        animatedItem->movie()->setPaused(animatedItem->movie()->state() != QMovie::Paused);
+        return true;
+    } else {
+        return false;
+    }
+}
+
+bool GraphicsScene::canSkipAnimationFrame() const {
+    return isPauseAnimation();
+}
+
+bool GraphicsScene::skipAnimationFrame(int delta)
+{
+    auto* animatedItem = fetchAnimatedItem(m_theThing);
+
+    // Only paused animated item can skip frame
+    if (animatedItem == nullptr) {
+        return false;
+    }
+    if (animatedItem->movie()->state() != QMovie::Paused) {
+        return false;
+    }
+
+    // Perform skip
+    const int frameCount = animatedItem->movie()->frameCount();
+    const int currentFrame = animatedItem->movie()->currentFrameNumber();
+    const int targetFrame = (currentFrame + delta) % frameCount;
+    return animatedItem->movie()->jumpToFrame(targetFrame);
+}
+
 QPixmap GraphicsScene::renderToPixmap()
 {
     PGraphicsPixmapItem * pixmapItem = qgraphicsitem_cast<PGraphicsPixmapItem *>(m_theThing);
@@ -121,3 +267,14 @@ QPixmap GraphicsScene::renderToPixmap()
 
     return pixmap;
 }
+
+void GraphicsScene::updateStyle(Qt::ColorScheme colorScheme) {
+    Q_UNUSED(colorScheme)
+
+    QGraphicsItem * item = this->m_theThing;
+    if (item == nullptr) return;
+    QGraphicsTextItem * textItem = qgraphicsitem_cast<QGraphicsTextItem*>(item);
+    if (textItem == nullptr) return;
+
+    textItem->setDefaultTextColor(ColorSchemaToTextForeground(colorScheme));
+}

app/graphicsscene.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef GRAPHICSSCENE_H
 #define GRAPHICSSCENE_H
 
@@ -17,10 +21,28 @@ public:
 
     bool trySetTransformationMode(Qt::TransformationMode mode, float scaleHint);
 
+    /// Check whether current thing is animation.
+    /// Only animation thing can be paused.
+    bool canPauseAnimation() const;
+    /// Check whether we are pasuing an animation graphics.
+    bool isPauseAnimation() const;
+    /// Toggle animation graphics pause state.
+    /// Return true for successfully toggle, otherwise false.
+    bool togglePauseAnimation();
+    /// Check whether we can skip animation frame.
+    /// Only paused animation graphics can skip frame.
+    bool canSkipAnimationFrame() const;
+    /// Skip paused animation graphics with given frame.
+    /// Return true for successfully skip, otherwise false.
+    bool skipAnimationFrame(int delta = 1);
+
     QPixmap renderToPixmap();
 
+private slots:
+    void updateStyle(Qt::ColorScheme colorScheme);
+
 private:
-    QGraphicsItem * m_theThing;
+    QGraphicsItem * m_theThing = nullptr;
 };
 
 #endif // GRAPHICSSCENE_H

app/graphicsview.cpp

@@ -1,21 +1,22 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #include "graphicsview.h"
 
 #include "graphicsscene.h"
+#include "settings.h"
 
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
 #include <QDebug>
+#include <QColorSpace>
 #include <QMouseEvent>
 #include <QScrollBar>
 #include <QMimeData>
 #include <QImageReader>
 #include <QStyleOptionGraphicsItem>
 
-// TODO: remove this once we drop older Qt support.
-#if QT_VERSION >= QT_VERSION_CHECK(5, 13, 0)
-#define COMPAT_CONSTCOLOR constexpr
-#else
-#define COMPAT_CONSTCOLOR const
-#endif
-
 GraphicsView::GraphicsView(QWidget *parent)
     : QGraphicsView (parent)
 {
@@ -24,16 +25,17 @@ GraphicsView::GraphicsView(QWidget *parent)
     setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
     setResizeAnchor(QGraphicsView::AnchorUnderMouse);
     setTransformationAnchor(QGraphicsView::AnchorUnderMouse);
-    setStyleSheet("background-color: rgba(0, 0, 0, 220);"
+    setAcceptDrops(false);
-                  "border-radius: 3px;");
-    setAcceptDrops(true);
     setCheckerboardEnabled(false);
 
+    updateStyle(qGuiApp->styleHints()->colorScheme());
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &GraphicsView::updateStyle);
+
     connect(horizontalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
     connect(verticalScrollBar(), &QScrollBar::valueChanged, this, &GraphicsView::viewportRectChanged);
 }
 
-void GraphicsView::showFileFromPath(const QString &filePath, bool doRequestGallery)
+void GraphicsView::showFileFromPath(const QString &filePath)
 {
     emit navigatorViewRequired(false, transform());
 
@@ -43,32 +45,40 @@ void GraphicsView::showFileFromPath(const QString &filePath, bool doRequestGalle
         QImageReader imageReader(filePath);
         imageReader.setAutoTransform(true);
         imageReader.setDecideFormatFromContent(true);
+        imageReader.setAllocationLimit(0);
 
         // Since if the image format / plugin does not support this feature, imageFormat() will returns an invalid format.
         // So we cannot use imageFormat() and check if it returns QImage::Format_Invalid to detect if we support the file.
         // QImage::Format imageFormat = imageReader.imageFormat();
         if (imageReader.format().isEmpty()) {
-            doRequestGallery = false;
             showText(tr("File is not a valid image"));
         } else if (imageReader.supportsAnimation() && imageReader.imageCount() > 1) {
             showAnimated(filePath);
         } else if (!imageReader.canRead()) {
-            doRequestGallery = false;
             showText(tr("Image data is invalid or currently unsupported"));
         } else {
-            const QPixmap & pixmap = QPixmap::fromImageReader(&imageReader);
+#if QT_VERSION >= QT_VERSION_CHECK(6, 8, 0)
-            if (pixmap.isNull()) {
+            QImage && img = imageReader.read();
-                doRequestGallery = false;
+            if (img.isNull()) {
                 showText(tr("Image data is invalid or currently unsupported"));
             } else {
+                if (img.format() == QImage::Format_CMYK8888) {
+                    img.convertToColorSpace(QColorSpace::SRgb);
+                }
+                img.setDevicePixelRatio(devicePixelRatioF());
+                showImage(img);
+            }
+#else
+            QPixmap && pixmap = QPixmap::fromImageReader(&imageReader);
+            if (pixmap.isNull()) {
+                showText(tr("Image data is invalid or currently unsupported"));
+            } else {
+                pixmap.setDevicePixelRatio(devicePixelRatioF());
                 showImage(pixmap);
             }
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 8, 0)
         }
     }
-
-    if (doRequestGallery) {
-        emit requestGallery(filePath);
-    }
 }
 
 void GraphicsView::showImage(const QPixmap &pixmap)
@@ -123,12 +133,14 @@ qreal GraphicsView::scaleFactor() const
 
 void GraphicsView::resetTransform()
 {
-    QGraphicsView::resetTransform();
+    if (!shouldAvoidTransform()) {
+        QGraphicsView::resetTransform();
+    }
 }
 
 void GraphicsView::zoomView(qreal scaleFactor)
 {
-    m_enableFitInView = false;
+    m_enableFitToScreen = false;
     scale(scaleFactor, scaleFactor);
     applyTransformationModeByScaleFactor();
     emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
@@ -145,6 +157,10 @@ void GraphicsView::rotateView(bool clockwise)
                   0,                  0,                  1);
     tf = transform() * tf;
     setTransform(tf);
+    
+    // Apply transformation mode but don't emit navigator signal here
+    // Let displayScene() handle the navigator visibility correctly
+    applyTransformationModeByScaleFactor();
 }
 
 void GraphicsView::flipView(bool horizontal)
@@ -176,22 +192,104 @@ void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
 {
     resetScale();
 
-    QRectF viewRect = this->viewport()->rect().adjusted(2, 2, -2, -2);
+    QRectF viewRect = this->viewport()->rect();
     QRectF imageRect = transform().mapRect(sceneRect());
+    QSize viewSize = viewRect.size().toSize();
 
     qreal ratio;
 
     if (ori == Qt::Horizontal) {
-        ratio = viewRect.width() / imageRect.width();
+        // Horizontal fit means fit by width
+        if (scaleDownOnly && imageRect.width() <= viewSize.width()) {
+            // Image width already fits, no scaling needed
+            ratio = 1;
+        } else {
+            ratio = viewRect.width() / imageRect.width();
+        }
     } else {
-        ratio = viewRect.height() / imageRect.height();
+        // Vertical fit means fit by height
+        if (scaleDownOnly && imageRect.height() <= viewSize.height()) {
+            // Image height already fits, no scaling needed
+            ratio = 1;
+        } else {
+            ratio = viewRect.height() / imageRect.height();
+        }
     }
 
-    if (scaleDownOnly && ratio > 1) ratio = 1;
+    if (ratio != 1) {
+        scale(ratio, ratio);
+    }
 
-    scale(ratio, ratio);
+    // Position the image correctly based on orientation with rotation consideration
-    centerOn(imageRect.top(), 0);
+    QRectF originalScene = sceneRect();
-    m_enableFitInView = false;
+    QTransform currentTransform = transform();
+    
+    // TODO: 
+    // I guess following code may be optimized by matrix arithmetic operation.
+    // There is an AI given solution. But I didn't use it.
+    // Because I want to keep the same behavior of upstream.
+
+    // // Horizontal fit: Let the position of top center of viewport, (cx, 0), be inversely mapped to scene.
+    // // And compensate the behavior of `centerOn` which put given point to the center of viewport.
+    // QTransform inv = currentTransform.inverted();
+    // QPointF viewCx = viewport()->rect().center().x();
+    // QPointF viewCy = viewport()->rect().center().y();
+    // // The target is viewport top center. Its y=0, so `centerOn` required scene point is (viewCx, -viewCy).
+    // centerOn(inv.map(QPointF(viewCx, -viewCy)));
+
+    if (ori == Qt::Horizontal) {
+        // For horizontal fit (fit by width), position at top (for tall images)
+        // Find the scene point that corresponds to the top-center of the transformed image
+        QPointF sceneTopCenter;
+
+        if (qFuzzyIsNull(currentTransform.m12()) && qFuzzyIsNull(currentTransform.m21())) {
+            // 0° or 180° rotation
+            if (currentTransform.m11() > 0 && currentTransform.m22() > 0) {
+                // 0° rotation: use original top-center
+                sceneTopCenter = QPointF(originalScene.center().x(), originalScene.top());
+            } else {
+                // 180° rotation: the visual "top" is now at the scene bottom
+                sceneTopCenter = QPointF(originalScene.center().x(), originalScene.bottom());
+            }
+        } else {
+            // 90/270 degree rotation: the "top" in view corresponds to left/right in scene
+            if (currentTransform.m12() > 0) {
+                // 90 degree: top in view = left in scene
+                sceneTopCenter = QPointF(originalScene.left(), originalScene.center().y());
+            } else {
+                // 270 degree: top in view = right in scene
+                sceneTopCenter = QPointF(originalScene.right(), originalScene.center().y());
+            }
+        }
+        centerOn(sceneTopCenter);
+    } else {
+        // For vertical fit (fit by height), position at left (for wide images)
+        // Find the scene point that corresponds to the left-center of the transformed image
+        QPointF sceneLeftCenter;
+
+        if (qFuzzyIsNull(currentTransform.m12()) && qFuzzyIsNull(currentTransform.m21())) {
+            // 0° or 180° rotation
+            if (currentTransform.m11() > 0 && currentTransform.m22() > 0) {
+                // 0° rotation: use original left-center
+                sceneLeftCenter = QPointF(originalScene.left(), originalScene.center().y());
+            } else {
+                // 180° rotation: the visual "left" is now at the scene right
+                sceneLeftCenter = QPointF(originalScene.right(), originalScene.center().y());
+            }
+        } else {
+            // 90/270 degree rotation: the "left" in view corresponds to top/bottom in scene
+            if (currentTransform.m21() > 0) {
+                // 90 degree: left in view = top in scene
+                sceneLeftCenter = QPointF(originalScene.center().x(), originalScene.top());
+            } else {
+                // 270 degree: left in view = bottom in scene
+                sceneLeftCenter = QPointF(originalScene.center().x(), originalScene.bottom());
+            }
+        }
+        centerOn(sceneLeftCenter);
+    }
+
+    m_enableFitToScreen = false;
 
     applyTransformationModeByScaleFactor();
     emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
@@ -199,11 +297,23 @@ void GraphicsView::fitByOrientation(Qt::Orientation ori, bool scaleDownOnly)
 
 void GraphicsView::displayScene()
 {
-    if (isSceneBiggerThanView()) {
+    if (shouldAvoidTransform()) {
-        fitInView(sceneRect(), Qt::KeepAspectRatio);
+        emit navigatorViewRequired(!isThingSmallerThanWindowWith(transform()), transform());
+        return;
     }
 
-    m_enableFitInView = true;
+    if (isSceneBiggerThanView()) {
+        // Do fit-in-view
+        fitInView(sceneRect(), Qt::KeepAspectRatio);
+        // After fitInView, the image should fit the window, so hide navigator
+        emit navigatorViewRequired(false, transform());
+    } else {
+        // Image is already smaller than window, no navigator needed
+        emit navigatorViewRequired(false, transform());
+    }
+
+    m_enableFitToScreen = true;
+    m_firstUserMediaLoaded = true;
 }
 
 bool GraphicsView::isSceneBiggerThanView() const
@@ -216,9 +326,28 @@ bool GraphicsView::isSceneBiggerThanView() const
 }
 
 // Automately do fit in view when viewport(window) smaller than image original size.
-void GraphicsView::setEnableAutoFitInView(bool enable)
+void GraphicsView::setEnableAutoFitToScreen(bool enable)
 {
-    m_enableFitInView = enable;
+    m_enableFitToScreen = enable;
+}
+
+bool GraphicsView::isAvoidResetTransform() const
+{
+    return m_avoidResetTransform;
+}
+
+void GraphicsView::setAvoidResetTransform(bool avoidReset)
+{
+    m_avoidResetTransform = avoidReset;
+}
+
+bool GraphicsView::isCheckerboard() const {
+    return m_checkerboardEnabled;
+}
+
+void GraphicsView::toggleCheckerboard(bool invertCheckerboardColor)
+{
+    setCheckerboardEnabled(!m_checkerboardEnabled, invertCheckerboardColor);
 }
 
 inline double zeroOrOne(double number)
@@ -235,9 +364,37 @@ QTransform GraphicsView::resetScale(const QTransform & orig)
                       orig.dx(),             orig.dy());
 }
 
-void GraphicsView::toggleCheckerboard(bool invertCheckerboardColor)
+void GraphicsView::updateStyle(Qt::ColorScheme colorScheme) {
-{
+    // YYC MARK:
-    setCheckerboardEnabled(!m_checkerboardEnabled, invertCheckerboardColor);
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: black;
+)#");
+        break;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: white;
+)#");
+        break;
+    }
 }
 
 void GraphicsView::mousePressEvent(QMouseEvent *event)
@@ -283,11 +440,11 @@ void GraphicsView::wheelEvent(QWheelEvent *event)
 
 void GraphicsView::resizeEvent(QResizeEvent *event)
 {
-    if (m_enableFitInView) {
+    if (m_enableFitToScreen) {
         bool originalSizeSmallerThanWindow = isThingSmallerThanWindowWith(resetScale(transform()));
         if (originalSizeSmallerThanWindow && scaleFactor() >= 1) {
             // no longer need to do fitInView()
-            // but we leave the m_enableFitInView value unchanged in case
+            // but we leave the m_enableToScreen value unchanged in case
             // user resize down the window again.
         } else if (originalSizeSmallerThanWindow && scaleFactor() < 1) {
             resetScale();
@@ -300,55 +457,6 @@ void GraphicsView::resizeEvent(QResizeEvent *event)
     return QGraphicsView::resizeEvent(event);
 }
 
-void GraphicsView::dragEnterEvent(QDragEnterEvent *event)
-{
-    if (event->mimeData()->hasUrls() || event->mimeData()->hasImage() || event->mimeData()->hasText()) {
-        event->acceptProposedAction();
-    } else {
-        event->ignore();
-    }
-//    qDebug() << event->mimeData() << "Drag Enter Event"
-//             << event->mimeData()->hasUrls() << event->mimeData()->hasImage()
-//             << event->mimeData()->formats() << event->mimeData()->hasFormat("text/uri-list");
-
-    return QGraphicsView::dragEnterEvent(event);
-}
-
-void GraphicsView::dragMoveEvent(QDragMoveEvent *event)
-{
-    Q_UNUSED(event)
-    // by default, QGraphicsView/Scene will ignore the action if there are no QGraphicsItem under cursor.
-    // We actually doesn't care and would like to keep the drag event as-is, so just do nothing here.
-}
-
-void GraphicsView::dropEvent(QDropEvent *event)
-{
-    event->acceptProposedAction();
-
-    const QMimeData * mimeData = event->mimeData();
-
-    if (mimeData->hasUrls()) {
-        const QList<QUrl> &urls = mimeData->urls();
-        if (urls.isEmpty()) {
-            showText(tr("File url list is empty"));
-        } else {
-            showFileFromPath(urls.first().toLocalFile(), true);
-        }
-    } else if (mimeData->hasImage()) {
-        QImage img = qvariant_cast<QImage>(mimeData->imageData());
-        QPixmap pixmap = QPixmap::fromImage(img);
-        if (pixmap.isNull()) {
-            showText(tr("Image data is invalid"));
-        } else {
-            showImage(pixmap);
-        }
-    } else if (mimeData->hasText()) {
-        showText(mimeData->text());
-    } else {
-        showText(tr("Not supported mimedata: %1").arg(mimeData->formats().first()));
-    }
-}
-
 bool GraphicsView::isThingSmallerThanWindowWith(const QTransform &transform) const
 {
     return rect().size().expandedTo(transform.mapRect(sceneRect()).size().toSize())
@@ -376,16 +484,16 @@ bool GraphicsView::shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) con
 void GraphicsView::setCheckerboardEnabled(bool enabled, bool invertColor)
 {
     m_checkerboardEnabled = enabled;
-    m_isLastCheckerboardColorInverted = invertColor;
+    bool isLightCheckerboard = Settings::instance()->useLightCheckerboard() ^ invertColor;
     if (m_checkerboardEnabled) {
         // Prepare background check-board pattern
         QPixmap tilePixmap(0x20, 0x20);
-        tilePixmap.fill(invertColor ? QColor(220, 220, 220, 170) : QColor(35, 35, 35, 170));
+        tilePixmap.fill(isLightCheckerboard ? QColor(220, 220, 220, 170) : QColor(35, 35, 35, 170));
         QPainter tilePainter(&tilePixmap);
-        COMPAT_CONSTCOLOR QColor color(45, 45, 45, 170);
+        constexpr QColor color(45, 45, 45, 170);
-        COMPAT_CONSTCOLOR QColor invertedColor(210, 210, 210, 170);
+        constexpr QColor invertedColor(210, 210, 210, 170);
-        tilePainter.fillRect(0, 0, 0x10, 0x10, invertColor ? invertedColor : color);
+        tilePainter.fillRect(0, 0, 0x10, 0x10, isLightCheckerboard ? invertedColor : color);
-        tilePainter.fillRect(0x10, 0x10, 0x10, 0x10, invertColor ? invertedColor : color);
+        tilePainter.fillRect(0x10, 0x10, 0x10, 0x10, isLightCheckerboard ? invertedColor : color);
         tilePainter.end();
 
         setBackgroundBrush(tilePixmap);
@@ -402,3 +510,8 @@ void GraphicsView::applyTransformationModeByScaleFactor()
         scene()->trySetTransformationMode(Qt::FastTransformation, this->scaleFactor());
     }
 }
+
+bool GraphicsView::shouldAvoidTransform() const
+{
+    return m_firstUserMediaLoaded && m_avoidResetTransform;
+}

app/graphicsview.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef GRAPHICSVIEW_H
 #define GRAPHICSVIEW_H
 
@@ -11,7 +15,7 @@ class GraphicsView : public QGraphicsView
 public:
     GraphicsView(QWidget *parent = nullptr);
 
-    void showFileFromPath(const QString &filePath, bool requestGallery = false);
+    void showFileFromPath(const QString &filePath);
 
     void showImage(const QPixmap &pixmap);
     void showImage(const QImage &image);
@@ -34,17 +38,22 @@ public:
 
     void displayScene();
     bool isSceneBiggerThanView() const;
-    void setEnableAutoFitInView(bool enable = true);
+    void setEnableAutoFitToScreen(bool enable = true);
+
+    bool isAvoidResetTransform() const;
+    void setAvoidResetTransform(bool avoidReset);
+
+    bool isCheckerboard() const;
+    void toggleCheckerboard(bool invertCheckerboardColor = false);
 
     static QTransform resetScale(const QTransform & orig);
 
 signals:
     void navigatorViewRequired(bool required, QTransform transform);
     void viewportRectChanged();
-    void requestGallery(const QString &filePath);
 
-public slots:
+private slots:
-    void toggleCheckerboard(bool invertCheckerboardColor = false);
+    void updateStyle(Qt::ColorScheme colorScheme);
 
 private:
     void mousePressEvent(QMouseEvent * event) override;
@@ -53,21 +62,21 @@ private:
     void wheelEvent(QWheelEvent *event) override;
     void resizeEvent(QResizeEvent *event) override;
 
-    void dragEnterEvent(QDragEnterEvent *event) override;
-    void dragMoveEvent(QDragMoveEvent *event) override;
-    void dropEvent(QDropEvent *event) override;
-
     bool isThingSmallerThanWindowWith(const QTransform &transform) const;
     bool shouldIgnoreMousePressMoveEvent(const QMouseEvent *event) const;
     void setCheckerboardEnabled(bool enabled, bool invertColor = false);
     void applyTransformationModeByScaleFactor();
 
+    inline bool shouldAvoidTransform() const;
+
     // Consider switch to 3 state for "no fit", "always fit" and "fit when view is smaller"?
     // ... or even more? e.g. "fit/snap width" things...
     // Currently it's "no fit" when it's false and "fit when view is smaller" when it's true.
-    bool m_enableFitInView = false;
+    bool m_enableFitToScreen = false;
+    bool m_avoidResetTransform = false;
     bool m_checkerboardEnabled = false;
-    bool m_isLastCheckerboardColorInverted = false;
+    bool m_useLightCheckerboard = false;
+    bool m_firstUserMediaLoaded = false;
 };
 
 #endif // GRAPHICSVIEW_H

app/main.cpp

@@ -1,6 +1,14 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "mainwindow.h"
 
-#include "playlistmanager.h"
+#include "settings.h"
+
+#ifdef Q_OS_MACOS
+#include "fileopeneventhandler.h"
+#endif // Q_OS_MACOS
 
 #include <QApplication>
 #include <QCommandLineParser>
@@ -8,45 +16,81 @@
 #include <QTranslator>
 #include <QUrl>
 
-// QM_FILE_INSTALL_DIR should be defined from the CMakeLists file.
+using namespace Qt::Literals::StringLiterals;
-#ifndef QM_FILE_INSTALL_DIR
-#define QM_FILE_INSTALL_DIR ":/i18n/"
-#endif // QM_FILE_INSTALL_DIR
 
 int main(int argc, char *argv[])
 {
+    QCoreApplication::setApplicationName(u"Pineapple Pictures"_s);
+    QCoreApplication::setApplicationVersion(PPIC_VERSION_STRING);
+    QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Settings::instance()->hiDpiScaleFactorBehavior());
+
     QApplication a(argc, argv);
 
     QTranslator translator;
-    QString qmDir;
+#if defined(TRANSLATION_RESOURCE_EMBEDDING)
-#ifdef _WIN32
+    const QString qmDir = u":/i18n/"_s;
-    qmDir = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("translations");
+#elif defined(QM_FILE_INSTALL_ABSOLUTE_DIR)
+    const QString qmDir = QT_STRINGIFY(QM_FILE_INSTALL_ABSOLUTE_DIR);
 #else
-    qmDir = QT_STRINGIFY(QM_FILE_INSTALL_DIR);
+    const QString qmDir = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("translations");
 #endif
-    if (translator.load(QString("PineapplePictures_%1").arg(QLocale::system().name()), qmDir)) {
+    if (translator.load(QLocale(), u"PineapplePictures"_s, u"_"_s, qmDir)) {
-        a.installTranslator(&translator);
+        QCoreApplication::installTranslator(&translator);
     }
-    a.setApplicationName("Pineapple Pictures");
-    a.setApplicationDisplayName(QCoreApplication::translate("main", "Pineapple Pictures"));
 
+    QGuiApplication::setApplicationDisplayName(QCoreApplication::translate("main", "Pineapple Pictures"));
+
+    // commandline options
+    QCommandLineOption supportedImageFormats(u"supported-image-formats"_s, QCoreApplication::translate("main", "List supported image format suffixes, and quit program."));
     // parse commandline arguments
     QCommandLineParser parser;
+    parser.addOption(supportedImageFormats);
     parser.addPositionalArgument("File list", QCoreApplication::translate("main", "File list."));
     parser.addHelpOption();
-
     parser.process(a);
 
+    if (parser.isSet(supportedImageFormats)) {
+#if QT_VERSION < QT_VERSION_CHECK(6, 9, 0)
+        fputs(qPrintable(MainWindow::supportedImageFormats().join(QChar('\n'))), stdout);
+        ::exit(EXIT_SUCCESS);
+#else
+        QCommandLineParser::showMessageAndExit(QCommandLineParser::MessageType::Information,
+                                               MainWindow::supportedImageFormats().join(QChar('\n')));
+#endif
+    }
+
     MainWindow w;
     w.show();
 
-    QStringList urlStrList = parser.positionalArguments();
+#ifdef Q_OS_MACOS
-    QList<QUrl> && urlList = PlaylistManager::convertToUrlList(urlStrList);
+    FileOpenEventHandler * fileOpenEventHandler = new FileOpenEventHandler(&a);
+    a.installEventFilter(fileOpenEventHandler);
+    a.connect(fileOpenEventHandler, &FileOpenEventHandler::fileOpen, [&w](const QUrl & url){
+        if (w.isHidden()) {
+            w.showNormal();
+        } else {
+            w.activateWindow();
+        }
+        w.showFiles({url});
+        w.initWindowSize();
+    });
 
-    if (!urlList.isEmpty()) {
+    // Handle dock icon clicks to show hidden window
-        w.showUrls(urlList);
+    a.connect(&a, &QApplication::applicationStateChanged, [&w](Qt::ApplicationState state) {
-        w.adjustWindowSizeBySceneRect();
+        if (state == Qt::ApplicationActive && w.isHidden()) {
-    }
+            w.showFiles({});
+            w.galleryCurrent(false);
+            w.showNormal();
+            w.raise();
+            w.activateWindow();
+        }
+    });
+#endif // Q_OS_MACOS
 
-    return a.exec();
+    QStringList fileList = parser.positionalArguments();
+    w.showFiles(fileList);
+
+    w.initWindowSize();
+
+    return QApplication::exec();
 }

app/mainwindow.cpp

@@ -1,7 +1,11 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #include "mainwindow.h"
+#include "ui_mainwindow.h"
 
 #include "settings.h"
-#include "toolbutton.h"
 #include "bottombuttongroup.h"
 #include "graphicsview.h"
 #include "navigatorview.h"
@@ -28,311 +32,239 @@
 #include <QFile>
 #include <QTimer>
 #include <QFileDialog>
+#include <QFileSystemWatcher>
 #include <QStandardPaths>
+#include <QStringBuilder>
+#include <QProcess>
+#include <QDesktopServices>
+#include <QMessageBox>
+
+#ifdef HAVE_QTDBUS
+#include <QDBusInterface>
+#include <QDBusConnectionInterface>
+#endif // HAVE_QTDBUS
+
+using namespace Qt::Literals::StringLiterals;
 
 MainWindow::MainWindow(QWidget *parent)
-    : FramelessWindow(parent)
+    : QWidget(parent)
+    , ui(new QT_PREPEND_NAMESPACE(Ui::MainWindow))
     , m_am(new ActionManager)
-    , m_pm(new PlaylistManager(PlaylistManager::PL_SAMEFOLDER, this))
+    , m_pm(new PlaylistManager(this))
+    , m_fileSystemWatcher(new QFileSystemWatcher(this))
 {
-    if (Settings::instance()->stayOnTop()) {
+    ui->setupUi(this);
-        this->setWindowFlag(Qt::WindowStaysOnTopHint);
+    this->setWindowFlags(Qt::Window | Qt::WindowTitleHint | Qt::WindowSystemMenuHint | Qt::WindowMinMaxButtonsHint | Qt::WindowCloseButtonHint);
-    }
 
-    this->setAttribute(Qt::WA_TranslucentBackground, true);
+    // YYC MARK:
-    this->setMinimumSize(350, 330);
+    // Blumis set original value is 350 x 330.
-    this->setWindowIcon(QIcon(":/icons/app-icon.svg"));
+    // It is too small for modern device,
-    this->setMouseTracking(true);
+    // so I level it up to SVGA resolution 800 x 600.
+    this->setMinimumSize(800, 600);
+    this->setWindowIcon(QIcon(u":/icons/app-icon.png"_s));
+    this->setAcceptDrops(true);
 
-    m_pm->setAutoLoadFilterSuffix({"*.jpg", "*.jpeg", "*.jfif", "*.png", "*.gif", "*.svg", "*.bmp", "*.webp"});
+    // Initialize playlist manager
-
+    m_pm->setAllowedSuffixes(supportedImageFormats());
-    m_fadeOutAnimation = new QPropertyAnimation(this, "windowOpacity");
-    m_fadeOutAnimation->setDuration(300);
-    m_fadeOutAnimation->setStartValue(1);
-    m_fadeOutAnimation->setEndValue(0);
-    m_floatUpAnimation = new QPropertyAnimation(this, "geometry");
-    m_floatUpAnimation->setDuration(300);
-    m_floatUpAnimation->setEasingCurve(QEasingCurve::OutCirc);
-    m_exitAnimationGroup = new QParallelAnimationGroup(this);
-    m_exitAnimationGroup->addAnimation(m_fadeOutAnimation);
-    m_exitAnimationGroup->addAnimation(m_floatUpAnimation);
-    connect(m_exitAnimationGroup, &QParallelAnimationGroup::finished,
-            this, &QWidget::close);
 
+    // Initialize graphics scene
     GraphicsScene * scene = new GraphicsScene(this);
-
+    // Setup graphics view (main photo view)
-    m_graphicsView = new GraphicsView(this);
+    ui->m_gv->setScene(scene);
-    m_graphicsView->setScene(scene);
+    // Setup navigator view (right-bottom corner thumbnail view)
-    this->setCentralWidget(m_graphicsView);
+    ui->m_nav->setScene(scene);
-
+    ui->m_nav->setMainView(ui->m_gv);
-    m_gv = new NavigatorView(this);
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
-    m_gv->setFixedSize(220, 160);
+    // Binding graphics and navigator views signals
-    m_gv->setScene(scene);
+    connect(ui->m_gv, &GraphicsView::navigatorViewRequired,
-    m_gv->setMainView(m_graphicsView);
+            this, [this](bool required, const QTransform & tf){
-    m_gv->fitInView(m_gv->sceneRect(), Qt::KeepAspectRatio);
+        if (Settings::instance()->showNavigatorView()){
-
+            ui->m_nav->setTransform(GraphicsView::resetScale(tf));
-    connect(m_graphicsView, &GraphicsView::navigatorViewRequired,
+            ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
-            this, [ = ](bool required, QTransform tf){
+            ui->m_nav->setVisible(required);
-        m_gv->setTransform(GraphicsView::resetScale(tf));
+            ui->m_navPH->setVisible(required);
-        m_gv->fitInView(m_gv->sceneRect(), Qt::KeepAspectRatio);
+            ui->m_nav->updateMainViewportRegion();
-        m_gv->setVisible(required);
+        } else {
-        m_gv->updateMainViewportRegion();
+            ui->m_nav->setVisible(false);
+            ui->m_navPH->setVisible(false);
+        }
     });
+    connect(ui->m_gv, &GraphicsView::viewportRectChanged,
+            ui->m_nav, &NavigatorView::updateMainViewportRegion);
 
-    connect(m_graphicsView, &GraphicsView::viewportRectChanged,
+    // Setup action manager
-            m_gv, &NavigatorView::updateMainViewportRegion);
-
-    connect(m_graphicsView, &GraphicsView::requestGallery,
-            this, &MainWindow::loadGalleryBySingleLocalFile);
-
-    m_closeButton = new ToolButton(true, m_graphicsView);
-    m_closeButton->setIcon(QIcon(":/icons/window-close"));
-    m_closeButton->setIconSize(QSize(50, 50));
-
-    connect(m_closeButton, &QAbstractButton::clicked,
-            this, &MainWindow::closeWindow);
-
-    m_prevButton = new ToolButton(false, m_graphicsView);
-    m_prevButton->setIcon(QIcon(":/icons/go-previous"));
-    m_prevButton->setIconSize(QSize(75, 75));
-    m_prevButton->setVisible(false);
-    m_prevButton->setOpacity(0, false);
-    m_nextButton = new ToolButton(false, m_graphicsView);
-    m_nextButton->setIcon(QIcon(":/icons/go-next"));
-    m_nextButton->setIconSize(QSize(75, 75));
-    m_nextButton->setVisible(false);
-    m_nextButton->setOpacity(0, false);
-
-    connect(m_prevButton, &QAbstractButton::clicked,
-            this, &MainWindow::galleryPrev);
-    connect(m_nextButton, &QAbstractButton::clicked,
-            this, &MainWindow::galleryNext);
-
     m_am->setupAction(this);
-
+    // Setup bottom button group
-    m_bottomButtonGroup = new BottomButtonGroup({
+    ui->m_bottomButtonGroup->addActions({
         m_am->actionActualSize,
-        m_am->actionToggleMaximize,
+        m_am->actionFitToScreen,
         m_am->actionZoomIn,
         m_am->actionZoomOut,
-        m_am->actionToggleCheckerboard,
+        m_am->actionPrevPicture,
-        m_am->actionRotateClockwise
+        m_am->actionProperties,
-    }, this);
+        m_am->actionNextPicture,
+        m_am->actionRotateCounterClockwise,
+        m_am->actionRotateClockwise,
+        m_am->actionFlipHorizontal,
+        m_am->actionFlipVertical,
+    });
+    // Setup right click menus
+    {
+        ui->m_subMenuCopy->addAction(m_am->actionCopyPixmap);
+        ui->m_subMenuCopy->addAction(m_am->actionCopyFilePath);
+    }
+    {
+        ui->m_subMenuTransform->addAction(m_am->actionActualSize);
+        ui->m_subMenuTransform->addAction(m_am->actionFitToScreen);
+        ui->m_subMenuTransform->addAction(m_am->actionFitByWidth);
+        ui->m_subMenuTransform->addAction(m_am->actionFitByHeight);
+        ui->m_subMenuTransform->addAction(m_am->actionZoomIn);
+        ui->m_subMenuTransform->addAction(m_am->actionZoomOut);
 
-    m_bottomButtonGroup->setOpacity(0, false);
+        ui->m_subMenuTransform->addSeparator();
-    m_gv->setOpacity(0, false);
-    m_closeButton->setOpacity(0, false);
 
-    connect(m_pm, &PlaylistManager::loaded, this, [this](int galleryFileCount) {
+        ui->m_subMenuTransform->addAction(m_am->actionFlipHorizontal);
-        m_prevButton->setVisible(galleryFileCount > 1);
+        ui->m_subMenuTransform->addAction(m_am->actionFlipVertical);
-        m_nextButton->setVisible(galleryFileCount > 1);
+        ui->m_subMenuTransform->addAction(m_am->actionRotateClockwise);
+        ui->m_subMenuTransform->addAction(m_am->actionRotateCounterClockwise);
+    }
+    {
+        ui->m_menu->addMenu(ui->m_subMenuCopy);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionPrevPicture);
+        ui->m_menu->addAction(m_am->actionNextPicture);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addMenu(ui->m_subMenuTransform);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionToggleAvoidResetTransform);
+        ui->m_menu->addAction(m_am->actionToggleCheckerboard);
+        ui->m_menu->addAction(m_am->actionTogglePauseAnimation);
+        ui->m_menu->addAction(m_am->actionAnimationNextFrame);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionTrash);
+        ui->m_menu->addAction(m_am->actionLocateInFileManager);
+        ui->m_menu->addAction(m_am->actionProperties);
+
+        ui->m_menu->addSeparator();
+
+        ui->m_menu->addAction(m_am->actionSettings);
+        ui->m_menu->addAction(m_am->actionHelp);
+    }
+
+    // Connect playlist manager and file watcher signals for photo browsering.
+    connect(m_pm, &PlaylistManager::playlistChanged, this, std::bind(&MainWindow::updateActionState, this));
+
+    connect(m_pm, &PlaylistManager::playlistChanged, this, std::bind(&MainWindow::galleryCurrent, this, false));
+    connect(m_pm, &PlaylistManager::currentIndexChanged, this, std::bind(&MainWindow::galleryCurrent, this, false));
+
+    connect(m_fileSystemWatcher, &QFileSystemWatcher::fileChanged, this, [this](){
+        QTimer::singleShot(500, this, std::bind(&MainWindow::galleryCurrent, this, true));
     });
 
-    QShortcut * fullscreenShorucut = new QShortcut(QKeySequence(QKeySequence::FullScreen), this);
+    // Change window location
-    connect(fullscreenShorucut, &QShortcut::activated,
-            this, &MainWindow::toggleFullscreen);
-
     centerWindow();
 
     QTimer::singleShot(0, this, [this](){
         m_am->setupShortcuts();
     });
+
 }
 
 MainWindow::~MainWindow()
 {
-
+    delete ui;
 }
 
-void MainWindow::showUrls(const QList<QUrl> &urls)
+void MainWindow::showFiles(const QStringList &files)
 {
-    if (!urls.isEmpty()) {
+    m_pm->loadPlaylist(files);
-        if (urls.count() == 1) {
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
-            m_graphicsView->showFileFromPath(urls.first().toLocalFile(), true);
+}
-        } else {
+
-            m_graphicsView->showFileFromPath(urls.first().toLocalFile(), false);
+void MainWindow::showFiles(const QList<QUrl>& urls)
-            m_pm->setPlaylist(urls);
+{
-            m_pm->setCurrentIndex(0);
+    m_pm->loadPlaylist(urls);
-        }
+    ui->m_nav->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
-    } else {
+}
-        m_graphicsView->showText(tr("File url list is empty"));
+
-        return;
+void MainWindow::initWindowSize()
+{
+    switch (Settings::instance()->initWindowSizeBehavior()) {
+    case Settings::WindowSizeBehavior::Maximized:
+        showMaximized();
+        break;
+    case Settings::WindowSizeBehavior::Windowed:
+    default:
+        showNormal();
+        break;
     }
-
-    m_gv->fitInView(m_gv->sceneRect(), Qt::KeepAspectRatio);
-}
-
-void MainWindow::adjustWindowSizeBySceneRect()
-{
-    QSize sceneSize = m_graphicsView->sceneRect().toRect().size();
-    QSize sceneSizeWithMargins = sceneSize + QSize(130, 125);
-
-    if (m_graphicsView->scaleFactor() < 1 || size().expandedTo(sceneSizeWithMargins) != size()) {
-        // if it scaled down by the resize policy:
-        QSize screenSize = qApp->screenAt(QCursor::pos())->availableSize();
-        if (screenSize.expandedTo(sceneSize) == screenSize) {
-            // we can show the picture by increase the window size.
-            QSize finalSize = (screenSize.expandedTo(sceneSizeWithMargins) == screenSize) ?
-                              sceneSizeWithMargins : screenSize;
-            // We have a very reasonable sizeHint() value ;P
-            this->resize(finalSize.expandedTo(this->sizeHint()));
-
-            // We're sure the window can display the whole thing with 1:1 scale.
-            // The old window size may cause fitInView call from resize() and the
-            // above resize() call won't reset the scale back to 1:1, so we
-            // just call resetScale() here to ensure the thing is no longer scaled.
-            m_graphicsView->resetScale();
-            centerWindow();
-        } else {
-            // toggle maximum
-            showMaximized();
-        }
-    }
-}
-
-// can be empty if it is NOT from a local file.
-QUrl MainWindow::currentImageFileUrl() const
-{
-    QUrl url;
-    std::tie(std::ignore, url) = m_pm->currentFileUrl();
-
-    return url;
 }
 
 void MainWindow::clearGallery()
 {
-    m_pm->clear();
+    m_pm->clearPlaylist();
-}
-
-void MainWindow::loadGalleryBySingleLocalFile(const QString &path)
-{
-    m_pm->setCurrentFile(path);
 }
 
 void MainWindow::galleryPrev()
 {
-    int index;
+    const bool loopGallery = Settings::instance()->loopGallery();
-    QString filePath;
+    if (!loopGallery && m_pm->isFirstIndex()) return;
-    std::tie(index, filePath) = m_pm->previousFile();
 
-    if (index >= 0) {
+    auto index = m_pm->previousIndex();
-        m_graphicsView->showFileFromPath(filePath, false);
+    if (index.has_value()) {
-        m_pm->setCurrentIndex(index);
+        m_pm->setCurrentIndex(*index);
     }
 }
 
 void MainWindow::galleryNext()
 {
-    int index;
+    const bool loopGallery = Settings::instance()->loopGallery();
-    QString filePath;
+    if (!loopGallery && m_pm->isLastIndex()) return;
-    std::tie(index, filePath) = m_pm->nextFile();
 
-    if (index >= 0) {
+    auto index = m_pm->nextIndex();
-        m_graphicsView->showFileFromPath(filePath, false);
+    if (index.has_value()) {
-        m_pm->setCurrentIndex(index);
+        m_pm->setCurrentIndex(*index);
     }
 }
 
-void MainWindow::showEvent(QShowEvent *event)
+void MainWindow::galleryCurrent(bool fromFileWatcher)
 {
-    updateWidgetsPosition();
+    auto index = m_pm->currentIndex();
-
+    if (index.has_value()) {
-    return FramelessWindow::showEvent(event);
+        QString localFilePath = m_pm->localFileByIndex(*index);
-}
+        ui->m_gv->showFileFromPath(localFilePath);
-
+        if (!fromFileWatcher) {
-void MainWindow::enterEvent(QT_ENTER_EVENT *event)
+            updateFileWatcher(localFilePath);
-{
+            setWindowTitle(m_pm->urlByIndex(*index).fileName());
-    m_bottomButtonGroup->setOpacity(1);
-    m_gv->setOpacity(1);
-
-    m_closeButton->setOpacity(1);
-    m_prevButton->setOpacity(1);
-    m_nextButton->setOpacity(1);
-
-    return FramelessWindow::enterEvent(event);
-}
-
-void MainWindow::leaveEvent(QEvent *event)
-{
-    m_bottomButtonGroup->setOpacity(0);
-    m_gv->setOpacity(0);
-
-    m_closeButton->setOpacity(0);
-    m_prevButton->setOpacity(0);
-    m_nextButton->setOpacity(0);
-
-    return FramelessWindow::leaveEvent(event);
-}
-
-void MainWindow::mousePressEvent(QMouseEvent *event)
-{
-    if (event->buttons() & Qt::LeftButton && !isMaximized()) {
-        m_clickedOnWindow = true;
-        m_oldMousePos = event->pos();
-//        qDebug() << m_oldMousePos << m_graphicsView->transform().m11()
-//                 << m_graphicsView->transform().m22() << m_graphicsView->matrix().m12();
-        event->accept();
-    }
-
-    return FramelessWindow::mousePressEvent(event);
-}
-
-void MainWindow::mouseMoveEvent(QMouseEvent *event)
-{
-    if (event->buttons() & Qt::LeftButton && m_clickedOnWindow && !isMaximized()) {
-#if QT_VERSION >= QT_VERSION_CHECK(5, 15, 0)
-        if (!window()->windowHandle()->startSystemMove()) {
-            move(event->globalPos() - m_oldMousePos);
         }
-#else
+    } else {
-        move(event->globalPos() - m_oldMousePos);
+        ui->m_gv->showText(tr("Drag image here"));
-#endif // QT_VERSION >= QT_VERSION_CHECK(5, 15, 0)
+        setWindowTitle(QString());
-        event->accept();
+        updateFileWatcher();
     }
 
-    return FramelessWindow::mouseMoveEvent(event);
+    updateActionState();
 }
 
-void MainWindow::mouseReleaseEvent(QMouseEvent *event)
+QStringList MainWindow::supportedImageFormats()
 {
-    m_clickedOnWindow = false;
+    QStringList formatFilters {
-
+#if QT_VERSION < QT_VERSION_CHECK(6, 8, 0)
-    // It seems the forward/back mouse button won't generate a key event [1] so we can't use
+        QStringLiteral("*.jfif")
-    // QShortcut or QKeySequence to indicate these shortcuts, so we do it here.
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 8, 0)
-    // Reference:
+    };
-    // [1]: https://codereview.qt-project.org/c/qt/qtbase/+/177475
+    for (const QByteArray &item : QImageReader::supportedImageFormats()) {
-    if (event->button() == Qt::ForwardButton || event->button() == Qt::BackButton) {
+        formatFilters.append(QStringLiteral("*.") % QString::fromLocal8Bit(item));
-        event->button() == Qt::BackButton ? galleryPrev() : galleryNext();
-        event->accept();
     }
-
+    return formatFilters;
-    return FramelessWindow::mouseReleaseEvent(event);
-}
-
-void MainWindow::mouseDoubleClickEvent(QMouseEvent *event)
-{
-    // The forward/back mouse button can also used to trigger a mouse double-click event
-    // Since we use that for gallery navigation so we ignore these two buttons.
-    if (event->buttons() & Qt::ForwardButton || event->buttons() & Qt::BackButton) {
-        return;
-    }
-
-    switch (Settings::instance()->doubleClickBehavior()) {
-    case ActionCloseWindow:
-        quitAppAction();
-        event->accept();
-        break;
-    case ActionMaximizeWindow:
-        toggleMaximize();
-        event->accept();
-        break;
-    case ActionDoNothing:
-        break;
-    }
-
-    // blumia: don't call parent constructor here, seems it will cause mouse move
-    //         event get called even if we set event->accept();
-    // return QMainWindow::mouseDoubleClickEvent(event);
 }
 
 void MainWindow::wheelEvent(QWheelEvent *event)
@@ -340,7 +272,7 @@ void MainWindow::wheelEvent(QWheelEvent *event)
     QPoint numDegrees = event->angleDelta() / 8;
     bool needWeelEvent = false, wheelUp = false;
     bool actionIsZoom = event->modifiers().testFlag(Qt::ControlModifier)
-            || Settings::instance()->mouseWheelBehavior() == ActionZoomImage;
+            || Settings::instance()->mouseWheelBehavior() == Settings::MouseWheelBehavior::Zoom;
 
     // NOTE: Only checking angleDelta since the QWheelEvent::pixelDelta() doc says
     //       pixelDelta() value is driver specific and unreliable on X11...
@@ -367,83 +299,43 @@ void MainWindow::wheelEvent(QWheelEvent *event)
         }
         event->accept();
     } else {
-        FramelessWindow::wheelEvent(event);
+        QWidget::wheelEvent(event);
     }
 }
 
-void MainWindow::resizeEvent(QResizeEvent *event)
-{
-    updateWidgetsPosition();
-
-    return FramelessWindow::resizeEvent(event);
-}
-
 void MainWindow::contextMenuEvent(QContextMenuEvent *event)
 {
-    QMenu * menu = new QMenu;
+    ui->m_menu->exec(mapToGlobal(event->pos()));
-    QMenu * copyMenu = new QMenu(tr("&Copy"));
-    QUrl currentFileUrl = currentImageFileUrl();
-    QImage clipboardImage;
-    QUrl clipboardFileUrl;
 
-    QAction * copyPixmap = m_am->actionCopyPixmap;
+    return QWidget::contextMenuEvent(event);
-    QAction * copyFilePath = m_am->actionCopyFilePath;
+}
 
-    copyMenu->addAction(copyPixmap);
+void MainWindow::dragEnterEvent(QDragEnterEvent *event)
-    if (currentFileUrl.isValid()) {
+{
-        copyMenu->addAction(copyFilePath);
+    if (event->mimeData()->hasUrls()) {
-    }
+        event->acceptProposedAction();
-
-    QAction * paste = m_am->actionPaste;
-
-    QAction * stayOnTopMode = m_am->actionToggleStayOnTop;
-    stayOnTopMode->setCheckable(true);
-    stayOnTopMode->setChecked(stayOnTop());
-
-    QAction * protectedMode = m_am->actionToggleProtectMode;
-    protectedMode->setCheckable(true);
-    protectedMode->setChecked(m_protectedMode);
-
-    QAction * toggleSettings = m_am->actionSettings;
-    QAction * helpAction = m_am->actionHelp;
-    QAction * propertiesAction = m_am->actionProperties;
-
-#if 0
-    menu->addAction(m_am->actionOpen);
-#endif // 0
-
-    if (copyMenu->actions().count() == 1) {
-        menu->addActions(copyMenu->actions());
     } else {
-        menu->addMenu(copyMenu);
+        event->ignore();
     }
 
-    if (canPaste()) {
+    return QWidget::dragEnterEvent(event);
-        menu->addAction(paste);
+}
+
+void MainWindow::dragMoveEvent(QDragMoveEvent *event)
+{
+    Q_UNUSED(event)
+}
+
+void MainWindow::dropEvent(QDropEvent *event)
+{
+    event->acceptProposedAction();
+
+    const QMimeData * mimeData = event->mimeData();
+    if (mimeData->hasUrls()) {
+        showFiles(mimeData->urls());
+    } else {
+        ui->m_gv->showText(tr("Not supported mimedata: %1").arg(mimeData->formats().first()));
     }
-
-    menu->addSeparator();
-
-    menu->addAction(m_am->actionHorizontalFlip);
-#if 0
-    menu->addAction(m_am->actionFitInView);
-    menu->addAction(m_am->actionFitByWidth);
-#endif // 0
-    menu->addSeparator();
-    menu->addAction(stayOnTopMode);
-    menu->addAction(protectedMode);
-    menu->addSeparator();
-    menu->addAction(toggleSettings);
-    menu->addAction(helpAction);
-    if (currentFileUrl.isValid()) {
-        menu->addSeparator();
-        menu->addAction(propertiesAction);
-    }
-    menu->exec(mapToGlobal(event->pos()));
-    menu->deleteLater();
-    copyMenu->deleteLater();
-
-    return FramelessWindow::contextMenuEvent(event);
 }
 
 void MainWindow::centerWindow()
@@ -453,74 +345,14 @@ void MainWindow::centerWindow()
             Qt::LeftToRight,
             Qt::AlignCenter,
             this->size(),
-            qApp->screenAt(QCursor::pos())->geometry()
+            qApp->screenAt(QCursor::pos())->availableGeometry()
         )
     );
 }
 
-void MainWindow::closeWindow()
+void MainWindow::toggleAvoidResetTransform()
 {
-    QRect windowRect(this->geometry());
+    ui->m_gv->setAvoidResetTransform(!ui->m_gv->isAvoidResetTransform());
-    m_floatUpAnimation->setStartValue(windowRect);
-    m_floatUpAnimation->setEndValue(windowRect.adjusted(0, -80, 0, 0));
-    m_floatUpAnimation->setStartValue(QRect(this->geometry().x(), this->geometry().y(), this->geometry().width(), this->geometry().height()));
-    m_floatUpAnimation->setEndValue(QRect(this->geometry().x(), this->geometry().y()-80, this->geometry().width(), this->geometry().height()));
-    m_exitAnimationGroup->start();
-}
-
-void MainWindow::updateWidgetsPosition()
-{
-    m_closeButton->move(width() - m_closeButton->width(), 0);
-    m_prevButton->move(25, (height() - m_prevButton->sizeHint().height()) / 2);
-    m_nextButton->move(width() - m_nextButton->sizeHint().width() - 25,
-                       (height() - m_prevButton->sizeHint().height()) / 2);
-    m_bottomButtonGroup->move((width() - m_bottomButtonGroup->width()) / 2,
-                              height() - m_bottomButtonGroup->height());
-    m_gv->move(width() - m_gv->width(), height() - m_gv->height());
-}
-
-void MainWindow::toggleProtectedMode()
-{
-    m_protectedMode = !m_protectedMode;
-    m_closeButton->setVisible(!m_protectedMode);
-    m_prevButton->setVisible(!m_protectedMode);
-    m_nextButton->setVisible(!m_protectedMode);
-}
-
-void MainWindow::toggleStayOnTop()
-{
-    setWindowFlag(Qt::WindowStaysOnTopHint, !stayOnTop());
-    show();
-}
-
-bool MainWindow::stayOnTop() const
-{
-    return windowFlags().testFlag(Qt::WindowStaysOnTopHint);
-}
-
-bool MainWindow::canPaste() const
-{
-    const QMimeData * clipboardData = QApplication::clipboard()->mimeData();
-    if (clipboardData->hasImage()) {
-        return true;
-    } else if (clipboardData->hasText()) {
-        QString clipboardText(clipboardData->text());
-        if (clipboardText.startsWith("PICTURE:")) {
-            QString maybeFilename(clipboardText.mid(8));
-            if (QFile::exists(maybeFilename)) {
-                return true;
-            }
-        }
-    }
-
-    return false;
-}
-
-void MainWindow::quitAppAction(bool force)
-{
-    if (!m_protectedMode || force) {
-        closeWindow();
-    }
 }
 
 void MainWindow::toggleFullscreen()
@@ -546,113 +378,21 @@ QSize MainWindow::sizeHint() const
     return QSize(710, 530);
 }
 
-void MainWindow::on_actionOpen_triggered()
+// region: Action Trigger
-{
-    QStringList picturesLocations = QStandardPaths::standardLocations(QStandardPaths::PicturesLocation);
-    QUrl pictureUrl = picturesLocations.isEmpty() ? QUrl::fromLocalFile(picturesLocations.first())
-                                                  : QUrl::fromLocalFile(QDir::homePath());
-    QList<QUrl> urls(QFileDialog::getOpenFileUrls(this, QString(), pictureUrl));
-    if (!urls.isEmpty()) {
-        showUrls(urls);
-    }
-}
-
-void MainWindow::on_actionActualSize_triggered()
-{
-    m_graphicsView->resetScale();
-    m_graphicsView->setEnableAutoFitInView(false);
-}
-
-void MainWindow::on_actionToggleMaximize_triggered()
-{
-    toggleMaximize();
-}
-
-void MainWindow::on_actionZoomIn_triggered()
-{
-    if (m_graphicsView->scaleFactor() < 1000) {
-        m_graphicsView->zoomView(1.25);
-    }
-}
-
-void MainWindow::on_actionZoomOut_triggered()
-{
-    m_graphicsView->zoomView(0.8);
-}
-
-void MainWindow::on_actionHorizontalFlip_triggered()
-{
-    m_graphicsView->flipView();
-}
-
-void MainWindow::on_actionFitInView_triggered()
-{
-    m_graphicsView->fitInView(m_gv->sceneRect(), Qt::KeepAspectRatio);
-    m_graphicsView->setEnableAutoFitInView(m_graphicsView->scaleFactor() <= 1);
-}
-
-void MainWindow::on_actionFitByWidth_triggered()
-{
-    m_graphicsView->fitByOrientation();
-}
 
 void MainWindow::on_actionCopyPixmap_triggered()
 {
     QClipboard *cb = QApplication::clipboard();
-    cb->setPixmap(m_graphicsView->scene()->renderToPixmap());
+    cb->setPixmap(ui->m_gv->scene()->renderToPixmap());
 }
 
 void MainWindow::on_actionCopyFilePath_triggered()
 {
-    QUrl currentFileUrl(currentImageFileUrl());
+    auto index = m_pm->currentIndex();
-    if (currentFileUrl.isValid()) {
+    if (!index.has_value()) return;
-        QClipboard *cb = QApplication::clipboard();
-        cb->setText(currentFileUrl.toLocalFile());
-    }
-}
 
-void MainWindow::on_actionPaste_triggered()
+    QClipboard *cb = QApplication::clipboard();
-{
+    cb->setText(m_pm->localFileByIndex(*index));
-    QImage clipboardImage;
-    QUrl clipboardFileUrl;
-
-    const QMimeData * clipboardData = QApplication::clipboard()->mimeData();
-    if (clipboardData->hasImage()) {
-        QVariant imageVariant(clipboardData->imageData());
-        if (imageVariant.isValid()) {
-            clipboardImage = qvariant_cast<QImage>(imageVariant);
-        }
-    } else if (clipboardData->hasText()) {
-        QString clipboardText(clipboardData->text());
-        if (clipboardText.startsWith("PICTURE:")) {
-            QString maybeFilename(clipboardText.mid(8));
-            if (QFile::exists(maybeFilename)) {
-                clipboardFileUrl = QUrl::fromLocalFile(maybeFilename);
-            }
-        }
-    }
-
-    if (!clipboardImage.isNull()) {
-        m_graphicsView->showImage(clipboardImage);
-        clearGallery();
-    } else if (clipboardFileUrl.isValid()) {
-        QString localFile(clipboardFileUrl.toLocalFile());
-        m_graphicsView->showFileFromPath(localFile, true);
-        m_pm->setCurrentFile(localFile);
-    }
-}
-
-void MainWindow::on_actionToggleCheckerboard_triggered()
-{
-    // TODO: is that okay to do this since we plan to support custom shortcuts?
-    m_graphicsView->toggleCheckerboard(QGuiApplication::queryKeyboardModifiers().testFlag(Qt::ShiftModifier));
-}
-
-void MainWindow::on_actionRotateClockwise_triggered()
-{
-    m_graphicsView->rotateView();
-    m_graphicsView->displayScene();
-    m_gv->setVisible(false);
 }
 
 void MainWindow::on_actionPrevPicture_triggered()
@@ -665,14 +405,155 @@ void MainWindow::on_actionNextPicture_triggered()
     galleryNext();
 }
 
-void MainWindow::on_actionToggleStayOnTop_triggered()
+void MainWindow::on_actionActualSize_triggered()
 {
-    toggleStayOnTop();
+    ui->m_gv->resetScale();
+    ui->m_gv->setEnableAutoFitToScreen(false);
 }
 
-void MainWindow::on_actionToggleProtectMode_triggered()
+void MainWindow::on_actionFitToScreen_triggered()
 {
-    toggleProtectedMode();
+    ui->m_gv->fitInView(ui->m_nav->sceneRect(), Qt::KeepAspectRatio);
+    ui->m_gv->setEnableAutoFitToScreen(ui->m_gv->scaleFactor() <= 1);
+}
+
+void MainWindow::on_actionFitByWidth_triggered()
+{
+    ui->m_gv->fitByOrientation(Qt::Orientation::Horizontal);
+}
+
+void MainWindow::on_actionFitByHeight_triggered()
+{
+    ui->m_gv->fitByOrientation(Qt::Orientation::Vertical);
+}
+
+void MainWindow::on_actionZoomIn_triggered()
+{
+    if (ui->m_gv->scaleFactor() < 1000) {
+        ui->m_gv->zoomView(1.25);
+    }
+}
+
+void MainWindow::on_actionZoomOut_triggered()
+{
+    ui->m_gv->zoomView(0.8);
+}
+
+void MainWindow::on_actionFlipHorizontal_triggered()
+{
+    ui->m_gv->flipView(true);
+}
+
+void MainWindow::on_actionFlipVertical_triggered()
+{
+    ui->m_gv->flipView(false);
+}
+
+void MainWindow::on_actionRotateClockwise_triggered()
+{
+    ui->m_gv->rotateView(true);
+    ui->m_gv->displayScene();
+}
+
+void MainWindow::on_actionRotateCounterClockwise_triggered()
+{
+    ui->m_gv->rotateView(false);
+    ui->m_gv->displayScene();
+}
+
+void MainWindow::on_actionToggleAvoidResetTransform_triggered()
+{
+    toggleAvoidResetTransform();
+}
+
+void MainWindow::on_actionToggleCheckerboard_triggered()
+{
+    ui->m_gv->toggleCheckerboard(QGuiApplication::queryKeyboardModifiers().testFlag(Qt::ShiftModifier));
+}
+
+void MainWindow::on_actionTogglePauseAnimation_triggered()
+{
+    ui->m_gv->scene()->togglePauseAnimation();
+}
+
+void MainWindow::on_actionAnimationNextFrame_triggered()
+{
+    ui->m_gv->scene()->skipAnimationFrame(1);
+}
+
+void MainWindow::on_actionTrash_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    if (!m_pm->urlByIndex(*index).isLocalFile()) return;
+
+    QFile file(m_pm->localFileByIndex(*index));
+    QFileInfo fileInfo(file.fileName());
+
+    QMessageBox::StandardButton result = QMessageBox::question(this, tr("Move to Trash"),
+                                                               tr("Are you sure you want to move \"%1\" to recycle bin?").arg(fileInfo.fileName()));
+    if (result == QMessageBox::Yes) {
+        bool succ = file.moveToTrash();
+        if (!succ) {
+            QMessageBox::warning(this, tr("Failed to move file to trash"),
+                                 tr("Move to trash failed, it might caused by file permission issue, file system limitation, or platform limitation."));
+        } else {
+            m_pm->removeFromPlaylist(*index);
+        }
+    }
+}
+
+void MainWindow::on_actionLocateInFileManager_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    QUrl currentFileUrl = m_pm->urlByIndex(*index);
+    if (!currentFileUrl.isValid()) return;
+
+    QFileInfo fileInfo(currentFileUrl.toLocalFile());
+    if (!fileInfo.exists()) return;
+
+    QUrl && folderUrl = QUrl::fromLocalFile(fileInfo.absolutePath());
+
+#ifdef Q_OS_WIN
+    QProcess::startDetached("explorer", QStringList() << "/select," << QDir::toNativeSeparators(fileInfo.absoluteFilePath()));
+#elif defined(Q_OS_LINUX) and defined(HAVE_QTDBUS)
+    // Use https://www.freedesktop.org/wiki/Specifications/file-manager-interface/ if possible
+    const QDBusConnectionInterface * dbusIface = QDBusConnection::sessionBus().interface();
+    if (!dbusIface || !dbusIface->isServiceRegistered(QLatin1String("org.freedesktop.FileManager1"))) {
+        QDesktopServices::openUrl(folderUrl);
+        return;
+    }
+    QDBusInterface fm1Iface(u"org.freedesktop.FileManager1"_s,
+                            u"/org/freedesktop/FileManager1"_s,
+                            u"org.freedesktop.FileManager1"_s);
+    fm1Iface.setTimeout(1000);
+    fm1Iface.callWithArgumentList(QDBus::Block, "ShowItems", {
+                                      QStringList{currentFileUrl.toString()},
+                                      QString()
+                                  });
+    if (fm1Iface.lastError().isValid()) {
+        QDesktopServices::openUrl(folderUrl);
+    }
+#else
+    QDesktopServices::openUrl(folderUrl);
+#endif // Q_OS_WIN
+}
+
+void MainWindow::on_actionProperties_triggered()
+{
+    auto index = m_pm->currentIndex();
+    if (!index.has_value()) return;
+    QUrl currentFileUrl = m_pm->urlByIndex(*index);
+    if (!currentFileUrl.isValid()) return;
+
+    MetadataModel * md = new MetadataModel();
+    md->setFile(currentFileUrl.toLocalFile());
+
+    MetadataDialog * ad = new MetadataDialog(this);
+    ad->setMetadataModel(md);
+    ad->exec();
+    ad->deleteLater();
 }
 
 void MainWindow::on_actionSettings_triggered()
@@ -689,21 +570,15 @@ void MainWindow::on_actionHelp_triggered()
     ad->deleteLater();
 }
 
-void MainWindow::on_actionProperties_triggered()
+// endregion
+
+bool MainWindow::updateFileWatcher(const QString &basePath)
 {
-    QUrl currentFileUrl = currentImageFileUrl();
+    m_fileSystemWatcher->removePaths(m_fileSystemWatcher->files());
-    if (!currentFileUrl.isValid()) return;
+    if (!basePath.isEmpty()) return m_fileSystemWatcher->addPath(basePath);
-
+    return false;
-    MetadataModel * md = new MetadataModel();
-    md->setFile(currentFileUrl.toLocalFile());
-
-    MetadataDialog * ad = new MetadataDialog(this);
-    ad->setMetadataModel(md);
-    ad->exec();
-    ad->deleteLater();
 }
 
-void MainWindow::on_actionQuitApp_triggered()
+void MainWindow::updateActionState() {
-{
+    m_am->updateActionState(m_pm, ui->m_gv);
-    quitAppAction(false);
 }

app/mainwindow.h

@@ -1,30 +1,23 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
 
-#include "framelesswindow.h"
+#include <QWidget>
-
-#include <QParallelAnimationGroup>
-#include <QPropertyAnimation>
-#include <QPushButton>
-
-#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
-    typedef QEnterEvent QT_ENTER_EVENT;
-#else
-    typedef QEvent QT_ENTER_EVENT;
-#endif // QT_VERSION_CHECK(6, 0, 0)
 
 QT_BEGIN_NAMESPACE
-class QGraphicsOpacityEffect;
+class QFileSystemWatcher;
-class QGraphicsView;
+namespace Ui {
+class MainWindow;
+}
 QT_END_NAMESPACE
 
 class ActionManager;
 class PlaylistManager;
-class ToolButton;
+
-class GraphicsView;
+class MainWindow : public QWidget
-class NavigatorView;
-class BottomButtonGroup;
-class MainWindow : public FramelessWindow
 {
     Q_OBJECT
 
@@ -32,35 +25,26 @@ public:
     explicit MainWindow(QWidget *parent = nullptr);
     ~MainWindow() override;
 
-    void showUrls(const QList<QUrl> &urls);
+    void showFiles(const QStringList& files);
-    void adjustWindowSizeBySceneRect();
+    void showFiles(const QList<QUrl>& urls);
-    QUrl currentImageFileUrl() const;
+    void initWindowSize();
 
     void clearGallery();
-    void loadGalleryBySingleLocalFile(const QString &path);
     void galleryPrev();
     void galleryNext();
+    void galleryCurrent(bool fromFileWatcher);
+
+    static QStringList supportedImageFormats();
 
 protected slots:
-    void showEvent(QShowEvent *event) override;
-    void enterEvent(QT_ENTER_EVENT *event) override;
-    void leaveEvent(QEvent *event) override;
-    void mousePressEvent(QMouseEvent *event) override;
-    void mouseMoveEvent(QMouseEvent *event) override;
-    void mouseReleaseEvent(QMouseEvent *event) override;
-    void mouseDoubleClickEvent(QMouseEvent *event) override;
     void wheelEvent(QWheelEvent *event) override;
-    void resizeEvent(QResizeEvent *event) override;
     void contextMenuEvent(QContextMenuEvent *event) override;
+    void dragEnterEvent(QDragEnterEvent *event) override;
+    void dragMoveEvent(QDragMoveEvent *event) override;
+    void dropEvent(QDropEvent *event) override;
 
     void centerWindow();
-    void closeWindow();
+    void toggleAvoidResetTransform();
-    void updateWidgetsPosition();
-    void toggleProtectedMode();
-    void toggleStayOnTop();
-    bool stayOnTop() const;
-    bool canPaste() const;
-    void quitAppAction(bool force = false);
     void toggleFullscreen();
     void toggleMaximize();
 
@@ -68,47 +52,46 @@ protected:
     QSize sizeHint() const override;
 
 private slots:
-    void on_actionOpen_triggered();
+    void on_actionCopyPixmap_triggered();
-
+    void on_actionCopyFilePath_triggered();
-    void on_actionActualSize_triggered();
-    void on_actionToggleMaximize_triggered();
-    void on_actionZoomIn_triggered();
-    void on_actionZoomOut_triggered();
-    void on_actionToggleCheckerboard_triggered();
-    void on_actionRotateClockwise_triggered();
 
     void on_actionPrevPicture_triggered();
     void on_actionNextPicture_triggered();
 
-    void on_actionHorizontalFlip_triggered();
+    void on_actionActualSize_triggered();
-    void on_actionFitInView_triggered();
+    void on_actionFitToScreen_triggered();
     void on_actionFitByWidth_triggered();
-    void on_actionCopyPixmap_triggered();
+    void on_actionFitByHeight_triggered();
-    void on_actionCopyFilePath_triggered();
+    void on_actionZoomIn_triggered();
-    void on_actionPaste_triggered();
+    void on_actionZoomOut_triggered();
-    void on_actionToggleStayOnTop_triggered();
+
-    void on_actionToggleProtectMode_triggered();
+    void on_actionFlipHorizontal_triggered();
+    void on_actionFlipVertical_triggered();
+    void on_actionRotateClockwise_triggered();
+    void on_actionRotateCounterClockwise_triggered();
+
+    void on_actionToggleAvoidResetTransform_triggered();
+    void on_actionToggleCheckerboard_triggered();
+    void on_actionTogglePauseAnimation_triggered();
+    void on_actionAnimationNextFrame_triggered();
+
+    void on_actionTrash_triggered();
+    void on_actionLocateInFileManager_triggered();
+    void on_actionProperties_triggered();
+
     void on_actionSettings_triggered();
     void on_actionHelp_triggered();
-    void on_actionProperties_triggered();
-    void on_actionQuitApp_triggered();
 
 private:
+    bool updateFileWatcher(const QString & basePath = QString());
+    void updateActionState();
+
+private:
+    QT_PREPEND_NAMESPACE(Ui::MainWindow) *ui;
+    
     ActionManager *m_am;
     PlaylistManager *m_pm;
-
+    QFileSystemWatcher *m_fileSystemWatcher;
-    QPoint m_oldMousePos;
-    QPropertyAnimation *m_fadeOutAnimation;
-    QPropertyAnimation *m_floatUpAnimation;
-    QParallelAnimationGroup *m_exitAnimationGroup;
-    ToolButton *m_closeButton;
-    ToolButton *m_prevButton;
-    ToolButton *m_nextButton;
-    GraphicsView *m_graphicsView;
-    NavigatorView *m_gv;
-    BottomButtonGroup *m_bottomButtonGroup;
-    bool m_protectedMode = false;
-    bool m_clickedOnWindow = false;
 };
 
 #endif // MAINWINDOW_H

app/mainwindow.ui

@@ -0,0 +1,169 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MainWindow</class>
+ <widget class="QWidget" name="MainWindow">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="minimumSize">
+   <size>
+    <width>640</width>
+    <height>480</height>
+   </size>
+  </property>
+  <property name="acceptDrops">
+   <bool>true</bool>
+  </property>
+  <layout class="QVBoxLayout" name="m_centralLayout">
+   <property name="spacing">
+    <number>0</number>
+   </property>
+   <property name="leftMargin">
+    <number>0</number>
+   </property>
+   <property name="topMargin">
+    <number>0</number>
+   </property>
+   <property name="rightMargin">
+    <number>0</number>
+   </property>
+   <property name="bottomMargin">
+    <number>0</number>
+   </property>
+   <item>
+    <widget class="GraphicsView" name="m_gv">
+     <property name="frameShape">
+      <enum>QFrame::NoFrame</enum>
+     </property>
+     <property name="verticalScrollBarPolicy">
+      <enum>Qt::ScrollBarAlwaysOff</enum>
+     </property>
+     <property name="horizontalScrollBarPolicy">
+      <enum>Qt::ScrollBarAlwaysOff</enum>
+     </property>
+    </widget>
+   </item>
+   <item>
+    <widget class="QWidget" name="bottomBar" native="true">
+     <property name="minimumSize">
+      <size>
+       <width>0</width>
+       <height>72</height>
+      </size>
+     </property>
+     <property name="maximumSize">
+      <size>
+       <width>16777215</width>
+       <height>72</height>
+      </size>
+     </property>
+     <layout class="QHBoxLayout" name="bottomBarLayout">
+      <property name="spacing">
+       <number>0</number>
+      </property>
+      <property name="leftMargin">
+       <number>0</number>
+      </property>
+      <property name="topMargin">
+       <number>0</number>
+      </property>
+      <property name="rightMargin">
+       <number>0</number>
+      </property>
+      <property name="bottomMargin">
+       <number>0</number>
+      </property>
+      <item>
+       <widget class="QWidget" name="m_navPH" native="true">
+        <property name="minimumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+       </widget>
+      </item>
+      <item>
+       <spacer name="leftSpacer">
+        <property name="orientation">
+         <enum>Qt::Horizontal</enum>
+        </property>
+       </spacer>
+      </item>
+      <item>
+       <widget class="BottomButtonGroup" name="m_bottomButtonGroup"/>
+      </item>
+      <item>
+       <spacer name="rightSpacer">
+        <property name="orientation">
+         <enum>Qt::Horizontal</enum>
+        </property>
+       </spacer>
+      </item>
+      <item>
+       <widget class="NavigatorView" name="m_nav">
+        <property name="minimumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>99</width>
+          <height>72</height>
+         </size>
+        </property>
+        <property name="frameShape">
+         <enum>QFrame::NoFrame</enum>
+        </property>
+        <property name="verticalScrollBarPolicy">
+         <enum>Qt::ScrollBarAlwaysOff</enum>
+        </property>
+        <property name="horizontalScrollBarPolicy">
+         <enum>Qt::ScrollBarAlwaysOff</enum>
+        </property>
+       </widget>
+      </item>
+     </layout>
+    </widget>
+   </item>
+  </layout>
+  <widget class="QMenu" name="m_subMenuCopy">
+   <property name="title">
+    <string>&amp;Copy</string>
+   </property>
+  </widget>
+  <widget class="QMenu" name="m_subMenuTransform">
+   <property name="title">
+    <string>&amp;Transform</string>
+   </property>
+  </widget>
+  <widget class="QMenu" name="m_menu"/>
+ </widget>
+ <customwidgets>
+  <customwidget>
+   <class>GraphicsView</class>
+   <extends>QGraphicsView</extends>
+   <header>graphicsview.h</header>
+  </customwidget>
+  <customwidget>
+   <class>NavigatorView</class>
+   <extends>QGraphicsView</extends>
+   <header>navigatorview.h</header>
+  </customwidget>
+  <customwidget>
+   <class>BottomButtonGroup</class>
+   <extends>QGroupBox</extends>
+   <header>bottombuttongroup.h</header>
+  </customwidget>
+ </customwidgets>
+ <resources/>
+ <connections/>
+</ui>

app/metadatadialog.cpp

@@ -1,10 +1,14 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "metadatadialog.h"
+#include "ui_metadatadialog.h"
 
 #include <QDialogButtonBox>
 #include <QPainter>
 #include <QStyledItemDelegate>
 #include <QTreeView>
-#include <QVBoxLayout>
 #include <QHeaderView>
 
 #include "metadatamodel.h"
@@ -69,30 +73,33 @@ protected:
 };
 
 MetadataDialog::MetadataDialog(QWidget *parent)
-    : QDialog(parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::MetadataDialog))
-    , m_treeView(new PropertyTreeView(this))
 {
+    ui->setupUi(this);
+    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
+
+    // YYC MARK:
+    // Because we use custom QTreeView and we do not want to expose it to public domain.
+    // So I have to use this way as the compromise.
+
+    // Create our custom QTreeView and insert them
+    m_treeView = new PropertyTreeView(this);
+    auto* layout = ui->verticalLayout;
+    const int index = layout->indexOf(ui->m_buttonBox);
+    layout->insertWidget(index, m_treeView);
+
+    // Setup our custom QTreeView
     m_treeView->setRootIsDecorated(false);
     m_treeView->setIndentation(0);
     m_treeView->setItemDelegate(new PropertyTreeItemDelegate(m_treeView));
     m_treeView->header()->resizeSection(0, sizeHint().width() / 2);
 
-    setWindowTitle(tr("Image Metadata"));
+    connect(ui->m_buttonBox, &QDialogButtonBox::rejected, this, &QDialog::close);
-
-    QDialogButtonBox * buttonBox = new QDialogButtonBox(QDialogButtonBox::Close);
-
-    setLayout(new QVBoxLayout);
-    layout()->addWidget(m_treeView);
-    layout()->addWidget(buttonBox);
-
-    connect(buttonBox, &QDialogButtonBox::rejected, this, &QDialog::close);
-
-    setWindowFlag(Qt::WindowContextHelpButtonHint, false);
 }
 
 MetadataDialog::~MetadataDialog()
 {
-
+    delete ui;
 }
 
 void MetadataDialog::setMetadataModel(MetadataModel * model)

app/metadatadialog.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef METADATADIALOG_H
 #define METADATADIALOG_H
 
@@ -7,6 +11,12 @@ QT_BEGIN_NAMESPACE
 class QTreeView;
 QT_END_NAMESPACE
 
+QT_BEGIN_NAMESPACE
+namespace Ui {
+class MetadataDialog;
+}
+QT_END_NAMESPACE
+
 class MetadataModel;
 class MetadataDialog : public QDialog
 {
@@ -21,6 +31,7 @@ public:
 
 private:
     QTreeView * m_treeView = nullptr;
+    QT_PREPEND_NAMESPACE(Ui::MetadataDialog) *ui;
 };
 
 #endif // METADATADIALOG_H

app/metadatadialog.ui

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>MetadataDialog</class>
+ <widget class="QDialog" name="MetadataDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>Image Metadata</string>
+  </property>
+  <layout class="QVBoxLayout" name="verticalLayout">
+   <item>
+    <widget class="QDialogButtonBox" name="m_buttonBox">
+     <property name="standardButtons">
+      <set>QDialogButtonBox::Close</set>
+     </property>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/metadatamodel.cpp

@@ -1,11 +1,18 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "metadatamodel.h"
 #include "exiv2wrapper.h"
 
+#include <QDir>
 #include <QDebug>
 #include <QDateTime>
 #include <QFileInfo>
 #include <QImageReader>
 
+using namespace Qt::Literals::StringLiterals;
+
 MetadataModel::MetadataModel(QObject *parent)
     : QAbstractItemModel(parent)
 {
@@ -32,127 +39,131 @@ void MetadataModel::setFile(const QString &imageFilePath)
     const QString & imageDimensionsString = imageSize(imgReader.size());
     const QString & imageRatioString = imageSizeRatio(imgReader.size());
 
-    appendSection(QStringLiteral("Description"), tr("Description", "Section name."));
+    appendSection(u"Description"_s, tr("Description", "Section name."));
-    appendSection(QStringLiteral("Origin"), tr("Origin", "Section name."));
+    appendSection(u"Origin"_s, tr("Origin", "Section name."));
-    appendSection(QStringLiteral("Image"), tr("Image", "Section name."));
+    appendSection(u"Image"_s, tr("Image", "Section name."));
-    appendSection(QStringLiteral("Camera"), tr("Camera", "Section name."));
+    appendSection(u"Camera"_s, tr("Camera", "Section name."));
-    appendSection(QStringLiteral("AdvancedPhoto"), tr("Advanced photo", "Section name."));
+    appendSection(u"AdvancedPhoto"_s, tr("Advanced photo", "Section name."));
-    appendSection(QStringLiteral("GPS"), tr("GPS", "Section name."));
+    appendSection(u"GPS"_s, tr("GPS", "Section name."));
-    appendSection(QStringLiteral("File"), tr("File", "Section name."));
+    appendSection(u"File"_s, tr("File", "Section name."));
 
     if (imgReader.supportsOption(QImageIOHandler::Size)) {
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.Dimensions"),
+        appendProperty(u"Image"_s, u"Image.Dimensions"_s,
                        tr("Dimensions"), imageDimensionsString);
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.SizeRatio"),
+        appendProperty(u"Image"_s, u"Image.SizeRatio"_s,
                        tr("Aspect ratio"), imageRatioString);
     }
     if (imgReader.supportsAnimation() && imgReader.imageCount() > 1) {
-        appendProperty(QStringLiteral("Image"), QStringLiteral("Image.FrameCount"),
+        appendProperty(u"Image"_s, u"Image.FrameCount"_s,
                        tr("Frame count"), QString::number(imgReader.imageCount()));
     }
 
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Name"),
+    appendProperty(u"File"_s, u"File.Name"_s,
                    tr("Name"), fileInfo.fileName());
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.ItemType"),
+    appendProperty(u"File"_s, u"File.ItemType"_s,
                    tr("Item type"), itemTypeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Path"),
+    appendProperty(u"File"_s, u"File.Path"_s,
-                   tr("Folder path"), fileInfo.path());
+                   tr("Folder path"), QDir::toNativeSeparators(fileInfo.path()));
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.Size"),
+    appendProperty(u"File"_s, u"File.Size"_s,
                    tr("Size"), sizeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.CreatedTime"),
+    appendProperty(u"File"_s, u"File.CreatedTime"_s,
                    tr("Date created"), birthTimeString);
-    appendProperty(QStringLiteral("File"), QStringLiteral("File.LastModified"),
+    appendProperty(u"File"_s, u"File.LastModified"_s,
                    tr("Date modified"), lastModifiedTimeString);
 
     Exiv2Wrapper wrapper;
     if (wrapper.load(imageFilePath)) {
         wrapper.cacheSections();
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
-                                  QStringLiteral("Xmp.dc.title"), tr("Title"), true);
+                                  u"Xmp.dc.title"_s, tr("Title"), true);
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
-                                  QStringLiteral("Exif.Image.ImageDescription"), tr("Subject"), true);
+                                  u"Exif.Image.ImageDescription"_s, tr("Subject"), true);
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
-                                  QStringLiteral("Exif.Image.Rating"), tr("Rating"));
+                                  u"Exif.Image.Rating"_s, tr("Rating"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Description"),
+        appendExivPropertyIfExist(wrapper, u"Description"_s,
-                                  QStringLiteral("Xmp.dc.subject"), tr("Tags"));
+                                  u"Xmp.dc.subject"_s, tr("Tags"));
-        appendPropertyIfNotEmpty(QStringLiteral("Description"), QStringLiteral("Description.Comments"),
+        appendPropertyIfNotEmpty(u"Description"_s, u"Description.Comments"_s,
                                  tr("Comments"), wrapper.comment());
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
-                                  QStringLiteral("Exif.Image.Artist"), tr("Authors"));
+                                  u"Exif.Image.Artist"_s, tr("Authors"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
-                                  QStringLiteral("Exif.Photo.DateTimeOriginal"), tr("Date taken"));
+                                  u"Exif.Photo.DateTimeOriginal"_s, tr("Date taken"));
         // FIXME: We may fetch the same type of metadata from different metadata collection.
         //        Current implementation is not pretty and may need to do a rework...
         // appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
         //                                  QStringLiteral("Xmp.xmp.CreatorTool"), tr("Program name"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
-                                  QStringLiteral("Exif.Image.Software"), tr("Program name"));
+                                  u"Exif.Image.Software"_s, tr("Program name"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Origin"),
+        appendExivPropertyIfExist(wrapper, u"Origin"_s,
-                                  QStringLiteral("Exif.Image.Copyright"), tr("Copyright"));
+                                  u"Exif.Image.Copyright"_s, tr("Copyright"));
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
-                                  QStringLiteral("Exif.Image.XResolution"), tr("Horizontal resolution"));
+                                  u"Exif.Image.XResolution"_s, tr("Horizontal resolution"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
-                                  QStringLiteral("Exif.Image.YResolution"), tr("Vertical resolution"));
+                                  u"Exif.Image.YResolution"_s, tr("Vertical resolution"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
-                                  QStringLiteral("Exif.Image.ResolutionUnit"), tr("Resolution unit"));
+                                  u"Exif.Image.ResolutionUnit"_s, tr("Resolution unit"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Image"),
+        appendExivPropertyIfExist(wrapper, u"Image"_s,
-                                  QStringLiteral("Exif.Photo.ColorSpace"), tr("Colour representation"));
+                                  u"Exif.Photo.ColorSpace"_s, tr("Colour representation"));
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Image.Make"), tr("Camera maker"));
+                                  u"Exif.Image.Make"_s, tr("Camera maker"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Image.Model"), tr("Camera model"));
+                                  u"Exif.Image.Model"_s, tr("Camera model"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.FNumber"), tr("F-stop"));
+                                  u"Exif.Photo.FNumber"_s, tr("F-stop"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.ExposureTime"), tr("Exposure time"));
+                                  u"Exif.Photo.ExposureTime"_s, tr("Exposure time"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.ISOSpeedRatings"), tr("ISO speed"));
+                                  u"Exif.Photo.ISOSpeedRatings"_s, tr("ISO speed"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.ExposureBiasValue"), tr("Exposure bias"));
+                                  u"Exif.Photo.ExposureBiasValue"_s, tr("Exposure bias"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.FocalLength"), tr("Focal length"));
+                                  u"Exif.Photo.FocalLength"_s, tr("Focal length"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.MaxApertureValue"), tr("Max aperture"));
+                                  u"Exif.Photo.MaxApertureValue"_s, tr("Max aperture"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.MeteringMode"), tr("Metering mode"));
+                                  u"Exif.Photo.MeteringMode"_s, tr("Metering mode"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.Flash"), tr("Flash mode"));
+                                  u"Exif.Photo.SubjectDistance"_s, tr("Subject distance"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("Camera"),
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
-                                  QStringLiteral("Exif.Photo.FocalLengthIn35mmFilm"), tr("35mm focal length"));
+                                  u"Exif.Photo.Flash"_s, tr("Flash mode"));
+        appendExivPropertyIfExist(wrapper, u"Camera"_s,
+                                  u"Exif.Photo.FocalLengthIn35mmFilm"_s, tr("35mm focal length"));
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.LensModel"), tr("Lens model"));
+                                  u"Exif.Photo.LensModel"_s, tr("Lens model"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.BrightnessValue"), tr("Brightness"));
+                                  u"Exif.Photo.Contrast"_s, tr("Contrast"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.ExposureProgram"), tr("Exposure program"));
+                                  u"Exif.Photo.BrightnessValue"_s, tr("Brightness"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.Saturation"), tr("Saturation"));
+                                  u"Exif.Photo.ExposureProgram"_s, tr("Exposure program"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.Sharpness"), tr("Sharpness"));
+                                  u"Exif.Photo.Saturation"_s, tr("Saturation"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.WhiteBalance"), tr("White balance"));
+                                  u"Exif.Photo.Sharpness"_s, tr("Sharpness"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.DigitalZoomRatio"), tr("Digital zoom"));
+                                  u"Exif.Photo.WhiteBalance"_s, tr("White balance"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("AdvancedPhoto"),
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
-                                  QStringLiteral("Exif.Photo.ExifVersion"), tr("EXIF version"));
+                                  u"Exif.Photo.DigitalZoomRatio"_s, tr("Digital zoom"));
+        appendExivPropertyIfExist(wrapper, u"AdvancedPhoto"_s,
+                                  u"Exif.Photo.ExifVersion"_s, tr("EXIF version"));
 
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSLatitudeRef"), tr("Latitude reference"));
+                                  u"Exif.GPSInfo.GPSLatitudeRef"_s, tr("Latitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSLatitude"), tr("Latitude"));
+                                  u"Exif.GPSInfo.GPSLatitude"_s, tr("Latitude"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSLongitudeRef"), tr("Longitude reference"));
+                                  u"Exif.GPSInfo.GPSLongitudeRef"_s, tr("Longitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSLongitude"), tr("Longitude"));
+                                  u"Exif.GPSInfo.GPSLongitude"_s, tr("Longitude"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSAltitudeRef"), tr("Altitude reference"));
+                                  u"Exif.GPSInfo.GPSAltitudeRef"_s, tr("Altitude reference"));
-        appendExivPropertyIfExist(wrapper, QStringLiteral("GPS"),
+        appendExivPropertyIfExist(wrapper, u"GPS"_s,
-                                  QStringLiteral("Exif.GPSInfo.GPSAltitude"), tr("Altitude"));
+                                  u"Exif.GPSInfo.GPSAltitude"_s, tr("Altitude"));
 
     }
 }

app/metadatamodel.h

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef METADATAMODEL_H
 #define METADATAMODEL_H
 

app/navigatorview.cpp

@@ -1,20 +1,26 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "navigatorview.h"
 
 #include "graphicsview.h"
-#include "opacityhelper.h"
 
+#include <QStyleHints>
+#include <QOperatingSystemVersion>
 #include <QMouseEvent>
 #include <QDebug>
+#include <QTimer>
 
 NavigatorView::NavigatorView(QWidget *parent)
     : QGraphicsView (parent)
     , m_viewportRegion(this->rect())
-    , m_opacityHelper(new OpacityHelper(this))
 {
     setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
     setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
-    setStyleSheet("background-color: rgba(0, 0, 0, 120);"
+
-                  "border-radius: 3px;");
+    updateStyle(qGuiApp->styleHints()->colorScheme());
+    connect(qGuiApp->styleHints(), &QStyleHints::colorSchemeChanged, this, &NavigatorView::updateStyle);
 }
 
 // doesn't take or manage its ownership
@@ -23,16 +29,48 @@ void NavigatorView::setMainView(GraphicsView *mainView)
     m_mainView = mainView;
 }
 
-void NavigatorView::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}
-
 void NavigatorView::updateMainViewportRegion()
 {
-    if (m_mainView != nullptr) {
+    // Use QTimer::singleShot with lambda to delay the update
-        m_viewportRegion = mapFromScene(m_mainView->mapToScene(m_mainView->rect()));
+    // This ensures all geometry updates are complete before calculating viewport region
-        update();
+    QTimer::singleShot(0, [this]() {
+        if (m_mainView != nullptr) {
+            m_viewportRegion = mapFromScene(m_mainView->mapToScene(m_mainView->rect()));
+            update();
+        }
+    });
+}
+
+void NavigatorView::updateStyle(Qt::ColorScheme colorScheme) {
+    // YYC MARK:
+    // If we are using Windows 10 and lower system or Qt which do not support "Windows 11"
+    // theme (lower than Qt 6.7), we should only support light mode.
+    // Because Qt's dark-mode-aware "Windows 11" theme is only well-supported on Windows 11.
+#if defined(Q_OS_WIN)
+#if QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+    colorScheme = Qt::ColorScheme::Light;
+#else
+    if (QOperatingSystemVersion::current() < QOperatingSystemVersion::Windows11) {
+        colorScheme = Qt::ColorScheme::Light;
+    }
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 7, 0)
+#endif // defined(Q_OS_WIN)
+
+    switch (colorScheme) {
+    case Qt::ColorScheme::Dark:
+    setStyleSheet(R"#(
+border-style: none;
+background-color: rgba(255, 255, 255, 70);
+)#");
+        break;
+    case Qt::ColorScheme::Light:
+    case Qt::ColorScheme::Unknown:
+    default:
+        setStyleSheet(R"#(
+border-style: none;
+background-color: rgba(0, 0, 0, 70);
+)#");
+        break;
     }
 }
 

app/navigatorview.h

@@ -1,9 +1,12 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef NAVIGATORVIEW_H
 #define NAVIGATORVIEW_H
 
 #include <QGraphicsView>
 
-class OpacityHelper;
 class GraphicsView;
 class NavigatorView : public QGraphicsView
 {
@@ -12,11 +15,13 @@ public:
     NavigatorView(QWidget *parent = nullptr);
 
     void setMainView(GraphicsView *mainView);
-    void setOpacity(qreal opacity, bool animated = true);
 
 public slots:
     void updateMainViewportRegion();
 
+private slots:
+    void updateStyle(Qt::ColorScheme colorScheme);
+
 private:
     void mousePressEvent(QMouseEvent * event) override;
     void mouseMoveEvent(QMouseEvent * event) override;
@@ -28,7 +33,6 @@ private:
     bool m_mouseDown = false;
     QPolygon m_viewportRegion;
     QGraphicsView *m_mainView = nullptr;
-    OpacityHelper *m_opacityHelper = nullptr;
 };
 
 #endif // NAVIGATORVIEW_H

app/opacityhelper.cpp

@@ -1,27 +0,0 @@
-#include "opacityhelper.h"
-
-#include <QGraphicsOpacityEffect>
-#include <QPropertyAnimation>
-
-OpacityHelper::OpacityHelper(QWidget *parent)
-    : QObject(parent)
-    , m_opacityFx(new QGraphicsOpacityEffect(parent))
-    , m_opacityAnimation(new QPropertyAnimation(m_opacityFx, "opacity"))
-{
-    parent->setGraphicsEffect(m_opacityFx);
-
-    m_opacityAnimation->setDuration(300);
-}
-
-void OpacityHelper::setOpacity(qreal opacity, bool animated)
-{
-    if (!animated) {
-        m_opacityFx->setOpacity(opacity);
-        return;
-    }
-
-    m_opacityAnimation->stop();
-    m_opacityAnimation->setStartValue(m_opacityFx->opacity());
-    m_opacityAnimation->setEndValue(opacity);
-    m_opacityAnimation->start();
-}

app/opacityhelper.h

@@ -1,23 +0,0 @@
-#ifndef OPACITYHELPER_H
-#define OPACITYHELPER_H
-
-#include <QWidget>
-
-QT_BEGIN_NAMESPACE
-class QGraphicsOpacityEffect;
-class QPropertyAnimation;
-QT_END_NAMESPACE
-
-class OpacityHelper : QObject
-{
-public:
-    OpacityHelper(QWidget * parent);
-
-    void setOpacity(qreal opacity, bool animated = true);
-
-protected:
-    QGraphicsOpacityEffect * m_opacityFx;
-    QPropertyAnimation * m_opacityAnimation;
-};
-
-#endif // OPACITYHELPER_H

app/playlistmanager.cpp

@@ -1,13 +1,20 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #include "playlistmanager.h"
+#include "playlistscout.h"
 
 #include <QCollator>
 #include <QDir>
 #include <QFileInfo>
 #include <QUrl>
 
-PlaylistManager::PlaylistManager(PlaylistType type, QObject *parent)
+PlaylistManager::PlaylistManager(QObject *parent)
     : QObject(parent)
-    , m_type(type)
+    , m_currentIndex(std::nullopt)
+    , m_playlist()
+    , m_allowedSuffixes()
 {
 
 }
@@ -17,148 +24,272 @@ PlaylistManager::~PlaylistManager()
 
 }
 
-void PlaylistManager::setPlaylistType(PlaylistManager::PlaylistType type)
+// region: Allowed Suffixes Operations
-{
+
-    m_type = type;
+const QStringList& PlaylistManager::allowedSuffixes() const {
+    return m_allowedSuffixes;
 }
 
-PlaylistManager::PlaylistType PlaylistManager::playlistType() const
+void PlaylistManager::setAllowedSuffixes(const QStringList& nameFilters) {
-{
+    m_allowedSuffixes = nameFilters;
-    return m_type;
+    emit allowedSuffixesChanged(m_allowedSuffixes);
 }
 
-QStringList PlaylistManager::autoLoadFilterSuffix() const
+// endregion
-{
+
-    return m_autoLoadSuffix;
+// region: Playlist Loader and Reset
+
+bool PlaylistManager::loadPlaylist(const QStringList& files) {
+    // Convert string list to url list first
+    QList<QUrl> urls;
+    for (const QString & file : std::as_const(files)) {
+        urls.append(urlFromString(file));
+    }
+
+    return loadPlaylist(urls);
 }
 
-void PlaylistManager::setAutoLoadFilterSuffix(const QStringList & nameFilters)
+bool PlaylistManager::loadPlaylist(const QList<QUrl>& urls) {
-{
+    // Check its count, and check M3U8 playlist for single file case.
-    m_autoLoadSuffix = nameFilters;
+    if (urls.isEmpty()) {
-}
+        clearPlaylist();
-
+        return true;
-void PlaylistManager::clear()
+    } else if (urls.count() == 1) {
-{
+        const QUrl& firstUrl = urls.first();
-    m_currentIndex = -1;
+        const QString lowerCaseUrlPath(firstUrl.path().toLower());
-    m_playlist.clear();
+        if (lowerCaseUrlPath.endsWith(".m3u8") || lowerCaseUrlPath.endsWith(".m3u")) {
-}
+            return loadM3U8Playlist(firstUrl);
-
-void PlaylistManager::setPlaylist(const QList<QUrl> &urls)
-{
-    m_playlist = urls;
-}
-
-void PlaylistManager::setCurrentFile(const QString & filePath)
-{
-    QFileInfo info(filePath);
-    QDir dir(info.path());
-    QString && currentFileName = info.fileName();
-
-    switch (playlistType()) {
-    case PL_SAMEFOLDER: {
-        if (dir.path() == m_currentDir) {
-            int index = indexOf(filePath);
-            m_currentIndex = index == -1 ? appendFile(filePath) : index;
         } else {
-            QStringList entryList = dir.entryList(
+            return loadSingleFilePlaylist(firstUrl);
-                        m_autoLoadSuffix,
+        }
-                        QDir::Files | QDir::NoSymLinks, QDir::NoSort);
+    } else {
+        return loadMultipleFilesPlaylist(std::move(urls));
+    }
+}
 
-            QCollator collator;
+bool PlaylistManager::loadSingleFilePlaylist(const QUrl& url) {
-            collator.setNumericMode(true);
+    // Check URL at first
+    if (!checkUrl(url))
+        return false;
 
-            std::sort(entryList.begin(), entryList.end(), collator);
+    // Scout playlist by given file
+    auto scoutResult = PlaylistScout::scout(url, m_allowedSuffixes);
+    if (!scoutResult.has_value()) {
+        return false;
+    }
 
-            clear();
+    // Setup playlist with index
+    setPlaylist(std::move(scoutResult->playlist), scoutResult->indexHint);
+    return true;
+}
 
-            int index = -1;
+bool PlaylistManager::loadMultipleFilesPlaylist(const QList<QUrl>&& urls) {
-            for (int i = 0; i < entryList.count(); i++) {
+    // Check all of them are valid
-                const QString & fileName = entryList.at(i);
+    for (const auto& url : std::as_const(urls)) {
-                const QString & oneEntry = dir.absoluteFilePath(fileName);
+        if (!checkUrl(url)) {
-                const QUrl & url = QUrl::fromLocalFile(oneEntry);
+            return false;
-                m_playlist.append(url);
+        }
-                if (fileName == currentFileName) {
+    }
-                    index = i;
+
-                }
+    // Set playlist and return
+    setPlaylist(std::move(urls));
+    return true;
+}
+
+bool PlaylistManager::loadM3U8Playlist(const QUrl& url) {
+    // Check URL at first
+    if (!checkUrl(url))
+        return false;
+
+    QList<QUrl> urls;
+    QFile file(url.toLocalFile());
+    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
+        while (!file.atEnd()) {
+            QString line = file.readLine();
+            if (line.startsWith('#')) {
+                continue;
             }
-            m_currentIndex = index == -1 ? appendFile(filePath) : index;
+            QFileInfo fileInfo(file);
-            m_currentDir = dir.path();
+            QUrl item = QUrl::fromUserInput(line, fileInfo.absolutePath());
+            if (!checkUrl(item)) {
+                return false;
+            }
+            urls.append(item);
         }
-        break;
+    } else {
-    }
+        return false;
-    case PL_USERPLAYLIST:{
-        int index = indexOf(filePath);
-        m_currentIndex = index == -1 ? appendFile(filePath) : index;
-        break;
-    }
-    default:
-        break;
     }
 
-    emit loaded(m_playlist.count());
+    setPlaylist(std::move(urls));
+    return true;
 }
 
-void PlaylistManager::setCurrentIndex(int index)
+void PlaylistManager::setPlaylist(const QList<QUrl>&& urls, std::optional<qsizetype> indexHint) {
+    // Setup playlist
+    m_playlist = std::move(urls);
+
+    // Set index with hint
+    if (indexHint.has_value()) {
+        m_currentIndex = *indexHint;
+    }
+    sanitizeIndex();
+
+    // Raise signal
+    emit playlistChanged(totalCount());
+}
+
+void PlaylistManager::clearPlaylist() {
+    m_playlist.clear();
+    sanitizeIndex();
+    emit playlistChanged(this->totalCount());
+}
+
+// endregion
+
+// region: Playlist Operations
+
+void PlaylistManager::appendToPlaylist(const QString &file)
 {
-    if (index < 0 || index >= m_playlist.count()) return;
+    return appendToPlaylist(urlFromString(file));
+}
+
+void PlaylistManager::appendToPlaylist(const QUrl &url)
+{
+    m_playlist.append(url);
+    sanitizeIndex();
+    emit playlistChanged(totalCount());
+}
+
+bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QString &file)
+{
+    return insertIntoPlaylist(index, urlFromString(file));
+}
+
+bool PlaylistManager::insertIntoPlaylist(qsizetype index, const QUrl &url)
+{
+    if (index < 0 || index > totalCount()) {
+        return false;
+    } else {
+        m_playlist.insert(index, url);
+        sanitizeIndex();
+        emit playlistChanged(totalCount());
+        return true;
+    }
+}
+
+bool PlaylistManager::removeFromPlaylist(qsizetype index)
+{
+    if (index < 0 || index >= totalCount()) {
+        return false;
+    } else {
+        m_playlist.removeAt(index);
+        sanitizeIndex();
+        emit playlistChanged(totalCount());
+        return true;
+    }
+}
+
+// endregion
+
+// region: Index Operations
+
+qsizetype PlaylistManager::totalCount() const
+{
+    return m_playlist.count();
+}
+
+std::optional<qsizetype> PlaylistManager::previousIndex() const
+{
+    if (!m_currentIndex.has_value() || totalCount() <= 0) return std::nullopt;
+    return (isFirstIndex() ? totalCount() - 1 : *m_currentIndex - 1);
+}
+
+std::optional<qsizetype> PlaylistManager::nextIndex() const
+{
+    if (!m_currentIndex.has_value() || totalCount() <= 0) return std::nullopt;
+    return (isLastIndex() ? 0 : *m_currentIndex + 1);
+}
+
+bool PlaylistManager::isFirstIndex() const
+{
+    return m_currentIndex.has_value() && *m_currentIndex == 0;
+}
+
+bool PlaylistManager::isLastIndex() const
+{
+    return m_currentIndex.has_value() && *m_currentIndex + 1 == totalCount();
+}
+
+std::optional<qsizetype> PlaylistManager::currentIndex() const
+{
+    return m_currentIndex;
+}
+
+bool PlaylistManager::setCurrentIndex(qsizetype index)
+{
+    if (!m_currentIndex.has_value()) {
+        return false;
+    }
+    if (index < 0 || index >= totalCount()) {
+        return false;
+    }
+    if (*m_currentIndex == index) {
+        return true;
+    }
+
     m_currentIndex = index;
+    emit currentIndexChanged(index);
+    return true;
 }
 
-int PlaylistManager::appendFile(const QString &filePath)
+QUrl PlaylistManager::urlByIndex(qsizetype index) const
 {
-    int index = m_playlist.length();
+    return m_playlist.value(index);
-    m_playlist.append(QUrl::fromLocalFile(filePath));
-
-    return index;
 }
 
-int PlaylistManager::indexOf(const QString &filePath)
+QString PlaylistManager::localFileByIndex(qsizetype index) const
 {
-    const QUrl & url = QUrl::fromLocalFile(filePath);
+    return urlByIndex(index).toLocalFile();
-    return m_playlist.indexOf(url);
 }
 
-std::tuple<int, QString> PlaylistManager::previousFile() const
+// endregion
+
+// region: Misc
+
+void PlaylistManager::sanitizeIndex()
 {
-    int count = m_playlist.count();
+    auto cnt = totalCount();
-    if (count == 0) return std::make_tuple(-1, QString());
+    if (cnt == 0) {
-
+        // If playlist is empty, current index should be invalid.
-    int index = m_currentIndex - 1 < 0 ? count - 1 : m_currentIndex - 1;
+        m_currentIndex = std::nullopt;
-    return std::make_tuple(index, m_playlist.at(index).toLocalFile());
+    } else {
-}
+        if (m_currentIndex.has_value()) {
-
+            // Clamp current index in playlist range.
-std::tuple<int, QString> PlaylistManager::nextFile() const
+            // If it is already in range, not change was done.
-{
+            auto currentIndex = *m_currentIndex;
-    int count = m_playlist.count();
+            if (currentIndex < 0) {
-    if (count == 0) return std::make_tuple(-1, QString());
+                m_currentIndex = 0;
-
+            } else if (currentIndex >= cnt) {
-    int index = m_currentIndex + 1 == count ? 0 : m_currentIndex + 1;
+                m_currentIndex = cnt - 1;
-    return std::make_tuple(index, m_playlist.at(index).toLocalFile());
+            } else {
-}
+                ; // No change.
-
+            }
-std::tuple<int, QString> PlaylistManager::currentFile() const
+        } else {
-{
+            // If there is no set value for current index,
-    if (m_playlist.count() == 0) return std::make_tuple(-1, QString());
+            // set it at the beginning of playlist.
-
+            m_currentIndex = 0;
-    return std::make_tuple(m_currentIndex, m_playlist.at(m_currentIndex).toLocalFile());
-}
-
-std::tuple<int, QUrl> PlaylistManager::currentFileUrl() const
-{
-    if (m_playlist.count() == 0) return std::make_tuple(-1, QUrl());
-
-    return std::make_tuple(m_currentIndex, m_playlist.at(m_currentIndex));
-}
-
-QList<QUrl> PlaylistManager::convertToUrlList(const QStringList &files)
-{
-    QList<QUrl> urlList;
-    for (const QString & str : qAsConst(files)) {
-        QUrl url = QUrl::fromLocalFile(str);
-        if (url.isValid()) {
-            urlList.append(url);
         }
     }
-
-    return urlList;
 }
+
+bool PlaylistManager::checkUrl(const QUrl& url)
+{
+    return url.isValid() && url.isLocalFile();
+}
+
+QUrl PlaylistManager::urlFromString(const QString& file)
+{
+    return QUrl::fromLocalFile(file);
+}
+
+// endregion

app/playlistmanager.h

@@ -1,48 +1,130 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+//
+// SPDX-License-Identifier: MIT
+
 #pragma once
 
+#include <QUrl>
 #include <QObject>
+#include <optional>
 
+/// The manager of playlist.
 class PlaylistManager : public QObject
 {
     Q_OBJECT
 public:
-    enum PlaylistType {
+    /// Constructs a PlaylistManager with an optional parent QObject.
-        PL_USERPLAYLIST, // Regular playlist, managed by user.
+    explicit PlaylistManager(QObject* parent = nullptr);
-        PL_SAMEFOLDER // PlaylistManager managed playlist, loaded from files from same folder.
+    /// Destructor.
-    };
-
-    explicit PlaylistManager(PlaylistType type = PL_USERPLAYLIST, QObject *parent = nullptr);
     ~PlaylistManager();
 
-    void setPlaylistType(PlaylistType type);
+    /// Get the allowed file suffixes of this playlist.
-    PlaylistType playlistType() const;
+    /// @return The current list of allowed suffixes.
+    const QStringList& allowedSuffixes() const;
+    /// Set the allowed file suffixes of this playlist.
+    /// @remark This only works for "load the whole directory by one file" case.
+    /// @param[in] nameFilters The new list of allowed suffixes.
+    void setAllowedSuffixes(const QStringList& nameFilters);
 
-    QStringList autoLoadFilterSuffix() const;
+    /// Load user specified files as playlist.
-    void setAutoLoadFilterSuffix(const QStringList &nameFilters);
+    /// @remark The wrapper for another overload.
+    /// @return True for successful load, otherwise false.
+    bool loadPlaylist(const QStringList& files);
+    /// Load user specified URLs as playlist.
+    /// @remark This function automatically dispatch these files into correct sub-load functions.
+    /// @return True for successful load, otherwise false.
+    bool loadPlaylist(const QList<QUrl>& urls);
+    /// Clear the entire playlist and reset current index.
+    void clearPlaylist();
 
-    void clear();
+    /// Append a local file path to the playlist.
+    void appendToPlaylist(const QString& file);
+    /// Append a URL to the playlist.
+    void appendToPlaylist(const QUrl& url);
+    /// Insert a local file path at the given index.
+    /// @return True if inserted successfully, false if index is out of range.
+    bool insertIntoPlaylist(qsizetype index, const QString& file);
+    /// Insert a URL at the given index.
+    /// @return True if inserted successfully, false if index is out of range.
+    bool insertIntoPlaylist(qsizetype index, const QUrl& url);
+    /// Remove the entry at the given index.
+    /// @return True if removed successfully, false if index is out of range.
+    bool removeFromPlaylist(qsizetype index);
 
-    void setPlaylist(const QList<QUrl> & urls);
+    /// Returns the total number of items in the playlist.
-    void setCurrentFile(const QString & filePath);
+    /// @return Total count of entries in the playlist.
-    void setCurrentIndex(int index);
+    qsizetype totalCount() const;
-    int appendFile(const QString & filePath);
+    /// Try fetching previous index.
-    int indexOf(const QString & filePath);
+    /// @details This previous index is gallery-loop-aware.
-
+    /// @return std::nullopt if playlist is empty, otherwise the previous index considering gallery loop.
-    std::tuple<int, QString> previousFile() const;
+    std::optional<qsizetype> previousIndex() const;
-    std::tuple<int, QString> nextFile() const;
+    /// Try fetching next index.
-    std::tuple<int, QString> currentFile() const;
+    /// @details This next index is gallery-loop-aware.
-    std::tuple<int, QUrl> currentFileUrl() const;
+    /// @return std::nullopt if playlist is empty, otherwise the next index considering gallery loop.
-
+    std::optional<qsizetype> nextIndex() const;
-    static QList<QUrl> convertToUrlList(const QStringList & files);
+    /// Check whether current index is the first index.
+    /// @return False if current index is not the first index or playlist is empty, otherwise true.
+    bool isFirstIndex() const;
+    /// Check whether current index is the last index.
+    /// @return False if current index is not the last index or playlist is empty, otherwise true.
+    bool isLastIndex() const;
+    /// Returns the current index.
+    /// @return std::nullopt if the playlist is empty, otherwise the current index.
+    std::optional<qsizetype> currentIndex() const;
+    /// Set the current index.
+    /// @remark Index only can be set when playlist is not empty.
+    /// @return True if successful set, including "not changed" set, otherwise false.
+    /// This return value only indicates whether we can set index and given index is valid for setting.
+    /// If "no changed" set occurs, this function returns true, but doesn't raise current index changed signal.
+    bool setCurrentIndex(qsizetype index);
+    /// Returns the URL at the given index.
+    /// @return The URL if index is valid.
+    /// This class guarantee that this QUrl is pointing to a local file.
+    QUrl urlByIndex(qsizetype index) const;
+    /// Returns the local file path at the given index.
+    /// @return The local file path if index is valid.
+    /// This class guarantee that local file path always is valid.
+    QString localFileByIndex(qsizetype index) const;
 
 signals:
-    void loaded(int length);
+    void allowedSuffixesChanged(const QStringList& suffixes);
+    /// Raised when index was changed bu setter.
+    /// The argument holds the new current index.
+    /// Please note that this signal will NOT be raised by the whole playlist change caused index change.
+    void currentIndexChanged(qsizetype index);
+    /// The whole playlist was changed, involving loading, editing and deleting some or full entries.
+    /// The argument holds the total count of new play list.
+    void playlistChanged(qsizetype count);
 
 private:
-    QList<QUrl> m_playlist;
+    /// The fundamental playlist setter.
-    PlaylistType m_type;
+    /// @details All playlist load functions will call this function to set playlist at last.
-    QString m_currentDir;
+    /// @param[in] urls ALl urls in this list should be checked by checkUrl() function.
-    int m_currentIndex = -1;
+    /// @param[in] indexHint Try to set current index to this index if possible.
-    QStringList m_autoLoadSuffix = {};
+    void setPlaylist(const QList<QUrl>&& urls, std::optional<qsizetype> indexHint = std::nullopt);
-};
+    /// Load playlist from a single file.
+    /// @details This function scans the same directory for siblings matching allowed suffixes, sorted naturally.
+    /// @return True if the playlist was loaded successfully, false otherwise.
+    bool loadSingleFilePlaylist(const QUrl& url);
+    /// Load playlist from multiple URLs directly.
+    /// @return True if all URLs are valid, false otherwise.
+    bool loadMultipleFilesPlaylist(const QList<QUrl>&& urls);
+    /// Load playlist from an M3U/M3U8 playlist file.
+    /// @return True if loaded successfully, false otherwise.
+    bool loadM3U8Playlist(const QUrl& url);
 
+    /// Make sure that current index is valid.
+    /// @details This function usually is used by those functions manipulating playlist.
+    void sanitizeIndex();
+
+    /// Check whether given QUrl is proper to be put into playlist.
+    /// @details Only the url pointing to local file can be put into playlist.
+    static bool checkUrl(const QUrl& url);
+    /// Convert a string to local file into a QUrl.
+    /// @param[in] file The string pointing to local file.
+    static QUrl urlFromString(const QString& file);
+
+    std::optional<qsizetype> m_currentIndex;
+    QList<QUrl> m_playlist;
+    QStringList m_allowedSuffixes;
+};

app/playlistscout.cpp

@@ -0,0 +1,25 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "playlistscout.h"
+
+#include "playlistscouts/qtscout.h"
+#include "playlistscouts/explorerscout.h"
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+
+#ifdef Q_OS_WIN
+    // In Windows, Qt approach can not aware Windows Explorer custom sort order.
+    // So we need to try using Win32 functions for fetching it at first.
+    if (auto rv = PlaylistScout::Explorer::scout(url, allowedSuffixes); rv.has_value()) {
+        return rv;
+    }
+#endif // Q_OS_WIN
+
+    // TODO: We may add macOS Finder, KDE Dolphin and etc supports in future.
+
+    // Qt way is the last fallback.
+    return PlaylistScout::Qt::scout(url, allowedSuffixes);
+}

app/playlistscout.h

@@ -0,0 +1,31 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include <QUrl>
+#include <QStringList>
+#include <QList>
+#include <optional>
+
+namespace PlaylistScout {
+    /// The result of scout
+    struct ScoutResult {
+        /// The final fetched playlist (it can be empty).
+        /// Each item must be a QUrl pointing to a local file.
+        QList<QUrl> playlist;
+        /// The index of given file located in playlist.
+        /// Nullopt if it is not presented in playlist.
+        std::optional<qsizetype> indexHint;
+    };
+
+    /// @brief Scout available image files in given file's parent dir with given allowed suffixes.
+    /// @param[in] url The path to file whose parent dir is our target dir for finding image files.
+    /// @param[in] allowedSuffixes 
+    /// Each items in this list is a wildcard pattern for matching allowed file name, like \c *.png .
+    /// The fetched item will be preserved if its name matching any of them.
+    /// If this list is empty, there is no restrictions for finding files.
+    /// @return Scout result if success, otherwise nullopt.
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}

app/playlistscouts/explorerscout.cpp

@@ -0,0 +1,332 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "explorerscout.h"
+
+#ifdef Q_OS_WIN
+
+#include <QDir>
+#include <QDebug>
+#include <QFileInfo>
+#include <QRegularExpression>
+
+#include <optional>
+
+#include <exdisp.h>     // IShellWindows, CLSID_ShellWindows
+#include <servprov.h>   // IServiceProvider
+#include <shlguid.h>    // SID_STopLevelBrowser
+#include <shlobj.h>
+
+// YYC MARK:
+// We use custom RAII wrappers instead of existing COM smart pointers because the
+// project may be built with MinGW, which does not have good compatibility with
+// CComPtr and Microsoft's WRL ComPtr (<wrl/client.h>).
+// Furthermore, PIDLs are not COM objects (they are freed via ILFree, not Release),
+// so no standard smart pointer covers them regardless of compiler.
+
+/// RAII wrapper for COM initialization (CoInitialize / CoUninitialize).
+/// Must be declared before any COM objects (e.g., ComPtr, UniquePidl) so that
+/// CoUninitialize runs after all COM objects are released during scope exit.
+class ComGuard {
+public:
+    ComGuard() : m_hr(CoInitialize(nullptr)) {}
+    ~ComGuard() { if (SUCCEEDED(m_hr)) CoUninitialize(); }
+    ComGuard(const ComGuard&) = delete;
+    ComGuard& operator=(const ComGuard&) = delete;
+
+    bool IsInitialized() const { return SUCCEEDED(m_hr); }
+
+private:
+    HRESULT m_hr;
+};
+
+/// RAII wrapper for COM interface pointers.
+template <typename T>
+class ComPtr {
+public:
+    ComPtr() = default;
+    ComPtr(std::nullptr_t) {}
+    ~ComPtr() { Reset(); }
+    ComPtr(const ComPtr&) = delete;
+    ComPtr& operator=(const ComPtr&) = delete;
+    ComPtr(ComPtr&& other) noexcept : m_ptr(other.m_ptr) { other.m_ptr = nullptr; }
+    ComPtr& operator=(ComPtr&& other) noexcept {
+        if (this != &other) {
+            Reset();
+            m_ptr = other.m_ptr;
+            other.m_ptr = nullptr;
+        }
+        return *this;
+    }
+
+    T* operator->() const { return m_ptr; }
+    T* Get() const { return m_ptr; }
+    T** GetAddressOf() { return &m_ptr; }
+    explicit operator bool() const { return m_ptr != nullptr; }
+    void Reset() { if (m_ptr) { m_ptr->Release(); m_ptr = nullptr; } }
+
+private:
+    T* m_ptr = nullptr;
+};
+
+/// RAII wrapper for PIDL (Item ID List).
+class UniquePidl {
+public:
+    UniquePidl() = default;
+    explicit UniquePidl(LPITEMIDLIST pidl) : m_pidl(pidl) {}
+    ~UniquePidl() { Reset(); }
+    UniquePidl(const UniquePidl&) = delete;
+    UniquePidl& operator=(const UniquePidl&) = delete;
+    UniquePidl(UniquePidl&& other) noexcept : m_pidl(other.m_pidl) { other.m_pidl = nullptr; }
+    UniquePidl& operator=(UniquePidl&& other) noexcept {
+        if (this != &other) {
+            Reset();
+            m_pidl = other.m_pidl;
+            other.m_pidl = nullptr;
+        }
+        return *this;
+    }
+
+    LPCITEMIDLIST Get() const { return m_pidl; }
+    LPITEMIDLIST* GetAddressOf() { return &m_pidl; }
+    explicit operator bool() const { return m_pidl != nullptr; }
+    void Reset() { if (m_pidl) { ILFree(m_pidl); m_pidl = nullptr; } }
+
+private:
+    LPITEMIDLIST m_pidl = nullptr;
+};
+
+/// Outputs a diagnostic warning for debugging Windows Explorer integration failures.
+static void ReportError(const QString& detail)
+{
+    qWarning("Windows Explorer file list fetch error: %s",
+             qPrintable(detail));
+}
+
+/// Normalizes a Windows directory path for case-insensitive comparison:
+/// converts to native separators, lowercases, and ensures a trailing backslash.
+static QString NormalizePath(const QString& path)
+{
+    QString result = QDir::toNativeSeparators(path).toLower();
+    if (!result.endsWith(QChar('\\'))) {
+        result += QChar('\\');
+    }
+    return result;
+}
+
+/// Checks whether the Explorer window represented by the given IDispatch is
+/// displaying the target folder. Returns its IFolderView2 on match, or null.
+static ComPtr<IFolderView2> TryMatchWindow(IDispatch* dispatch, const QString& normalizedTarget)
+{
+    // Navigate: IDispatch -> IServiceProvider -> IShellBrowser.
+    ComPtr<IServiceProvider> serviceProvider;
+    if (FAILED(dispatch->QueryInterface(IID_PPV_ARGS(serviceProvider.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    ComPtr<IShellBrowser> shellBrowser;
+    if (FAILED(serviceProvider->QueryService(SID_STopLevelBrowser,
+            IID_PPV_ARGS(shellBrowser.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    // IShellBrowser -> active IShellView.
+    ComPtr<IShellView> shellView;
+    if (FAILED(shellBrowser->QueryActiveShellView(shellView.GetAddressOf()))) {
+        return nullptr;
+    }
+
+    // Retrieve the folder's path via IPersistIDList.
+    ComPtr<IPersistIDList> persistIdList;
+    if (FAILED(shellView->QueryInterface(IID_PPV_ARGS(persistIdList.GetAddressOf())))) {
+        return nullptr;
+    }
+
+    UniquePidl folderPidl;
+    if (FAILED(persistIdList->GetIDList(folderPidl.GetAddressOf()))) {
+        return nullptr;
+    }
+
+    PWSTR pathStr = nullptr;
+    if (FAILED(SHGetNameFromIDList(folderPidl.Get(), SIGDN_DESKTOPABSOLUTEPARSING, &pathStr))) {
+        return nullptr;
+    }
+
+    QString windowPath = NormalizePath(QString::fromWCharArray(pathStr));
+    CoTaskMemFree(pathStr);
+
+    if (windowPath != normalizedTarget) {
+        return nullptr;
+    }
+
+    // Path matches — query IFolderView2 from the ShellView.
+    ComPtr<IFolderView2> folderView2;
+    if (FAILED(shellView->QueryInterface(IID_PPV_ARGS(folderView2.GetAddressOf())))) {
+        return nullptr;
+    }
+    return folderView2;
+}
+
+/// Tries to find a live Explorer window that is currently displaying the given
+/// folder path. Returns the IFolderView2 from that window, or an empty ComPtr.
+///
+/// Explorer's sort order is stored only in the running Explorer process's memory.
+/// Creating a new shell view via IShellFolder::CreateViewObject yields a default
+/// sort (always by name), so we must find the actual live IFolderView2 instead.
+///
+/// Reference:
+/// - https://www.stephenli.ca/getting-windows-explorers-current-directory-sort-order
+/// - https://github.com/d2phap/ImageGlass/blob/75a296287f338edcf409eee3917531b25ff5d927/v9/Components/ImageGlass.Base/FileSystem/FileFinder.cs
+/// - NuGet Package: D2Phap.EggShell
+static ComPtr<IFolderView2> FindLiveFolderView(const QString& targetFolderPath)
+{
+    // Create the Shell windows collection (all open Explorer windows).
+    ComPtr<IShellWindows> shellWindows;
+    if (FAILED(CoCreateInstance(CLSID_ShellWindows, nullptr, CLSCTX_ALL,
+            IID_PPV_ARGS(shellWindows.GetAddressOf())))) {
+        ReportError("Failed to create IShellWindows instance");
+        return nullptr;
+    }
+
+    QString normalizedTarget = NormalizePath(targetFolderPath);
+
+    // 1. Try the Desktop window first — it may contain the file the user opened.
+    {
+        VARIANT varLoc;
+        VariantInit(&varLoc);
+        varLoc.vt = VT_I4;
+        varLoc.lVal = 0;
+
+        VARIANT varLocRoot;
+        VariantInit(&varLocRoot);
+
+        long desktopHwnd = 0;
+        ComPtr<IDispatch> desktopDispatch;
+        HRESULT findHr = shellWindows->FindWindowSW(
+            &varLoc, &varLocRoot, SWC_DESKTOP,
+            &desktopHwnd, SWFO_NEEDDISPATCH,
+            desktopDispatch.GetAddressOf());
+
+        VariantClear(&varLoc);
+        VariantClear(&varLocRoot);
+
+        if (SUCCEEDED(findHr) && desktopDispatch) {
+            ComPtr<IFolderView2> result = TryMatchWindow(desktopDispatch.Get(), normalizedTarget);
+            if (result) return result;
+        }
+    }
+
+    // 2. Iterate regular Explorer windows.
+    LONG count = 0;
+    shellWindows->get_Count(&count);
+
+    for (LONG i = 0; i < count; i++) {
+        VARIANT varIndex;
+        VariantInit(&varIndex);
+        varIndex.vt = VT_I4;
+        varIndex.lVal = i;
+
+        ComPtr<IDispatch> dispatch;
+        HRESULT itemHr = shellWindows->Item(varIndex, dispatch.GetAddressOf());
+        VariantClear(&varIndex);
+
+        if (FAILED(itemHr) || !dispatch) {
+            continue;
+        }
+
+        ComPtr<IFolderView2> result = TryMatchWindow(dispatch.Get(), normalizedTarget);
+        if (result) return result;
+    }
+
+    return nullptr;
+}
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::Explorer::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+    PlaylistScout::ScoutResult rv;
+
+    QFileInfo info(url.toLocalFile());
+    QString folderPath = info.path();
+    QString currentFileName = info.fileName();
+
+    // Pre-compile wildcard suffix filters into regular expressions for performance.
+    QList<QRegularExpression> nameRegexps;
+    for (const QString &pattern : allowedSuffixes) {
+        nameRegexps.append(QRegularExpression(
+            QRegularExpression::wildcardToRegularExpression(pattern),
+            QRegularExpression::CaseInsensitiveOption));
+    }
+
+    // Initialize COM. The ComGuard must be declared before any COM objects
+    // below so that CoUninitialize runs after all of them are released.
+    ComGuard comGuard;
+    if (!comGuard.IsInitialized()) {
+        ReportError("COM initialization failed");
+        return std::nullopt;
+    }
+
+    // Find a live Explorer window that is currently displaying the target folder.
+    ComPtr<IFolderView2> folderView2 = FindLiveFolderView(folderPath);
+    if (!folderView2) {
+        ReportError("No open Explorer window matches the folder: " + folderPath);
+        return std::nullopt;
+    }
+
+    // Get items already sorted in Explorer's view order, as an IShellItemArray.
+    // SVGIO_ALLVIEW returns all items; SVGIO_FLAG_VIEWORDER respects the view's sort.
+    ComPtr<IShellItemArray> itemArray;
+    if (FAILED(folderView2->Items(SVGIO_ALLVIEW | SVGIO_FLAG_VIEWORDER,
+            IID_PPV_ARGS(itemArray.GetAddressOf())))) {
+        ReportError("IFolderView2::Items(SVGIO_ALLVIEW | SVGIO_FLAG_VIEWORDER) failed");
+        return std::nullopt;
+    }
+
+    DWORD itemCount = 0;
+    itemArray->GetCount(&itemCount);
+
+    // Enumerate sorted items, filter by pattern, and build the playlist.
+    for (DWORD i = 0; i < itemCount; i++) {
+        ComPtr<IShellItem> shellItem;
+        if (FAILED(itemArray->GetItemAt(i, shellItem.GetAddressOf()))) {
+            continue;
+        }
+
+        // Get the full parsing path of the item.
+        PWSTR pathStr = nullptr;
+        if (FAILED(shellItem->GetDisplayName(SIGDN_DESKTOPABSOLUTEPARSING, &pathStr)) || !pathStr) {
+            continue;
+        }
+        QString filePath = QString::fromWCharArray(pathStr);
+        CoTaskMemFree(pathStr);
+
+        // Skip directories — the view may include folders alongside files.
+        QFileInfo fileInfo(filePath);
+        if (!fileInfo.isFile()) {
+            continue;
+        }
+
+        QString fileName = fileInfo.fileName();
+
+        // Match against compiled wildcard patterns.
+        bool matches = nameRegexps.isEmpty();
+        for (const QRegularExpression &re : std::as_const(nameRegexps)) {
+            if (re.match(fileName).hasMatch()) {
+                matches = true;
+                break;
+            }
+        }
+        if (!matches) {
+            continue;
+        }
+
+        rv.playlist.append(QUrl::fromLocalFile(filePath));
+        if (fileName == currentFileName) {
+            rv.indexHint = rv.playlist.size() - 1;
+        }
+    }
+
+    return rv;
+}
+
+#endif // Q_OS_WIN

app/playlistscouts/explorerscout.h

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "../playlistscout.h"
+#include <QtSystemDetection>
+
+#ifdef Q_OS_WIN
+
+namespace PlaylistScout::Explorer {
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}
+
+#endif // Q_OS_WIN

app/playlistscouts/qtscout.cpp

@@ -0,0 +1,40 @@
+// SPDX-FileCopyrightText: 2025 Gary Wang <git@blumia.net>
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#include "qtscout.h"
+
+#include <QFileInfo>
+#include <QDir>
+#include <QCollator>
+
+std::optional<PlaylistScout::ScoutResult> PlaylistScout::Qt::scout(
+    const QUrl &url, const QStringList &allowedSuffixes) {
+    PlaylistScout::ScoutResult rv;
+
+    QFileInfo info(url.toLocalFile());
+    QDir dir(info.path());
+    QString currentFileName = info.fileName();
+
+    QStringList entryList = dir.entryList(
+        allowedSuffixes, QDir::Files | QDir::NoSymLinks, QDir::NoSort);
+
+    QCollator collator;
+    collator.setNumericMode(true);
+
+    std::sort(entryList.begin(), entryList.end(), collator);
+
+    for (qsizetype i = 0; i < entryList.count(); i++) {
+        const QString &fileName = entryList.at(i);
+        const QString &oneEntry = dir.absoluteFilePath(fileName);
+        const QUrl &url = QUrl::fromLocalFile(oneEntry);
+
+        rv.playlist.append(url);
+        if (fileName == currentFileName) {
+            rv.indexHint = i;
+        }
+    }
+
+    return rv;
+}

app/playlistscouts/qtscout.h

@@ -0,0 +1,11 @@
+// SPDX-FileCopyrightText: 2026 yyc12345 <yyc12321@outlook.com>
+//
+// SPDX-License-Identifier: MIT
+
+#pragma once
+
+#include "../playlistscout.h"
+
+namespace PlaylistScout::Qt {
+    std::optional<ScoutResult> scout(const QUrl &url, const QStringList &allowedSuffixes);
+}

app/settings.cpp

@@ -1,119 +1,174 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "settings.h"
 
 #include <QApplication>
 #include <QStandardPaths>
 #include <QDebug>
 #include <QDir>
-
+#include <QAction>
-Settings *Settings::m_settings_instance = nullptr;
+#include <QWidget>
+#include <QKeySequence>
+#include <QMetaEnum>
 
 Settings *Settings::instance()
 {
-    if (!m_settings_instance) {
+    // SAFETY:
-        m_settings_instance = new Settings;
+    // This is a global singleton and it is leaked by design.
+    static Settings* INSTANCE = new Settings(nullptr);
+    return INSTANCE;
+}
+
+namespace QEnumHelper
+{
+    template <typename E>
+    E fromString(const QString &text, const E defaultValue)
+    {
+        bool ok;
+        E result = static_cast<E>(QMetaEnum::fromType<E>().keyToValue(text.toUtf8(), &ok));
+        if (!ok) {
+            return defaultValue;
+        }
+        return result;
     }
 
-    return m_settings_instance;
+    template <typename E>
+    QString toString(E value)
+    {
+        const int intValue = static_cast<int>(value);
+        return QString::fromUtf8(QMetaEnum::fromType<E>().valueToKey(intValue));
+    }
 }
 
-bool Settings::stayOnTop()
+bool Settings::showNavigatorView() const
 {
-    return m_qsettings->value("stay_on_top", true).toBool();
+    return m_qsettings->value("show_navigator_view", true).toBool();
 }
 
-DoubleClickBehavior Settings::doubleClickBehavior()
+bool Settings::useLightCheckerboard() const
 {
-    QString result = m_qsettings->value("double_click_behavior", "close").toString().toLower();
+    return m_qsettings->value("use_light_checkerboard", false).toBool();
-
-    return stringToDoubleClickBehavior(result);
 }
 
-MouseWheelBehavior Settings::mouseWheelBehavior()
+bool Settings::loopGallery() const
 {
-    QString result = m_qsettings->value("mouse_wheel_behavior", "close").toString().toLower();
+    return m_qsettings->value("loop_gallery", true).toBool();
-
-    return stringToMouseWheelBehavior(result);
 }
 
-void Settings::setStayOnTop(bool on)
+bool Settings::svgTiny12Only() const
 {
-    m_qsettings->setValue("stay_on_top", on);
+    // Qt 6.7.0's SVG support is terrible caused by huge memory usage, see QTBUG-124287
+    // Qt 6.7.1's is somewhat better, memory issue seems fixed, but still laggy when zoom in, see QTBUG-126771.
+    // Qt 6.9.3 and Qt 6.10.1 seems no longer have the laggy issue, so let's make the default value different
+    // based on Qt version.
+#if QT_VERSION < QT_VERSION_CHECK(6, 9, 3)
+    return m_qsettings->value("svg_tiny12_only", true).toBool();
+#else
+    return m_qsettings->value("svg_tiny12_only", false).toBool();
+#endif // QT_VERSION < QT_VERSION_CHECK(6, 9, 3)
+}
+
+Settings::MouseWheelBehavior Settings::mouseWheelBehavior() const
+{
+    QString result = m_qsettings->value("mouse_wheel_behavior", "").toString();
+    return QEnumHelper::fromString<MouseWheelBehavior>(result, MouseWheelBehavior::Zoom);
+}
+
+Settings::WindowSizeBehavior Settings::initWindowSizeBehavior() const
+{
+    QString result = m_qsettings->value("init_window_size_behavior", "").toString();
+    return QEnumHelper::fromString<WindowSizeBehavior>(result, WindowSizeBehavior::Windowed);
+}
+
+Qt::HighDpiScaleFactorRoundingPolicy Settings::hiDpiScaleFactorBehavior() const
+{
+    QString result = m_qsettings->value("hidpi_scale_factor_behavior", "").toString();
+    return QEnumHelper::fromString<Qt::HighDpiScaleFactorRoundingPolicy>(result, Qt::HighDpiScaleFactorRoundingPolicy::PassThrough);
+}
+
+void Settings::setShowNavigatorView(bool on)
+{
+    m_qsettings->setValue("show_navigator_view", on);
     m_qsettings->sync();
 }
 
-void Settings::setDoubleClickBehavior(DoubleClickBehavior dcb)
+void Settings::setUseLightCheckerboard(bool light)
 {
-    m_qsettings->setValue("double_click_behavior", doubleClickBehaviorToString(dcb));
+    m_qsettings->setValue("use_light_checkerboard", light);
+    m_qsettings->sync();
+}
+
+void Settings::setLoopGallery(bool on)
+{
+    m_qsettings->setValue("loop_gallery", on);
+    m_qsettings->sync();
+}
+
+void Settings::setSvgTiny12Only(bool on)
+{
+    m_qsettings->setValue("svg_tiny12_only", on);
     m_qsettings->sync();
 }
 
 void Settings::setMouseWheelBehavior(MouseWheelBehavior mwb)
 {
-    m_qsettings->setValue("mouse_wheel_behavior", mouseWheelBehaviorToString(mwb));
+    m_qsettings->setValue("mouse_wheel_behavior", QEnumHelper::toString(mwb));
     m_qsettings->sync();
 }
 
-QString Settings::doubleClickBehaviorToString(DoubleClickBehavior dcb)
+void Settings::setInitWindowSizeBehavior(WindowSizeBehavior wsb)
 {
-    static QMap<DoubleClickBehavior, QString> _map {
+    m_qsettings->setValue("init_window_size_behavior", QEnumHelper::toString(wsb));
-        {ActionCloseWindow, "close"},
+    m_qsettings->sync();
-        {ActionMaximizeWindow, "maximize"},
-        {ActionDoNothing, "ignore"}
-    };
-
-    return _map.value(dcb, "close");
 }
 
-QString Settings::mouseWheelBehaviorToString(MouseWheelBehavior mwb)
+void Settings::setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy hidpi)
 {
-    static QMap<MouseWheelBehavior, QString> _map {
+    m_qsettings->setValue("hidpi_scale_factor_behavior", QEnumHelper::toString(hidpi));
-        {ActionZoomImage, "zoom"},
+    m_qsettings->sync();
-        {ActionPrevNextImage, "switch"}
-    };
-
-    return _map.value(mwb, "zoom");
 }
 
-DoubleClickBehavior Settings::stringToDoubleClickBehavior(QString str)
+#if defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
+#include <windows.h>
+// QCoreApplication::applicationDirPath() parses the "applicationDirPath" from arg0, which...
+// 1. rely on a QApplication object instance
+//    but we need to call QGuiApplication::setHighDpiScaleFactorRoundingPolicy() before QApplication get created
+// 2. arg0 is NOT garanteed to be the path of execution
+//    see also: https://stackoverflow.com/questions/383973/is-args0-guaranteed-to-be-the-path-of-execution
+// This function is here mainly for #1.
+QString getApplicationDirPath()
 {
-    static QMap<QString, DoubleClickBehavior> _map {
+    WCHAR buffer[MAX_PATH];
-        {"close", ActionCloseWindow},
+    GetModuleFileNameW(NULL, buffer, MAX_PATH);
-        {"maximize", ActionMaximizeWindow},
+    QString appPath = QString::fromWCharArray(buffer);
-        {"ignore", ActionDoNothing}
-    };
 
-    return _map.value(str, ActionCloseWindow);
+    return appPath.left(appPath.lastIndexOf('\\'));
 }
+#endif // defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
 
-MouseWheelBehavior Settings::stringToMouseWheelBehavior(QString str)
+Settings::Settings(QObject *parent)
-{
+    : QObject(parent)
-    static QMap<QString, MouseWheelBehavior> _map {
-        {"zoom", ActionZoomImage},
-        {"switch", ActionPrevNextImage}
-    };
-
-    return _map.value(str, ActionZoomImage);
-}
-
-Settings::Settings()
-    : QObject(qApp)
 {
     QString configPath;
 
-#ifdef FLAG_PORTABLE_MODE_SUPPORT
+#if defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
-    QString portableConfigDirPath = QDir(QCoreApplication::applicationDirPath()).absoluteFilePath("data");
+    QString portableConfigDirPath = QDir(getApplicationDirPath()).absoluteFilePath("data");
     QFileInfo portableConfigDirInfo(portableConfigDirPath);
     if (portableConfigDirInfo.exists() && portableConfigDirInfo.isDir() && portableConfigDirInfo.isWritable()) {
         // we can use it.
         configPath = portableConfigDirPath;
     }
-#endif // FLAG_PORTABLE_MODE_SUPPORT
+#endif // defined(FLAG_PORTABLE_MODE_SUPPORT) && defined(Q_OS_WIN)
 
-    // %LOCALAPPDATA% under Windows.
     if (configPath.isEmpty()) {
-        configPath = QStandardPaths::writableLocation(QStandardPaths::ConfigLocation);
+        // Should be %LOCALAPPDATA%\<APPNAME> under Windows, ~/.config/<APPNAME> under Linux.
+        configPath = QStandardPaths::writableLocation(QStandardPaths::AppConfigLocation);
     }
 
     m_qsettings = new QSettings(QDir(configPath).absoluteFilePath("config.ini"), QSettings::IniFormat, this);
+
+    qRegisterMetaType<QList<QKeySequence>>();
 }
 

app/settings.h

@@ -1,48 +1,48 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #pragma once
 
 #include <QObject>
 #include <QSettings>
 
-enum DoubleClickBehavior {
-    ActionDoNothing,
-    ActionCloseWindow,
-    ActionMaximizeWindow,
-
-    DCActionStart = ActionDoNothing,
-    DCActionEnd = ActionMaximizeWindow
-};
-
-enum MouseWheelBehavior {
-    ActionZoomImage,
-    ActionPrevNextImage,
-
-    MWActionStart = ActionZoomImage,
-    MWActionEnd = ActionPrevNextImage
-};
-
 class Settings : public QObject
 {
     Q_OBJECT
 public:
+    enum MouseWheelBehavior {
+        Zoom,
+        Switch,
+    };
+    Q_ENUM(MouseWheelBehavior)
+
+    enum WindowSizeBehavior {
+        Maximized,
+        Windowed,
+    };
+    Q_ENUM(WindowSizeBehavior)
+
     static Settings *instance();
 
-    bool stayOnTop();
+    bool showNavigatorView() const;
-    DoubleClickBehavior doubleClickBehavior();
+    bool useLightCheckerboard() const;
-    MouseWheelBehavior mouseWheelBehavior();
+    bool loopGallery() const;
+    bool svgTiny12Only() const;
+    MouseWheelBehavior mouseWheelBehavior() const;
+    WindowSizeBehavior initWindowSizeBehavior() const;
+    Qt::HighDpiScaleFactorRoundingPolicy hiDpiScaleFactorBehavior() const;
 
-    void setStayOnTop(bool on);
+    void setShowNavigatorView(bool on);
-    void setDoubleClickBehavior(DoubleClickBehavior dcb);
+    void setUseLightCheckerboard(bool light);
+    void setLoopGallery(bool on);
+    void setSvgTiny12Only(bool on);
     void setMouseWheelBehavior(MouseWheelBehavior mwb);
-
+    void setInitWindowSizeBehavior(WindowSizeBehavior wsb);
-    static QString doubleClickBehaviorToString(DoubleClickBehavior dcb);
+    void setHiDpiScaleFactorBehavior(Qt::HighDpiScaleFactorRoundingPolicy hidpi);
-    static QString mouseWheelBehaviorToString(MouseWheelBehavior mwb);
-    static DoubleClickBehavior stringToDoubleClickBehavior(QString str);
-    static MouseWheelBehavior stringToMouseWheelBehavior(QString str);
 
 private:
-    Settings();
+    Settings(QObject *parent = nullptr);
-
-    static Settings *m_settings_instance;
 
     QSettings *m_qsettings;
 
@@ -50,4 +50,3 @@ signals:
 
 public slots:
 };
-

app/settingsdialog.cpp

@@ -1,72 +1,145 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #include "settingsdialog.h"
+#include "ui_settingsdialog.h"
 
 #include "settings.h"
 
-#include <QCheckBox>
+#include <QApplication>
-#include <QComboBox>
+#include <QTimer>
-#include <QFormLayout>
 #include <QStringListModel>
+#include <type_traits>
+
+template <typename E, typename = std::enable_if_t<std::is_enum_v<E>>>
+class EnumComboBoxTransformer {
+public:
+    using Pair = QPair<E, QString>;
+    using Pairs = QList<QPair<E, QString>>;
+
+    EnumComboBoxTransformer(Pairs &&pairs) : pairs(std::move(pairs)) {}
+    ~EnumComboBoxTransformer() = default;
+    Q_DISABLE_COPY_MOVE(EnumComboBoxTransformer)
+
+    /// Build Qt model used for QComboBox
+    QStringListModel* buildComboBoxModel(QObject *parent = nullptr) const {
+        QStringList dropDownEntries;
+        for (const auto& pair : std::as_const(this->pairs)) {
+            dropDownEntries.append(pair.second);
+        }
+        return new QStringListModel(dropDownEntries, parent);
+    }
+    /// Convert QComboBox index to enum value.
+    E to_value(int index) const {
+        return this->pairs.at(static_cast<qsizetype>(index)).first;
+    }
+    /// Convert enum value to QComboBox index.
+    int to_index(E value) const {
+        for (qsizetype i = 0; i < pairs.size(); ++i) {
+            if (pairs.at(i).first == value) {
+                return static_cast<int>(i);
+            }
+        }
+        // Value not found
+        throw std::invalid_argument("invalid enum value for finding index");
+    }
+
+private:
+    Pairs pairs;
+};
+
+static EnumComboBoxTransformer<Settings::MouseWheelBehavior, QString> MW_OPTIONS {
+    {
+        { Settings::MouseWheelBehavior::Zoom, QCoreApplication::translate("SettingsDialog", "Zoom in and out") },
+        { Settings::MouseWheelBehavior::Switch, QCoreApplication::translate("SettingsDialog", "View next or previous item") }
+    }
+};
+
+static EnumComboBoxTransformer<Settings::WindowSizeBehavior, QString> IWS_OPTIONS {
+    {
+        { Settings::WindowSizeBehavior::Maximized, QCoreApplication::translate("SettingsDialog", "Maximized") },
+        { Settings::WindowSizeBehavior::Windowed, QCoreApplication::translate("SettingsDialog", "Windowed") }
+    }
+};
+
+static EnumComboBoxTransformer<Qt::HighDpiScaleFactorRoundingPolicy, QString> HIDPI_OPTIONS {
+    {
+        { Qt::HighDpiScaleFactorRoundingPolicy::Round, QCoreApplication::translate("SettingsDialog", "Round (Integer scaling)", "This option means round up for .5 and above") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Ceil, QCoreApplication::translate("SettingsDialog", "Ceil (Integer scaling)", "This option means always round up") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::Floor, QCoreApplication::translate("SettingsDialog", "Floor (Integer scaling)", "This option means always round down") },
+        { Qt::HighDpiScaleFactorRoundingPolicy::PassThrough, QCoreApplication::translate("SettingsDialog", "Follow system (Fractional scaling)", "This option means don't round") }
+    }
+};
 
 SettingsDialog::SettingsDialog(QWidget *parent)
-    : QDialog(parent)
+    : QDialog(parent), ui(new QT_PREPEND_NAMESPACE(Ui::SettingsDialog))
-    , m_stayOnTop(new QCheckBox)
-    , m_doubleClickBehavior(new QComboBox)
-    , m_mouseWheelBehavior(new QComboBox)
 {
-    this->setWindowTitle(tr("Settings"));
+    ui->setupUi(this);
-
-    QFormLayout * settingsForm = new QFormLayout(this);
-
-    static QMap<DoubleClickBehavior, QString> _dc_map {
-        { ActionDoNothing, tr("Do nothing") },
-        { ActionCloseWindow, tr("Close the window") },
-        { ActionMaximizeWindow, tr("Toggle maximize") }
-    };
-
-    static QMap<MouseWheelBehavior, QString> _mw_map {
-        { ActionZoomImage, tr("Zoom in and out") },
-        { ActionPrevNextImage, tr("View next or previous item") }
-    };
-
-    QStringList dcbDropDown;
-    for (int dcb = DCActionStart; dcb <= DCActionEnd; dcb++) {
-        dcbDropDown.append(_dc_map.value(static_cast<DoubleClickBehavior>(dcb)));
-    }
-
-    QStringList mwbDropDown;
-    for (int mwb = MWActionStart; mwb <= MWActionEnd; mwb++) {
-        mwbDropDown.append(_mw_map.value(static_cast<MouseWheelBehavior>(mwb)));
-    }
-
-    settingsForm->addRow(tr("Stay on top when start-up"), m_stayOnTop);
-    settingsForm->addRow(tr("Double-click behavior"), m_doubleClickBehavior);
-    settingsForm->addRow(tr("Mouse wheel behavior"), m_mouseWheelBehavior);
-
-    m_stayOnTop->setChecked(Settings::instance()->stayOnTop());
-    m_doubleClickBehavior->setModel(new QStringListModel(dcbDropDown));
-    DoubleClickBehavior dcb = Settings::instance()->doubleClickBehavior();
-    m_doubleClickBehavior->setCurrentIndex(static_cast<int>(dcb));
-    m_mouseWheelBehavior->setModel(new QStringListModel(mwbDropDown));
-    MouseWheelBehavior mwb = Settings::instance()->mouseWheelBehavior();
-    m_mouseWheelBehavior->setCurrentIndex(static_cast<int>(mwb));
-
-    connect(m_stayOnTop, &QCheckBox::stateChanged, this, [ = ](int state){
-        Settings::instance()->setStayOnTop(state == Qt::Checked);
-    });
-
-    connect(m_doubleClickBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setDoubleClickBehavior(static_cast<DoubleClickBehavior>(index));
-    });
-
-    connect(m_mouseWheelBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
-        Settings::instance()->setMouseWheelBehavior(static_cast<MouseWheelBehavior>(index));
-    });
-
-    this->setMinimumSize(300, 61); // not sure why it complain "Unable to set geometry"
     setWindowFlag(Qt::WindowContextHelpButtonHint, false);
+
+    auto* settings = Settings::instance();
+    ui->m_showNavigatorView->setChecked(Settings::instance()->showNavigatorView());
+    ui->m_useLightCheckerboard->setChecked(settings->useLightCheckerboard());
+    ui->m_loopGallery->setChecked(settings->loopGallery());
+    ui->m_svgTiny12Only->setChecked(settings->svgTiny12Only());
+    ui->m_mouseWheelBehavior->setModel(MW_OPTIONS.buildComboBoxModel(this));
+    Settings::MouseWheelBehavior mwb = settings->mouseWheelBehavior();
+    ui->m_mouseWheelBehavior->setCurrentIndex(MW_OPTIONS.to_index(mwb));
+    ui->m_initWindowSizeBehavior->setModel(IWS_OPTIONS.buildComboBoxModel(this));
+    Settings::WindowSizeBehavior iwsb = settings->initWindowSizeBehavior();
+    ui->m_initWindowSizeBehavior->setCurrentIndex(IWS_OPTIONS.to_index(iwsb));
+    ui->m_hiDpiRoundingPolicyBehavior->setModel(HIDPI_OPTIONS.buildComboBoxModel(this));
+    Qt::HighDpiScaleFactorRoundingPolicy hidpi = settings->hiDpiScaleFactorBehavior();
+    ui->m_hiDpiRoundingPolicyBehavior->setCurrentIndex(HIDPI_OPTIONS.to_index(hidpi));
+
+#if QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+# define QCHECKBOX_CHECKSTATECHANGED QCheckBox::checkStateChanged
+# define QT_CHECKSTATE Qt::CheckState
+#else
+# define QCHECKBOX_CHECKSTATECHANGED QCheckBox::stateChanged
+# define QT_CHECKSTATE int
+#endif // QT_VERSION >= QT_VERSION_CHECK(6, 7, 0)
+
+    connect(ui->m_showNavigatorView, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setShowNavigatorView(state == Qt::Checked);
+    });
+
+    connect(ui->m_useLightCheckerboard, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setUseLightCheckerboard(state == Qt::Checked);
+    });
+
+    connect(ui->m_loopGallery, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setLoopGallery(state == Qt::Checked);
+    });
+
+    connect(ui->m_svgTiny12Only, &QCHECKBOX_CHECKSTATECHANGED, this, [ = ](QT_CHECKSTATE state){
+        Settings::instance()->setSvgTiny12Only(state == Qt::Checked);
+    });
+
+    connect(ui->m_mouseWheelBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setMouseWheelBehavior(MW_OPTIONS.to_value(index));
+    });
+
+    connect(ui->m_initWindowSizeBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setInitWindowSizeBehavior(IWS_OPTIONS.to_value(index));
+    });
+
+    connect(ui->m_hiDpiRoundingPolicyBehavior, QOverload<int>::of(&QComboBox::currentIndexChanged), this, [ = ](int index){
+        Settings::instance()->setHiDpiScaleFactorBehavior(HIDPI_OPTIONS.to_value(index));
+    });
+
+    // YYC MARK:
+    // Use adjustSize() to make sure all ComboBox are expanded by its items.
+    // Because items are added after inserting them into layout.
+    // It is inviable to call this function in ctor because this relys on Qt event system.
+    // It only can be done by QTimer::singleShot().
+    QTimer::singleShot(0, this, [this](){
+        this->adjustSize();
+    });
 }
 
 SettingsDialog::~SettingsDialog()
 {
-
+    delete ui;
 }

app/settingsdialog.h

@@ -1,11 +1,18 @@
+// SPDX-FileCopyrightText: 2022 Gary Wang <wzc782970009@gmail.com>
+//
+// SPDX-License-Identifier: MIT
+
 #ifndef SETTINGSDIALOG_H
 #define SETTINGSDIALOG_H
 
-#include <QObject>
 #include <QDialog>
 
-class QCheckBox;
+QT_BEGIN_NAMESPACE
-class QComboBox;
+namespace Ui {
+class SettingsDialog;
+}
+QT_END_NAMESPACE
+
 class SettingsDialog : public QDialog
 {
     Q_OBJECT
@@ -13,14 +20,8 @@ public:
     explicit SettingsDialog(QWidget *parent = nullptr);
     ~SettingsDialog();
 
-signals:
-
-public slots:
-
 private:
-    QCheckBox * m_stayOnTop = nullptr;
+    QT_PREPEND_NAMESPACE(Ui::SettingsDialog) *ui;
-    QComboBox * m_doubleClickBehavior = nullptr;
-    QComboBox * m_mouseWheelBehavior = nullptr;
 };
 
 #endif // SETTINGSDIALOG_H

app/settingsdialog.ui

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>SettingsDialog</class>
+ <widget class="QDialog" name="SettingsDialog">
+  <property name="windowModality">
+   <enum>Qt::NonModal</enum>
+  </property>
+  <property name="windowTitle">
+   <string>Settings</string>
+  </property>
+  <layout class="QHBoxLayout" name="mainLayout">
+   <item>
+    <widget class="QTabWidget" name="settingsTabs">
+     <property name="currentIndex">
+      <number>0</number>
+     </property>
+     <widget class="QWidget" name="optionsTab">
+      <attribute name="title">
+       <string>Options</string>
+      </attribute>
+      <layout class="QFormLayout" name="settingsForm">
+        <item row="0" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_showNavigatorView">
+          <property name="text">
+           <string>Show navigation view</string>
+          </property>
+         </widget>
+        </item>
+        <item row="1" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_useLightCheckerboard">
+          <property name="text">
+           <string>Use light-color checkerboard</string>
+          </property>
+         </widget>
+        </item>
+        <item row="2" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_loopGallery">
+          <property name="text">
+           <string>Loop the loaded gallery</string>
+          </property>
+         </widget>
+        </item>
+        <item row="3" column="0" colspan="2">
+         <widget class="QCheckBox" name="m_svgTiny12Only">
+          <property name="text">
+           <string>Limit SVG support to SVG Tiny 1.2</string>
+          </property>
+         </widget>
+        </item>
+       <item row="4" column="0">
+         <widget class="QLabel" name="m_mouseWheelBehaviorLabel">
+         <property name="text">
+          <string>Mouse wheel behavior</string>
+         </property>
+        </widget>
+       </item>
+       <item row="4" column="1">
+        <widget class="QComboBox" name="m_mouseWheelBehavior"/>
+       </item>
+       <item row="5" column="0">
+         <widget class="QLabel" name="m_initWindowSizeBehaviorLabel">
+         <property name="text">
+          <string>Default window size</string>
+         </property>
+        </widget>
+       </item>
+       <item row="5" column="1">
+        <widget class="QComboBox" name="m_initWindowSizeBehavior"/>
+       </item>
+       <item row="6" column="0">
+         <widget class="QLabel" name="m_hiDpiRoundingPolicyBehaviorLabel">
+         <property name="text">
+          <string>HiDPI scale factor rounding policy</string>
+         </property>
+        </widget>
+       </item>
+       <item row="6" column="1">
+        <widget class="QComboBox" name="m_hiDpiRoundingPolicyBehavior"/>
+       </item>
+      </layout>
+     </widget>
+    </widget>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>

app/toolbutton.cpp

@@ -1,28 +0,0 @@
-#include "toolbutton.h"
-
-#include "opacityhelper.h"
-
-#include <QPainter>
-#include <QGraphicsOpacityEffect>
-#include <QPropertyAnimation>
-
-ToolButton::ToolButton(bool hoverColor, QWidget *parent)
-    : QPushButton(parent)
-    , m_opacityHelper(new OpacityHelper(this))
-{
-    setFlat(true);
-    QString qss = "QPushButton {"
-                  "background: transparent;"
-                  "}";
-    if (hoverColor) {
-        qss += "QPushButton:hover {"
-               "background: red;"
-               "}";
-    }
-    setStyleSheet(qss);
-}
-
-void ToolButton::setOpacity(qreal opacity, bool animated)
-{
-    m_opacityHelper->setOpacity(opacity, animated);
-}

app/toolbutton.h

@@ -1,20 +0,0 @@
-#ifndef TOOLBUTTON_H
-#define TOOLBUTTON_H
-
-#include <QPushButton>
-
-class OpacityHelper;
-class ToolButton : public QPushButton
-{
-    Q_OBJECT
-public:
-    ToolButton(bool hoverColor = false, QWidget * parent = nullptr);
-
-public slots:
-    void setOpacity(qreal opacity, bool animated = true);
-
-private:
-    OpacityHelper * m_opacityHelper;
-};
-
-#endif // TOOLBUTTON_H

appveyor.yml

@@ -1,140 +0,0 @@
-image:
-  - Visual Studio 2019
-environment:
-  CMAKE_INSTALL_ROOT: C:\projects\cmake
-  LIBZ: C:\projects\zlib
-  LIBEXPAT: C:\projects\libexpat
-  LIBAVIF: C:\projects\libavif
-  LIBEXIV2: C:\projects\exiv2
-  matrix:
-    - build_name: mingw81_64_qt5_15_2
-      QTPATH: C:\Qt\5.15.2\mingw81_64
-      MINGW64: C:\Qt\Tools\mingw810_64
-
-install:
-  - mkdir %CMAKE_INSTALL_ROOT%
-  - mkdir %LIBZ%
-  - mkdir %LIBEXPAT%
-  - mkdir %LIBAVIF%
-  - mkdir %LIBEXIV2%
-  - cd %APPVEYOR_BUILD_FOLDER%
-  - git submodule update --init --recursive
-  - set PATH=%PATH%;%CMAKE_INSTALL_ROOT%;%QTPATH%\bin;%MINGW64%\bin
-  - set CC=%MINGW64%\bin\gcc.exe
-  - set CXX=%MINGW64%\bin\g++.exe
-
-build_script:
-# prepare
-  - mkdir 3rdparty
-  - cinst ninja
-# download and install zlib for KArchive
-  - cd %LIBZ%
-  - curl -fsSL -o zlib1211.zip https://zlib.net/zlib1211.zip
-  - 7z x zlib1211.zip -y
-  - cd zlib-1.2.11
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT%
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install ECM so we can build KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/extra-cmake-modules.git
-  - git rev-parse HEAD
-  - cd extra-cmake-modules
-  - cmake -G "Ninja" . -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT% -DBUILD_TESTING=OFF
-  - cmake --build .
-  - cmake --build . --target install
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install AOM for libavif AV1 decoding support...
-  - cd 3rdparty
-  - git clone -b v3.1.2 --depth 1 https://aomedia.googlesource.com/aom
-  - cd aom
-  - mkdir build.libavif
-  - cd build.libavif
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT% -DENABLE_DOCS=OFF -DBUILD_SHARED_LIBS=ON -DAOM_TARGET_CPU=generic -DENABLE_TESTS=OFF -DENABLE_TESTDATA=OFF -DENABLE_TOOLS=OFF -DENABLE_EXAMPLES=0
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install libavif for avif format support of KImageFormats
-  - cd %LIBAVIF%
-  - curl -fsSL -o libavif-v0_9_0.zip https://github.com/AOMediaCodec/libavif/archive/v0.9.0.zip
-  - 7z x libavif-v0_9_0.zip -y
-  - cd libavif-0.9.0
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT% -DAVIF_CODEC_AOM=ON
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install KArchive for kra format support of KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/karchive.git
-  - git rev-parse HEAD
-  - cd karchive
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT%
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# build libexpat for libexiv2
-  - cd %LIBEXPAT%
-  - curl -fsSL -o R_2_4_1.zip https://github.com/libexpat/libexpat/archive/R_2_4_1.zip
-  - 7z x R_2_4_1.zip -y
-  - cd libexpat-R_2_4_1/expat/
-  - cmake -G "Ninja" . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT% -DEXPAT_BUILD_EXAMPLES=OFF -DEXPAT_BUILD_TESTS=OFF -DEXPAT_BUILD_TOOLS=OFF
-  - cmake --build . --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# build libexiv2
-  - cd %LIBEXIV2%
-  - curl -fsSL -o v0.27.4.zip https://github.com/Exiv2/exiv2/archive/v0.27.4.zip
-  - 7z x v0.27.4.zip -y
-  - cd exiv2-0.27.4
-  - cmake -G "Ninja" . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=%CMAKE_INSTALL_ROOT% -DEXIV2_BUILD_SAMPLES=OFF -DEXIV2_ENABLE_WIN_UNICODE=ON
-  - cmake --build . --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# install KImageFormats
-  - cd 3rdparty
-  - git clone -q https://invent.kde.org/frameworks/kimageformats.git
-  - git rev-parse HEAD
-  - cd kimageformats
-  - mkdir build
-  - cd build
-  - cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DKDE_INSTALL_QTPLUGINDIR=%QTPATH%\plugins
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-  - cd %APPVEYOR_BUILD_FOLDER%
-# finally...
-  - mkdir build
-  - cd build
-  - cmake .. -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_MAKE_PROGRAM=mingw32-make -DCMAKE_INSTALL_PREFIX='%cd%'
-  - cmake --build . --config Release
-  - cmake --build . --config Release --target install/strip
-# fixme: I don't know how to NOT make the binary installed to the ./bin/ folder...
-  - cd bin
-  - copy %APPVEYOR_BUILD_FOLDER%\LICENSE .
-  - copy %CMAKE_INSTALL_ROOT%\lib\libaom.dll
-  - copy %CMAKE_INSTALL_ROOT%\bin\libexpat.dll
-  - copy %CMAKE_INSTALL_ROOT%\bin\libexiv2.dll
-  - copy %CMAKE_INSTALL_ROOT%\bin\libavif.dll
-  - copy %CMAKE_INSTALL_ROOT%\bin\libzlib.dll
-  - copy C:\projects\cmake\bin\libKF5Archive.dll .
-  - windeployqt --verbose=2 --no-quick-import --no-translations --no-opengl-sw --no-angle --no-system-d3d-compiler .\ppic.exe
-# copy 3rdparty licenses for the libs we vendored for windows...
-  - mkdir licenses
-  - cd licenses
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\aom\LICENSE License.aom.txt
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\karchive\LICENSES\LGPL-2.0-or-later.txt License.KArchive.txt
-  - copy %APPVEYOR_BUILD_FOLDER%\3rdparty\kimageformats\LICENSES\LGPL-2.1-or-later.txt License.kimageformats.txt
-  - copy %LIBEXPAT%\libexpat-R_2_4_1\expat\COPYING License.expat.txt
-  - copy %LIBAVIF%\libavif-0.9.0\LICENSE License.libavif.txt
-  - copy %LIBEXIV2%\exiv2-0.27.4\COPYING License.exiv2.txt
-# TODO: Qt, zlib
-  - cd ..
-# for debug..
-  - tree /f
-
-artifacts:
-  - path: build\bin

assets/htmls/about.html

@@ -0,0 +1,29 @@
+<center>
+    <p>
+        <img width='128' height='128' src=':/icons/app-icon.png'/>
+        <br/>
+        <!-- Application name -->
+        <span>%1</span>
+        <br/>
+        <!-- Version info -->
+        <span>%2</span>
+    </p>
+    <hr/>
+    <p>
+        <!-- Upstream author and fork author -->
+        <span>%3</span><span>:&nbsp;</span><a href='https://github.com/BLumia'>@BLumia</a>
+        <br/>
+        <span>%4</span><span>:&nbsp;</span><a href='https://github.com/yyc12345'>@yyc12345</a>
+        <br/>
+        <!-- Icon author -->
+        <span>%5</span><span>:&nbsp;</span><a href='https://github.com/Lovelyblack'>@Lovelyblack</a>
+    </p>
+    <hr/>
+    <p>
+        <!-- Built Qt version info -->
+        <span>%6</span>
+        <br/>
+        <!-- Source code -->
+        <span>%7</span><span>:&nbsp;</span><a href='https://github.com/BLumia/pineapple-pictures'>GitHub</a>
+    </p>
+</center>

assets/htmls/help.html

@@ -0,0 +1,29 @@
+<!-- General help -->
+<h1 align='center'>%1</h1>
+<ul>
+    <li>
+        <span>%2</span>
+        <ul>
+            <li>%3</li>
+            <li>%4</li>
+        </ul>
+    </li>
+    <li>%5</li>
+    <li>%6</li>
+</ul>
+<hr/>
+<!-- Context menu option help -->
+<h1 align='center'>%7</h1>
+<!-- Context menu option list -->
+<ul>
+    <li>
+        <b>%8</b><span>:</span>
+        <br/>
+        <span>%9</span>
+    </li>
+    <li>
+        <b>%10</b><span>:</span>
+        <br/>
+        <span>%11</span>
+    </li>
+</ul>

assets/htmls/license.html

@@ -0,0 +1,29 @@
+<!-- License -->
+<h1 align='center'><b>%1</b></h1>
+<p>%2</p>
+<hr/>
+<!-- VErbatime license -->
+<h1 align='center'><b>%3</b></h1>
+<pre>
+Expat/MIT License
+
+Copyright &copy; 2026 BLumia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+</pre>

assets/htmls/special-thanks.html

@@ -0,0 +1,32 @@
+<!-- Contributor title -->
+<h1 align='center'>%1</h1>
+<!-- Contributor list -->
+<a href='https://github.com/BLumia/pineapple-pictures/graphs/contributors'>%2</a>
+<!-- The message to thank these contributors -->
+<p>%3</p>
+
+<!-- Translator title -->
+<h1 align='center'>%4</h1>
+<!-- The message to thank these translators -->
+<p>%5</p>
+<ul>
+<li><u>Catalan</u>: Toni Estévez</li>
+<li><u>Chinese (Simplified)</u>: Percy Hong</li>
+<li><u>Dutch</u>: Heimen Stoffels</li>
+<li><u>French</u>: J. Lavoie, K. Herbert, Maxime Leroy</li>
+<li><u>German</u>: K. Herbert, J. Lavoie, sal0max</li>
+<li><u>Indonesian</u>: liimee, Reza Almanda</li>
+<li><u>Italian</u>: albanobattistella</li>
+<li><u>Japanese</u>: Black Cat, mmahhi, Percy Hong</li>
+<li><u>Korean</u>: VenusGirl</li>
+<li><u>Norwegian Bokmål</u>: Allan Nordhøy, ovl-1</li>
+<li><u>Punjabi (Pakistan)</u>: bgo-eiu</li>
+<li><u>Russian</u>: Sergey Shornikov, Artem, Andrey</li>
+<li><u>Sinhala</u>: HelaBasa</li>
+<li><u>Slovenian</u>: Andrej Poženel - SDT</li>
+<li><u>Spanish</u>: Toni Estévez, Génesis Toxical, William(ѕ)ⁿ, gallegonovato</li>
+<li><u>Tamil</u>: தமிழ்நேரம் (TamilNeram)</li>
+<li><u>Turkish</u>: E-Akcaer, Oğuz Ersen, Sabri Ünal</li>
+<li><u>Ukrainian</u>: Dan, volkov, Сергій</li>
+<li><u>Vietnamese</u>: Loc Huynh</li>
+</ul>

assets/htmls/third-party-libs.html

@@ -0,0 +1,15 @@
+<!-- Title -->
+<h1 align='center'><b>%1</b></h1>
+<!-- List intro message -->
+<p>%2</p>
+<p>%3</p>
+<ul>
+    <li>
+        <a href='https://www.qt.io/'>Qt</a><span>: </span>
+        <span>GPLv2 + GPLv3 + LGPLv2.1 + LGPLv3</span>
+    </li>
+    <li style="display: none;">
+        <a href='https://www.exiv2.org/'>Exiv2</a><span>: </span>
+        <span>GPLv2</span>
+    </li>
+</ul>

assets/icons/go-next.svg

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 75 75" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;">
-    <g transform="matrix(1,0,0,1,-119,-102)">
-        <g id="go-next" transform="matrix(1.25,0,0,1.44231,119,-7.61538)">
-            <rect x="0" y="76" width="60" height="52" style="fill:none;"/>
-            <g transform="matrix(0.8,0,0,0.693333,0.260244,25.056)">
-                <circle cx="37.175" cy="110.977" r="33.175" style="fill-opacity:0.15;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g id="path867" transform="matrix(0.8,0,0,0.693333,1.80436,76.0055)">
-                <path d="M31.578,26.175L42.911,37.508L31.578,48.809" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/go-previous.svg

@@ -1,15 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 75 75" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;">
-    <g transform="matrix(1,0,0,1,-39,-102)">
-        <g id="go-previous" transform="matrix(1.25,0,0,1.44231,39,-7.61538)">
-            <rect x="0" y="76" width="60" height="52" style="fill:none;"/>
-            <g transform="matrix(0.8,0,0,0.693333,0.260244,25.056)">
-                <circle cx="37.175" cy="110.977" r="33.175" style="fill-opacity:0.15;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g id="path867" transform="matrix(0.8,0,0,0.693333,-1.8205,76.0055)">
-                <path d="M43.442,26.175L32.109,37.508L43.442,48.809" style="fill:none;fill-rule:nonzero;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/object-rotate-right.svg

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,-7.10543e-15)">
-        <g id="object-rotate-right" transform="matrix(1,0,0,1,74,7.10543e-15)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-1,-0.275147)">
-                <g transform="matrix(1,0,0,1,-74,-7.10543e-15)">
-                    <path d="M100,18C100,22.967 95.967,27 91,27C86.033,27 82,22.967 82,18C82,13.033 86.033,9 91,9" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-                <g transform="matrix(0.984136,-0.177418,0.177418,0.984136,-74.2676,16.4198)">
-                    <path d="M89,13L93,9L89,5" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/view-background-checkerboard.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,0,-37)">
-        <g id="view-background-checkerboard" transform="matrix(1,0,0,1,0,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g id="rect814" transform="matrix(0.964431,0,0,0.907545,0.187581,-988.266)">
-                <rect x="6.027" y="1095.56" width="10.369" height="11.019" style="fill:white;fill-opacity:0.87;"/>
-            </g>
-            <g id="rect814-4" transform="matrix(0.984615,0,0,0.898704,-0.143354,-978.502)">
-                <rect x="16.396" y="1106.6" width="10.156" height="11.127" style="fill:white;fill-opacity:0.87;"/>
-            </g>
-            <g id="rect814-2" transform="matrix(0.963684,0,0,0.898697,0.199828,-978.495)">
-                <rect x="6.019" y="1106.6" width="10.377" height="11.127" style="fill:white;fill-opacity:0.07;"/>
-            </g>
-            <g id="rect814-2-6" transform="matrix(0.980558,0,0,0.898693,-0.0768322,-978.47)">
-                <rect x="16.396" y="1095.45" width="10.198" height="11.127" style="fill:white;fill-opacity:0.07;"/>
-            </g>
-            <g transform="matrix(1,0,0,0.952381,-74,-34)">
-                <rect x="80" y="42" width="20" height="21" style="fill:none;stroke:white;stroke-width:2.05px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/view-fullscreen.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-37,-37)">
-        <g id="view-fullscreen" transform="matrix(1,0,0,1,37,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-36,-37)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(-1,1.22465e-16,1.22465e-16,1,68,-37)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,-2.46519e-32,-2.46519e-32,-1,-36,69)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1.11111,0,0,1.14286,-42.3333,-42.8571)">
-                <rect x="48" y="48" width="9" height="7" style="fill:none;stroke:white;stroke-width:1.77px;"/>
-            </g>
-            <g transform="matrix(-1,-1.22465e-16,1.22465e-16,-1,68,69)">
-                <path d="M42,49L42,43L48,43" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/window-close.svg

@@ -1,71 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="32"
-   height="32"
-   viewBox="0 0 8.4666665 8.4666669"
-   version="1.1"
-   id="svg8"
-   inkscape:version="0.92.4 (5da689c313, 2019-01-14)"
-   sodipodi:docname="window-close.svg">
-  <defs
-     id="defs2" />
-  <sodipodi:namedview
-     id="base"
-     pagecolor="#000000"
-     bordercolor="#666666"
-     borderopacity="1.0"
-     inkscape:pageopacity="0.69803922"
-     inkscape:pageshadow="2"
-     inkscape:zoom="22.627417"
-     inkscape:cx="19.29838"
-     inkscape:cy="15.79404"
-     inkscape:document-units="px"
-     inkscape:current-layer="layer1"
-     showgrid="false"
-     units="px"
-     inkscape:pagecheckerboard="true"
-     inkscape:window-width="1920"
-     inkscape:window-height="1001"
-     inkscape:window-x="-9"
-     inkscape:window-y="-9"
-     inkscape:window-maximized="1" />
-  <metadata
-     id="metadata5">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title />
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(0,-288.5333)">
-    <path
-       style="fill:none;stroke:#ffffff;stroke-width:0.396875;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
-       d="m 2.100237,290.55098 4.3234589,4.22265"
-       id="path817"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
-    <path
-       style="fill:none;stroke:#ffffff;stroke-width:0.396875;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
-       d="m 2.099406,294.78651 4.3414732,-4.24185"
-       id="path819"
-       inkscape:connector-curvature="0"
-       sodipodi:nodetypes="cc" />
-  </g>
-</svg>

assets/icons/zoom-in.svg

@@ -1,17 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <rect id="zoom-in" x="0" y="0" width="32" height="32" style="fill:none;"/>
-    <g id="zoom-in1" serif:id="zoom-in">
-        <g>
-            <g transform="matrix(1,0,0,1,-1,0)">
-                <circle cx="16" cy="15" r="9" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(0.8,0.8,-0.8,0.8,27.6,-17.2)">
-                <path d="M21,28L26,28" style="fill:none;stroke:white;stroke-width:2.65px;"/>
-            </g>
-            <path d="M11,15L19,15" style="fill:none;stroke:white;stroke-width:2px;"/>
-            <path d="M15,11L15,19" style="fill:none;stroke:white;stroke-width:2px;"/>
-        </g>
-    </g>
-</svg>

assets/icons/zoom-original.svg

@@ -1,24 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:square;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,-37)">
-        <g id="zoom-original" transform="matrix(1,0,0,1,74,37)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g transform="matrix(1,0,0,1,-73,-37)">
-                <path d="M85,57L85,49L84,49" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-74,-37)">
-                <rect x="89" y="50" width="2" height="2" style="fill:white;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-74,-33)">
-                <rect x="89" y="50" width="2" height="2" style="fill:white;"/>
-            </g>
-            <g transform="matrix(1,0,0,1,-64,-37)">
-                <path d="M85,57L85,49L84,49" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-            <g transform="matrix(1,0,0,0.952381,-74,-34)">
-                <rect x="80" y="42" width="20" height="21" style="fill:none;stroke:white;stroke-width:2.05px;stroke-linecap:round;stroke-linejoin:round;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/icons/zoom-out.svg

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg width="100%" height="100%" viewBox="0 0 32 32" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:1.5;">
-    <g transform="matrix(1,0,0,1,-74,0)">
-        <g id="zoom-out" transform="matrix(1,0,0,1,74,0)">
-            <rect x="0" y="0" width="32" height="32" style="fill:none;"/>
-            <g>
-                <g transform="matrix(1,0,0,1,-1,0)">
-                    <circle cx="16" cy="15" r="9" style="fill:none;stroke:white;stroke-width:2px;"/>
-                </g>
-                <g transform="matrix(0.8,0.8,-0.8,0.8,27.6,-17.2)">
-                    <path d="M21,28L26,28" style="fill:none;stroke:white;stroke-width:2.65px;"/>
-                </g>
-                <path d="M11,15L19,15" style="fill:none;stroke:white;stroke-width:2px;"/>
-            </g>
-        </g>
-    </g>
-</svg>

assets/pineapple-pictures.rc

@@ -1,17 +0,0 @@
-IDI_ICON1               ICON    DISCARDABLE     "icons/app-icon.ico"
-1               VERSIONINFO
-BEGIN
-    BLOCK "StringFileInfo"
-    BEGIN
-        BLOCK "040904E4"
-        BEGIN
-            VALUE "FileDescription", "Pineapple Pictures - Image Viewer"
-            VALUE "LegalCopyright", "MIT/Expat License - Copyright (C) 2020 Gary Wang"
-            VALUE "ProductName", "Pineapple Pictures"
-        END
-    END
-    BLOCK "VarFileInfo"
-    BEGIN
-        VALUE "Translation", 0x409, 1200
-    END
-END

assets/plain/translators.html

@@ -1,11 +0,0 @@
-<ul>
-<li><u>Chinese (Simplified)</u>: Percy Hong</li>
-<li><u>Dutch</u>: Heimen Stoffels</li>
-<li><u>French</u>: J. Lavoie, K. Herbert, Maxime Leroy</li>
-<li><u>German</u>: K. Herbert, J. Lavoie</li>
-<li><u>Indonesian</u>: liimee</li>
-<li><u>Norwegian Bokmål</u>: Allan Nordhøy</li>
-<li><u>Russian</u>: Sergey Shornikov, Artem, Andrey</li>
-<li><u>Sinhala</u>: HelaBasa</li>
-<li><u>Spanish</u>: William(ѕ)ⁿ</li>
-</ul>

assets/resources.qrc

@@ -1,15 +1,23 @@
 <RCC>
     <qresource prefix="/">
-        <file>icons/zoom-in.svg</file>
+        <!-- In-app icon resources -->
-        <file>icons/zoom-out.svg</file>
+        <file>icons/app-icon.png</file>
-        <file>icons/view-fullscreen.svg</file>
+        <file>icons/image-info.png</file>
-        <file>icons/zoom-original.svg</file>
+        <file>icons/fit-to-screen.png</file>
-        <file>icons/object-rotate-right.svg</file>
+        <file>icons/fit-to-size.png</file>
-        <file>icons/view-background-checkerboard.svg</file>
+        <file>icons/zoom-in.png</file>
-        <file>icons/app-icon.svg</file>
+        <file>icons/zoom-out.png</file>
-        <file>icons/window-close.svg</file>
+        <file>icons/rotate-left.png</file>
-        <file>icons/go-next.svg</file>
+        <file>icons/rotate-right.png</file>
-        <file>icons/go-previous.svg</file>
+        <file>icons/go-next.png</file>
-        <file>plain/translators.html</file>
+        <file>icons/go-previous.png</file>
+        <file>icons/flip-horizontal.png</file>
+        <file>icons/flip-vertical.png</file>
+        <!-- HTML resources -->
+        <file>htmls/help.html</file>
+        <file>htmls/about.html</file>
+        <file>htmls/special-thanks.html</file>
+        <file>htmls/license.html</file>
+        <file>htmls/third-party-libs.html</file>
     </qresource>
 </RCC>

cmake/FindLibExiv2.cmake

@@ -1,96 +0,0 @@
-#.rst:
-# FindLibExiv2
-# ------------
-#
-# Try to find the Exiv2 library.
-#
-# This will define the following variables:
-#
-# ``LibExiv2_FOUND``
-#     True if (the requested version of) Exiv2 is available
-#
-# ``LibExiv2_VERSION``
-#     The version of Exiv2
-#
-# ``LibExiv2_INCLUDE_DIRS``
-#     The include dirs of Exiv2 for use with target_include_directories()
-#
-# ``LibExiv2_LIBRARIES``
-#     The Exiv2 library for use with target_link_libraries().
-#     This can be passed to target_link_libraries() instead of
-#     the ``LibExiv2::LibExiv2`` target
-#
-# If ``LibExiv2_FOUND`` is TRUE, it will also define the following imported
-# target:
-#
-# ``LibExiv2::LibExiv2``
-#     The Exiv2 library
-#
-# In general we recommend using the imported target, as it is easier to use.
-# Bear in mind, however, that if the target is in the link interface of an
-# exported library, it must be made available by the package config file.
-#
-# Since 5.53.0.
-#
-#=============================================================================
-# SPDX-FileCopyrightText: 2018 Christophe Giboudeaux <christophe@krop.fr>
-# SPDX-FileCopyrightText: 2010 Alexander Neundorf <neundorf@kde.org>
-# SPDX-FileCopyrightText: 2008 Gilles Caulier <caulier.gilles@gmail.com>
-#
-# SPDX-License-Identifier: BSD-3-Clause
-#=============================================================================
-
-find_package(PkgConfig QUIET)
-pkg_check_modules(PC_EXIV2 QUIET exiv2)
-
-find_path(LibExiv2_INCLUDE_DIRS NAMES exiv2/exif.hpp
-    HINTS ${PC_EXIV2_INCLUDEDIR}
-)
-
-find_library(LibExiv2_LIBRARIES NAMES exiv2 libexiv2
-    HINTS ${PC_EXIV2_LIBRARY_DIRS}
-)
-
-set(LibExiv2_VERSION ${PC_EXIV2_VERSION})
-
-if(NOT LibExiv2_VERSION AND DEFINED LibExiv2_INCLUDE_DIRS)
-    # With exiv >= 0.27, the version #defines are in exv_conf.h instead of version.hpp
-    foreach(_exiv2_version_file "version.hpp" "exv_conf.h")
-        if(EXISTS "${LibExiv2_INCLUDE_DIRS}/exiv2/${_exiv2_version_file}")
-            file(READ "${LibExiv2_INCLUDE_DIRS}/exiv2/${_exiv2_version_file}" _exiv_version_file_content)
-            string(REGEX MATCH "#define EXIV2_MAJOR_VERSION[ ]+\\([0-9]+\\)" EXIV2_MAJOR_VERSION_MATCH ${_exiv_version_file_content})
-            string(REGEX MATCH "#define EXIV2_MINOR_VERSION[ ]+\\([0-9]+\\)" EXIV2_MINOR_VERSION_MATCH ${_exiv_version_file_content})
-            string(REGEX MATCH "#define EXIV2_PATCH_VERSION[ ]+\\([0-9]+\\)" EXIV2_PATCH_VERSION_MATCH ${_exiv_version_file_content})
-            if(EXIV2_MAJOR_VERSION_MATCH)
-                string(REGEX REPLACE ".*_MAJOR_VERSION[ ]+\\((.*)\\)" "\\1" EXIV2_MAJOR_VERSION ${EXIV2_MAJOR_VERSION_MATCH})
-                string(REGEX REPLACE ".*_MINOR_VERSION[ ]+\\((.*)\\)" "\\1" EXIV2_MINOR_VERSION ${EXIV2_MINOR_VERSION_MATCH})
-                string(REGEX REPLACE ".*_PATCH_VERSION[ ]+\\((.*)\\)" "\\1"  EXIV2_PATCH_VERSION  ${EXIV2_PATCH_VERSION_MATCH})
-            endif()
-        endif()
-    endforeach()
-
-    set(LibExiv2_VERSION "${EXIV2_MAJOR_VERSION}.${EXIV2_MINOR_VERSION}.${EXIV2_PATCH_VERSION}")
-endif()
-
-include(FindPackageHandleStandardArgs)
-find_package_handle_standard_args(LibExiv2
-    FOUND_VAR LibExiv2_FOUND
-    REQUIRED_VARS  LibExiv2_LIBRARIES LibExiv2_INCLUDE_DIRS
-    VERSION_VAR  LibExiv2_VERSION
-)
-
-mark_as_advanced(LibExiv2_INCLUDE_DIRS LibExiv2_LIBRARIES)
-
-if(LibExiv2_FOUND AND NOT TARGET LibExiv2::LibExiv2)
-    add_library(LibExiv2::LibExiv2 UNKNOWN IMPORTED)
-    set_target_properties(LibExiv2::LibExiv2 PROPERTIES
-        IMPORTED_LOCATION "${LibExiv2_LIBRARIES}"
-        INTERFACE_INCLUDE_DIRECTORIES "${LibExiv2_INCLUDE_DIRS}"
-    )
-endif()
-
-include(FeatureSummary)
-set_package_properties(LibExiv2 PROPERTIES
-    URL "https://www.exiv2.org"
-    DESCRIPTION "Image metadata support"
-)

dist/MacOSXBundleInfo.plist.in

@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>English</string>
+    <key>CFBundleExecutable</key>
+    <string>${MACOSX_BUNDLE_EXECUTABLE_NAME}</string>
+    <key>CFBundleGetInfoString</key>
+    <string>${MACOSX_BUNDLE_INFO_STRING}</string>
+    <key>CFBundleIconFile</key>
+    <string>${MACOSX_BUNDLE_ICON_FILE}</string>
+    <key>CFBundleIdentifier</key>
+    <string>${MACOSX_BUNDLE_GUI_IDENTIFIER}</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleLongVersionString</key>
+    <string>${MACOSX_BUNDLE_LONG_VERSION_STRING}</string>
+    <key>CFBundleName</key>
+    <string>${MACOSX_BUNDLE_BUNDLE_NAME}</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>${MACOSX_BUNDLE_SHORT_VERSION_STRING}</string>
+    <key>CFBundleSignature</key>
+    <string>????</string>
+    <key>CFBundleVersion</key>
+    <string>${MACOSX_BUNDLE_BUNDLE_VERSION}</string>
+    <key>CSResourcesFileMapped</key>
+    <true/>
+    <key>NSHumanReadableCopyright</key>
+    <string>${MACOSX_BUNDLE_COPYRIGHT}</string>
+    <!-- FIXME: this list can't be automatically generated by Qt's CMake API, don't know why. -->
+    <key>CFBundleLocalizations</key>
+    <array>
+        <string>en</string>
+        <string>ca</string>
+        <string>de</string>
+        <string>es</string>
+        <string>fr</string>
+        <string>id</string>
+        <string>it</string>
+        <string>ja</string>
+        <string>ko</string>
+        <string>nb_NO</string>
+        <string>nl</string>
+        <string>pa_PK</string>
+        <string>ru</string>
+        <string>si</string>
+        <string>ta</string>
+        <string>tr</string>
+        <string>uk</string>
+        <string>zh_CN</string>
+    </array>
+    <key>CFBundleDocumentTypes</key>
+    <array>
+        <!-- JPEG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>JPEG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>jpg</string>
+                <string>jpeg</string>
+                <string>jfif</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/jpeg</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- PNG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>PNG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>png</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/png</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- WebP -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>WebP Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>webp</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/webp</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- GIF -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>GIF Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>gif</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/gif</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+        <!-- SVG -->
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>SVG Image</string>
+            <key>CFBundleTypeExtensions</key>
+            <array>
+                <string>svg</string>
+            </array>
+            <key>CFBundleTypeMIMETypes</key>
+            <array>
+                <string>image/svg+xml</string>
+            </array>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+        </dict>
+    </array>
+</dict>
+</plist>

dist/appstream/net.blumia.pineapple-pictures.metainfo.xml

@@ -1,19 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<component type="desktop-application">
-  <id>net.blumia.pineapple-pictures</id>
-  <metadata_license>CC0-1.0</metadata_license>
-  <project_license>MIT</project_license>
-  <name>Pineapple Pictures</name>
-  <name xml:lang="zh-CN">菠萝看图</name>
-  <summary>Image Viewer</summary>
-  <summary xml:lang="zh-CN">图像查看器</summary>
-  <description>
-    <p>Pineapple Pictures is a lightweight and easy-to-use image viewer that comes with a handy navigation thumbnail when zoom-in, and doesn't contain any image management support.</p>
-    <p xml:lang="zh-CN">菠萝看图是一个轻量级易用的图像查看器，在图片放大时提供了方便的鸟瞰导航功能，且不包含任何图片管理功能。</p>
-  </description>
-  <url type="homepage">https://github.com/BLumia/pineapple-pictures</url>
-  <url type="bugtracker">https://github.com/BLumia/pineapple-pictures/issues</url>
-  <provides>
-    <binary>ppic</binary>
-  </provides>
-</component>