macOS support: fix DXT rendering, crash-on-quit, Finder dialog, and CI

- Add built-in software DXT1/DXT3/DXT5 decoder replacing broken
  Compressonator decompression on ARM64 (works on all platforms)
- Fix crash-on-quit from use-after-free in QTextDocument::destroyed lambda
- Fix Finder file dialog by adding valid CFBundleIdentifier to Info.plist
- Fix long VTF path text blocking image preview with word wrap
- Fix false "DXT compression unavailable" warning for non-DXT formats
- Add macOS Compressonator build-from-source in CI for DXT compression
- Fix CI: clone GLM dep, patch OpenCV requirement, drop macOS Qt arch
- Update Compressonator header to match Yellow-Dog-Man fork ABI

Author: programmer1o1

.github/workflows/ci.yml

@@ -25,7 +25,7 @@ jobs:
         run: >-
           cmake -S . -B build
           -DCMAKE_BUILD_TYPE=Release
-          -DVTFLIB_USE_COMPRESSONATOR=${{ runner.os == 'Linux' && 'ON' || 'OFF' }}
+          -DVTFLIB_USE_COMPRESSONATOR=${{ runner.os != 'Windows' && 'ON' || 'OFF' }}
           -DVTFCMD_IMAGE_BACKEND=stb
           -DBUILD_VTFEDIT_QT=OFF
 
@@ -65,7 +65,7 @@ jobs:
         with:
           version: 6.8.3
           cache: true
-          arch: ${{ runner.os == 'Windows' && 'win64_msvc2022_64' || runner.os == 'macOS' && 'clang_64' || 'linux_gcc_64' }}
+          arch: ${{ runner.os == 'Windows' && 'win64_msvc2022_64' || runner.os == 'Linux' && 'linux_gcc_64' || '' }}
 
       - name: Install additional Linux dependencies
         if: runner.os == 'Linux'
@@ -157,6 +157,13 @@ jobs:
             -always-overwrite \
             -verbose=2
 
+          # macdeployqt copies frameworks but may not fix LC_RPATH in the binary.
+          # Add the standard rpath so @rpath references resolve at runtime.
+          exe=dist/vtfeditqt.app/Contents/MacOS/vtfeditqt
+          if ! otool -l "$exe" | grep -A2 LC_RPATH | grep -q '@executable_path/../Frameworks'; then
+            install_name_tool -add_rpath @executable_path/../Frameworks "$exe"
+          fi
+
       - name: Add README
         shell: bash
         run: |

VTFEdit/CMakeLists.txt

@@ -54,6 +54,14 @@ add_executable(vtfeditqt
     MainWindow.cpp
 )
 
