Remove stale changes.

This reverts commit 0c16b7d879.

.github/workflows/build.yml

@@ -43,13 +43,16 @@ jobs:
         with:
           version: ${{ env.QT_VERSION }}
 
-      # Windows
+      - name: Install pkgconfiglite
-
-      - name: Chocolatey Action
         if: matrix.os == 'windows-latest'
         uses: crazy-max/ghaction-chocolatey@v2
         with:
           args: install pkgconfiglite --checksum e87b5ea3c9142256af60f2d5b917aa63b571e6a0 --checksum-type sha1
+      - name: Install nsis
+        if: matrix.os == 'windows-latest'
+        uses: crazy-max/ghaction-chocolatey@v2
+        with:
+          args: install nsis
 
       - name: Install Debian packaging dependencies
         if: matrix.os == 'ubuntu-latest'
@@ -191,6 +194,11 @@ jobs:
         uses: crazy-max/ghaction-chocolatey@v2
         with:
           args: install pkgconfiglite --checksum e87b5ea3c9142256af60f2d5b917aa63b571e6a0 --checksum-type sha1
+      - name: Install nsis
+        if: matrix.os == 'windows-latest'
+        uses: crazy-max/ghaction-chocolatey@v2
+        with:
+          args: install nsis
 
       - name: Configure Qtk Library
         shell: bash
@@ -198,13 +206,13 @@ jobs:
 
       - name: Build Qtk Library
         shell: bash
-        run: cmake --build build/ --config Release --target qtk_library -- ${{ matrix.flags }}
+        run: cmake --build build/ --config Release --target qtk -- ${{ matrix.flags }}
 
       # Packaging
 
       - name: Install Qtk Library
         shell: bash
-        run: cmake --install build/ --config Release --prefix=$(pwd)/install --component qtk_library
+        run: cmake --install build/ --config Release --prefix=$(pwd)/install --component qtk
 
       - name: Package Qtk Library
         shell: bash
@@ -369,7 +377,6 @@ jobs:
       - name: Download Installer Artifact
         uses: actions/download-artifact@v4
         with:
