Installation: Difference between revisions

From PanelForge 7 Documentation
No edit summary
No edit summary
 
(52 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Preparation=
__NOTOC__


Make sure the target computer system reaches the minimum [[System Requirements]]. Obtain the correct PanelForge software distribution for your computer’s operating system. Carefully refer to this PanelForge documentation wiki when required.
PanelForge is distributed as an intuitive Installer Executable. After installation PanelForge can be opened via the 'PanelForge' item added to the 'Windows Start Menu'.


The PanelForge software is provided in three forms:
Major PanelForge versions (7.0, 6.0, 5.0 etc) can be installed concurrently. Each version will use independent settings.
* PanelForge-1_X_X-Mac64.dmg - A Macintosh OS X compressed disk image containing the ‘PanelForge.app’ OS X application file.
* PanelForge-1_X_X-Win64.exe - A Windows installer executable that will install the PanelForge Program directory and register the PanelForge executable and uninstaller in the Windows registry and add a shortcut to PanelForge to the Windows Start Menu.
* PanelForge-1_X_X-Win64.zip - A compressed directory containing the PanelForge Program directory which contains the ‘PanelForge.exe’ executable that can be run without installation for portability and testing.


=Installation=
'PanelForge Studio' is also provided as a simple zip compressed directory for flexibility allowing multiple versions to be accessed simply in a Studio environment. 


Although the installation of PanelForge is designed to be as easy and intuitive as possible the following provides a detail description of it's nature.
===Preparation===


==Windows==
Make sure the target computer system reaches the minimum [[System Requirements]]. Carefully refer to this PanelForge documentation when required.


===Standard Installation===
The PanelForge software is provided directly in three forms:
* '''PanelForge-X_X_X-macOS-Universal.zip''' - A compressed self contained 'macOS App' File. Simply uncompress and drag to Application folder to Install. Drag the Application File to the macOS 'Dock' for quick access.
* '''PanelForge-X_X_X-Win64.exe''' - A Windows installer executable that will install the PanelForge Program directory and register the PanelForge executable with Windows.
* '''PanelForge-X_X_X-Win64.zip'''  - (Studio version only) A compressed directory containing the Windows PanelForge Program directory. Contains a ‘PanelForge.exe’ executable that can be run directly without the need for installation.


If you have already installed a previous version of ‘PanelForge’ it is required to be uninstalled before continuing.
Offical PanelForge downloads are provided in some tiers/regions via the following third-parties:
* '''Apple 'Mac App Store'.'''
* '''Microsoft Windows 'App Store'.'''


To install on Windows load the installer executable for PanelForge and follow the simple on screen instructions:
* PanelForge-1_X_X-Win64.exe


The installer will install the following items:
===Windows Installation===
 
If you have already installed a previous version of ‘PanelForge’ you will be prompted for it to be uninstalled before continuing.
 
* First 'double click' the '''PanelForge-X_X_X-Win64.exe''' installer executable file icon.
* Then simply follow the simple on-screen instructions.
 
:[[File: PanelForgeInstaller02.PNG|frame|546px|none]]
 
<small>The installer will install the following items:
* The PanelForge program directory (default into the Windows ‘ProgramFiles’ directory).
* The PanelForge program directory (default into the Windows ‘ProgramFiles’ directory).
* A Shortcut to the PanelForge executable and uninstaller executable into the Windows Start Menu.
* A Shortcut to the PanelForge executable and uninstaller executable into the Windows Start Menu.
* Registry entries for PanelForge Project ‘pfz’ and Panel ‘pfn’ file format association.
* Registry entries for PanelForge Project ‘pfz’ and Panel ‘pfn’ file format association.
* Registry entries for PanelForge Project and Panel file format icons for use in Windows Explorer.
* Registry entries for PanelForge Project and Panel file format icons for use in Windows Explorer.
* Registry entry for PanelForge uninstaller for use with the ‘Uninstall A Program’ Windows Control Panel.
* Registry entry for PanelForge uninstaller for use with the ‘Uninstall a Program’ Windows Control Panel.
 
</small>
===Silent Command Line Installation===
 
The above installer executable can also be used via the Windows Command Prompt without the display of graphical windows. This mode can be activated using ‘/s’ silent flag.


===Portable Installation===


For temporary usage of PanelForge the compressed distribution of the PanelForge Program directory can be used:
===Windows Uninstallation===
* PanelForge-1_X_X-Win64.zip


First decompress the above file, then open the ‘panelforge.exe’ Windows executable file in the decompressed PanelForge Program directory.
First, exit PanelForge if open before proceeding with uninstallation.


Using this installation method for a permanent solution is not recommend as it will not provide the optimal experience with the Windows operating system.
:[[File: PanelForgeInstaller05.PNG|frame|531px|none]]
 
==Macintosh==
 
If you have already installed a previous version of PanelForge it is recommended to uninstall it before continuing to avoid possible confussion.
 
To install on Macintosh open the PanelForge disk image file using the OS X Finder:
* PanelForge-1_X_X-Mac64.dmg
 
In the disk mounted from the above disk image drag the ‘PanelForge’ application file to the ‘Application’ folder. The mounted disk can then be ejected and the copied ‘PanelForge’ application opened.
The ‘PanelForge’ application will open and function correctly if renamed or moved to any other folder although the above placement is recommended.
 
=Activation=
 
=Uninstallation=
 
==Windows==
 
First exit PanelForge if open before proceeding with uninstallation.


To uninstall PanelForge the Windows 'Uninstall or Change a Program' Control Panel can be used.  
To uninstall PanelForge the Windows 'Uninstall or Change a Program' Control Panel can be used.  
The following instructions refer to Windows 7, under other version of Windows the method may vary.
The following instructions refer to Windows 11, under other versions of Windows the method may vary.


1) Open the Windows 'Control Panels' using the start menu item.
# Open the Windows 'Settings' using the start menu item.
# Click the 'Apps' item from the list on the left.
# Click the 'Installed apps' item from the main list.
# Locate the 'PanelForge (Studio/Pro)' item in the app list.
# Click the '...' menu button and select 'Uninstall'
# Select ‘Yes’ when prompted to uninstall 'PanelForge (Studio/Pro).
# You have now have successfully uninstalled 'PanelForge (Studio/Pro)’.


