Skip to content

gl-transitions package converted to Interactive Shader Format.

License

Notifications You must be signed in to change notification settings

benoitlahoz/isf-transitions

Repository files navigation

isf-transitions

gl-transitions converted to Interactive Shader Format + a very basic zero-dependency converter and installer.

v0.0.1

Usage

Download the latest release or clone the repository and copy / paste the converted folder's content to your ISF directory.

You can also run

npm run copy

or

yarn copy

to automatically copy the converted transitions in your ISF folder (tested on macOS).

If not specifically mentionned below, all shaders work in Millumin 4, VDMX 5 and ISF Editor on macOS. Some of the shaders have also been tested on macOS in After Effects with ISF plugin.

Flip

Destination (to input) image appears vertically flipped in Millumin. A flip option has been added to handle this case.

Conversion

If you want to update and convert the current gl-transitions repository:

  • Clone this repository.
  • Update submodule: git submodule update --remote --merge.
  • npm run convert or yarn convert.

It is strongly suggested to make a Pull Request if things have changed :-)!

Patches

Some shaders need manual changes to work. A patches.json file helps to make these changes automatically in a very rudimentary way.

Shader Name Comments
burn Expected vec3 as color.
circle Expected vec3 as color.
dissolve Expected vec3 as color.
fadecolor Expected vec3 as color.
undulatingBurnOut Expected vec3 as color.

Known bugs

Shader Name Bug Why Fixed
EdgeTransition Doesn't compile in ISF4AE plugin. Array size must appear after variable name.
StereoViewer Crashes in Millumin.

Thoughts

VDMX and ISF4AE allow to get an internal layer as destination input of the shader (to). Would be great that Millumin implement that. For the time being, Millumin only allows live inputs as textures in ISF shaders.

20240606 --> Should be available in next Millumin beta version! (see here).

TODO

  • Tests with interactive-shader-format.js
  • Documentation / examples site.
  • Refactor parsing methods.
  • Decouple implementations.
  • Search for vec3 to vec4 color input conversion automatically.

PR VERY WELCOME!!!

If you want to contribute with a 'native ISF' transition, please put it in the transitions folder.

converted folder is deleted and generated automatically on conversion.

Author

Benoît LAHOZ for this package, initial authors for the transitions (see in each file).

License

This package: MIT

Shaders: see for each file (as of 20240606 --> MIT, BSD-2 and BSD-3).

About

gl-transitions package converted to Interactive Shader Format.

Resources

License

Stars

Watchers

Forks

Packages

No packages published