-          name: Qtk Packages
           path: |
             build/packages/*
             install/*

.github/workflows/linting.yml

@@ -39,7 +39,7 @@ jobs:
           # Check the entire repo for source files to tidy
           files-changed-only: false
           # Ignore qtk build and external assimp directories
-          ignore: '.github|build|extern/assimp/assimp'
+          ignore: '.github|build|extern'
           # Point to compile_commands.json produced by build
           database: 'build'
           # Use thread comments as feedback
@@ -61,8 +61,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: clang-format Check
+      - uses: cpp-linter/cpp-linter-action@v2
-        uses: jidicula/clang-format-action@v4.9.0
         with:
-          clang-format-version: '18'
+          version: '18'
-          check-path: ${{ matrix.path }}
+          style: 'file'
+          tidy-checks: ''
+          files-changed-only: false
+          ignore: '.github|build|extern'
+          extensions: 'cpp,h'
+          files: ${{ matrix.path }}

CMakeLists.txt

@@ -4,7 +4,7 @@
 ## Author: Shaun Reed | Contact: shaunrd0@gmail.com | URL: www.shaunreed.com  ##
 ## All Content (c) 2025 Shaun Reed, all rights reserved                       ##
 ################################################################################
-cmake_minimum_required(VERSION 3.23)
+cmake_minimum_required(VERSION 3.28)
 
 ################################################################################
 # Constants
@@ -31,7 +31,7 @@ add_compile_options(-fPIC)
 ################################################################################
 project(
     #[[NAME]]   Qtk
-    VERSION     0.2
+    VERSION     0.3
     DESCRIPTION "Qt OpenGL library and desktop application."
     LANGUAGES   CXX C
 )
@@ -84,7 +84,7 @@ endif()
 set(QT_INSTALL_DIR "$ENV{HOME}/Qt/6.5.0/gcc_64/lib/cmake" CACHE PATH "Path to Qt6 install.")
 if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
   set(CMAKE_INSTALL_PREFIX  "${CMAKE_BINARY_DIR}/install")
-endif ()
+endif()
 
 set(QTK_RESOURCES "${CMAKE_SOURCE_DIR}/resources")
 set(QTK_OSX_ICONS ${CMAKE_SOURCE_DIR}/resources/icons/osx/kilroy.icns)
@@ -157,8 +157,15 @@ list(APPEND VAR_NAMES QT6_INSTALL_PLUGINS)
 
 # Find Assimp.
 if(QTK_SUBMODULES)
+  if(APPLE)
+    # Avoid zlib redefining fdopen, causing build failures in apple clang.
+    # https://github.com/assimp/assimp/issues/6118
+    add_compile_definitions(-Dfdopen=fdopen)
+  endif()
+  if(NOT WIN32)
     # Required to statically link.
     add_compile_options(-fPIC)
+  endif()
   set(BUILD_SHARED_LIBS OFF CACHE STRING "Build static assimp libs" FORCE)
   set(ASSIMP_BUILD_ZLIB ON CACHE STRING "Build Zlib with assimp." FORCE)
   set(
@@ -175,6 +182,14 @@ if(QTK_SUBMODULES)
       "${CMAKE_CURRENT_SOURCE_DIR}/extern/assimp/assimp/"
       EXCLUDE_FROM_ALL
   )
+  install(
+      TARGETS assimp zlibstatic
+      EXPORT qtk_export
+      COMPONENT qtk
+      ARCHIVE DESTINATION lib
+      LIBRARY DESTINATION lib
+      RUNTIME DESTINATION bin
+  )
 else()
   find_package(assimp REQUIRED)
 endif()
@@ -189,8 +204,8 @@ endif()
 add_subdirectory(src)
 
 if(QTK_EXAMPLE)
-  # Create a namespaced alias for linking with qtk_library in the example.
+  # Create a namespaced alias for linking with libqtk in the example.
-  add_library(${PROJECT_NAME}::qtk_library ALIAS qtk_library)
+  add_library(${PROJECT_NAME}::qtk ALIAS qtk)
   add_subdirectory(example-app EXCLUDE_FROM_ALL)
 endif()
 
@@ -205,3 +220,25 @@ foreach(VAR_NAME IN LISTS VAR_NAMES VAR_PATHS)
     message(STATUS "[Qtk] ${VAR_NAME}=${${VAR_NAME}}")
   endif()
 endforeach()
+message(STATUS "[Qtk] Installation prefix: ${CMAKE_INSTALL_PREFIX}")
+message(STATUS "[Qtk] Found Qt6: ${Qt6Core_VERSION}")
+
+# qt_generate_deploy_app_script is supported on Linux in QtCore >= 6.5.0.
+# qt_generate_deploy_app_script supports Windows and OSX in QtCore >= 6.3.
+# https://doc.qt.io/qt-6.5/qt-generate-deploy-app-script.html
+# https://doc.qt.io/archives/qt-6.4/qt-generate-deploy-app-script.html
+# The application can still build and run, we just can't install.
+if(QTK_GUI OR QTK_EXAMPLE)
+  if(UNIX AND NOT APPLE)
+    # Ubuntu 24.04 provides QtCore 6.4.2 in qt-base-dev.
+    # This version of qt_generate_deploy_app_script does not support Linux.
+    if (Qt6_VERSION VERSION_LESS "6.5.0")
+      message(WARNING "[Qtk] Installation is only supported on Qt >=6.5.\n")
+    endif()
+  elseif(APPLE OR WIN32)
+    # Predates qt_generate_deploy_app_script.
+    if (Qt6_VERSION VERSION_LESS "6.3.0")
+      message(WARNING "[Qtk] Installation is only supported on Qt >=6.5.\n")
+    endif()
+  endif()
+endif()

README.md

@@ -1,9 +1,9 @@
 # Qtk
 
-[![All Builds](https://github.com/shaunrd0/qtk/actions/workflows/all-builds.yml/badge.svg)](https://github.com/shaunrd0/qtk/actions/workflows/all-builds.yml)
+[![All Builds](https://github.com/shaunrd0/qtk/actions/workflows/build.yml/badge.svg)](https://github.com/shaunrd0/qtk/actions/workflows/build.yml)
 [![Linting](https://github.com/shaunrd0/qtk/actions/workflows/linting.yml/badge.svg)](https://github.com/shaunrd0/qtk/actions/workflows/linting.yml)
 
-Qtk desktop application provides a model loader using [Assimp](https://assimp.org/) within a Qt widget application.
+The Qtk desktop application provides a model loader using [Assimp](https://assimp.org/) within a Qt widget application.
 You can fly around the scene using WASD while holding down the left or right mouse button.
 [QtkWidget](./src/designer-plugins/qtkwidget.h) is the primary QOpenGLWidget used to render the scene and handle input.
 
@@ -11,8 +11,8 @@ The underlying shared library [libqtk](./src/qtk) wraps QOpenGL objects in conve
 lower-level OpenGL APIs to handle the rendering process manually. Many of these classes offer
 ways to expand the low-level OpenGL logic within a Qt application without having to set up much scaffolding.
 
-The Qtk GUI is built using custom [Qt Designer plugins](). These can be installed to Qt Designer for
+The Qtk GUI is built using custom [Qt Designer plugins](https://doc.qt.io/qt-6/designer-creating-custom-widgets.html). These can be installed to Qt Designer for
-use in other Qt applications, or built exclusively for Qtk. See
+use in other Qt applications, or built exclusively for Qtk. See [Build Options](#build-options) for more details.
 
 Object names can be double-clicked in the tree view panel for quick camera navigation.
 Properties of the object, like shader code and translation / scale, can be viewed and modified in the side panel.
@@ -29,7 +29,7 @@ detached from the main window in this way.
 The small triangles floating near 3D models represent the light source being used for the shader.
 These appear on models using phong, specular, and diffuse lighting techniques.
 
-The default scene contains basic examples like texture mapping to make a crate from basic cube geometry
+The example scene contains basic examples like texture mapping to make a crate from simple cube geometry.
 This scene is used in the following screenshots, and can be built locally by enabling
 the `QTK_GUI_SCENE` [Build Option](#build-options) described below. Because this scene
 uses large 3D model resources, this option is disabled by default.
@@ -60,47 +60,54 @@ Key features that are planned:
 - [x] Runtime loading of `.obj` or similar 3D models.
 - [x] Drag-and-drop interaction for adding objects to the scene.
 - [x] Shader / object properties panel to modify related settings.
+- [x] Reduce size of application resources and git references.
 - [ ] Runtime reloading of modified GLSL shaders attached to objects within scenes.
 - [ ] Multiple views of a scene at one time.
 - [ ] Camera control modes such as panning, orbiting, or following objects.
 - [ ] Save / load scene data. The current model requires writing C++ code.
 - [ ] Basic text editor for quickly modifying shaders attached to objects.
-- [ ] Reduce size of application resources and git references.
 
-For examples of using the Qtk API, see the `example-app` project in the root of
+For examples of using libqtk, see the [example-app](./example-app)
-this repository.
+project in the root of this repository.
 
 To get textures loading on models look
 into [material files](http://www.paulbourke.net/dataformats/mtl/)
-and see some examples in the `resources/models/` directory.
+and see some examples at [qtk-resources/resources/models](https://git.shaunreed.com/shaunrd0/qtk-resources/src/branch/master/models).
 
 ### Source Builds
 
 Qtk was developed and tested using CLion
 and [Qt Creator](https://github.com/qt-creator/qt-creator).
-Simply open the root `CMakeLists.txt` with either of these editors and
+Simply open the root `CMakeLists.txt` with either of these editors and default
-configurations will be loaded.
+configurations will be loaded. To simplify providing Qt to the build, Qt Creator
+is the recommended option.
 
-This project has been ported to **Qt 6.6.0**, which is not yet available in
+If you have manually installed [Qt6 Open Source Binaries](https://www.qt.io/download-qt-installer)
-Ubuntu apt repositories.
+for your system, be sure to correctly set your `CMAKE_PREFIX_PATH` in the next steps.
-To run this project, you will *need* to
+On Ubuntu 24.04 the default installation directory to use for this path using Qt 6.5.0 is `$HOME/Qt/6.5.0/gcc_64/lib/cmake`.
-install [Qt6 Open Source Binaries](https://www.qt.io/download-qt-installer) for
+
-your system, **version 6.6.0** or later.
+The Ubuntu apt repositories contain all the packages we need to build all targets.
-Be sure to take note of the Qt6 installation directory, as we will need it to
+To build Qtk desktop application with the scene in the screenshots below run the following commands.
-correctly set our `CMAKE_PREFIX_PATH` in the next steps.
+
+```bash
+sudo apt update && sudo apt install cmake build-essential git ccache libxkbcommon-dev libassimp-dev qt6-base-dev qt6-tools-dev zlib1g-dev
+cmake -DQTK_GUI_SCENE=ON -B build
+cmake --build build
+./build/bin/qtk_gui
+```
 
 #### Build Options
 
 Qtk is composed of three separate components.
 
-* The shared library libqtk provides classes that leverage QOpenGL functionality
+* The shared library [libqtk](./src/qtk) provides classes that leverage QOpenGL functionality
 while still using lower-level OpenGL APIs to customize the rendering process.
 Many of these classes can be further expanded, such as [Qtk::Scene](./src/qtk/scene.h).
-This taget, `qtk_library` in cmake, is always selected to build and install as
+This taget, `qtk` in cmake, is always selected to build and install as
 it is required by all other components in this project.
-* The Qtk desktop application is built using libqtk within a Qt application.
+* The [Qtk desktop application](./src/app) is built using libqtk within a Qt application.
 This target, `qtk_gui` in cmake, is optional and can be controlled using the `QTK_GUI` option below.
-* The GUI for the Qtk desktop application is constructed using a custom set of Qt Designer widget plugins that are also built using libqtk.
+* The GUI for the Qtk desktop application is constructed using a [custom set of Qt Designer widget plugins](./src/designer-plugins) that are also built using libqtk.
 If `QTK_GUI` is disabled this target (`qtk_plugins`) is optional and can be controlled using the `QTK_PLUGINS` options below.
 
 
@@ -115,10 +122,10 @@ If `QTK_GUI` is disabled this target (`qtk_plugins`) is optional and can be cont
 | QTK_GUI                  | Build and install Qtk desktop application.                   | ON      |
 | QTK_GUI_SCENE            | Fetch external 3D model resources for example scene.         | OFF     |
 
-*The Qtk plugins are always built if QTK_GUI is enabled. Disabling this option
+*The Qtk plugins are always built if `QTK_GUI` is enabled. Disabling this option
 with QTK_GUI set will not mark the plugins for installation if we do
-`cmake --install build/` without selecting a component. If both QTK_GUI and
+`cmake --install build/` without selecting a component. If both `QTK_GUI` and
-QTK_PLUGINS are unset, neither will be built.
+`QTK_PLUGINS` are unset, neither will be built.
 
 If you are building on **Windows / Mac**, consider setting
 the `-DQTK_ASSIMP_NEW_INTERFACE` cmake build option.
@@ -145,7 +152,7 @@ For this example we will configure the build with all options enabled.
 In the separate sections below we can install individual components with cmake.
 
 ```bash
-sudo apt update -y && sudo apt install libassimp-dev cmake build-essential git ccache libgl1-mesa-dev libglvnd-dev zlib1g-dev -y
+sudo apt update -y && sudo apt install cmake build-essential git ccache libxkbcommon-dev libassimp-dev qt6-base-dev qt6-tools-dev -y
 git clone https://github.com/shaunrd0/qtk
 cd qtk
 # Configure the build with all components enabled
@@ -155,8 +162,8 @@ cmake --build build-all/
 ````
 
 Now that we have all the components fully built, the following sections will
-cover installing each component individually.
+install each component individually.
-If you want to uninstall a previously installed component, run the following command.
+If you want to uninstall previously installed components, run the following command.
 
 ```bash
 sudo xargs rm -v < install_manifest.txt
@@ -164,7 +171,7 @@ sudo xargs rm -v < install_manifest.txt
 
 ##### Qtk Library
 
-Qtk provides a simple library for working with lower-level OpenGL to customize the rendering process.
+Shared libqtk library for working with lower-level OpenGL to customize the rendering process.
 We can install this library on a system path or a custom path and then
 set `CMAKE_PREFIX_PATH` to point to this location when building an application
 using libqtk.
@@ -173,14 +180,14 @@ Here we will install to the `/usr/local/` path.
 
 ```bash
 # Install libqtk only
-cmake --build build-all/ --target qtk_library -- -j $(nproc)
+cmake --build build-all/ --target qtk -- -j $(nproc)
-cmake --install build-all/ --component qtk_library --prefix=/usr/local
+cmake --install build-all/ --component qtk --prefix=/usr/local
 -- Install configuration: "Release"
 -- Installing: /usr/local/lib/cmake/Qtk/QtkConfig.cmake
 -- Installing: /usr/local/lib/cmake/Qtk/QtkConfigVersion.cmake
 -- Installing: /usr/local/lib/cmake/Qtk/QtkTargets.cmake
 -- Installing: /usr/local/lib/cmake/Qtk/QtkTargets-release.cmake
--- Installing: /usr/local/lib/static/libqtk_library.a
+-- Installing: /usr/local/lib/static/libqtk.a
 -- Installing: /usr/local/include/qtk/camera3d.h
 -- Installing: /usr/local/include/qtk/input.h
 -- Installing: /usr/local/include/qtk/meshrenderer.h
@@ -210,7 +217,7 @@ cmake --install build-all/ --component qtk_gui --prefix=$(pwd)/install
 ```
 
 If any errors are encountered loading plugins, we can debug plugin loading by
-setting the following environment variable -
+setting the following environment variable
 
 ```bash
 QT_DEBUG_PLUGINS=1 ./install/bin/qtk_gui
@@ -237,7 +244,7 @@ cmake --build build-all/ --target qtk_plugins -- -j $(nproc)
 # The path here should be initialized during build configuration, so no need for --prefix
 cmake --install build-all/ --component qtk_plugins
 -- Install configuration: "Release"
--- Up-to-date: /home/shaun/Qt/6.6.0/gcc_64/../../Tools/QtCreator/lib/Qt/lib/libqtk_library.a
+-- Up-to-date: /home/shaun/Qt/6.6.0/gcc_64/../../Tools/QtCreator/lib/Qt/lib/libqtk.a
 -- Up-to-date: /home/shaun/Qt/6.6.0/gcc_64/../../Tools/QtCreator/lib/Qt/lib/libqtk_plugin_library.a
 -- Up-to-date: /home/shaun/Qt/6.6.0/gcc_64/../../Tools/QtCreator/lib/Qt/plugins/designer/libqtk_collection.so
 ```
@@ -264,7 +271,7 @@ This project is using `clang-format` version `>=15.0.5`.
 On Ubuntu 24.04, clang-format 18 is available to install in apt repositories.
 
 ```bash
-sudo apt install clang-format
+sudo apt install clang-format clang-tidy
 ```
 
 If `clang-format --version` is any earlier than `15.0.0`, running `clang-format` will fail because this project uses configuration options made available since `15.0.0`.
@@ -289,14 +296,18 @@ If you'd still like to run these tools manually, see the instructions below.
 cd qtk
 # Build
 cmake -B build && cmake --build build -- -j $(nproc)
-clang-tidy -p build/ --fix --config-file=.clang-tidy src/**/*.cpp src/**/*.h example-app/*.cpp example-app/*.h
+```
+
+```bash
+export SOURCES=src/**/*.cpp src/**/*.h example-app/*.cpp example-app/*.h
+run-clang-tidy -p build/ -j $(nproc --ignore=1) -fix -config-file=.clang-tidy $SOURCES
 ```
 
 Last we need to run `clang-format`, this can be done with the command directly.
 This will reformat all the code in the repository.
 
 ```bash
-clang-format -i --style=file:.clang-format src/**/*.cpp src/**/*.h example-app/*.cpp example-app/*.h
+clang-format -i --style=file:.clang-format $SOURCES
 ```
 
 `clang-format` can be run with git integration (or CLion if you prefer).

example-app/CMakeLists.txt

@@ -56,8 +56,8 @@ endif()
 
 # Allow add_subdirectory on this project to use target ALIAS if available.
 # If this example project is opened standalone we will use find_package.
-if(NOT TARGET Qtk::qtk_library)
+if(NOT TARGET Qtk::qtk)
-  find_package(Qtk 0.2 REQUIRED)
+  find_package(Qtk 0.3 REQUIRED)
 endif()
 
 find_package(Qt6 COMPONENTS Core Widgets OpenGLWidgets REQUIRED)
@@ -77,20 +77,27 @@ configure_file(
 
 qt_add_executable(qtk_example ${EXAMPLE_SOURCES})
 target_link_libraries(qtk_example PUBLIC Qt6::Widgets Qt6::OpenGLWidgets Qt6::Core)
-target_link_libraries(qtk_example PUBLIC Qtk::qtk_library)
+target_link_libraries(qtk_example PUBLIC Qtk::qtk)
 target_include_directories(qtk_example PRIVATE "${CMAKE_CURRENT_BINARY_DIR}")
 
-install(
+# qt_generate_deploy_app_script supports Windows and OSX in QtCore >= 6.3.
+# qt_generate_deploy_app_script is supported on Linux in QtCore >= 6.5.0.
+if((Qt6_VERSION VERSION_GREATER_EQUAL "6.3.0" AND (WIN32 OR APPLE))
+    OR Qt6_VERSION VERSION_GREATER_EQUAL "6.5.0")
+  install(
       TARGETS qtk_example
       COMPONENT qtk_example
       BUNDLE DESTINATION .
       LIBRARY DESTINATION lib
       ARCHIVE DESTINATION lib/static
       RUNTIME DESTINATION bin
-)
+  )
-qt_generate_deploy_app_script(
+  qt_generate_deploy_app_script(
       TARGET qtk_example
       OUTPUT_SCRIPT QTK_EXAMPLE_DEPLOY_SCRIPT
       NO_UNSUPPORTED_PLATFORM_ERROR
-)
+  )
-install(SCRIPT ${QTK_EXAMPLE_DEPLOY_SCRIPT} COMPONENT qtk_example)
+  install(SCRIPT ${QTK_EXAMPLE_DEPLOY_SCRIPT} COMPONENT qtk_example)
+elseif(NOT Qtk_IS_TOP_LEVEL)
+  message(WARNING "[Qtk] Installation is only supported on Qt >=6.5.\n")
+endif()

example-app/examplescene.cpp

@@ -22,18 +22,7 @@ ExampleScene::~ExampleScene() = default;
 
 void ExampleScene::init()
 {
-  setSkybox(new Qtk::Skybox(":/textures/skybox/right.png",
+  setSkybox(new Qtk::Skybox);
-                            ":/textures/skybox/top.png",
-                            ":/textures/skybox/front.png",
-                            ":/textures/skybox/left.png",
-                            ":/textures/skybox/bottom.png",
-                            ":/textures/skybox/back.png",
-                            "Skybox"));
-
-  std::string spartanPath = QTK_EXAMPLE_SOURCE_DIR;
-  spartanPath += "/../resources/models/spartan/spartan.obj";
-  auto spartan = addObject(new Model("spartan", spartanPath.c_str()));
-  spartan->getTransform().setTranslation(-4.0f, 0.0f, 0.0f);
 
   auto mesh = addObject(
       new Qtk::MeshRenderer("rightTriangle", Triangle(QTK_DRAW_ELEMENTS)));

resources/minimal_resources.qrc

@@ -0,0 +1,21 @@
+<RCC>
+    <qresource prefix="/textures">
+        <file alias="crate.png">images/crate.png</file>
+        <file alias="stone.png">images/stone.png</file>
+        <file alias="wood.png">images/wood.png</file>
+        <file>skybox/back.png</file>
+        <file>skybox/bottom.png</file>
+        <file>skybox/front.png</file>
+        <file>skybox/left.png</file>
+        <file>skybox/right.png</file>
+        <file>skybox/top.png</file>
+    </qresource>
+    <qresource prefix="/icons">
+        <file>fontawesome-free-6.2.1-desktop/svgs/solid/cube.svg</file>
+        <file>fontawesome-free-6.2.1-desktop/svgs/regular/trash-can.svg</file>
+        <file>fontawesome-free-6.2.1-desktop/svgs/regular/folder-open.svg</file>
+        <file>fontawesome-free-6.2.1-desktop/svgs/regular/floppy-disk.svg</file>
+        <file>fontawesome-free-6.2.1-desktop/svgs/brands/git-alt.svg</file>
+        <file alias="icon.png">icons/icon.png</file>
+    </qresource>
+</RCC>

resources/resources.qrc

@@ -1,6 +1,5 @@
 <RCC>
     <qresource prefix="/textures">
-        <file alias="plaster.png">images/plaster.png</file>
         <file alias="crate.png">images/crate.png</file>
         <file alias="stone.png">images/stone.png</file>
         <file alias="wood.png">images/wood.png</file>
@@ -28,8 +27,6 @@
         <file alias="solid.vert">shaders/vertex/solid.vert</file>
         <file alias="solid-perspective.frag">shaders/fragment/solid-perspective.frag</file>
         <file alias="solid-perspective.vert">shaders/vertex/solid-perspective.vert</file>
-        <file alias="multi-color.frag">shaders/fragment/multi-color.frag</file>
-        <file alias="multi-color.vert">shaders/vertex/multi-color.vert</file>
         <file alias="rgb-normals.frag">shaders/fragment/rgb-normals.frag</file>
         <file alias="rgb-normals.vert">shaders/vertex/rgb-normals.vert</file>
         <file alias="texture-cubemap.frag">shaders/fragment/texture-cubemap.frag</file>
@@ -44,13 +41,9 @@
         <file alias="solid-specular.vert">shaders/vertex/solid-specular.vert</file>
         <file alias="solid-phong.frag">shaders/fragment/solid-phong.frag</file>
         <file alias="solid-phong.vert">shaders/vertex/solid-phong.vert</file>
-        <file alias="model-basic.frag">shaders/fragment/model-basic.frag</file>
-        <file alias="model-basic.vert">shaders/vertex/model-basic.vert</file>
         <file alias="model-phong.frag">shaders/fragment/model-phong.frag</file>
         <file alias="model-phong.vert">shaders/vertex/model-phong.vert</file>
         <file alias="model-normals.frag">shaders/fragment/model-normals.frag</file>
         <file alias="model-normals.vert">shaders/vertex/model-normals.vert</file>
-        <file alias="skybox.frag">skybox/skybox.frag</file>
-        <file alias="skybox.vert">skybox/skybox.vert</file>
     </qresource>
 </RCC>

resources/shaders/fragment/model-basic.frag

@@ -1,11 +0,0 @@
-#version 330 core
-out vec4 fColor;
-
-in vec2 vTextureCoord;
-
-uniform sampler2D texture_diffuse1;
-
-void main()
-{
-    fColor = texture(texture_diffuse1, vTextureCoord);
-}

resources/shaders/fragment/multi-color.frag

@@ -1,9 +0,0 @@
-#version 330
-in vec4 vColor;
-
-out vec4 fColor;
-
-void main()
-{
-  fColor = vColor;
-}

resources/shaders/vertex/model-basic.vert

@@ -1,16 +0,0 @@
-#version 330 core
-layout (location = 0) in vec3 aPosition;
-layout (location = 1) in vec3 aNormal;
-layout (location = 2) in vec2 aTextureCoord;
-
-out vec2 vTextureCoord;
-
-uniform mat4 uModel;
-uniform mat4 uView;
-uniform mat4 uProjection;
-
-void main()
-{
-    vTextureCoord = aTextureCoord;
-    gl_Position = uProjection * uView * uModel * vec4(aPosition, 1.0);
-}

resources/shaders/vertex/multi-color.vert

@@ -1,16 +0,0 @@
-#version 330
-layout(location = 0) in vec3 aPosition;
-layout(location = 1) in vec3 aColor;
-
-out vec4 vColor;
-
-uniform mat4 uModel;  // Model
-uniform mat4 uView; // View
-uniform mat4 uProjection;  // Projection
-
-void main()
-{
-  gl_Position = uProjection * uView * uModel * vec4(aPosition, 1.0);
-
-  vColor = vec4(aColor, 1.0f);
-}

resources/skybox/skybox.frag

@@ -1,9 +0,0 @@
-#version 330
-uniform samplerCube uTexture;
-
-varying vec3 vTexCoord;
-
-void main()
-{
-  gl_FragColor = texture(uTexture, vTexCoord);
-}

resources/skybox/skybox.vert

@@ -1,15 +0,0 @@
-#version 330
-layout(location = 0) in vec3 aPosition;
-
-out vec3 vTexCoord;
-
-uniform mat4 uProjectionMatrix;
-uniform mat4 uViewMatrix;
-
-void main()
-{
-  // Strip translation column from camera's 4x4 matrix
-  mat4 view = mat4(mat3(uViewMatrix));
-  gl_Position = uProjectionMatrix * view * vec4(aPosition, 1.0);
-  vTexCoord = aPosition;
-}

src/CMakeLists.txt

@@ -13,22 +13,22 @@ install(
     FILES
     "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Config.cmake"
     "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}ConfigVersion.cmake"
-    COMPONENT qtk_library
+    COMPONENT qtk
     DESTINATION lib/cmake/${PROJECT_NAME}
 )
 install(
     EXPORT qtk_export
     FILE ${PROJECT_NAME}Targets.cmake
     NAMESPACE ${PROJECT_NAME}::
-    COMPONENT qtk_library
+    COMPONENT qtk
     DESTINATION lib/cmake/${PROJECT_NAME}
 )
-# System install for qtk_library
+# System install for libqtk
 install(
-    TARGETS qtk_library
+    TARGETS qtk
-    # Associate qtk_library target with qtk-export
+    # Associate libqtk target with qtk-export
     EXPORT qtk_export
-    COMPONENT qtk_library
+    COMPONENT qtk
     FILE_SET HEADERS DESTINATION include
     INCLUDES DESTINATION include
     LIBRARY DESTINATION lib

src/app/CMakeLists.txt

@@ -17,6 +17,8 @@ if (QTK_GUI_SCENE)
       qtkscene.cpp qtkscene.h
       main.cpp
   )
+
+  qt6_add_big_resources(QTK_GUI_SOURCES "${QTK_RESOURCES}/resources.qrc")
 else()
   # The scene will use a default skybox with no models or examples.
   # Models can be added by click-and-dragging an .obj into the scene.
@@ -24,13 +26,18 @@ else()
       qtkmainwindow.cpp qtkmainwindow.h qtkmainwindow.ui
       main.cpp
   )
+
+  qt6_add_big_resources(
+      QTK_GUI_SOURCES
+      "${QTK_RESOURCES}/minimal_resources.qrc"
+  )
 endif()
 
 qt_add_executable(qtk_gui ${QTK_GUI_SOURCES})
 target_link_libraries(qtk_gui PRIVATE qtk_plugin_library)
 
 if (QTK_GUI_SCENE)
-  target_compile_definitions(qtk_gui PUBLIC QTK_GUI_SCENE)
+  target_compile_definitions(qtk_gui PRIVATE -DQTK_GUI_SCENE)
 endif()
 
 if (WIN32)
@@ -49,21 +56,25 @@ elseif(APPLE)
   )
 endif()
 
-install(
+# qt_generate_deploy_app_script supports Windows and OSX in QtCore >= 6.3.
+# qt_generate_deploy_app_script is supported on Linux in QtCore >= 6.5.0.
+if((Qt6_VERSION VERSION_GREATER_EQUAL "6.3.0" AND (WIN32 OR APPLE))
+    OR Qt6_VERSION VERSION_GREATER_EQUAL "6.5.0")
+  install(
       TARGETS qtk_gui
       COMPONENT qtk_gui
       BUNDLE DESTINATION .
       LIBRARY DESTINATION lib
       ARCHIVE DESTINATION lib
       RUNTIME DESTINATION bin
-)
+  )
-
+  qt_generate_deploy_app_script(
-qt_generate_deploy_app_script(
       TARGET qtk_gui
       OUTPUT_SCRIPT QTK_DEPLOY_SCRIPT
       NO_UNSUPPORTED_PLATFORM_ERROR
-)
+  )
-install(SCRIPT ${QTK_DEPLOY_SCRIPT} COMPONENT qtk_gui)
+  install(SCRIPT ${QTK_DEPLOY_SCRIPT} COMPONENT qtk_gui)
+endif()
 
 if(WIN32)
   if(MSVC AND TARGET Qt6::qmake)

src/app/main.cpp

@@ -9,12 +9,10 @@
 #include <QApplication>
 
 #include "qtkmainwindow.h"
-#include "qtkscene.h"
 
 int main(int argc, char * argv[])
 {
-  Q_INIT_RESOURCE(resources);
+  initResources();
-
   QApplication a(argc, argv);
 
   auto window = MainWindow::getMainWindow();
@@ -24,11 +22,7 @@ int main(int argc, char * argv[])
   // NOTE: We set the scene here and not in QtkMainWindow to detach the scene
   // from the QtkWidget plugin (qtk_plugin_library build target).
   // Once we can save / load scenes, this call, and QtkScene, can be removed.
-#ifdef QTK_GUI_SCENE
+  window->setScene(new AppScene);
-  window->setScene(new QtkScene);
-#else
-  window->setScene(new EmptyScene);
-#endif
 
   window->show();
 

src/app/qtkmainwindow.cpp

@@ -48,6 +48,16 @@ MainWindow::MainWindow(QWidget * parent) : QMainWindow(parent)
             &Qtk::ToolBox::updateFocus);
   }
 
+  connect(ui_->actionDelete_Object,
+          &QAction::triggered,
+          this,
+          &MainWindow::deleteObject);
+
+  connect(ui_->actionLoad_Model,
+          &QAction::triggered,
+          this,
+          &MainWindow::loadObject);
+
   // TODO: Fix / use MainWindow in Qt Designer to add these dock widgets.
   // For now we will add them manually, but we should be able to do this in the
   // designer. At the moment if you edit the UI in designer the dock widget
@@ -62,7 +72,7 @@ MainWindow::MainWindow(QWidget * parent) : QMainWindow(parent)
   ui_->menuView->addAction(ui_->qtk__TreeView->toggleViewAction());
 
   // Set the window icon used for Qtk.
-  setWindowIcon(Qtk::getIcon());
+  setWindowIcon(getIcon());
 }
 
 MainWindow::~MainWindow()
@@ -104,6 +114,26 @@ void MainWindow::refreshScene(const QString & sceneName)
   ui_->qtk__TreeView->updateView(getQtkWidget()->getScene());
 }
 
+void MainWindow::deleteObject()
+{
+  if (auto object = ui_->qtk__ToolBox->getObjectFocus(); object != Q_NULLPTR) {
+    auto scene = getQtkWidget()->getScene();
+    switch (object->getType()) {
+      case Qtk::Object::Type::QTK_MESH:
+        scene->removeObject(dynamic_cast<Qtk::MeshRenderer *>(object));
+        ui_->qtk__ToolBox->clearFocus();
+        break;
+      case Qtk::Object::Type::QTK_MODEL:
+        scene->removeObject(dynamic_cast<Qtk::Model *>(object));
+        ui_->qtk__ToolBox->clearFocus();
+        break;
+      default:
+        qDebug() << "Failed to delete model with invalid type";
+        break;
+    }
+  }
+}
+
 void MainWindow::setScene(Qtk::Scene * scene)
 {
   connect(scene,

src/app/qtkmainwindow.h

@@ -11,8 +11,8 @@
 
 #include <unordered_map>
 
+#include <QFileDialog>
 #include <QMainWindow>
-#include <QPlainTextEdit>
 
 #include "designer-plugins/debugconsole.h"
 
@@ -62,6 +62,27 @@ class EmptyScene : public Qtk::Scene
     }
 };
 
+/*
+ * Conditionally include the QtkScene header if the example is enabled.
+ * Set AppScene type to use in main() for creating the scene.
+ * Define helper function to initialize Qt resources for the application.
+ *    These resources are different based on if the example is enabled.
+ */
+#ifdef QTK_GUI_SCENE
+#include "qtkscene.h"
+using AppScene = QtkScene;
+inline void initResources()
+{
+  Q_INIT_RESOURCE(resources);
+}
+#else
+using AppScene = EmptyScene;
+inline void initResources()
+{
+  Q_INIT_RESOURCE(minimal_resources);
+}
+#endif
+
 /**
  * MainWindow class to provide an example of using a QtkWidget within a Qt
  * window application.
@@ -111,6 +132,11 @@ class MainWindow : public QMainWindow
      */
     void setScene(Qtk::Scene * scene);
 