2) Select the 'Uninstall a program' item.


3) In the 'Uninstall or change a program' window double click the 'Garibaldi Express' item from the list.
===Silent Windows Command Line Installation===


4) Select Yes when prompted to uninstall 'Garibaldi Express'.
The above installer executable can also be used via the Windows Command Prompt without the display of graphical windows. This mode can be activated using ‘/S’ silent flag.
:[[File: PanelForgeInstaller04.PNG|frame|704px|none]]


5) You have now have successfully uninstalled 'Garibaldi Express'.


==Macintosh==
===Silent Windows Command Line Uninstallation===


First quit PanelForge application if open before proceeding with uninstallation.
The PanelForge Windows Uninstaller is located in the 'PanelForge (Studio/Pro)' Program Files Directory.  


Locate the PanelForge application you installed and to the trash.
The Silent mode can be activated using ‘/S’ silent flag.  


For complete removal the current users preferences file can be also optional removed from ‘~/Library/Preferences/com.panelforge.PanelForge.plist’.
Example default Uninstaller 'PanelForge Studio' location (replace 'X' with major version number):
  "C:\Program Files\PanelForgeStudioX\Uninstallers\PanelForge Studio X Uninstaller.exe" /S


=Troubleshooting=


If you are experiencing unexpected results and require additional support contact use via email: TODO
===Portable Windows Installation ('Studio' version only)===


==The PanelForge Viewport UI is not drawing Correctly==
First, decompress the '''PanelForge-X_X_X-Win64.zip''' file, then open the ‘panelforge.exe’ Windows executable file in the decompressed PanelForge Program directory.


Installing a newer graphics card/chipset driver in many cases will fix this issue.
:[[File: PanelForgeInstaller03.PNG|frame|606px|none]]
Older versions of Windows may not automatically update graphics card drivers as part of the 'Windows Update' feature.


Official Graphics card/chipset drivers can be found at the following websites depending on model:
Using this installation method for a permanent solution is not recommend as it will not provide the optimal experience with the Windows operating system.
 
