Basic Usage - Histórico de revisão

Trilib em 19h26min de 21 de janeiro de 2025

2025-01-21T19:26:43Z

← Edição anterior		Edição das 16h26min de 21 de janeiro de 2025
Linha 5:		Linha 5:
	* Custom Source Loading		* Custom Source Loading

	The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called ~~[https://ricardoreis.net/trilib/trilib2/docs/namespace_tri_lib_core_1_1_mappers.html~~ Mappers], used to load Textures and external data from custom data Streams.		The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called Mappers, used to load Textures and external data from custom data Streams.

	==Local File-System Loading==		==Local File-System Loading==
Linha 92:		Linha 92:

	=== Using the Model Filename ===		=== Using the Model Filename ===
	You can also load your Models, passing the Model Filename to the ~~[https://ricardoreis.net/trilib/trilib2/docs/class_tri_lib_core_1_1_asset_loader.html~~ AssetLoader] methods.		You can also load your Models, passing the Model Filename to the AssetLoader methods.

	Let's create an empty Unity project in this example and import the TriLib Unity package.		Let's create an empty Unity project in this example and import the TriLib Unity package.
Linha 170:		Linha 170:
	== URL Loading ==		== URL Loading ==

	You can use the ~~[https://ricardoreis.net/trilib/trilib2/docs/class_tri_lib_core_1_1_asset_downloader.html~~ AssetDownloader] class to load models from URLs (network). The usage is relatively simple and similar to the local file-system loading.		You can use the AssetDownloader class to load models from URLs (network). The usage is relatively simple and similar to the local file-system loading.

	Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.		Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.

Trilib: /* URL Loading */

2024-05-18T11:55:58Z

URL Loading

← Edição anterior		Edição das 08h55min de 18 de maio de 2024
Linha 176:		Linha 176:
	Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.		Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.

	Important: If you're downloading models from files that are not Zipped, you must pass the model extension as the last parameter from the "AssetDownloader.LoadModelFromUri" call (Eg: "fbx")		Important: If you're downloading models from files that are not Zipped, you must pass the model extension as the last parameter from the <code>AssetDownloader.LoadModelFromUri</code> call (Eg: "fbx")

	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:

Trilib em 16h11min de 30 de abril de 2024

2024-04-30T16:11:57Z

← Edição anterior		Edição das 13h11min de 30 de abril de 2024
Linha 18:		Linha 18:
	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:

	<~~source lang="csharp"~~>		<pre>
	using TriLibCore;		using TriLibCore;
	using TriLibCore.General;		using TriLibCore.General;
Linha 89:		Linha 89:
	}		}
	}		}
	</~~source~~>		</pre>

	=== Using the Model Filename ===		=== Using the Model Filename ===
Linha 98:		Linha 98:
	Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.		Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.

	Use the following code in your "TestLoader.cs" and hit the play button to test it:<~~source lang="csharp"~~>		Use the following code in your "TestLoader.cs" and hit the play button to test it:
			<pre>
	using TriLibCore;		using TriLibCore;
	using TriLibCore.General;		using TriLibCore.General;
Linha 165:		Linha 166:
	}		}
	}		}
	</~~source~~>		</pre>

	== URL Loading ==		== URL Loading ==
Linha 179:		Linha 180:
	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:

	<~~source lang="csharp"~~>		<pre>
	using TriLibCore;		using TriLibCore;
	using TriLibCore.General;		using TriLibCore.General;
Linha 244:		Linha 245:
	}		}
	}		}
	</~~source~~>		</pre>

Trilib em 04h22min de 24 de julho de 2021

2021-07-24T04:22:18Z

← Edição anterior		Edição das 01h22min de 24 de julho de 2021
Linha 174:		Linha 174:

	Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.		Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.

			Important: If you're downloading models from files that are not Zipped, you must pass the model extension as the last parameter from the "AssetDownloader.LoadModelFromUri" call (Eg: "fbx")

	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:
Linha 200:		Linha 202:
	var webRequest = AssetDownloader.CreateWebRequest("https://ricardoreis.net/trilib/demos/avatars/003/003_visemes.zip");		var webRequest = AssetDownloader.CreateWebRequest("https://ricardoreis.net/trilib/demos/avatars/003/003_visemes.zip");

			// Important: If you're downloading models from files that are not Zipped, you must pass the model extension as the last parameter from this call (Eg: "fbx")
	// Begins the model downloading.		// Begins the model downloading.
	AssetDownloader.LoadModelFromUri(webRequest, OnLoad, OnMaterialsLoad, OnProgress, OnError, null, assetLoaderOptions);		AssetDownloader.LoadModelFromUri(webRequest, OnLoad, OnMaterialsLoad, OnProgress, OnError, null, assetLoaderOptions, null, null);
	}		}
	}		}

Trilib em 17h41min de 28 de fevereiro de 2021

2021-02-28T17:41:20Z

