lazy-widgets-wle
TypeScript icon, indicating that this package has built-in type declarations

0.8.3 • Public • Published

lazy-widgets-wle

Wonderland Engine integration for the lazy-widgets Typescript UI library.

A reboot of the @rafern/canvas-ui-wl library.

Installation and setup

Before you follow these instructions: These instructions don't apply to the example project. The example project should run out-of-the-box, and following these might break it.

  1. Install the lazy-widgets NPM package: npm install --save-dev lazy-widgets
  2. Install this NPM package: npm install --save lazy-widgets-wle
    • Make sure to use --save instead of --save-dev, otherwise it will not work, since Wonderland Engine libraries can't be devDependencies if they are meant to be used in the editor
  3. Import needed classes from lazy-widgets and lazy-widgets-wle in your code
  4. Create a new component for your UI root (see example section)
  5. Set the material to use for your UI root component to a textured material. If you want a semi-transparent background, create a new pipeline with alpha blending enabled

Note that there is no API in Wonderland Engine to get information about a pipeline or shader. This means that there is no way for this library to know which field should be set for a material's texture (is it diffuseTexture or flatTexture, or another field name?). Because of this, this library tries to guess which field should be set by looking at the name of the shader. The following names are supported at the moment:

  • Flat Opaque Textured
  • Phong Opaque Textured
  • Physical Opaque Textured
  • Flat Transparent Textured
  • Phong Transparent Textured
  • Physical Transparent Textured
  • Phong Normalmapped
  • Phong Lightmapped

If a custom pipeline is used, the texture uniform name can also be set with the textureUniformName WLRoot property.

Documentation

Documentation can be generated locally with the command npm run docs. Output will be in a new docs folder. The documentation is also served on Github Pages.

Documentation for lazy-widgets is available in the lazy-widgets Github Pages.

Example

An example project can be found in the example-project folder, which is also served on Github Pages.

Miscellaneous

A component which disables a component of 2 given objects if the keyboard and/or mouse are in use in a UI root is also provided. The component is named lazy-widgets-input-guard.

Special thanks

Special thanks to Playko (website, github) where this project started and is currently being developed at, and to the Wonderland Engine developers (website).

License

This project is licensed under the MIT license (see the LICENSE file)

This project uses the following open-source projects:

Package Sidebar

Install

npm i lazy-widgets-wle

Weekly Downloads

8

Version

0.8.3

License

MIT

Unpacked Size

198 kB

Total Files

36

Last publish

Collaborators

  • rafern