+    /**
+     * @return Default icon to use for Qtk desktop application.
+     */
+    static QIcon getIcon() { return QIcon(":/icons/icon.png"); }
+
   public slots:
     /**
      * Trigger a refresh for widgets related to a scene that has been updated.
@@ -118,6 +144,23 @@ class MainWindow : public QMainWindow
      */
     void refreshScene(const QString & sceneName);
 
+
+    /**
+     * Opens a QFileDialog for selecting an object file to load into the scene.
+     */
+    void loadObject()
+    {
+      const QUrl file = QFileDialog::getOpenFileName(
+          this, tr("Load Model"), QDir::homePath(), tr("Object Files (*.obj)"));
+      getQtkWidget()->getScene()->loadModel(file.fileName().replace(".obj", ""),
+                                            file.toString());
+    }
+
+    /**
+     * Deletes the currently selected object from the scene.
+     */
+    void deleteObject();
+
   private:
     /***************************************************************************
      * Private Members

src/app/qtkmainwindow.ui

@@ -222,6 +222,9 @@
    </property>
   </action>
   <action name="actionLoad_Model">
+   <property name="enabled">
+    <bool>true</bool>
+   </property>
    <property name="icon">
     <iconset>
      <normaloff>:/icons/fontawesome-free-6.2.1-desktop/svgs/solid/cube.svg</normaloff>:/icons/fontawesome-free-6.2.1-desktop/svgs/solid/cube.svg</iconset>
@@ -234,6 +237,9 @@
    </property>
   </action>
   <action name="actionDelete_Object">
+   <property name="enabled">
+    <bool>true</bool>
+   </property>
    <property name="icon">
     <iconset>
      <normaloff>:/icons/fontawesome-free-6.2.1-desktop/svgs/regular/trash-can.svg</normaloff>:/icons/fontawesome-free-6.2.1-desktop/svgs/regular/trash-can.svg</iconset>

src/app/qtkscene.cpp

@@ -42,8 +42,8 @@ void QtkScene::init()
   // Clone qtk-resources if it doesn't already exist.
   QDir repoDir("resources/");
   if (!repoDir.exists()) {
-    qDebug() << "Cloning qtk-resources repository to '"
+    qDebug() << "Cloning qtk-resources repository to " << repoDir.absolutePath()
-             << repoDir.absolutePath() << "'...";
+             << "...";
 
     // Run git clone
     QProcess gitProcess;
@@ -426,6 +426,7 @@ void QtkScene::draw()
   // WARNING: We must call the base class draw() function first.
   // + This will handle rendering core scene components like the Skybox.
   Scene::draw();
+  const QVector3D cameraPosition = getCamera().getTransform().getTranslation();
 
   mTestPhong->bindShaders();
   mTestPhong->setUniform("uModelInverseTransposed",
@@ -433,14 +434,12 @@ void QtkScene::draw()
   mTestPhong->setUniform(
       "uLightPosition",
       MeshRenderer::getInstance("phongLight")->getTransform().getTranslation());
-  mTestPhong->setUniform("uCameraPosition",
+  mTestPhong->setUniform("uCameraPosition", cameraPosition);
-                         QtkScene::getCamera().getTransform().getTranslation());
   mTestPhong->releaseShaders();
   mTestPhong->draw();
 
   mTestAmbient->bindShaders();
-  mTestAmbient->setUniform(
+  mTestAmbient->setUniform("uCameraPosition", cameraPosition);
-      "uCameraPosition", QtkScene::getCamera().getTransform().getTranslation());
   mTestAmbient->releaseShaders();
   mTestAmbient->draw();
 
@@ -452,8 +451,7 @@ void QtkScene::draw()
                            MeshRenderer::getInstance("diffuseLight")
                                ->getTransform()
                                .getTranslation());
-  mTestDiffuse->setUniform(
+  mTestDiffuse->setUniform("uCameraPosition", cameraPosition);
-      "uCameraPosition", QtkScene::getCamera().getTransform().getTranslation());
   mTestDiffuse->releaseShaders();
   mTestDiffuse->draw();
 
@@ -465,67 +463,70 @@ void QtkScene::draw()
                             MeshRenderer::getInstance("specularLight")
                                 ->getTransform()
                                 .getTranslation());
-  mTestSpecular->setUniform(
+  mTestSpecular->setUniform("uCameraPosition", cameraPosition);
-      "uCameraPosition", QtkScene::getCamera().getTransform().getTranslation());
   mTestSpecular->releaseShaders();
   mTestSpecular->draw();
 }
 
 void QtkScene::update()
 {
-  auto mySpartan = Model::getInstance("My spartan");
+  auto getModel = Model::getInstance;
+  const QVector3D cameraPosition = getCamera().getTransform().getTranslation();
+
+  // Models may have failed to load, so we should check before accessing.
+  if (auto mySpartan = getModel("My spartan"); mySpartan) {
     mySpartan->getTransform().rotate(0.75f, 0.0f, 1.0f, 0.0f);
+  }
 
-  auto myCube = MeshRenderer::getInstance("My cube");
+  if (auto myCube = getModel("My cube"); myCube) {
     myCube->getTransform().rotate(-0.75f, 0.0f, 1.0f, 0.0f);
+  }
 
-  auto position = MeshRenderer::getInstance("alienTestLight")
+  QMatrix4x4 posMatrix;
-                      ->getTransform()
+  if (auto alien = getModel("alienTest"); alien) {
-                      .getTranslation();
+    alien->setLightPosition("alienTestLight");
-  auto alien = Model::getInstance("alienTest");
+
-  alien->setUniform("uLight.position", position);
+    alien->setUniform("uCameraPosition", cameraPosition);
-  alien->setUniform("uCameraPosition",
+    posMatrix = alien->getTransform().toMatrix();
-                    QtkScene::getCamera().getTransform().getTranslation());
-  auto posMatrix = alien->getTransform().toMatrix();
     alien->setUniform("uMVP.normalMatrix", posMatrix.normalMatrix());
     alien->setUniform("uMVP.model", posMatrix);
     alien->setUniform("uMVP.view", QtkScene::getCamera().toMatrix());
     alien->setUniform("uMVP.projection", QtkScene::getProjectionMatrix());
     alien->getTransform().rotate(0.75f, 0.0f, 1.0f, 0.0f);
+  }
 
-  position = MeshRenderer::getInstance("spartanTestLight")
+  if (auto spartan = getModel("spartanTest"); spartan) {
-                 ->getTransform()
+    spartan->setLightPosition("spartanTestLight");
-                 .getTranslation();
+
-  auto spartan = Model::getInstance("spartanTest");
+    spartan->setUniform("uCameraPosition", cameraPosition);
-  spartan->setUniform("uLight.position", position);
-  spartan->setUniform("uCameraPosition",
-                      QtkScene::getCamera().getTransform().getTranslation());
     posMatrix = spartan->getTransform().toMatrix();
     spartan->setUniform("uMVP.normalMatrix", posMatrix.normalMatrix());
     spartan->setUniform("uMVP.model", posMatrix);
     spartan->setUniform("uMVP.view", QtkScene::getCamera().toMatrix());
     spartan->setUniform("uMVP.projection", QtkScene::getProjectionMatrix());
     spartan->getTransform().rotate(0.75f, 0.0f, 1.0f, 0.0f);
+  }
+
+  if (auto phong = getModel("testPhong"); phong) {
+    phong->setLightPosition("testLight");
 
-  auto phong = MeshRenderer::getInstance("testPhong");
     phong->getTransform().rotate(0.75f, 1.0f, 0.5f, 0.0f);
     phong->bindShaders();
-  position =
+    phong->setUniform("uCameraPosition", cameraPosition);
-      MeshRenderer::getInstance("testLight")->getTransform().getTranslation();
-  phong->setUniform("uLight.position", position);
-  phong->setUniform("uCameraPosition",
-                    QtkScene::getCamera().getTransform().getTranslation());
     posMatrix = phong->getTransform().toMatrix();
     phong->setUniform("uMVP.normalMatrix", posMatrix.normalMatrix());
     phong->setUniform("uMVP.model", posMatrix);
     phong->setUniform("uMVP.view", QtkScene::getCamera().toMatrix());
     phong->setUniform("uMVP.projection", QtkScene::getProjectionMatrix());
     phong->releaseShaders();
+  }
+
+  // MeshRenderers are lower level opengl objects baked into the source code.
+  auto getMesh = MeshRenderer::getInstance;
 
   // Rotate lighting example cubes
   mTestPhong->getTransform().rotate(0.75f, 0.5f, 0.3f, 0.2f);
-  MeshRenderer::getInstance("noLight")->getTransform().rotate(
+  getMesh("noLight")->getTransform().rotate(0.75f, 0.5f, 0.3f, 0.2f);
-      0.75f, 0.5f, 0.3f, 0.2f);
   mTestAmbient->getTransform().rotate(0.75f, 0.5f, 0.3f, 0.2f);
   mTestDiffuse->getTransform().rotate(0.75f, 0.5f, 0.3f, 0.2f);
   mTestSpecular->getTransform().rotate(0.75f, 0.5f, 0.3f, 0.2f);
@@ -533,46 +534,27 @@ void QtkScene::update()
   // Examples of various translations and rotations
 
   // Rotate in multiple directions simultaneously
-  MeshRenderer::getInstance("rgbNormalsCube")
+  getMesh("rgbNormalsCube")->getTransform().rotate(0.75f, 0.2f, 0.4f, 0.6f);
-      ->getTransform()
-      .rotate(0.75f, 0.2f, 0.4f, 0.6f);
 
   // Pitch forward and roll sideways
-  MeshRenderer::getInstance("leftTriangle")
+  getMesh("leftTriangle")->getTransform().rotate(0.75f, 1.0f, 0.0f, 0.0f);
-      ->getTransform()
+  getMesh("rightTriangle")->getTransform().rotate(0.75f, 0.0f, 0.0f, 1.0f);
-      .rotate(0.75f, 1.0f, 0.0f, 0.0f);
-  MeshRenderer::getInstance("rightTriangle")
-      ->getTransform()
-      .rotate(0.75f, 0.0f, 0.0f, 1.0f);
 
   // Move between two positions over time
   static float translateX = 0.025f;
   float limit = -9.0f;  // Origin position.x - 2.0f
-  float posX = MeshRenderer::getInstance("topTriangle")
+  float posX = getMesh("topTriangle")->getTransform().getTranslation().x();
-                   ->getTransform()
-                   .getTranslation()
-                   .x();
   if (posX < limit || posX > limit + 4.0f) {
     translateX = -translateX;
   }
-  MeshRenderer::getInstance("topTriangle")
+  getMesh("topTriangle")->getTransform().translate(translateX, 0.0f, 0.0f);
-      ->getTransform()
+  getMesh("bottomTriangle")->getTransform().translate(-translateX, 0.0f, 0.0f);
-      .translate(translateX, 0.0f, 0.0f);
-  MeshRenderer::getInstance("bottomTriangle")
-      ->getTransform()
-      .translate(-translateX, 0.0f, 0.0f);
   // And lets rotate the triangles in two directions at once
-  MeshRenderer::getInstance("topTriangle")
+  getMesh("topTriangle")->getTransform().rotate(0.75f, 0.2f, 0.0f, 0.4f);
-      ->getTransform()
+  getMesh("bottomTriangle")->getTransform().rotate(0.75f, 0.0f, 0.2f, 0.4f);
-      .rotate(0.75f, 0.2f, 0.0f, 0.4f);
-  MeshRenderer::getInstance("bottomTriangle")
-      ->getTransform()
-      .rotate(0.75f, 0.0f, 0.2f, 0.4f);
   // And make the bottom triangle green, instead of RGB
 
   // Rotate center cube in several directions simultaneously
   // + Not subject to gimbal lock since we are using quaternions :)
-  MeshRenderer::getInstance("centerCube")
+  getMesh("centerCube")->getTransform().rotate(0.75f, 0.2f, 0.4f, 0.6f);
-      ->getTransform()
-      .rotate(0.75f, 0.2f, 0.4f, 0.6f);
 }

src/designer-plugins/CMakeLists.txt

@@ -29,7 +29,7 @@ target_sources(
     "${QTK_PLUGIN_LIBRARY_SOURCES}"
     "${QTK_PLUGIN_LIBRARY_HEADERS}"
 )
-target_link_libraries(qtk_plugin_library PUBLIC Qt6::UiPlugin qtk_library)
+target_link_libraries(qtk_plugin_library PUBLIC Qt6::UiPlugin qtk)
 
 ################################################################################
 # Qtk Widget Plugins
@@ -47,7 +47,7 @@ target_link_libraries(qtk_plugins PUBLIC qtk_plugin_library)
 # Otherwise, we just use them for building the Qtk desktop application.
 if(QTK_PLUGINS)
   install(
-      TARGETS qtk_plugins qtk_library qtk_plugin_library
+      TARGETS qtk_plugins qtk qtk_plugin_library
       COMPONENT qtk_plugins
       LIBRARY DESTINATION "${QTK_PLUGIN_INSTALL_DIR}"
       ARCHIVE DESTINATION "${QTK_PLUGIN_INSTALL_DIR}"

src/designer-plugins/toolbox.cpp

@@ -16,20 +16,121 @@
 
 using namespace Qtk;
 
-ToolBox::ToolBox(QWidget * parent) : QDockWidget(parent), ui(new Ui::ToolBox)
+ToolBox::ToolBox(QWidget * parent) :
+    QDockWidget(parent), objectDetails_(this), transformPanel_(this),
+    scalePanel_(this), vertex_(this, "Vertex Shader:"),
+    fragment_(this, "Fragment Shader:"), properiesForm_(new QFormLayout),
+    shaderForm_(new QFormLayout), ui(new Ui::ToolBox), objectFocus_(Q_NULLPTR)
 {
   ui->setupUi(this);
   setMinimumWidth(350);
+
+  // Object Properties.
+  ui->page_properties->setLayout(properiesForm_);
+  properiesForm_->addRow(objectDetails_.name.label, objectDetails_.name.value);
+  properiesForm_->addRow(objectDetails_.objectType.label,
+                         objectDetails_.objectType.value);
+  properiesForm_->addRow(reinterpret_cast<QWidget *>(&transformPanel_));
+  properiesForm_->addRow(reinterpret_cast<QWidget *>(&scalePanel_));
+  ui->toolBox->setCurrentWidget(ui->page_properties);
+
+  // Shader views.
+  ui->page_shaders->setLayout(shaderForm_);
+  shaderForm_->addRow(reinterpret_cast<QWidget *>(&vertex_));
+  shaderForm_->addRow(reinterpret_cast<QWidget *>(&fragment_));
 }
 
 void ToolBox::updateFocus(const QString & name)
 {
   auto object =
-      Qtk::QtkWidget::mWidgetManager.get_widget()->getScene()->getObject(name);
+      QtkWidget::mWidgetManager.get_widget()->getScene()->getObject(name);
-  if (object != Q_NULLPTR) {
+  // If we can't find the object show a warning.
-    removePages();
+  if (object == Q_NULLPTR) {
-    createPageProperties(object);
+    qDebug() << "Failed to find selected object: " << name
-    createPageShader(object);
+             << ";  Clearing object panels.";
+  }
+
+  // We should still pass the nullptr here if we failed to find the object
+  // above.
+  objectFocus_ = object;
+  refreshProperties(object);
+  refreshShaders(object);
+}
+
+void ToolBox::clearFocus()
+{
+  objectFocus_ = Q_NULLPTR;
+  refreshProperties(objectFocus_);
+  refreshShaders(objectFocus_);
+}
+
+ToolBox::SpinBox3D::SpinBox3D(QWidget * parent, const char * l) :
+    QWidget(parent), layout(new QHBoxLayout(this)), label(new QLabel(tr(l)))
+{
+  // The layout owns the widget and will clean it up on destruction.
+  layout->addWidget(label);
+  for (const auto & f : fields) {
+    layout->addWidget(f->spinBox);
+    f->spinBox->setMinimum(std::numeric_limits<double>::lowest());
+    f->spinBox->setSingleStep(0.1);
+    f->spinBox->setFixedWidth(75);
+  }
+}
+
+void ToolBox::SpinBox::disconnect() const
+{
+  Object::disconnect(connection);
+}
+
+void ToolBox::TransformPanel::setObject(const Qtk::Object * object)
+{
+  // Zero the panel contents if there is no object selected.
+  if (object == Q_NULLPTR) {
+    spinBox3D.clear();
+    return;
+  }
+
+
+  // Reconnect translation panel controls to the new object.
+  const std::vector binds = {&Object::setTranslationX,
+                             &Object::setTranslationY,
+                             &Object::setTranslationZ};
+  for (size_t i = 0; i < spinBox3D.fields.size(); i++) {
+    auto * f = spinBox3D.fields[i];
+    // Disconnect before changing spin box value.
+    f->disconnect();
+
+    // Set the values in the spin box to the object's current X,Y,Z
+    f->spinBox->setValue(object->getTransform().getTranslation()[i]);
+
+    // Reconnect to bind spin box value to the new object's position.
+    f->connection =
+        connect(f->spinBox, &QDoubleSpinBox::valueChanged, object, binds[i]);
+  }
+}
+
+void ToolBox::ScalePanel::setObject(const Qtk::Object * object)
+{
+  // Zero the panel contents if there is no object selected.
+  if (object == Q_NULLPTR) {
+    spinBox3D.clear();
+    return;
+  }
+
+  // Reconnect scale panel controls to the new object.
+  const std::vector binds = {
+      &Object::setScaleX, &Object::setScaleY, &Object::setScaleZ};
+  for (size_t i = 0; i < spinBox3D.fields.size(); i++) {
+    auto * f = spinBox3D.fields[i];
+    // Disconnect before changing spin box value.
+    f->disconnect();
+
+    // Set the values in the spin box to the object's current X,Y,Z
+    f->spinBox->setValue(object->getTransform().getScale()[i]);
+
+    // Reconnect to bind spin box value to the new object's scale.
+    f->connection =
+        connect(f->spinBox, &QDoubleSpinBox::valueChanged, object, binds[i]);
   }
 }
 
@@ -38,120 +139,32 @@ ToolBox::~ToolBox()
   delete ui;
 }
 
-void ToolBox::removePages()
+void ToolBox::refreshProperties(const Object * object)
 {
-  // Remove all existing pages.
+  // Refresh to show the new object's details.
-  for (size_t i = 0; i < ui->toolBox->count(); i++) {
+  objectDetails_.setObject(object);
-    delete ui->toolBox->widget(i);
+  // Reconnect transform panel controls to the new object.
-    ui->toolBox->removeItem(i);
+  transformPanel_.setObject(object);
-  }
+  scalePanel_.setObject(object);
 }
 
-void ToolBox::createPageProperties(const Object * object)
+void ToolBox::refreshShaders(const Object * object)
 {
-  auto transform = object->getTransform();
+  // Zero the panel contents if there is no object selected.
-  auto type = object->getType();
+  if (object == Q_NULLPTR) {
-  auto * widget = new QWidget;
+    vertex_.clear();
-  ui->toolBox->addItem(widget, "Properties");
+    fragment_.clear();
-  ui->toolBox->setCurrentWidget(widget);
+    return;
-
-  auto * layout = new QFormLayout;
-  layout->addRow(new QLabel(tr("Name:")),
-                 new QLabel(object->getName().c_str()));
-
-  layout->addRow(new QLabel(tr("Type:")),
-                 new QLabel(type == Object::Type::QTK_MESH ? "Mesh" : "Model"));
-
-  auto rowLayout = new QHBoxLayout;
-  rowLayout->addWidget(new QLabel(tr("Translation:")));
-  int minWidth = 75;
-  for (size_t i = 0; i < 3; i++) {
-    auto spinBox = new QDoubleSpinBox;
-    spinBox->setMinimum(std::numeric_limits<double>::lowest());
-    spinBox->setSingleStep(0.1);
-    spinBox->setValue(transform.getTranslation()[i]);
-    spinBox->setFixedWidth(minWidth);
-    rowLayout->addWidget(spinBox);
-
-    if (i == 0) {
-      connect(spinBox,
-              &QDoubleSpinBox::valueChanged,
-              object,
-              &Object::setTranslationX);
-    } else if (i == 1) {
-      connect(spinBox,
-              &QDoubleSpinBox::valueChanged,
-              object,
-              &Object::setTranslationY);
-    } else if (i == 2) {
-      connect(spinBox,
-              &QDoubleSpinBox::valueChanged,
-              object,
-              &Object::setTranslationZ);
   }
-  }
-  layout->addRow(rowLayout);
 
-  rowLayout = new QHBoxLayout;
+  vertex_.path.setValue(object->getVertexShader().c_str());
-  rowLayout->addWidget(new QLabel(tr("Scale:")));
+  vertex_.editor->setText(object->getVertexShaderSourceCode().c_str());
-  for (size_t i = 0; i < 3; i++) {
+  fragment_.path.setValue(object->getFragmentShader().c_str());
-    auto spinBox = new QDoubleSpinBox;
+  fragment_.editor->setText(object->getFragmentShaderSourceCode().c_str());
-    spinBox->setMinimum(std::numeric_limits<double>::lowest());
-    spinBox->setSingleStep(0.1);
-    spinBox->setValue(transform.getScale()[i]);
-    spinBox->setFixedWidth(minWidth);
-    rowLayout->addWidget(spinBox);
-
-    if (i == 0) {
-      connect(
-          spinBox, &QDoubleSpinBox::valueChanged, object, &Object::setScaleX);
-    } else if (i == 1) {
-      connect(
-          spinBox, &QDoubleSpinBox::valueChanged, object, &Object::setScaleY);
-    } else if (i == 2) {
-      connect(
-          spinBox, &QDoubleSpinBox::valueChanged, object, &Object::setScaleZ);
-    }
-  }
-  layout->addRow(rowLayout);
-  widget->setLayout(layout);
 }
 
-void ToolBox::createPageShader(const Object * object)
+void ToolBox::refresh(const Object * object)
 {
-  // Shaders page.
+  refreshProperties(object);
-  auto widget = new QWidget;
+  refreshShaders(object);
-  ui->toolBox->addItem(widget, "Shaders");
-  auto mainLayout = new QFormLayout;
-  auto rowLayout = new QHBoxLayout;
-  rowLayout->addWidget(new QLabel("Vertex Shader:"));
-  rowLayout->addWidget(new QLabel(object->getVertexShader().c_str()));
-  mainLayout->addRow(rowLayout);
-
-  auto shaderView = new QTextEdit;
-  shaderView->setReadOnly(true);
-  auto vertexFile = QFile(object->getVertexShader().c_str());
-  if (vertexFile.exists()) {
-    vertexFile.open(QIODeviceBase::ReadOnly);
-    shaderView->setText(vertexFile.readAll());
-    vertexFile.close();
-    mainLayout->addRow(shaderView);
-  }
-
-  rowLayout = new QHBoxLayout;
-  rowLayout->addWidget(new QLabel("Fragment Shader:"));
-  rowLayout->addWidget(new QLabel(object->getFragmentShader().c_str()));
-  mainLayout->addRow(rowLayout);
-
-  shaderView = new QTextEdit;
-  shaderView->setReadOnly(true);
-  auto fragmentfile = QFile(object->getFragmentShader().c_str());
-  if (fragmentfile.exists()) {
-    fragmentfile.open(QIODeviceBase::ReadOnly);
-    shaderView->setText(fragmentfile.readAll());
-    fragmentfile.close();
-    mainLayout->addRow(shaderView);
-  }
-
-  widget->setLayout(mainLayout);
 }

src/designer-plugins/toolbox.h

@@ -13,10 +13,13 @@
 #include <QDesignerExportWidget>
 #include <QDockWidget>
 #include <QDoubleSpinBox>
-#include <QGroupBox>
+#include <QFormLayout>
+#include <QHBoxLayout>
+#include <QLabel>
+#include <QTextEdit>
 
+#include "qtk/object.h"
 
-#include "qtk/scene.h"
 
 namespace Ui
 {
@@ -25,7 +28,7 @@ namespace Ui
 
 namespace Qtk
 {
-  class ToolBox : public QDockWidget
+  class ToolBox final : public QDockWidget
   {
       Q_OBJECT
 
@@ -38,20 +41,184 @@ namespace Qtk
 
       ~ToolBox();
 
-      void removePages();
+      void refreshProperties(const Object * object);
 
-      void createPageProperties(const Object * object);
+      void refreshShaders(const Object * object);
 
-      void createPageShader(const Object * object);
+      void refresh(const Object * object);
 
       void updateFocus(const QString & name);
 
+      [[nodiscard]] Object * getObjectFocus() const { return objectFocus_; }
+
+      void clearFocus();
 
     private:
       /*************************************************************************
        * Private Members
        ************************************************************************/
 
+      /// Displays details on the object.
+      struct ObjectDetails {
+          /// Single item containing a label and value.
+          struct Item {
+              explicit Item(QWidget * parent,
+                            const char * l = "Item:",
+                            const char * v = "") :
+                  label(new QLabel(tr(l), parent)),
+                  value(new QLabel(tr(v), parent))
+              {
+              }
+
+              void setValue(const char * v) const { value->setText(tr(v)); }
+
+              void setItem(const char * l, const char * v) const
+              {
+                label->setText(tr(l));
+                value->setText(tr(v));
+              }
+
+              QLabel * label;
+              QLabel * value;
+          };
+
+          /// We pass the parent widget so that Qt handles releasing memory.
+          explicit ObjectDetails(QWidget * parent) :
+              name(parent, "Name:"), objectType(parent, "Object Type:")
+          {
+          }
+
+          /// Refresh to display the new object's details
+          void setObject(const Qtk::Object * object) const
+          {
+            // Zero contents if there is no object selected.
+            if (object == Q_NULLPTR) {
+              name.setValue("");
+              objectType.setValue("No object selected");
+              return;
+            }
+            name.setItem("Name:", object->getName().toStdString().c_str());
+            objectType.setItem(
+                "Type:",
+                object->getType() == Object::QTK_MESH ? "Mesh" : "Model");
+          }
+
+          Item name, objectType;
+      };
+      ObjectDetails objectDetails_;
+
+      /// Structure to associate a QSpinBox with a connection.
+      struct SpinBox {
+          /**
+           * Default constructor passes no parent to the QSpinBox.
+           * It must be added to a layout for Qt to clean up the resources.
+           */
+          SpinBox() : spinBox(new QDoubleSpinBox) {}
+
+          /// Disconnect the associated connection.
+          void disconnect() const;
+
+          QDoubleSpinBox * spinBox;
+          QMetaObject::Connection connection;
+      };
+
+      /// Spinbox with 3 fields and a single label.
+      class SpinBox3D final : QWidget
+      {
+        public:
+          /// We pass a parent to ensure Qt will clean up resources.
+          /// Assigning a QWidget to a QLayout also ensures Qt will clean up.
+          explicit SpinBox3D(QWidget * parent, const char * l = "SpinBox3D:");
+
+          /// Zero the SpinBox3D display.
+          void clear()
+          {
+            for (auto & field : fields) {
+              field->disconnect();
+              field->spinBox->setValue(0.0);
+            }
+          }
+
+          /// The main layout for the SpinBox3D widget.
+          QHBoxLayout * layout;
+
+          /// Label for the SpinBox3D.
+          QLabel * label;
+
+          /// SpinBox and a connection for each field.
+          SpinBox x, y, z;
+          /// Array for iterating over fields.
+          std::array<SpinBox *, 3> fields {&x, &y, &z};
+      };
+
+      /// Initialize the transform panel and configure QObject connections.
+      struct TransformPanel {
+          explicit TransformPanel(QWidget * parent) :
+              spinBox3D(parent, "Transform:")
+          {
+          }
+
+          /// Reconnect QObject connections and spin box values in UI.
+          void setObject(const Qtk::Object * object);
+
+          SpinBox3D spinBox3D;
+      };
+      TransformPanel transformPanel_;
+
+      /// Initialize the scale panel and configure QObject connections.
+      struct ScalePanel {
+          explicit ScalePanel(QWidget * parent) : spinBox3D(parent, "Scale:") {}
+
+          /// Reconnect QObject connections and spin box values in UI.
+          void setObject(const Qtk::Object * object);
+
+          SpinBox3D spinBox3D;
+      };
+      ScalePanel scalePanel_;
+
+      /// Displays shader name, path, and read-only text view.
+      class ShaderView final : QWidget
+      {
+        public:
+          explicit ShaderView(QWidget * parent,
+                              const char * l = "ShaderView:") :
+              layout(new QVBoxLayout(this)), path(parent, l),
+              editor(new QTextEdit(parent))
+          {
+            // Create a child horizontal layout for shader name and file path.
+            auto * pathLayout = new QHBoxLayout;
+            pathLayout->addWidget(path.label);
+            pathLayout->addWidget(path.value);
+            layout->addLayout(pathLayout);
+
+            // Add the read-only text editor widget to the main layout.
+            editor->setReadOnly(true);
+            layout->addWidget(editor);
+          }
+
+          /// Zero the ShaderView display.
+          void clear() const
+          {
+            path.setValue("");
+            editor->setText("");
+          }
+
+          /// The main layout for the ShaderView widget.
+          QVBoxLayout * layout;
+
+          /// Shader name and path on disk.
+          ObjectDetails::Item path;
+
+          /// Read-only (for now) display of the shader source code.
+          QTextEdit * editor;
+      };
+      ShaderView vertex_, fragment_;
+
+      QFormLayout * properiesForm_;
+      QFormLayout * shaderForm_;
+
+      Object * objectFocus_ {};
+
       Ui::ToolBox * ui;
   };
 }  // namespace Qtk

