06 - Application Management and Settings

Purpose: To cover general application settings, data management actions, and help/licensing information.

Clearing Data

The application provides options to clear specific parts of your project data or reset the entire project.

Clear Wires

This option removes all defined wire connections and their associated quantities from the current project.

• Action: Found under the "Tools" menu.
• Confirmation: A confirmation dialog will appear asking, "Are you sure you want to clear all defined wire connections and quantities?" before proceeding.
• Impact:
  • All wiring data managed by the Wiring Manager will be erased.
  • Calculated conduit sizes (both 2D and vertical) will be cleared as they depend on wire data.
  • Visual representations of wiring arrows will be removed from the canvas.
  • The wiring topology calculation will be reset.
  • The main conduit path, nodes, and image will remain unaffected.
  • The status bar will update to reflect that wire data has been cleared and totals will be recalculated.

Clear All

This option resets the entire project, removing all nodes, conduit paths, wiring data, and obstacles. The loaded image and scale settings are preserved.

• Action: Found under the "Tools" menu.
• Confirmation: A confirmation dialog will appear asking, "Are you sure you want to clear all nodes, conduit paths, and wiring data?" before proceeding.
• Impact:
  • All nodes will be deleted.
  • All defined obstacles will be removed.
  • All wiring data and conduit path information will be erased.
  • Calculated conduit sizes (2D and vertical) and any wiring topology will be cleared.
  • The scale and image will be unaffected.
  • The status bar will be updated.

Application Options

These settings allow you to customize the application's appearance and behavior. They are accessible via "File" > "Options".

Theme Selection

You can choose between a Light or Dark theme for the application interface.

• Setting: Located in the "Options" dialog.
• Options:
  • Light Mode
  • Dark Mode
• Behavior: Selecting a theme will immediately preview the change. Applied themes update the visual style of UI elements, including the canvas background and drawing colors for nodes, paths, and text. The chosen theme is saved and will be applied on subsequent application starts.

Auto-Calculate Conduit Toggle

This setting determines if the conduit path and sizes are automatically recalculated when nodes are added or deleted.

• Setting: A checkbox in the "Options" dialog: "Auto Conduit On Add/Delete Node".
• Behavior:
  • Enabled (Checked): When a node is added or deleted, the application will automatically attempt to recalculate the conduit path and associated sizes.
  • Disabled (Unchecked): When nodes are added or deleted, the conduit path is marked as invalid. A manual "Update Conduit" button will appear on the canvas, which must be clicked to recalculate the conduit path and sizes.
• The setting is saved and applied on subsequent application starts.

Text Background Mask Toggle

This setting controls whether a background mask is drawn behind text elements (like node labels and conduit metadata) on the canvas to improve readability against complex backgrounds.

• Setting: A checkbox in the "Options" dialog: "Enable Text Background Mask".
• Behavior:
  • Enabled (Checked): Text elements will have a small, opaque background rectangle matching the canvas background color, making the text easier to read.
  • Disabled (Unchecked): Text elements will be drawn directly on the canvas without a background mask.
• The setting is saved and applied on subsequent application starts. A redraw of the canvas is performed when the setting is changed to reflect the new state.

Checking for Updates

The application can check if a newer version is available.

• Action: Found under the "Help" menu ("Check for Updates"). An automatic check is also performed at startup.
• Behavior:
  • The application contacts a server to compare the current application version with the latest available version.
  • If an update is available, a dialog will appear notifying you of the new version and providing a clickable link to the download page (wireplanpro.com/download).
  • If the current version is up-to-date, a dialog will inform you.
  • If the check fails due to a network issue (and it's not a startup check), a warning will be displayed.

License Information

Details about your software license and third-party components can be found here.

• Action: Accessible via "Help" > "License Information".
• Content:
  • Displays the current status of your WirePlan Pro license (e.g., Valid, Invalid, Expiry Date).
  • Provides a brief description of the application.
  • Includes a button to "View Third-Party Licenses," which opens another dialog showing the licenses for open-source components used within the application.
• EULA: The End-User License Agreement (EULA) is a legal agreement between you and WirePlan Pro. Key terms include:
  • A limited, non-exclusive, non-transferable, revocable license to install and use one copy of the Software on a single computer.
  • Restrictions on use, such as no reverse engineering, unauthorized copying, or commercial exploitation beyond the terms.
  • WirePlan Pro retains all intellectual property rights.
  • Warranty Disclaimer: The software is provided "AS IS" without warranty. Calculations and suggestions are for informational and estimating purposes only and must be independently verified by a qualified professional.
  • Limitation of Liability: The company's liability is limited as per the EULA terms.
  • The EULA is governed by the laws of the State of Michigan.
  • The full EULA can be found in the installer distributed with the application.