oultrox / unmaskforugui

An extension of the reverse masking solution for uGUI element in Unity.

Unmask For UGUI

Cross-Scene Featured Reverse mask for uGUI element in Unity3D.

<< Description | WebGL Demo | Installation | Usage | Contributing >>

Description

Unmask provides the following features:

1. Reverse mask
2. Ray through the unmasked rectangle
3. Following another object
4. Support nesting

Component	Features	Screenshot
Unmask	Reverse masking for parent Mask component. Fit Target / Fit On Late Update: Fit graphic's transform to target transform on LateUpdate. Only For Children: Unmask affects only for children. Show Unmask Graphic: Show the graphic that is associated with the unmask render area.
UnmaskRaycastFilter	The ray Passes through the unmasked rectangle. You can click on the unmasked button on the back side.

Demo

WebGL Demo

Installation

Requirement

Using Git

Find the manifest.json file in the Packages folder of your project and edit it to look like this:

{
  "dependencies": {
    "com.oultrox.unmask": "https://github.com/oultrox/UnmaskForUGUI.git",
    ...
  },
}

To update the package, change suffix #{version} to the target version.

• e.g. "com.oultrox.unmask": "https://github.com/oultrox/UnmaskForUGUI.git#2.0.0",

For Unity 2018.2 or earlier

1. Download a source code zip file from Releases page
2. Extract it
3. Import it into the following directory in your Unity project
   • Packages (It works as an embedded package. For Unity 2018.1 or later)
   • Assets (Legacy way. For Unity 2017.1 or later)

Usage

Create Object From Menu (GameObject > UI > Unmask > ***)

Menu	Screenshot
Tutorial Button
Iris Shot

Example of using

Case	Description	Screenshot
Unmasked text	Black screen is cut out with unmasked text.
Hole	Black screen is cut out with unmasked Image.
Tutorial button	In tutorial, only specific button can be pressed.
Iris in/out	Transition effect with iris in/out.

Contributing

Issues

Issues are very valuable to this project.

• Ideas are a valuable source of contributions others can make
• Problems show where this project is lacking
• With a question you show where contributors can improve the user experience

Pull Requests

Pull requests are, a great way to get your ideas into this repository.
See CONTRIBUTING.md and develop branch..

Support

Project is not originally mine I just extended it if you wanna support the OG developer click on the following.

If you like it, please support him.

License

• MIT
• © UTJ/UCL (Because of Unity-Chan lol)

Author

I just extended it. Real author:

mob-sakai

See Also

• GitHub page : https://github.com/mob-sakai/UnmaskForUGUI
• Releases : https://github.com/mob-sakai/UnmaskForUGUI/releases
• Issue tracker : https://github.com/mob-sakai/UnmaskForUGUI/issues
• Change log : https://github.com/mob-sakai/UnmaskForUGUI/blob/main/CHANGELOG.md