src/designer-plugins/treeview.cpp

@@ -43,7 +43,7 @@ void Qtk::TreeView::updateView(const Qtk::Scene * scene)
   mSceneName = scene->getSceneName();
   auto objects = scene->getObjects();
   for (const auto & object : objects) {
-    QStringList list(QStringList(QString(object->getName().c_str())));
+    QStringList list(QStringList(QString(object->getName())));
     ui->treeWidget->insertTopLevelItem(0, new QTreeWidgetItem(list));
   }
 }

src/designer-plugins/widgetplugin.cpp

@@ -67,7 +67,7 @@ QString WidgetPlugin::whatsThis() const
 
 QIcon WidgetPlugin::icon() const
 {
-  return Qtk::getIcon();
+  return QIcon(":/icons/icon.png");
 }
 
 bool WidgetPlugin::isContainer() const

src/qtk/CMakeLists.txt

@@ -24,6 +24,7 @@ set(
     skybox.h
     texture.h
     transform3D.h
+    shaders.h
 )
 
 set(
@@ -43,11 +44,10 @@ set(
     transform3D.cpp
 )
 
-qt6_add_big_resources(QTK_LIBRARY_SOURCES "${QTK_RESOURCES}/resources.qrc")
+qt_add_library(qtk STATIC EXCLUDE_FROM_ALL)
-qt_add_library(qtk_library STATIC EXCLUDE_FROM_ALL)
+target_sources(qtk PRIVATE ${QTK_LIBRARY_SOURCES})
-target_sources(qtk_library PRIVATE ${QTK_LIBRARY_SOURCES})
 target_sources(
-    qtk_library PUBLIC
+    qtk PUBLIC
     FILE_SET HEADERS
       BASE_DIRS $<BUILD_INTERFACE:${CMAKE_SOURCE_DIR}/src>
       BASE_DIRS $<INSTALL_INTERFACE:${CMAKE_INSTALL_PREFIX}/include>
@@ -55,25 +55,25 @@ target_sources(
 )
 
 if(QTK_DEBUG)
-  target_compile_definitions(qtk_library PUBLIC QTK_DEBUG)
+  target_compile_definitions(qtk PUBLIC -DQTK_DEBUG)
 endif()
 
 set_target_properties(
-    qtk_library PROPERTIES
+    qtk PROPERTIES
       VERSION ${PROJECT_VERSION}
 )
 
 target_link_libraries(
-    qtk_library PUBLIC
+    qtk PUBLIC
     Qt6::Core Qt6::OpenGLWidgets Qt6::Widgets
 )
 
 if(QTK_SUBMODULES OR NOT QTK_ASSIMP_NEW_INTERFACE)
-  target_link_libraries(qtk_library PUBLIC assimp)
+  target_link_libraries(qtk PUBLIC assimp)
 elseif(QTK_ASSIMP_NEW_INTERFACE)
-  target_link_libraries(qtk_library PUBLIC assimp::assimp)
+  target_link_libraries(qtk PUBLIC assimp::assimp)
 endif()
 
 if(WIN32)
-  target_link_libraries(qtk_library PUBLIC OpenGL::GL)
+  target_link_libraries(qtk PUBLIC OpenGL::GL)
 endif()

src/qtk/meshrenderer.cpp

@@ -10,6 +10,7 @@
 
 #include "meshrenderer.h"
 #include "scene.h"
+#include "shaders.h"
 #include "texture.h"
 
 using namespace Qtk;
@@ -35,8 +36,7 @@ MeshRenderer::MeshRenderer(const char * name) :
 }
 
 MeshRenderer::MeshRenderer(const char * name, const ShapeBase & shape) :
-    Object(name, shape, QTK_MESH), mVertexShader(":/shaders/multi-color.vert"),
+    Object(name, shape, QTK_MESH), mDrawType(GL_TRIANGLES)
-    mFragmentShader(":/shaders/multi-color.frag"), mDrawType(GL_TRIANGLES)
 {
   mShape = Shape(shape);
   init();
@@ -45,7 +45,7 @@ MeshRenderer::MeshRenderer(const char * name, const ShapeBase & shape) :
 
 MeshRenderer::~MeshRenderer()
 {
-  sInstances.remove(mName.c_str());
+  sInstances.remove(mName);
 }
 
 /*******************************************************************************
@@ -68,10 +68,22 @@ void MeshRenderer::init()
   mVAO.bind();
 
   mProgram.create();
+  // If no shader is provided, use a default one.
+  if (mVertexShader.empty()) {
+    mProgram.addShaderFromSourceCode(QOpenGLShader::Vertex,
+                                     QTK_SHADER_VERTEX_MESH);
+  } else {
     mProgram.addShaderFromSourceFile(QOpenGLShader::Vertex,
                                      mVertexShader.c_str());
+  }
+
+  if (mFragmentShader.empty()) {
+    mProgram.addShaderFromSourceCode(QOpenGLShader::Fragment,
+                                     QTK_SHADER_FRAGMENT_MESH);
+  } else {
     mProgram.addShaderFromSourceFile(QOpenGLShader::Fragment,
                                      mFragmentShader.c_str());
+  }
   mProgram.link();
   mProgram.bind();
 
@@ -109,9 +121,7 @@ void MeshRenderer::draw()
   bindShaders();
   mVAO.bind();
 
-  if (mTexture.hasTexture()) {
+  mTexture.bind();
-    mTexture.getOpenGLTexture().bind();
-  }
 
   // TODO: Automate uniforms some other way
   setUniformMVP();
@@ -126,9 +136,7 @@ void MeshRenderer::draw()
                    mShape.mIndices.data());
   }
 
-  if (mTexture.hasTexture()) {
+  mTexture.bind();
-    mTexture.getOpenGLTexture().release();
-  }
 
   mVAO.release();
   releaseShaders();

src/qtk/model.cpp

@@ -56,8 +56,19 @@ void Model::flipTexture(const std::string & fileName, bool flipX, bool flipY)
   }
 }
 
+void Model::setLightPosition(const QString & lightName, const char * uniform)
+{
+  if (auto light = MeshRenderer::getInstance(lightName); light) {
+    QVector3D position = light->getTransform().getTranslation();
+    setUniform(uniform, position);
+  } else {
+    qDebug() << "[QtkScene] Failed to set " << mName
+             << "light position: " << lightName;
+  }
+}
+
 // Static function to access ModelManager for getting Models by name
-Model * Qtk::Model::getInstance(const char * name)
+Model * Model::getInstance(const char * name)
 {
   return mManager[name];
 }
@@ -102,7 +113,7 @@ void Model::loadModel(const std::string & path)
   sortModelMeshes();
 
   // Object finished loading, insert it into ModelManager
-  mManager.insert(getName().c_str(), this);
+  mManager.insert(getName(), this);
 }
 
 void Model::processNode(aiNode * node, const aiScene * scene)
@@ -261,13 +272,11 @@ ModelMesh::Textures Model::loadMaterialTextures(aiMaterial * mat,
 
 void Model::sortModelMeshes()
 {
-  auto cameraPos = Scene::getCamera().getTransform();
+  auto cameraPos = Scene::getCamera().getTransform().getTranslation();
   auto cameraDistance = [&cameraPos](const ModelMesh & a, const ModelMesh & b) {
     // Sort by the first vertex position in the model
-    return (cameraPos.getTranslation().distanceToPoint(
+    return cameraPos.distanceToPoint(a.mVertices[0].mPosition)
-               a.mVertices[0].mPosition))
+           < cameraPos.distanceToPoint(b.mVertices[0].mPosition);
-           < (cameraPos.getTranslation().distanceToPoint(
-               b.mVertices[0].mPosition));
   };
   std::sort(mMeshes.begin(), mMeshes.end(), cameraDistance);
 }

src/qtk/model.h

@@ -55,15 +55,15 @@ namespace Qtk
        */
       inline Model(const char * name,
                    const char * path,
-                   const char * vertexShader = ":/shaders/model-basic.vert",
+                   const char * vertexShader = "",
-                   const char * fragmentShader = ":/shaders/model-basic.frag") :
+                   const char * fragmentShader = "") :
           Object(name, QTK_MODEL), mModelPath(path),
           mVertexShader(vertexShader), mFragmentShader(fragmentShader)
       {
         loadModel(mModelPath);
       }
 
-      inline ~Model() override { mManager.remove(getName().c_str()); }
+      inline ~Model() override { mManager.remove(getName()); }
 
       /*************************************************************************
        * Public Methods
@@ -113,6 +113,14 @@ namespace Qtk
         }
       }
 
+      /**
+       * Sets the position of a light used in GLSL unfiroms.
+       *
+       * @param lightName Object name of the light
+       */
+      void setLightPosition(const QString & lightName,
+                            const char * uniform = "uLight.position");
+
       /*************************************************************************
        * Accessors
        ************************************************************************/

src/qtk/modelmesh.cpp

@@ -8,6 +8,7 @@
 
 #include "modelmesh.h"
 #include "scene.h"
+#include "shaders.h"
 
 using namespace Qtk;
 
@@ -73,12 +74,12 @@ void ModelMesh::draw(QOpenGLShaderProgram & shader)
  * Private Member Functions
  ******************************************************************************/
 
-void ModelMesh::initMesh(const char * vert, const char * frag)
+void ModelMesh::initMesh(const std::string & vert, const std::string & frag)
 {
   initializeOpenGLFunctions();
 
   // Create VAO, VBO, EBO
-  bool status = mVAO->create();
+  mVAO->create();
   mVBO->create();
   mEBO->create();
 
@@ -97,10 +98,26 @@ void ModelMesh::initMesh(const char * vert, const char * frag)
   mEBO->release();
 
   // Load and link shaders
-  mProgram->addShaderFromSourceFile(QOpenGLShader::Vertex, vert);
+  if (!vert.empty()) {
-  mProgram->addShaderFromSourceFile(QOpenGLShader::Fragment, frag);
+    mProgram->addShaderFromSourceFile(QOpenGLShader::Vertex, vert.c_str());
-  mProgram->link();
+  } else {
-  mProgram->bind();
+    mProgram->addShaderFromSourceCode(QOpenGLShader::Vertex,
+                                      QTK_SHADER_VERTEX_MODEL);
+  }
+
+  if (!frag.empty()) {
+    mProgram->addShaderFromSourceFile(QOpenGLShader::Fragment, frag.c_str());
+  } else {
+    mProgram->addShaderFromSourceCode(QOpenGLShader::Fragment,
+                                      QTK_SHADER_FRAGMENT_MODEL);
+  }
+
+  if (!mProgram->link()) {
+    qDebug() << "Failed to link shader: " << mProgram->log();
+  }
+  if (!mProgram->bind()) {
+    qDebug() << "Failed to bind shader: " << mProgram->log();
+  }
 
   // Positions
   mProgram->enableAttributeArray(0);

src/qtk/modelmesh.h

@@ -97,8 +97,8 @@ namespace Qtk
       ModelMesh(Vertices vertices,
                 Indices indices,
                 Textures textures,
-                const char * vertexShader = ":/model-basic.vert",
+                const char * vertexShader = "",
-                const char * fragmentShader = ":/model-basic.frag") :
+                const char * fragmentShader = "") :
           mProgram(new QOpenGLShaderProgram),
           mVAO(new QOpenGLVertexArrayObject),
           mVBO(new QOpenGLBuffer(QOpenGLBuffer::VertexBuffer)),
@@ -146,7 +146,7 @@ namespace Qtk
        * @param vert Path to vertex shader to use for this model.
        * @param frag Path to fragment shader to use for this model.
        */
-      void initMesh(const char * vert, const char * frag);
+      void initMesh(const std::string & vert, const std::string & frag);
 
       /*************************************************************************
        * Private Members

src/qtk/object.cpp

@@ -9,3 +9,15 @@
 #include "object.h"
 
 using namespace Qtk;
+
+std::string Object::getShaderSourceCode(
+    QOpenGLShader::ShaderType shader_type) const
+{
+  for (const auto & shader : mProgram.shaders()) {
+    if (shader->shaderType() == shader_type) {
+      return shader->sourceCode().toStdString();
+    }
+  }
+  qDebug() << "Failed to find shader of type " << shader_type;
+  return "";
+}

src/qtk/object.h

@@ -51,7 +51,6 @@ namespace Qtk
           mName(name), mVBO(QOpenGLBuffer::VertexBuffer), mBound(false),
           mType(type)
       {
-        initResources();
         setObjectName(name);
       }
 
@@ -60,7 +59,6 @@ namespace Qtk
           mName(name), mVBO(QOpenGLBuffer::VertexBuffer), mShape(shape),
           mBound(false), mType(type)
       {
-        initResources();
         setObjectName(name);
       }
 
@@ -102,7 +100,7 @@ namespace Qtk
         return mShape.mVertices;
       }
 
-      [[nodiscard]] inline std::string getName() const { return mName; }
+      [[nodiscard]] inline QString getName() const { return mName; }
 
       [[nodiscard]] inline const Type & getType() const { return mType; }
 
@@ -126,11 +124,26 @@ namespace Qtk
         return "Base Object has no fragment shader.";
       }
 
+      [[nodiscard]] virtual std::string getShaderSourceCode(
+          QOpenGLShader::ShaderType shader_type) const;
+
+
+      [[nodiscard]] virtual inline std::string getVertexShaderSourceCode() const
+      {
+        return getShaderSourceCode(QOpenGLShader::Vertex);
+      }
+
+      [[nodiscard]] virtual inline std::string getFragmentShaderSourceCode()
+          const
+      {
+        return getShaderSourceCode(QOpenGLShader::Fragment);
+      }
+
       /*************************************************************************
        * Setters
        ************************************************************************/
 
-      virtual inline void setName(const std::string & name) { mName = name; }
+      virtual inline void setName(const QString & name) { mName = name; }
 
       virtual inline void setColors(const Colors & value)
       {
@@ -231,6 +244,23 @@ namespace Qtk
         mProgram.release();
       }
 
+      /*************************************************************************
+       * Public Static Methods
+       ************************************************************************/
+
+      /**
+       * Helper to disconnect a QObject connection, only if it's valid.
+       * If the connection is valid and we fail to disconnect log a message.
+       *
+       * @param con QObject connection handle to disconnect.
+       */
+      static void disconnect(const QMetaObject::Connection & con)
+      {
+        if (con && !QObject::disconnect(con)) {
+          qDebug() << "[Qtk] Failed to disconnect valid connection: " << con;
+        }
+      }
+
     private:
       /*************************************************************************
        * Private Members
@@ -242,7 +272,7 @@ namespace Qtk
       Transform3D mTransform;
       Shape mShape;
       Texture mTexture;
-      std::string mName;
+      QString mName;
       bool mBound;
       Type mType = QTK_OBJECT;
   };

src/qtk/qtkapi.h

@@ -22,16 +22,6 @@
 #define QTKAPI
 #endif
 
-/**
- * Initialize Qt resources required by the Qtk library.
- * This cannot be defined within any namespace, but can be called by ctors.
- * See object.h for example.
- */
-inline void initResources()
-{
-  Q_INIT_RESOURCE(resources);
-}
-
 namespace Qtk
 {
   /**
@@ -53,14 +43,6 @@ namespace Qtk
     }
     return widget;
   }
-
-  /**
-   * @return Default icon to use for Qtk desktop application.
-   */
-  static QIcon getIcon()
-  {
-    return QIcon(":/icons/icon.png");
-  }
 }  // namespace Qtk
 
 #endif  // QTK_QTKAPI_H

src/qtk/scene.cpp

@@ -55,6 +55,34 @@ template <> Model * Scene::addObject(Model * object)
   return object;
 }
 
