From 6c84895f6c7e0780431afdb58b74f64780a16845 Mon Sep 17 00:00:00 2001 From: JulianThijssen Date: Thu, 12 Oct 2023 14:04:12 +0200 Subject: [PATCH 1/4] Update README.md --- README.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index d82e2a6..0ac826d 100644 --- a/README.md +++ b/README.md @@ -20,18 +20,31 @@ Be sure to first have ManiVault installed before continuing to download this rep ``` git clone https://github.com/ManiVaultStudio/ExamplePlugins.git ``` -After unzipping the download file or navigating to the cloned folder, continue with the next step. +With SSH this would be: +``` +git clone git@github.com:ManiVaultStudio/ExamplePlugins.git +``` +After unzipping you should have an `ExamplePlugins-master`, after cloning you should have an `ExamplePlugins` folder, after navigating to this folder, continue with the next step. ## Project setup You'll need to define a `MV_INSTALL_DIR` variable and provide it to CMake, as described in the ManiVault install guide. This variable is used to find your local ManiVault installation and defines an install location for the example plugins. For Windows, using the CMake GUI: 1. Launch CMake (available here: https://cmake.org/) -2. In the source code field browse to the `ExamplePlugins-master` folder (which contains CMakeLists.txt). -3. In the build field browse to the `ExamplePlugins-master/build` folder. It will create it if it doesn't exist. -4. Press `Configure` and select the `Visual Studio 15 2019` (or 16 2022) generator with the optional platform of `x64`. If it is not available, be sure to install Visual Studio. Press Finish to configure the project. -5. A lot of red paths should now appear. Check that the ones pointing to Qt directories seem correct and then press `Generate` to generate the Visual Studio solution. -6. Press `Open Project` to launch Visual Studio and the example project. +2. In the source code field browse to the `ExamplePlugins-master` or `ExamplePlugins` folder (which contains CMakeLists.txt). +3. In the build field browse to the `ExamplePlugins-master/build` or `ExamplePlugins/build` folder. It will create it if it doesn't exist. + + The source and build fields in your cmake should now roughly look like this: + + `Source: C:/YourOwnFolder/ExamplePlugins-master` + `Build: C:/YourOwnFolder/ExamplePlugins-master/build` + +4. Press `Configure` and select the `Visual Studio 15 2019` (or 17 2022) generator with the optional platform of `x64`. If it is not available, be sure to install Visual Studio. Press Finish to configure the project. +5. CMake should now ask you to provide an `MV_INSTALL_DIR` path that points to where ManiVault is installed. Double click the `MV_INSTALL_DIR` variable and press the small button on the right to browse to the folder where ManiVault Studio is installed. (The folder containing either or both the Debug and Release folder). +![image](https://github.com/ManiVaultStudio/ExamplePlugins/assets/2978176/8f082e77-d90d-45fb-bc0d-e0b8a5a634f3) + +6. A lot of red paths should now appear. Check that the ones pointing to Qt directories seem correct and then press `Generate` to generate the Visual Studio solution. If it is asking you for a Qt6_DIR please refer to [CMake cannot find my Qt Installation](https://github.com/ManiVaultStudio/PublicWiki/wiki/FAQ#cmake-cannot-find-my-qt-installation). +7. Press `Open Project` to launch Visual Studio and the example project. ## Compiling For Windows: From 246a5cc82cc0335bdb3f9e3f7418a32f05dbf0a5 Mon Sep 17 00:00:00 2001 From: JulianThijssen Date: Thu, 12 Oct 2023 14:07:39 +0200 Subject: [PATCH 2/4] Update README.md --- README.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 0ac826d..328c920 100644 --- a/README.md +++ b/README.md @@ -49,8 +49,7 @@ For Windows, using the CMake GUI: ## Compiling For Windows: 1. At the top of Visual Studio set the build mode (where it says `Debug`) to `Release`. -2. Right click the project `ExamplePlugins` in the Solution Explorer and select Set as StartUp Project. -3. Right click the project again and select Properties. -4. In the Configuration Properties -> Debugging set the `Command` by browsing to your `HDPS.exe` file. Set the `Working Directory` field by browsing to the folder containing the `HDPS.exe` file. -5. Press Apply and OK and right click the project in the Solution Explorer and press Build. -6. If all is well the build should succeed and if you run the project with Ctrl+F5 it will launch `HDPS.exe` and load the Example project as an available plug-in. +2. Right click the project `ALL_BUILD` in the Solution Explorer and select Properties. +3. In the Configuration Properties -> Debugging set the `Command` by browsing to your `ManiVault Studio.exe` file. Set the `Working Directory` field by browsing to the folder containing the `ManiVault Studio.exe` file. +4. Press Apply and OK and right click the project in the Solution Explorer and press Build. +5. If all is well the build should succeed and if you run the project with Ctrl+F5 it will launch `ManiVault Studio.exe` and load the Example project as an available plug-in. From e8d1ecca1ead2cdf7a3fd4836c3e9f9d6dee53ef Mon Sep 17 00:00:00 2001 From: JulianThijssen Date: Thu, 12 Oct 2023 14:09:26 +0200 Subject: [PATCH 3/4] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 328c920..4413e6c 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ # ManiVault Example Plugins +(ManiVault version 0.9) [ManiVault](https://github.com/ManiVaultStudio/Core) can currently be extended by six types of plugins, each dedicated to a specific functionality. Here, you can find exemplary implementations for each plugins type that can be used as a starting point for new plugins: - [Analysis](https://github.com/ManiVaultStudio/ExamplePlugins/tree/master/ExampleAnalysis): general analytics methods, e.g., dimensionality reduction From 21518b0b410b67c7b4f11e85e9ff394b42b0c9ca Mon Sep 17 00:00:00 2001 From: JulianThijssen Date: Thu, 12 Oct 2023 14:10:17 +0200 Subject: [PATCH 4/4] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4413e6c..39a9ba6 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ - [View](https://github.com/ManiVaultStudio/ExamplePlugins/tree/master/ExampleView): visualize data and provide interaction, e.g., using [OpenGL](https://github.com/ManiVaultStudio/ExamplePlugins/tree/master/ExampleViewOpenGL) or [JavaScript](https://github.com/ManiVaultStudio/ExamplePlugins/tree/master/ExampleViewJS) backends ## Requirements -* ManiVault (https://github.com/ManiVaultStudio/Core) +* ManiVault Studio (https://github.com/ManiVaultStudio/Core) * CMake 3.17+ (https://cmake.org/) * Qt 6.3.1+ (https://www.qt.io/download), additional libraries: Qt WebEngine, Qt WebChannel, Qt Positioning and the Qt5 Compatibility Module * A C++17 compatible compiler