Texture Source


TextureSource is a utility that provides a consistent API to get the texture from various sources.

!virtual-texture

Example API Usage

``c#
using TextureSource;
using UnityEngine;

[RequireComponent(typeof(VirtualTextureSource))]
public class TextureSourceSample: MonoBehaviour
{
private void Start()
{
// Listen to OnTexture event from VirtualTextureSource
// Also able to bind in the inspector
if (TryGetComponent(out VirtualTextureSource source))
{
source.OnTexture.AddListener(OnTexture);
}
}

private void OnDestroy()
{
if (TryGetComponent(out VirtualTextureSource source))
{
source.OnTexture.RemoveListener(OnTexture);
}
}

public void OnTexture(Texture texture)
{
// Do whatever 🥳
// You don't need to think about webcam texture rotation.
}
}
`

Install via UPM

Add the following setting to Packages/manifest.json

`json
{
"scopedRegistries": [
{
"name": "npm",
"url": "https://registry.npmjs.com",
"scopes": [
"com.github.asus4"
]
}
],
"dependencies": {
"com.github.asus4.texture-source": "0.3.5",
...// other dependencies
}
}
`

How To Use

After installing the library, attach VirtualTextureSource to the GameObject.

!virtual-texture

Then, right-click on the project panel and create the TextureSource scriptable object that you want to use. You can set different sources for the Editor and Runtime.

!scriptable-object

Currently provides the following sources:

$3

Includes collecting device rotation.

!webcam-texture-source

$3

Useful when using test videos only in the Editor.

!video-texture-source

$3

Test with static images.

OnTexture event is invoked every frame if the sendContinuousUpdate` is enabled.

!image-texture-source

$3

Provides AR camera texture access. It supports both ARCore/ARKit.

!ar-foundation-texture-source

Acknowledgement

Inspired from TestTools

License

MIT