+template <> void Scene::removeObject(MeshRenderer * object)
+{
+  auto it = std::find(mMeshes.begin(), mMeshes.end(), object);
+  if (it == mMeshes.end()) {
+    qDebug() << "[Scene::removeObject]: Failed to remove object: "
+             << object->getName() << " (" << object << ")";
+    return;
+  }
+
+  --mObjectCount[object->getName()];
+  mMeshes.erase(it);
+  emit sceneUpdated(mSceneName);
+}
+
+template <> void Scene::removeObject(Model * object)
+{
+  auto it = std::find(mModels.begin(), mModels.end(), object);
+  if (it == mModels.end()) {
+    qDebug() << "[Scene::removeObject]: Failed to remove object: "
+             << object->getName() << " (" << object << ")";
+    return;
+  }
+
+  --mObjectCount[object->getName()];
+  mModels.erase(it);
+  emit sceneUpdated(mSceneName);
+}
+
 void Scene::draw()
 {
   if (!mInit) {
@@ -103,7 +131,7 @@ std::vector<Object *> Scene::getObjects() const
 Object * Scene::getObject(const QString & name) const
 {
   for (const auto & object : getObjects()) {
-    if (object->getName() == name.toStdString()) {
+    if (object->getName() == name) {
       return object;
     }
   }
@@ -121,6 +149,6 @@ void Scene::initSceneObjectName(Object * object)
   // If the object name exists make it unique.
   auto count = ++mObjectCount[object->getName()];
   if (count > 1) {
-    object->setName(object->getName() + " (" + std::to_string(count) + ")");
+    object->setName(object->getName() + " (" + QString::number(count) + ")");
   }
 }

src/qtk/scene.h

@@ -85,16 +85,16 @@ namespace Qtk
 
       void loadModel(const QUrl & url)
       {
-        auto fileName = url.fileName().replace(".obj", "").toStdString();
+        auto fileName = url.fileName().replace(".obj", "");
-        auto filePath = url.toLocalFile().toStdString();
+        auto filePath = url.toLocalFile();
         loadModel(fileName, filePath);
       }
 
-      void loadModel(const std::string & name, const std::string & path)
+      void loadModel(const QString & name, const QString & path)
       {
         // Add the dropped model to the load queue.
         // This is consumed during rendering of the scene if not empty.
-        mModelLoadQueue.emplace(name, path);
+        mModelLoadQueue.emplace(name.toStdString(), path.toStdString());
       }
 
       /*************************************************************************
@@ -120,9 +120,7 @@ namespace Qtk
        */
       [[nodiscard]] uint64_t getObjectCount(const QString & name)
       {
-        return mObjectCount.count(name.toStdString())
+        return mObjectCount.count(name) ? mObjectCount[name] : 0;
-                   ? mObjectCount[name.toStdString()]
-                   : 0;
       }
 
       /**
@@ -184,8 +182,9 @@ namespace Qtk
 
       /**
        * Adds objects to the scene.
-       * This template provides explicit specializations for valid types.
+       * This template provides explicit specializations for the valid types:
-       * Adding any object other than these types will cause errors.
+       * 		MeshRenderer, Model
+       * Any other object type will cause errors.
        * TODO: Refactor to use Object base class container for scene objects.
        *
        * If creating a new object type for a scene, it must inherit Qtk::Object
@@ -196,6 +195,17 @@ namespace Qtk
        */
       template <typename T> T * addObject(T * object);
 
+      /**
+       * Removes an object from the scene.
+       * This template provides explicit specializations for the valid types:
+       * 		MeshRenderer, Model
+       * Any other object type will cause errors.
+       * TODO: Refactor to use Object base class container for scene objects.
+       *
+       * @param object Pointer to the object to remove from the scene.
+       */
+      template <typename T> void removeObject(T * object);
+
       /**
        * @param name The name to use for this scene.
        */
@@ -248,7 +258,7 @@ namespace Qtk
       /* MeshRenderers used simple geometry. */
       std::vector<MeshRenderer *> mMeshes {};
       /* Track count of objects with same initial name. */
-      std::unordered_map<std::string, uint64_t> mObjectCount;
+      std::unordered_map<QString, uint64_t> mObjectCount;
   };
 }  // namespace Qtk
 

src/qtk/shaders.h

@@ -0,0 +1,121 @@
+/*##############################################################################
+## Author: Shaun Reed                                                         ##
+## Legal: All Content (c) 2025 Shaun Reed, all rights reserved                ##
+## About: Default GLSL shaders to use for objects if no shader if provided.   ##
+##                                                                            ##
+## Contact: shaunrd0@gmail.com  | URL: www.shaunreed.com | GitHub: shaunrd0   ##
+##############################################################################*/
+#ifndef QTK_SHADERS_H
+#define QTK_SHADERS_H
+
+//
+// Model
+
+#define QTK_SHADER_VERTEX_MODEL \
+  R"(
+#version 330 core
+layout (location = 0) in vec3 aPosition;
+layout (location = 1) in vec3 aNormal;
+layout (location = 2) in vec2 aTextureCoord;
+
+out vec2 vTextureCoord;
+
+uniform mat4 uModel;
+uniform mat4 uView;
+uniform mat4 uProjection;
+
+void main()
+{
+    vTextureCoord = aTextureCoord;
+    gl_Position = uProjection * uView * uModel * vec4(aPosition, 1.0);
+}
+)"
+
+#define QTK_SHADER_FRAGMENT_MODEL \
+  R"(
+#version 330 core
+out vec4 fColor;
+
+in vec2 vTextureCoord;
+
+uniform sampler2D texture_diffuse1;
+
+void main()
+{
+    fColor = texture(texture_diffuse1, vTextureCoord);
+}
+)"
+
+//
+// MeshRenderer
+
+#define QTK_SHADER_VERTEX_MESH \
+  R"(
+#version 330
+layout(location = 0) in vec3 aPosition;
+layout(location = 1) in vec3 aColor;
+
+out vec4 vColor;
+
+uniform mat4 uModel;  // Model
+uniform mat4 uView; // View
+uniform mat4 uProjection;  // Projection
+
+void main()
+{
+  gl_Position = uProjection * uView * uModel * vec4(aPosition, 1.0);
+
+  vColor = vec4(aColor, 1.0f);
+}
+)"
+
+#define QTK_SHADER_FRAGMENT_MESH \
+  R"(
+#version 330
+in vec4 vColor;
+
+out vec4 fColor;
+
+void main()
+{
+  fColor = vColor;
+}
+)"
+
+//
+// Skybox
+
+#define QTK_SHADER_VERTEX_SKYBOX \
+  R"(
+#version 330
+layout(location = 0) in vec3 aPosition;
+
+out vec3 vTexCoord;
+
+uniform mat4 uProjectionMatrix;
+uniform mat4 uViewMatrix;
+
+void main()
+{
+  // Strip translation column from camera's 4x4 matrix
+  mat4 view = mat4(mat3(uViewMatrix));
+  gl_Position = uProjectionMatrix * view * vec4(aPosition, 1.0);
+  vTexCoord = aPosition;
+}
+)"
+
+#define QTK_SHADER_FRAGMENT_SKYBOX \
+  R"(
+#version 330
+uniform samplerCube uTexture;
+
+in vec3 vTexCoord;
+out vec4 FragColor;
+
+void main()
+{
+  FragColor = texture(uTexture, vTexCoord);
+}
+)"
+
+#endif  // QTK_SHADERS_H

