Unified window controller for macOS and Windows
Abbreviation：UniWinC
This is a library for apps built for Windows / macOS standalone with Unity.
This library controls transparency, borderless, position, size, etc. of its own window.
And it allows also accept file and folder drops.
https://twitter.com/i/status/1314440790945361920
You can find some sample builts on the Release page.
If you use the UPM, you can also perform version upgrades from UPM.
A. Using the Unity Package Manager (UPM)
- Open [Package Manager] from the [Window] menu of the Unity Editor.
- Select [+] and then select [Add package from git URL...].
- Enter https://github.com/kirurobo/UniWindowController.git#upm and [Add].
B. Using an UnityPackage
- Download an .unitypackage file from the Release page.
- Import the asset in the Unity Editor.
- Add the
UniWindowControllerprefab in the Runtime/Prefabs to your scene. - Select the
UniWindowControllerplaced scene, and watch the inspector.
- Fix the Player Settings appropriately (the green button will change all settings at once)
- Adjust the settings such as
IsTransparentto your liking
- Add
DragMoveCanvasprefab in the Runtime/Prefabs if you want to move the window by mouse dragging.
- An EventSystem is required for this to work. If it is not present in your scene, add UI → Event System.
- Build for PC / Mac standalone
- Launch the build
- Transparency is not available on the Unity Editor. Please build and try it.
- It works for topmost, moving windows, etc., but I do not recommend closing the game view or changing the docking arrangement while it is running. In the meantime, the window will reacquire when the focus is shifted to the game view.
- The proper support for touch operations has not yet been determined.
- On Windows, if you change the
TransparentTypefrom Alpha to ColorKey, you will lose the beautiful translucency, but the touch operation will be natural.
- On Windows, if you change the
- Multiple windows are not supported.
- This has not been fully tested and there may be unstable behavior.
See also Issues for known issues.
- Unity: 2019 4.31f1 or later
- Scripting Runtime: .NET 4.x or later
- OS: Windows 10, Windows 11 or macOS
Development environment is Unity 2020.4.30f1, Windows 11 / macOS 13.3
When the window is successfully made transparent, it looks as if it is a non-rectangular window.
However, this is only an appearance, and the window actually exists as a rectangular window.
Therefore, by looking directly under the mouse cursor, if it is transparent, the mouse operation is passed to the window below (click-through), and if it is opaque, the mouse operation is returned to normal,
If it is opaque, it returns to normal.
Two types of hit tests are available. (You can also choose to disable the automatic hit test and control it yourself or not.)
| Name | Method | Note |
|---|---|---|
| Opacity | Check transparency | Matches appearance and is natural, but heavy processing |
| Raycast | Check colider | Lightweight, but requires coliders |
The Raycast method is recommended in terms of performance, but if you forget colider, you will not be able to touch the screen, so the default is Opacity.
Also, note that touch operation may feel uncomfortable because you cannot see the color under your finger in advance.
Since we have not found the best solution for this, I'm sorry to say that touch support has been put on the back burner.
One way to support touch operation is to select monochromatic transparency for layered windows.
If this is selected, semi-transparency cannot be expressed and performance will be reduced, but since the hit test is left to Windows, it should match your senses for touch operation.
| Name | Description | Note |
|---|---|---|
| Alpha | Reflects transparency of rendering results | This is standard |
| ColorKey | Only one color with matching RGB is transparent | Poor performance, but touch is natural |
This is something that can be manipulated from other scripts in Unity.
Specifications are not finalized and are subject to change.
This is the main script. The following properties can be manipulated from other scripts. (Other properties may be added.)
| Name | Type | Description |
|---|---|---|
| isTransparent | bool | Set/unset for transparent (non-rectangular) windows |
| isTopmost | bool | Always set/unset to topmost |
| isZoomed | bool | Maximize/unmaximize the window. Also, get the current state |
| isHitTestEnabled | bool | Enables/disables the automatic hit test. If enabled, isClickThrough will automatically change depending on the mouse cursor position. |
| isClickThrough | bool | Sets/unset the click-through state. |
| windowPosition | Vector2 | Allows you to get/set the window position. The lower left corner of the main monitor is the origin and the coordinate system is positive upward, and the lower left corner of the window is the coordinate system. |
| windowSize | Vector2 | You can get/set the window size. |
If you attach this script to a UI element (which will be the Raycast Target), you can move the window by dragging that UI element. For example, it is assumed to be attached to an image with a handle that says, "You can move by grabbing here.
Within the prefab called DragMoveCanvas, we use a Panel that covers the entire transparent screen.
By setting the Layer to "Ignore Raycast", the automatic hit test will be excluded even if the panel is a Raycast.
This allows dragging anywhere on the screen.
However, other UI operations will take precedence over dragging. (This is due to the smaller Sort Order in DragMoveCanvas.)
If you just want to use this library, you can download .unitypackage in Release and do not need to clone this repository.
If you want to see/build the source, please refer to this.
- UniWinC
- This is a Unity project.
- It already contains built DLLs and bundles.
- The contents of this project are in the release as the .unitypackage.
- VisualStudio
- There is a solution to generate LibUniWinC.dll for Windows x86 and x64.
- Building with Release will overwrite the DLL under the Unity folder.
- A Windows Forms app project for testing is also included.
- Xcode
- There is a project to generate LibUniWinC.bundle for macOS.
- Building it will overwrite the .bundle under the Unity folder.
- The macOS code is based on Unity + Mac + Swift で透過最前面ウィンドウを作る by かりばぁ.
- I used hecomi's Unity で .unitypackage で配布していたアセットを Package Manager 対応してみた for generating UPM branches in GitHub Actions.
I would like to thank them.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent