NoesisGUI
 

🎓 Installing and Setting Up Noesis Studio

đŸ˜ī¸ NoesisGUI ▸ 🏠 Noesis Studio ▸ 🎓 Installing and Setting Up Noesis Studio

1. Download Noesis Studio

If you haven't yet downloaded Noesis Studio and its associated files, or if you wish to update a previously-downloaded copy of the application, you should first đŸ’ģ Download Noesis Studio.

Inside of the downloaded folder, you will find the following:

NoesisGUI-Studio-win-#.#.###-xxxx
đŸ–ŗ App.StudioTool.exe
The Noesis Studio application.
🗋 version.txt
A text file in which you can find information on the downloaded version of Noesis Studio.
🗀 Samples
A selection of projects made in Noesis Studio, which you can use as reference, or as a medium through which to discover some of the features of the application.

Note

The provided Noesis Studio Windows executable is delivered as a portable application. This means that it does not need to be 'installed' to your computer (for example, you can run Studio directly from a USB stick). This 'portable' nature results in a more flexible, and far cleaner presence on your machine than is usually the case for more typical software installations.

2. Setting up Your Environment

2.1 Selecting a Directory for the Application

Due to Noesis Studio being a portable application, the đŸ–ŗ App.StudioTool.exe file included in the download is not the installer, but the actual application itself. Therefore, before continuing, you should select a robust location for the application to live on your machine. This should ideally be somewhere easy to access, and where the file won't accidentally be deleted (as deleting the file will have the same effect as removing the application from your machine.)

When selecting a directory for the application to live, we recommend keeping đŸ–ŗ App.StudioTool.exe and the 🗀 Samples folder together in the same directory at the start of your journey. Keeping them together will result in these reference projects being automatically loaded, and easy to access when launching Studio.

If you do not wish for these samples to always appear in the Launcher, simply remove the 🗀 Samples folder from the directory shared with the application file at any time. Doing so will have no detrimental effect on the application other than preventing the automatic loading of the sample projects.

If the 🗀 Samples folder is not kept alongside the application, any projects you wish to open for inspection will have to be added manually: 📑 Adding Projects

2.2. Replicating the Features of an Installed Application (Optional)

If you wish to have your copy of Noesis Studio appear within your Windows Start Menu, pinned to your Windows Taskbar, or if you wish to access it via a Shortcut placed anywhere on your machine (such as your Desktop), you can perform the following steps:

Prerequisite (All Methods)

Regardless of method chosen below, you will first need to select a location on your machine where you wish for đŸ–ŗ App.StudioTool.exe to permanently live. This is required as all of the below methods need to point to a fixed location to properly link to the portable application file.

Note

If you change the location of đŸ–ŗ App.StudioTool.exe after using any of the below methods, you will have to update the shortcut to reflect the new location of the application file.

Add Noesis Studio to the Start Menu

Windows 10, Windows 11:

  • Right-Click on đŸ–ŗ App.StudioTool.exe, and select 'Pin to Start' from the context menu.

The application should now appear in your Start Menu shortcuts.

Pin Noesis Studio to the Taskbar

Windows 10:

  • Right-Click on đŸ–ŗ App.StudioTool.exe, and select 'Pin to Taskbar' from the context menu.

Windows 11:

  1. Right-Click on đŸ–ŗ App.StudioTool.exe, and select 'Show More Options' from the context menu.
  2. Click on 'Pin to Taskbar' from the context menu.

The application should now appear within your Taskbar.

Create a Portable Noesis Studio Shortcut

Windows 10:

  • Right-Click on đŸ–ŗ App.StudioTool.exe, and select 'Send to'▸'Desktop (Create Shortcut)' from the context menu.

Windows 11:

  1. Right-Click on đŸ–ŗ App.StudioTool.exe, and select 'Show More Options' from the context menu.
  2. Click on 'Send to'▸'Desktop (create shortcut)' from the context menu.

The application should now appear on your Desktop, and you can now move this shortcut to anywhere you wish on your machine.

3. Opening Noesis Studio and Discovering the Launcher

When you are ready, double-click on the Noesis Studio đŸ–ŗ App.StudioTool.exe application, the Launcher will open, and you will be presented with a listing of projects associated to the application. Clicking on any project in this list will open it in the visual editor.

Project Listing

If you elected to keep the 🗀 Samples folder alongside your đŸ–ŗ App.StudioTool.exe file, you will see these appear in the Launcher's project listing every time you start Noesis Studio. Any projects you manually add will also appear in this list.

Tutorial_InstallationAndSetup_Launcher_Projects.png

If you chose to not carry over the 🗀 Samples folder, or removed it before launching the application, these will not appear in the project listing.

Opening Projects

Any projects present in the Project Listing can be launched in the Launcher by clicking on the project row.

Creating Projects

Clicking 'Create New' in the Launcher will open your file browser, from where you can select a directory in which to store your .noesis project file.
Tutorial_InstallationAndSetup_Launcher_CreateNew.png Tutorial_InstallationAndSetup_Launcher_FileExplorer.png

Once created, this new .noesis file, or project root can be moved to a different location on your machine after creating it, but doing so will make it disappear from the project listing. To make it appear once again will require you to select 'Add Existing' within the Launcher, and re-add it from its new location: 📑 Adding Projects

Note

When inputting the name for your new .noesis file, you are not obligated to include the '.noesis' extension in the field. If this suffix is not included in the file name directly, it will be automatically added after providing a name and clicking 'Add Project' to complete the creation of your project file.

Note

To avoid breaking any content, once you have created interfaces within Studio, it is not recommended to move your .noesis file to a different location without its associated .xaml files that it depends on to correctly display, and to function.

Adding Projects

Clicking the 'Add Existing' button will open your file browser, and allow you to select an existing .noesis project to add to the Launcher.

Tutorial_InstallationAndSetup_Launcher_AddExisting.png

Note

If you already have a non-Studio XAML project that you wish to open in Studio, you will first have to create a new .noesis project in the same directory as your current project's root. This can be done directly from the launcher: 📑 Creating Projects

Removing Projects

Clicking on the 🗑 (Remove) icon found on any project row will remove it from the project listing until it is manually re-added.

Tutorial_InstallationAndSetup_Launcher_Remove.png

Note

Removing a project from the Launcher, only removes it from the project listing, and does not remove it from your machine.

If you elected to keep the 🗀 Samples folder alongside your đŸ–ŗ App.StudioTool.exe file, these will be re-added to the Launcher at every launch. If you wish for these to no longer appear, remove the 🗀 Samples folder from the directory shared with đŸ–ŗ App.StudioTool.exe.

5. The Visual Editor

When you are set up, ready to jump in and continue your journey of discovery, moving into the visual editor, we recommend following with:

6. Engine Integration (Optional)

Tutorial_InstallationAndSetup_Feature_HotReloading.png

Methods of Operation

Although Noesis Studio can be run as a standalone visual editor for Noesis XAML interfaces. when paired with an engine in 'connected mode', it can benefit from enhanced features such as:

  • Seamless integration of engine-encapsulated content, such as data, materials or 3D assets, directly into Studio.
  • Shared data contexts between Noesis Studio and your engine.
  • With built-in hot-reloading, any changes made in Studio are instantaneously reflected in-engine, all without losing the currently-active engine user state.
  • The ability for Studio to leverage cusom controls, converters, and actions from your engine.
  • The ability to introduce new texture formats, or even replace the entire renderer, whilst maintaining visual parity between Studio and the engine.

Note

Installation of both the apppropriate SDK and matching NoesisGUI Plugin are required to pair Studio with your engine.

Noesis Studio
Standalone Application
✅ Released
Unity
Direct Integration
Downloads:
Unreal Engine
Direct Integration
Custom Engine
Direct Integration
Downloads:
 
© 2017 Noesis Technologies