src/qtk/skybox.cpp

@@ -8,6 +8,7 @@
 
 #include "skybox.h"
 #include "scene.h"
+#include "shaders.h"
 #include "texture.h"
 
 using namespace Qtk;
@@ -16,9 +17,28 @@ using namespace Qtk;
  * Constructors / Destructors
  ******************************************************************************/
 
-Skybox::Skybox(QOpenGLTexture * cubeMap, const std::string & name)
+Skybox::Skybox(const std::string & name) :
+    mVBO(QOpenGLBuffer::VertexBuffer),
+    mVertices(Cube(QTK_DRAW_ELEMENTS).getVertices()),
+    mIndices(Cube(QTK_DRAW_ELEMENTS).getIndexData())
 {
+  QImage image({1024, 1024}, QImage::Format_RGBA8888);
+  image.fill(Qt::darkGray);
+  mTexture.setCubeMap(image, image, image, image, image, image);
+  init();
+}
+
+Skybox::Skybox(QOpenGLTexture * cubeMap, const std::string & name) :
+    mVBO(QOpenGLBuffer::VertexBuffer),
+    mVertices(Cube(QTK_DRAW_ELEMENTS).getVertices()),
+    mIndices(Cube(QTK_DRAW_ELEMENTS).getIndexData())
+{
+  if (cubeMap == Q_NULLPTR) {
+    qDebug()
+        << "[Qtk] Failed to set cubemap for skybox with null QOpenGLTexture.";
+  } else {
     mTexture.setTexture(cubeMap);
+  }
   init();
 }
 
