Table of Contents

Main Panel

The Main Panel is the primary window of the HiNC application, providing navigation and access to all major features.

Key Models

Layout Structure

  • Top Navigation Menu
    • Project Menu Dropdown
      • Project Path Text Field
      • New MenuItem
      • Load MenuItem
      • Save MenuItem
      • Save As MenuItem
    • Environment Menu Dropdown (WPF application only — the web application has no such dropdown; see below)
    • Mission MenuItem Open Mission Page In the web application the Mission editor is a Player Control Tree branch; /mission redirects there.
    • Player MenuItem Link to Player Panel (Not exist on WPF app.)
    • Player Belonged Tool Bars. See Player Panel. Shows only if the Main Panel content is Player Panel.
    • Util Menu Dropdown (web application only). See Util Pages.
      • File Explorer MenuItem
      • Mechanism Builder MenuItem
      • Legacy-Controller MenuItem (below a separator) Open Controller Page
    • Preference Menu Dropdown
    • Help MenuItem
      • HiAPI Version label A label to show the HiNc library version. The web application shows this as a version badge next to the brand logo, with no Help dropdown.
  • Log MenuItem Open Log Viewer to display application logs for the current day. The Log Viewer provides real-time access to system logs with filtering and download capabilities. It reads log files from the server's log directory and presents them in a formatted, searchable interface. Users can refresh the log content or download the current day's log file for offline analysis. In the web application this is an always-visible Show Log button on the menu bar's right side.
  • Central Page Panel
  • Message Section on Main Panel

Project Menu Behavior

The Project Path Text Field displays the current project path when a project is loaded. It is implemented as a pure text field (not a button) that allows users to select and copy the path.

The Project Menu manages MachiningProject with the following operations:

Operation Description Example
New Creates a new project See DemoBuildGeomOnlyMachiningProject
Load Opens an existing project See DemoUseMachiningProject
Save Saves the current project See DemoBuildGeomOnlyMachiningProject
Save As Saves the project to a new location See DemoBuildGeomOnlyMachiningProject

All operation results (success or exception) are reported as IMessage notifications through the MessageUtil helpers. When a project is loaded, the Player Panel's RenderingCanvas is set to isometric view using SetViewToIsometricView().

Note

The implementation uses the MessageUtil extension methods for message handling. Async operations ensure smooth user experience during file I/O.

Platform-Specific Differences

WPF Application

  • Only a single instance of each sub-window (Mission, Workpiece, Fixture) can exist at a time
  • The Player MenuItem does not exist in the WPF version, as the Main Panel itself serves as the Player Panel

Web Application

  • The Player Panel is the default panel displayed on the main page
  • The page URL and panel state are synchronized (bi-directional navigation)
  • There is no Environment dropdown. Machine Tool, Tool House, Fixture, Workpiece, Background / Coolant and Spindle Capability are all Player Control Tree roots or branches (their old routes redirect there), and Controller moved to Util → Legacy-Controller. The menu bar is therefore Project ▾ | Player | Util ▾ | Preference ▾.

Source Code Locations

See HiNC GUI Architecture for git repository links.

WPF Application

  • MainWindow

Web Application

  • Environments/PreferenceController.cs
  • Environments/ProjectController.cs
  • wwwroot-src/src/components/AppMenuBar.vue — the whole navigation menu.
  • wwwroot-src/src/layouts/MainLayout.vue — the shell that hosts the menu bar and the central page panel.
  • wwwroot-src/src/pages/LogViewerPage.vue — the Log Viewer the Show Log button opens.