1
0
Fork 0
mirror of https://github.com/hawkeye-stan/msfs-popout-panel-manager.git synced 2024-11-22 05:40:11 +00:00
msfs-popout-panel-manager/README.md

176 lines
10 KiB
Markdown
Raw Permalink Normal View History

2021-09-21 00:19:46 +00:00
# MSFS Pop Out Panel Manager
2021-09-17 03:18:02 +00:00
2023-07-12 22:41:31 +00:00
MSFS Pop Out Panel Manager is an application for MSFS 2020 which helps pop out, save and position pop out panels to be used by utilities such as Sim Innovations Air Manager or to place pop out panels onto your screen or another monitor at predetermined locations automatically. It also adds touch capability to pop out panels that are operated on touch screen which is currently not supported by the game.
2021-12-14 05:40:07 +00:00
2022-09-12 14:27:23 +00:00
Please follow [FlightSimulator.com](https://forums.flightsimulator.com/t/msfs-pop-out-panel-manager-automatically-pop-out-and-save-panel-position/460613) forum thread regarding this project or comments at [Flightsim.to](https://flightsim.to/file/35759/msfs-pop-out-panel-manager).
2021-12-14 05:40:07 +00:00
2023-07-12 22:41:31 +00:00
<br>
<p align="center">
<img src="assets/readme/images/app.png" width="600" hspace="10"/>
</p>
2021-12-14 05:40:07 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-12-14 05:40:07 +00:00
2023-07-12 22:41:31 +00:00
## Getting Started
2021-09-30 02:17:20 +00:00
2024-03-12 14:32:17 +00:00
[Please see Getting Started guide to setup your first profile](./GETTING_STARTED.md) - Updated for version 4.1.
Video showing how to create a new aircraft profile and panel source selection:</br>
https://vimeo.com/917361559
Video showing how to update existing aircraft profile (Pre-Version 4.1) to use the new panel selection method:</br>
https://vimeo.com/917364912
Video showing how to use the new floating panel feature:</br>
https://vimeo.com/918153200
2021-09-30 02:17:20 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-09-30 02:17:20 +00:00
2022-07-06 18:09:10 +00:00
## How to Install
2021-10-07 17:00:10 +00:00
2022-07-23 20:04:06 +00:00
1. After downloading the latest zip package from github repository or from Flightsim.to website, extract the zip package to a folder of your choice on your computer.
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
2. If you're using Auto Pop Out Panel feature, a plugin is required to be installed in MSFS community folder. Please copy the folder "zzz-ready-to-fly-button-skipper" into your MSFS community folder. This plugin is used to automatically skip the "Ready to Fly" button press when flight starts so Auto Pop Out Panel can start its process.
2021-10-08 15:18:38 +00:00
2022-07-23 20:04:06 +00:00
3. Start the application **MSFSPopoutPanelManager.exe** and it will automatically connect when MSFS/SimConnect starts.
2021-10-08 15:18:38 +00:00
2023-07-12 22:41:31 +00:00
4. If Pop Out Panel Manager is not connecting to the game (green connection icon in the upper left corner of the app), you may be missing VC++ redistributable that is required for SimConnect to work. Please download and install the following [VC++ redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe) on your PC to resolve this issue.
<br>
2022-07-06 18:09:10 +00:00
## How to Update
2022-07-23 20:04:06 +00:00
1. To update the application, you can download the latest zip package and directly extract the package into your Pop Out Manager installation folder and overwrite all files within. Your application setting and profile data will be safe.
2022-07-06 18:09:10 +00:00
2. You can also use the built-in auto update feature and let the application handles the update. If the update is optional, you can skip the update if you so choose. When you start the application and if an update is available, a dialog will appear and it will show the latest version's release notes and an option to update the application.
2023-07-12 22:41:31 +00:00
3. If you're not being prompt for update when new update is available, please try the following fix:
2022-07-06 18:09:10 +00:00
- Restart you computer and most of the time this will do the trick.
- Clear your default web browser cache on your computer since auto update will try to download latest version of update configuration file from github repository and the file may have been cached on your machine.
2022-07-23 20:04:06 +00:00
- Clear Internet Browser History. First search for "Internet Options" in Windows control panel. In "General" tab, select "Delete" in Browsing History section.
2022-07-06 18:09:10 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-09-17 03:18:02 +00:00
2023-07-12 22:41:31 +00:00
## Application Features
* Display resolution independent. Supports 1080p/1440p/4k display and ultrawide displays.
2021-09-30 02:17:20 +00:00
2023-07-12 22:41:31 +00:00
* Support multiple user defined aircraft profiles to save panel locations to be recalled later.
2021-09-30 02:17:20 +00:00
2023-07-12 22:41:31 +00:00
* Intuitive user interface to defined location of source panels to be popped out and configure the size and location of pop out panels.
2021-09-30 02:17:20 +00:00
2023-07-12 22:41:31 +00:00
* Enable touch support for pop outs on touch capable display. Please see [Touch Enable Pop Out Feature](#touch-enable-pop-out-feature) for more information.
2021-09-30 02:17:20 +00:00
2023-07-12 22:41:31 +00:00
* Auto game refocus to enable operation of pop out panels either by click or touch without losing flight control.
2021-10-17 16:18:45 +00:00
2023-07-12 22:41:31 +00:00
* Auto Pop Out feature. The application will detect active aircraft and will activate the corresponding profile on start of new flight session.
2021-10-17 16:18:45 +00:00
2023-07-12 22:41:31 +00:00
* Cold Start Feature. Instrumentation panels can be popped out even when they're not powered on (for G1000 Only) to overcome an outstanding MSFS bug.
2022-04-18 22:07:30 +00:00
2024-03-12 14:32:17 +00:00
* (Version 4.1+ backward compatibility support) Auto Panning feature remembers the cockpit camera angle when you first define the pop out panels. You can now pan, zoom in, and zoom out to identify offscreen panels and the camera angle will be saved and reused. This feature requires the use of Ctrl-Alt-0 keyboard binding to save custom camera view per plane configuration. (Can be configured to use 0 through 9). If the keyboard binding is currently being used. The auto-panning feature will overwrite the saved camera view if enabled.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* Fine-grain control of positioning of panels down to pixel level.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* Panels can be configured to appear always on top, with title bar hidden, or stretch to full screen mode.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* Auto disable Track IR when pop out starts.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* User-friendly features such as application always on top, auto start, minimized to tray with keyboard shortcuts.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* Auto save feature. All profile and panel changes are saved automatically.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
* Auto update feature. Application can auto-update itself when new version becomes available.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-10-17 16:18:45 +00:00
2022-06-22 16:31:41 +00:00
## Touch Enable Pop Out Feature
2023-07-12 22:41:31 +00:00
To enable touch support, just activate the hand icon for the panel that you want this support.
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
This feature will make pop out panel touch capable on touch screen monitor or tablet (through remote display tool such as [Spacedesk](https://www.spacedesk.net/). As of this writing, MSFS does not support touch natively on touch enabled display and Pop Out Panel Manager tries to fill this gap by providing touch capabilities to aircraft panels such as:
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
- King Air 350 G3000
2022-06-22 16:31:41 +00:00
- PMS GTN750
2022-07-31 13:11:02 +00:00
- PMS GTN530
2023-07-12 22:41:31 +00:00
- TBM 930 GTC580
2022-07-31 13:11:02 +00:00
- Flybywire A32NX EFB
2023-07-12 22:41:31 +00:00
- Aircrafts that have instrumentation panel that is clickable
- Or can be used for built-in panels such as Checklist, ATC, etc
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
The touch enabled pop out feature solved two limitations in MSFS.
2022-06-22 16:31:41 +00:00
- Limitation #1 - For pop out panel, touch events do not get pass through to panels such as King Air PFD or GTN750 and they can only be operated with a mouse. There is a work around if youre using Spacedesk with tablet by disabling USB HID within Spacedesk drivers in Windows device manager. But if youre using touch monitors directly connected to your gaming PC, then Spacedesk workaround is not an option.
2023-07-12 22:41:31 +00:00
- Limitation #2 - When you click or hover your mouse over any pop out panels on your main monitor or on another monitor, the game main window will lose focus and you cant operate flight control without clicking the game window again. Pop Out Panel Manager provides a configurable game auto refocus when you click on or touch any pop out panels.
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
<br>
2022-07-23 20:04:06 +00:00
2021-12-14 05:40:07 +00:00
## User Profile Data Files
2021-10-17 16:18:45 +00:00
2023-05-21 14:32:15 +00:00
The user plane profile data and application settings data are stored as JSON files under your "Documents" folder. (%userprofile%\Documents\MSFS Pop Out Manager)
2021-10-17 16:18:45 +00:00
2022-07-23 20:04:06 +00:00
* userprofiledata.json
2022-06-22 16:31:41 +00:00
Stored your various plane profiles.
2022-07-23 20:04:06 +00:00
* appsettingdata.json
2022-06-22 16:31:41 +00:00
Stored your application preference settings.
2022-07-23 20:04:06 +00:00
* autoupdate.json
2021-10-17 16:18:45 +00:00
2022-06-22 16:31:41 +00:00
Stored the application auto update information. This file can be deleted if you want to reset your update status.
2022-07-23 20:04:06 +00:00
You can backup this folder and restore this folder if you want to uninstall and reinstall MSFS Pop Out Manager.
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-10-17 16:18:45 +00:00
2021-12-14 05:40:07 +00:00
## Current Known Issue
2021-10-17 16:18:45 +00:00
2022-04-18 22:07:30 +00:00
* Automatic power on for Auto Pop Out Panels feature will not work if you're using any flight control hardware (such as Honeycomb Alpha or Bravo) that permanently binds the master battery switch or master avionics switch. If the hardware control switch is in the off position, pop out manager won't be able to temporary turn on the instrumentation panels to pop them out. This seems to be a bug on Asobo side and only affects the G1000 instrumentation at the moment.
2022-01-27 13:40:04 +00:00
2023-07-12 22:41:31 +00:00
* Please see [Version](VERSION.md) file for latest known application issues and fixes.
2022-04-18 22:07:30 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-09-30 02:17:20 +00:00
2021-09-17 03:18:02 +00:00
## Common Problem Resolution
2023-07-12 22:41:31 +00:00
* Unable to pop out panel and the panel is highlighted in red. This may indicate an issue where your placement for the panel source circle is incorrect or some application window may be blocking Pop Out Panel Manager from clicking in the game to simulate pop out keystroke. Please try to adjust the panel source circle or reposition any window that can interfere with the app's operation. Or you can change the order or panels being popped, sometime this can resolve pop out issue.
2021-12-14 05:40:07 +00:00
2022-07-23 20:04:06 +00:00
* If you encounter application crashes or unknown error, please help my continuing development effort by attaching the file **error.log** in the application Logs folder and open an issue ticket in github repo for this project. This is going to help me troubleshoot the issue and provide hotfixes.
2022-04-18 03:38:33 +00:00
* If you encounter an issue with panels that are not restored back to your saved profile locations, please check if you have other apps such as Sizer or Windows PowerToys that may have conflict with Pop Out Manager.
2022-06-22 16:31:41 +00:00
2023-07-12 22:41:31 +00:00
<br>
2022-06-22 16:31:41 +00:00
2021-09-17 03:18:02 +00:00
## Author
Stanley Kwok
[hawkeyesk@outlook.com](mailto:hawkeyesk@outlook.com)
2022-02-06 20:10:46 +00:00
I welcome feedback to help improve the usefulness of this application. You are welcome to take a copy of this code to further enhance it and use within your own project. But please abide by licensing terms and keep it open source:)
## Donation
[<img src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif"
alt="Markdown Monster icon"
style="float: left; margin-right: 10px;" />](https://www.paypal.com/donate/?business=NBJ7SZR7MUDE6&no_recurring=0&item_name=Thank+you+for+your+kind+support+of+MSFS+Pop+Out+Panel+Manager%21&currency_code=USD)
Thank you for your super kind support of this app!
2021-12-14 05:40:07 +00:00
2023-07-12 22:41:31 +00:00
<br>
2021-09-17 03:18:02 +00:00
## Credits
2023-07-12 22:41:31 +00:00
[Material Design in XAML Toolkit](http://materialdesigninxaml.net/) by Material Design team
2021-12-14 05:40:07 +00:00
2023-07-12 22:41:31 +00:00
[Hardcodet NotifyIcon](https://github.com/hardcodet/wpf-notifyicon) by Philipp Sumi, Robin Krom, Jan Karger
2021-09-17 03:18:02 +00:00
2023-07-12 22:41:31 +00:00
[Fody](https://github.com/Fody/Fody) .NET assemblies weaver by Fody
2022-01-27 13:40:04 +00:00
2023-07-12 22:41:31 +00:00
[WindowsHook](https://github.com/topstarai/WindowsHook) by Mark Kang
2022-01-27 13:40:04 +00:00
[WPF CalcBinding](https://github.com/Alex141/CalcBinding) by Alexander Zinchenko
2024-07-28 00:12:07 +00:00
[AutoUpdater.NET](https://github.com/ravibpatel/AutoUpdater.NET) by Ravi Patel
[DynamicLOD](https://github.com/Fragtality/DynamicLOD_ by Fragtality (idea and MSFS memory access code)