@@ Linha 8: / Linha 8: @@
 ==Local File-System Loading==
 Loading models from the local file-system is simplified by using the StandaloneFileBrowser classes that come with TriLib.
@@ Linha 40: / Linha 42: @@
 			// Shows the model selection file-picker.
 			assetLoaderFilePicker.LoadModelFromFilePickerAsync("Select a File", OnLoad, OnMaterialsLoad, OnProgress, OnBeginLoad, OnError, null, assetLoaderOptions);
+		}
+	}

Trilib em 17h37min de 28 de fevereiro de 2021

2021-02-28T17:37:49Z

← Edição anterior		Edição das 14h37min de 28 de fevereiro de 2021
Linha 5:		Linha 5:
	* Custom Source Loading		* Custom Source Loading

	The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called Mappers, used to load Textures and external data from custom data Streams.		The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called [https://ricardoreis.net/trilib/trilib2/docs/namespace_tri_lib_core_1_1_mappers.html Mappers], used to load Textures and external data from custom data Streams.

	==Local File-System Loading==		==Local File-System Loading==
Linha 91:		Linha 91:
	== URL Loading ==		== URL Loading ==

	You can use the AssetDownloader class to load models from URLs (network). The usage is relatively simple and similar to the local file-system loading.		You can use the [https://ricardoreis.net/trilib/trilib2/docs/class_tri_lib_core_1_1_asset_downloader.html AssetDownloader] class to load models from URLs (network). The usage is relatively simple and similar to the local file-system loading.

	Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.		Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.

Trilib em 17h32min de 28 de fevereiro de 2021

2021-02-28T17:32:07Z

← Edição anterior		Edição das 14h32min de 28 de fevereiro de 2021
Linha 1:		Linha 1:
	There are three main methods to load models and their dependencies in TriLib:		There are three main methods to load models and their dependencies in TriLib:
	*Local File-System Loading
	*URL Loading		* Local File-System Loading
	*Custom Source Loading		* URL Loading
	The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called Mappers, used to load ~~textures,~~ and external data from custom data Streams.		* Custom Source Loading

			The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called Mappers, used to load Textures and external data from custom data Streams.

	==Local File-System Loading==		==Local File-System Loading==
	Loading models from the local file-system is simplified by using the StandaloneFileBrowser classes that come with TriLib.		Loading models from the local file-system is simplified by using the StandaloneFileBrowser classes that come with TriLib.

Trilib em 15h55min de 28 de fevereiro de 2021

2021-02-28T15:55:19Z

← Edição anterior		Edição das 12h55min de 28 de fevereiro de 2021
Linha 13:		Linha 13:
	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:

	<~~sourcelang~~="csharp">		<source lang="csharp">
	using TriLibCore;		using TriLibCore;
	using TriLibCore.General;		using TriLibCore.General;
Linha 96:		Linha 96:
	Use the following code in your "TestLoader.cs" and hit the play button to test it:		Use the following code in your "TestLoader.cs" and hit the play button to test it:

	<~~sourcelang~~="csharp">		<source lang="csharp">
	using TriLibCore;		using TriLibCore;
	using TriLibCore.General;		using TriLibCore.General;

Trilib: Criou página com 'There are three main methods to load models and their dependencies in TriLib: Local File-System Loading URL Loading *Custom Source Loading The user can adapt other loading m...'

2021-02-28T15:54:59Z

Criou página com 'There are three main methods to load models and their dependencies in TriLib: *Local File-System Loading *URL Loading *Custom Source Loading The user can adapt other loading m...'

Página nova

There are three main methods to load models and their dependencies in TriLib:
*Local File-System Loading
*URL Loading
*Custom Source Loading
The user can adapt other loading mechanisms as the core loading methods accept Streams as data input and Scriptable Objects called Mappers, used to load textures, and external data from custom data Streams.
==Local File-System Loading==
Loading models from the local file-system is simplified by using the StandaloneFileBrowser classes that come with TriLib.

Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.

Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.

Use the following code in your "TestLoader.cs" and hit the play button to test it:

<sourcelang="csharp">
using TriLibCore;
using TriLibCore.General;
using UnityEngine;

public class TestLoader : MonoBehaviour
{
// Lets the user load a new model by clicking a GUI button.
private void OnGUI()
{
// Displays a button to begin the model loading process.
if (GUILayout.Button("Load Model from File"))
{
// Creates an AssetLoaderOptions instance.
// AssetLoaderOptions is a class used to configure many aspects of the loading process.
// We won't change the default settings this time, so we can use the instance as it is.
var assetLoaderOptions = AssetLoader.CreateDefaultLoaderOptions();

// Creates the AssetLoaderFilePicker instance.
// AssetLoaderFilePicker is a class that allows users to select models from the local file system.
var assetLoaderFilePicker = AssetLoaderFilePicker.Create();

// Shows the model selection file-picker.
assetLoaderFilePicker.LoadModelFromFilePickerAsync("Select a File", OnLoad, OnMaterialsLoad, OnProgress, OnBeginLoad, OnError, null, assetLoaderOptions);
}
}

// This event is called when the model is about to be loaded.
// You can use this event to do some loading preparation, like showing a loading screen in platforms without threading support.
// This event receives a Boolean indicating if any file has been selected on the file-picker dialog.
private void OnBeginLoad(bool anyModelSelected)
{

}

// This event is called when the model loading progress changes.
// You can use this event to update a loading progress-bar, for instance.
// The "progress" value comes as a normalized float (goes from 0 to 1).
// Platforms like UWP and WebGL don't call this method at this moment, since they don't use threads.
private void OnProgress(AssetLoaderContext assetLoaderContext, float progress)
{

}

// This event is called when there is any critical error loading your model.
// You can use this to show a message to the user.
private void OnError(IContextualizedError contextualizedError)
{

}

// This event is called when all model GameObjects and Meshes have been loaded.
// There may still Materials and Textures processing at this stage.
private void OnLoad(AssetLoaderContext assetLoaderContext)
{
// The root loaded GameObject is assigned to the "assetLoaderContext.RootGameObject" field.
// If you want to make sure the GameObject will be visible only when all Materials and Textures have been loaded, you can disable it at this step.
var myLoadedGameObject = assetLoaderContext.RootGameObject;
myLoadedGameObject.SetActive(false);
}

// This event is called after OnLoad when all Materials and Textures have been loaded.
// This event is also called after a critical loading error, so you can clean up any resource you want to.
private void OnMaterialsLoad(AssetLoaderContext assetLoaderContext)
{
// The root loaded GameObject is assigned to the "assetLoaderContext.RootGameObject" field.
// You can make the GameObject visible again at this step if you prefer to.
var myLoadedGameObject = assetLoaderContext.RootGameObject;
myLoadedGameObject.SetActive(true);
}
}
</source>

== URL Loading ==

You can use the AssetDownloader class to load models from URLs (network). The usage is relatively simple and similar to the local file-system loading.

Let's create an empty Unity project in this example and import the TriLib Unity package. Make sure you include the StandaloneFileBrowser folder when extracting.

Create a new Script. You can call it "TestLoader.cs" then assign this script to the "Main Camera" on your scene.

Use the following code in your "TestLoader.cs" and hit the play button to test it:

<sourcelang="csharp">
using TriLibCore;
using TriLibCore.General;
using UnityEngine;

public class TestLoader : MonoBehaviour
{
// Lets the user load a new model by clicking a GUI button.
private void OnGUI()
{
// Displays a button to begin the model loading process.
if (GUILayout.Button("Load Model from URL"))
{
// Creates an AssetLoaderOptions instance.
// AssetLoaderOptions is a class used to configure many aspects of the loading process.
// We won't change the default settings this time, so we can use the instance as it is.
var assetLoaderOptions = AssetLoader.CreateDefaultLoaderOptions();

// Creates the web-request.
// The web-request contains information on how to download the model.
// Let's download a model from the TriLib website.
var webRequest = AssetDownloader.CreateWebRequest("https://ricardoreis.net/trilib/demos/avatars/003/003_visemes.zip");

// Begins the model downloading.
AssetDownloader.LoadModelFromUri(webRequest, OnLoad, OnMaterialsLoad, OnProgress, OnError, null, assetLoaderOptions);
}
}

// This event is called when the model loading progress changes.
// You can use this event to update a loading progress-bar, for instance.
// The "progress" value comes as a normalized float (goes from 0 to 1).
// Platforms like UWP and WebGL don't call this method at this moment, since they don't use threads.
private void OnProgress(AssetLoaderContext assetLoaderContext, float progress)
{

}

// This event is called when there is any critical error loading your model.
// You can use this to show a message to the user.
private void OnError(IContextualizedError contextualizedError)
{

}

// This event is called when all model GameObjects and Meshes have been loaded.
// There may still Materials and Textures processing at this stage.
private void OnLoad(AssetLoaderContext assetLoaderContext)
{
// The root loaded GameObject is assigned to the "assetLoaderContext.RootGameObject" field.
// If you want to make sure the GameObject will be visible only when all Materials and Textures have been loaded, you can disable it at this step.
var myLoadedGameObject = assetLoaderContext.RootGameObject;
myLoadedGameObject.SetActive(false);
}

// This event is called after OnLoad when all Materials and Textures have been loaded.
// This event is also called after a critical loading error, so you can clean up any resource you want to.
private void OnMaterialsLoad(AssetLoaderContext assetLoaderContext)
{
// The root loaded GameObject is assigned to the "assetLoaderContext.RootGameObject" field.
// You can make the GameObject visible again at this step if you prefer to.
var myLoadedGameObject = assetLoaderContext.RootGameObject;
myLoadedGameObject.SetActive(true);
}
}
</source>