@@ -33,13 +53,13 @@ Skybox::Skybox(const std::string & right,
     mVertices(Cube(QTK_DRAW_ELEMENTS).getVertices()),
     mIndices(Cube(QTK_DRAW_ELEMENTS).getIndexData())
 {
-  init();
   mTexture.setCubeMap(QImage(right.c_str()).mirrored(),
                       QImage(top.c_str()),
                       QImage(front.c_str()),
                       QImage(left.c_str()),
                       QImage(bottom.c_str()),
                       QImage(back.c_str()));
+  init();
 }
 
 /*******************************************************************************
@@ -53,7 +73,7 @@ void Skybox::draw()
 
   mVAO.bind();
   mProgram.bind();
-  mTexture.getOpenGLTexture().bind();
+  mTexture.bind();
 
   mProgram.setUniformValue("uProjectionMatrix", Scene::getProjectionMatrix());
   mProgram.setUniformValue("uViewMatrix", Scene::getCamera().toMatrix());
@@ -61,7 +81,7 @@ void Skybox::draw()
   glDrawElements(
       GL_TRIANGLES, mIndices.size(), GL_UNSIGNED_INT, mIndices.data());
 
-  mTexture.getOpenGLTexture().bind();
+  mTexture.bind();
   mProgram.release();
   mVAO.release();
 
@@ -80,10 +100,10 @@ void Skybox::init()
 
   // Set up shader program
   mProgram.create();
-  mProgram.addShaderFromSourceFile(QOpenGLShader::Vertex,
+  mProgram.addShaderFromSourceCode(QOpenGLShader::Fragment,
-                                   ":/shaders/skybox.vert");
+                                   QTK_SHADER_FRAGMENT_SKYBOX);
-  mProgram.addShaderFromSourceFile(QOpenGLShader::Fragment,
+  mProgram.addShaderFromSourceCode(QOpenGLShader::Vertex,
-                                   ":/shaders/skybox.frag");
+                                   QTK_SHADER_VERTEX_SKYBOX);
   mProgram.link();
   mProgram.bind();
 

src/qtk/skybox.h

@@ -34,7 +34,12 @@ namespace Qtk
        * Constructors / Destructors
        ************************************************************************/
 
-      // Delegate this constructor to use default skybox images
+      /**
+       * Construct a skybox with a default texture.
+       *
+       * @param name The objectName to use for the Skybox.
+       */
+      explicit Skybox(const std::string & name = "Skybox");
 
       /**
        * Construct a skybox with an existing QOpenGLTexture.

src/qtk/texture.cpp

@@ -8,6 +8,7 @@
 
 #include <QDebug>
 #include <QImageReader>
+#include <QPainter>
 
 #include "texture.h"
 
@@ -65,6 +66,22 @@ QOpenGLTexture * OpenGLTextureFactory::initCubeMap(const char * right,
                      QImage(back));
 }
 
+QImage OpenGLTextureFactory::defaultTexture()
+{
+  QImage image({256, 256}, QImage::Format_RGBA8888);
+  image.fill(Qt::lightGray);
+
+  // Draw a red '?' to the center of the image.
+  QPainter painter(&image);
+  painter.setRenderHint(QPainter::Antialiasing);
+  painter.setPen(Qt::red);
+  painter.setFont({"Helvetica", 100, QFont::Bold});
+  constexpr QRect rect(0, 0, 256, 256);
+  painter.drawText(rect, Qt::AlignCenter, "?");
+
+  return image;
+}
+
 QOpenGLTexture * OpenGLTextureFactory::initCubeMap(const QImage & right,
                                                    const QImage & top,
                                                    const QImage & front,
@@ -87,9 +104,9 @@ QOpenGLTexture * OpenGLTextureFactory::initCubeMap(const QImage & right,
       QOpenGLTexture::CubeMapNegativeZ};
   int i = 0;
   for (const auto & face : faces) {
-    QImage faceImage(faceTextures[i]);
+    QImage & faceImage = faceTextures[i];
     if (faceImage.isNull()) {
-      qDebug() << "Error loading cube map image\n";
+      qDebug() << "[libqtk] Error loading cube map image\n";
       faceImage = defaultTexture();
     }
     faceImage = faceImage.convertToFormat(QImage::Format_RGBA8888);

src/qtk/texture.h

@@ -145,13 +145,7 @@ namespace Qtk
                                           const char * back);
 
       /// The texture used in place of a missing texture.
-      static QImage defaultTexture()
+      static QImage defaultTexture();
-      {
-        // Use plaster for default texture if image fails to load.
-        // This prevents segfaults when loading a texture that doesn't exist.
-        // TODO: Replace with a '?' texture to indicate missing texture.
-        return QImage(":/textures/plaster.png");
-      }
 
     private:
       // Private ctor to prevent creating instances of this class
@@ -223,6 +217,20 @@ namespace Qtk
         return mOpenGLTexture != Q_NULLPTR;
       }
 
+      /**
+       * Bind the OpenGL texture if it exists, avoiding segmentation faults.
+       */
+      bool bind() const
+      {
+        if (hasTexture()) {
+          // TODO: It would be nice to warn here but some objects may not have
+          // a texture. Factor Texture out of those objects so we don't bind.
+          mOpenGLTexture->bind();
+          return true;
+        }
+        return false;
+      }
+
       /*************************************************************************
        * Accessors
        ************************************************************************/
@@ -306,12 +314,12 @@ namespace Qtk
       /**
        * Sets this Texture to be a cube map with provided sides.
        *
-       * @param right Path to texture to use for right cube map side.
+       * @param right QImage texture to use for right cube map side.
-       * @param top Path to texture to use for top cube map side.
+       * @param top QImage texture to use for top cube map side.
-       * @param front Path to texture to use for front cube map side.
+       * @param front QImage texture to use for front cube map side.
-       * @param left Path to texture to use for left cube map side.
+       * @param left QImage texture to use for left cube map side.
-       * @param bottom Path to texture to use for bottom cube map side.
+       * @param bottom QImage texture to use for bottom cube map side.
-       * @param back Path to texture to use for back cube map side.
+       * @param back QImage texture to use for back cube map side.
        */
       virtual inline void setCubeMap(const QImage & right,
                                      const QImage & top,