+set_target_properties(vtfeditqt PROPERTIES
+    MACOSX_BUNDLE_BUNDLE_NAME "QTFEdit"
+    MACOSX_BUNDLE_GUI_IDENTIFIER "com.qtfedit.vtfeditqt"
+    MACOSX_BUNDLE_BUNDLE_VERSION "${PROJECT_VERSION}"
+    MACOSX_BUNDLE_SHORT_VERSION_STRING "${PROJECT_VERSION}"
+    MACOSX_BUNDLE_INFO_STRING "QTFEdit - VTF/VMT Editor"
+)
+
 target_link_libraries(vtfeditqt
     PRIVATE
         vtflib

VTFEdit/CreateVtfDialog.cpp

@@ -110,7 +110,7 @@ CreateVtfDialog::CreateVtfDialog(QWidget *parent) : QDialog(parent) {
 
     // Disable formats we can’t encode (DXT typically requires a compressor; P8 is not supported).
     if(auto *model = qobject_cast<QStandardItemModel *>(format_->model())) {
-        bool anyDisabled = false;
+        bool dxtDisabled = false;
         for(int i = 0; i < format_->count(); ++i) {
             const auto fmt = static_cast<VTFImageFormat>(format_->itemData(i).toInt());
             const bool canEncode = vtflibCanEncode(fmt);
@@ -120,14 +120,14 @@ CreateVtfDialog::CreateVtfDialog(QWidget *parent) : QDialog(parent) {
                     if(fmt == IMAGE_FORMAT_DXT1 || fmt == IMAGE_FORMAT_DXT3 || fmt == IMAGE_FORMAT_DXT5 ||
                        fmt == IMAGE_FORMAT_DXT1_ONEBITALPHA) {
                         it->setToolTip("DXT encoding requires a compressor (e.g. Compressonator).");
+                        dxtDisabled = true;
                     } else {
                         it->setToolTip("This image format is not supported for creation by this build of VTFLib.");
                     }
                 }
-                anyDisabled = true;
             }
         }
-        if(anyDisabled) {
+        if(dxtDisabled) {
             compressionNote_->setText("DXT compression is unavailable on this build (Compressonator not found). "
                                       "Choose an uncompressed format (RGBA8888/BGRA8888) or install Compressonator and rebuild.");
         } else {

VTFEdit/MainWindow.cpp

@@ -1317,6 +1317,8 @@ MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
 
     infoPath_ = new QLabel("-");
     infoPath_->setTextInteractionFlags(Qt::TextSelectableByMouse);
+    infoPath_->setWordWrap(true);
+    infoPath_->setMinimumWidth(80);
     infoLayout->addRow("Path:", infoPath_);
 
     infoVersion_ = new QLabel("-");
@@ -1339,6 +1341,7 @@ MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
 
     infoFlags_ = new QLabel("-");
     infoFlags_->setTextInteractionFlags(Qt::TextSelectableByMouse);
+    infoFlags_->setWordWrap(true);
     infoLayout->addRow("Flags:", infoFlags_);
 
     infoStartFrame_ = new QLabel("-");
@@ -1574,7 +1577,6 @@ MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) {
     }
     connect(vmtEditor_->document(), &QObject::destroyed, this, [this] {
         vmtHighlighter_ = nullptr;
-        if(actionVmtHighlight_) actionVmtHighlight_->setChecked(false);
     });
     connect(vmtEditor_->document(), &QTextDocument::modificationChanged, this, [this](bool) {
         updateWindowTitle();
@@ -2930,11 +2932,11 @@ void MainWindow::liveValidateVmtTick() {
 void MainWindow::openFileDialog() {
     QSettings s;
     const QString startDir = s.value("paths/open_vtf").toString();
-    const QString path = QFileDialog::getOpenFileName(this, "Open VTF", startDir, "Valve Texture Format (*.vtf)");
+    const QString path = QFileDialog::getOpenFileName(this, "Open VTF", startDir, "Valve Texture Format (*.vtf);;All files (*)");
     if(path.isEmpty()) return;
     s.setValue("paths/open_vtf", QFileInfo(path).absolutePath());
     // Defer until after the native file dialog fully closes.
-    QTimer::singleShot(0, this, [this, path] { openVtf(path); });
+    QTimer::singleShot(0, this, [this, path] { openPath(path); });
 }
 
 void MainWindow::openRecentFile() {
@@ -2995,7 +2997,7 @@ void MainWindow::openVmtDialog() {
     if(!maybeSaveVmt()) return;
     QSettings s;
     const QString startDir = s.value("paths/open_vmt").toString();
-    const QString path = QFileDialog::getOpenFileName(this, "Open VMT", startDir, "Valve Material Type (*.vmt)");
+    const QString path = QFileDialog::getOpenFileName(this, "Open VMT", startDir, "Valve Material Type (*.vmt);;All files (*)");
     if(path.isEmpty()) return;
     s.setValue("paths/open_vmt", QFileInfo(path).absolutePath());
     openVmtFromPath(path);
@@ -3051,7 +3053,7 @@ void MainWindow::openMatchingVmtFromVtf() {
 
     QSettings s;
     const QString startDir = QFileInfo(currentPath_).absolutePath();
-    const QString path = QFileDialog::getOpenFileName(this, "Open VMT", startDir, "Valve Material Type (*.vmt)");
+    const QString path = QFileDialog::getOpenFileName(this, "Open VMT", startDir, "Valve Material Type (*.vmt);;All files (*)");
     if(path.isEmpty()) return;
     s.setValue("paths/open_vmt", QFileInfo(path).absolutePath());
     openVmtFromPath(path);
@@ -3336,7 +3338,7 @@ void MainWindow::saveVmtAs() {
     QSettings s;
     const QString startDir = s.value("paths/save_vmt").toString();
     const QString start = startDir.isEmpty() ? suggested : QDir(startDir).filePath(suggested);
-    const QString path = QFileDialog::getSaveFileName(this, "Save VMT As", start, "Valve Material Type (*.vmt)");
+    const QString path = QFileDialog::getSaveFileName(this, "Save VMT As", start, "Valve Material Type (*.vmt);;All files (*)");
     if(path.isEmpty()) return;
     s.setValue("paths/save_vmt", QFileInfo(path).absolutePath());
     currentVmtPath_ = path;

VTFLib/CMakeLists.txt

@@ -52,6 +52,13 @@ if(VTFLIB_USE_COMPRESSONATOR)
             ${PROJECT_SOURCE_DIR}/lib/linux/${CMAKE_SYSTEM_PROCESSOR}
             ${PROJECT_SOURCE_DIR}/lib/linux/x86_64
         )
+    elseif(APPLE)
+        # macOS static libs live under lib/darwin/<arch>/ (built from source in CI).
+        list(APPEND _compressonator_search_paths
+            ${PROJECT_SOURCE_DIR}/lib/darwin/${CMAKE_SYSTEM_PROCESSOR}
+            ${PROJECT_SOURCE_DIR}/lib/darwin/arm64
+            ${PROJECT_SOURCE_DIR}/lib/darwin/x86_64
+        )
     endif()
 
     if(WIN32)
@@ -116,7 +123,7 @@ if(VTFLIB_USE_COMPRESSONATOR)
             endif()
         endif()
     else()
-        find_library(COMPRESSONATOR_LIB NAMES Compressonator compressonator
+        find_library(COMPRESSONATOR_LIB NAMES Compressonator compressonator CMP_Compressonator
             PATHS ${_compressonator_search_paths}
         )
         if(COMPRESSONATOR_LIB)
@@ -126,6 +133,13 @@ if(VTFLIB_USE_COMPRESSONATOR)
     endif()
 
     if(_vtflib_has_compressonator)
+        # Link CMP_Framework if available (needed by Yellow-Dog-Man fork builds)
+        find_library(CMP_FRAMEWORK_LIB NAMES CMP_Framework
+            PATHS ${_compressonator_search_paths}
+        )
+        if(CMP_FRAMEWORK_LIB)
+            target_link_libraries(vtflib PRIVATE ${CMP_FRAMEWORK_LIB})
+        endif()
         # Link all CMP_Core variants (base, SSE, AVX)
         find_library(CMP_CORE_LIB NAMES CMP_Core
             PATHS ${_compressonator_search_paths}
@@ -136,6 +150,9 @@ if(VTFLIB_USE_COMPRESSONATOR)
         find_library(CMP_CORE_AVX_LIB NAMES CMP_Core_AVX
             PATHS ${_compressonator_search_paths}
         )
+        find_library(CMP_CORE_AVX512_LIB NAMES CMP_Core_AVX512
+            PATHS ${_compressonator_search_paths}
+        )
         if(CMP_CORE_LIB)
             target_link_libraries(vtflib PRIVATE ${CMP_CORE_LIB})
         endif()
@@ -145,6 +162,9 @@ if(VTFLIB_USE_COMPRESSONATOR)
         if(CMP_CORE_AVX_LIB)
             target_link_libraries(vtflib PRIVATE ${CMP_CORE_AVX_LIB})
         endif()
+        if(CMP_CORE_AVX512_LIB)
+            target_link_libraries(vtflib PRIVATE ${CMP_CORE_AVX512_LIB})
+        endif()
         target_compile_definitions(vtflib PRIVATE VTFLIB_HAS_COMPRESSONATOR)
         target_include_directories(vtflib PRIVATE ${PROJECT_SOURCE_DIR}/lib/include)
     else()