Advanced Masks 1.5.1

Because of course I missed a bug on the major release and needed to do a same day hotfix... Huge thanks to discord user Craqgerbil for bringing this to my attention. This release fixes a bug where masks applied to image sources might not render correctly.

Release 1.5.0​

This is the second feature release for Advanced Masks. Big thanks to the huge number of people who have downloaded and used the plugin- I'm glad so many people are finding it useful! This release fixes a few bugs, and adds a number of new features. Read down below for details.

New Features:​

This release extends some of the existing features, and adds some entirely new mask types.

• Shape Masks
  
  • Invert Option- one of the most requested features for Advanced masks- you now have the ability to invert a shape mask for all shapes.
  • Squircles/Superellipses/Superformula Shapes- A new shape was added based off the Superformula family of shapes. The interface allows for the more widely used Squircles and Superellipses to be created using some simple size and curvature parameters, and the more general Superformula option lets you create infinite abstract shapes which can be animated with other plugins like the Move plugin. More information on Superformulas can be found here: https://en.wikipedia.org/wiki/Superformula
• Chroma Key Masks- A new Chroma Key mask was added, and has 2 different algorithms for keying.
  • The first is an Advanced Chroma Key which is the same algorithm used by the Chroma Key filter that ships with OBS, but allows you to pick a light and a dark shade for your key. It also provides a black/white matte output so you can easily see the quality of your mask.
  • Second is a Super Chroma Key, which is currently an experimental feature that I hope to expand over time. It uses the basic Ultimatte algorithm which recently came off patent. Keys are created using 3 parameters- a low and high range parameter, and a veil parameter to reduce noise in the mask.
• Feather Mask- a new mask type that takes an existing mask (e.g.- a chroma key) and allows you to feather the edges. This is especially useful for cleaning up an imperfect key by applying a 2-4 pixel feather.
• SVG Masks- Create scalable masks using an SVG file, or SVG tag text entered directly into a text box.
• FontAwesome Masks- Note- this feature requires a free or paid FontAwesome account in order to access the FontAwesome APIs. FontAwesome is a repository of over 50k SVG-based icons, and now you can use them as highly scalable masks! Need a rocket ship mask, or perhaps a mask in the shape of a controller? Maybe a flame, or the Twitch logo? FontAwesome has you covered.

Bug Fixes:​

This release fixes a few small bugs, including a small memory leak, and some issues with linux installs.

Thank you everyone who has downloaded and given feedback on the Advanced Mask Plugin! I've seen some amazing things that the community had built- y'all are incredible! This release contains new features and one bugfix (that causes a slight breaking change, so make sure to read below, AND PLEASE BACK UP YOUR OBS SETTINGS BEFORE UPGRADING).

Bug Fixes

• Fixes a bug where advanced masks were not applied correctly to image sources.
• Fixes a bug where shape mask dimensions were not correct- prior to this release, all shape masks were 20% larger than the user specified (So a rectangle mask of 100px x 200px would end up being 120px x 240px). Any existing filters you have will continue to use this incorrect scaling (so you don't have to change the mask size on anything you've already created, nor do you need to change values in third party plugins like websockets or the Move plugin). Any new filters created will use the correct scaling. If you would like your existing filters to use the correct scaling, you'll need to delete the filter and re-create it.

New Features

• Scalable/movable source masks. You can now scale your source masks, change their position and rotation, and have the option to tile or mirror them. This gives a lot of creative options for taking your masks to the next level!
• Scalable/movable image masks. Same new feature as the source masks above, but for image masks.
• BoomSoMuch Alpha/Adjustment Fade mask. A brand new mask that lets a moving mask recurse/fade over a user defined time, allowing the effect created by BoomSoMuch: https://www.youtube.com/watch?v=ZSUMdj_I28M . In addition to it use as an alpha mask, I've also provided the the same functionality for Adjustment masks.

Thank you everyone who has downloaded and given feedback on the Advanced Mask Plugin! I've seen some amazing things that the community had built- y'all are incredible! This release contains new features and one bugfix (that causes a slight breaking change, so make sure to read below, AND PLEASE BACK UP YOUR OBS SETTINGS BEFORE UPGRADING).

Bug Fixes

• Fixes a bug where advanced masks were not applied correctly to image sources.
• Fixes a bug where shape mask dimensions were not correct- prior to this release, all shape masks were 20% larger than the user specified (So a rectangle mask of 100px x 200px would end up being 120px x 240px). Any existing filters you have will continue to use this incorrect scaling (so you don't have to change the mask size on anything you've already created, nor do you need to change values in third party plugins like websockets or the Move plugin). Any new filters created will use the correct scaling. If you would like your existing filters to use the correct scaling, you'll need to delete the filter and re-create it.

New Features

• Scalable/movable source masks. You can now scale your source masks, change their position and rotation, and have the option to tile or mirror them. This gives a lot of creative options for taking your masks to the next level!
• Scalable/movable image masks. Same new feature as the source masks above, but for image masks.
• BoomSoMuch Alpha/Adjustment Fade mask. A brand new mask that lets a moving mask recurse/fade over a user defined time, allowing the effect created by BoomSoMuch: https://www.youtube.com/watch?v=ZSUMdj_I28M . In addition to it use as an alpha mask, I've also provided the the same functionality for Adjustment masks.