[http://downloadcenter.intel.com/ Intel: https://downloadcenter.intel.com/]
 
[http://www.geforce.com/drivers NVIDIA: http://www.geforce.com/drivers]
 
[http://support.amd.com/en-us/download AMD/ATI: http://support.amd.com/en-us/download]

Latest revision as of 16:13, 13 August 2025


PanelForge is distributed as an intuitive Installer Executable. After installation PanelForge can be opened via the 'PanelForge' item added to the 'Windows Start Menu'.

Major PanelForge versions (7.0, 6.0, 5.0 etc) can be installed concurrently. Each version will use independent settings.

'PanelForge Studio' is also provided as a simple zip compressed directory for flexibility allowing multiple versions to be accessed simply in a Studio environment.

Preparation

Make sure the target computer system reaches the minimum System Requirements. Carefully refer to this PanelForge documentation when required.

The PanelForge software is provided directly in three forms:

  • PanelForge-X_X_X-macOS-Universal.zip - A compressed self contained 'macOS App' File. Simply uncompress and drag to Application folder to Install. Drag the Application File to the macOS 'Dock' for quick access.
  • PanelForge-X_X_X-Win64.exe - A Windows installer executable that will install the PanelForge Program directory and register the PanelForge executable with Windows.
  • PanelForge-X_X_X-Win64.zip - (Studio version only) A compressed directory containing the Windows PanelForge Program directory. Contains a ‘PanelForge.exe’ executable that can be run directly without the need for installation.

Offical PanelForge downloads are provided in some tiers/regions via the following third-parties:

  • Apple 'Mac App Store'.
  • Microsoft Windows 'App Store'.


Windows Installation

If you have already installed a previous version of ‘PanelForge’ you will be prompted for it to be uninstalled before continuing.

  • First 'double click' the PanelForge-X_X_X-Win64.exe installer executable file icon.
  • Then simply follow the simple on-screen instructions.

The installer will install the following items:

  • The PanelForge program directory (default into the Windows ‘ProgramFiles’ directory).
  • A Shortcut to the PanelForge executable and uninstaller executable into the Windows Start Menu.
  • Registry entries for PanelForge Project ‘pfz’ and Panel ‘pfn’ file format association.
  • Registry entries for PanelForge Project and Panel file format icons for use in Windows Explorer.
  • Registry entry for PanelForge uninstaller for use with the ‘Uninstall a Program’ Windows Control Panel.


Windows Uninstallation

First, exit PanelForge if open before proceeding with uninstallation.

To uninstall PanelForge the Windows 'Uninstall or Change a Program' Control Panel can be used. The following instructions refer to Windows 11, under other versions of Windows the method may vary.

  1. Open the Windows 'Settings' using the start menu item.
  2. Click the 'Apps' item from the list on the left.
  3. Click the 'Installed apps' item from the main list.
  4. Locate the 'PanelForge (Studio/Pro)' item in the app list.
  5. Click the '...' menu button and select 'Uninstall'
  6. Select ‘Yes’ when prompted to uninstall 'PanelForge (Studio/Pro).
  7. You have now have successfully uninstalled 'PanelForge (Studio/Pro)’.


Silent Windows Command Line Installation

The above installer executable can also be used via the Windows Command Prompt without the display of graphical windows. This mode can be activated using ‘/S’ silent flag.


Silent Windows Command Line Uninstallation

The PanelForge Windows Uninstaller is located in the 'PanelForge (Studio/Pro)' Program Files Directory.

The Silent mode can be activated using ‘/S’ silent flag.

Example default Uninstaller 'PanelForge Studio' location (replace 'X' with major version number):

 "C:\Program Files\PanelForgeStudioX\Uninstallers\PanelForge Studio X Uninstaller.exe" /S


Portable Windows Installation ('Studio' version only)

First, decompress the PanelForge-X_X_X-Win64.zip file, then open the ‘panelforge.exe’ Windows executable file in the decompressed PanelForge Program directory.

Using this installation method for a permanent solution is not recommend as it will not provide the optimal experience with the Windows operating system.