/// <summary>
/// Constructor
/// </summary>
public EditorGltfImporter(string gltfPath, string importPath,
GltfImportOptions importOptions,
ProgressCallback progressCallback = null)
: base(new Uri(gltfPath), null, importOptions,
new EditorGltfImportCache(UnityPathUtil.GetProjectPath(importPath)),
progressCallback)
{
_importPath = importPath;
}
/// <summary>
/// Reset all Piglet glTF import options to default values.
/// </summary>
public void Reset()
{
EnableDragAndDropImport = true;
ImportOptions = new GltfImportOptions();
LogProgress = false;
PromptBeforeOverwritingFiles = true;
SelectPrefabAfterImport = true;
OpenPrefabAfterImport = true;
AddPrefabToScene = false;
SelectPrefabInScene = false;
}
/// <summary>
/// Returns an asynchronous glTF import task. The import task is
/// advanced by calling MoveNext(), typically from the
/// Update() method of a MonoBehaviour.
///
/// At least one of the `uri` and `data` arguments must be
/// non-null. If both are non-null, no data is read from
/// the `uri` argument and `uri` is only used for resolving relative
/// URIs that appear in the file provided by the `data` argument.
/// In the case that the `data` argument is a .zip file, the `uri`
/// argument is completely ignored and any relative URIs are resolved
/// relative the location of the .gltf/.glb file inside the zip archive.
/// </summary>
/// <param name="uri">
/// The URI of the input .gltf/.glb/.zip file.
/// </param>
/// <param name="data">
/// The raw bytes of the input .gltf/.glb/.zip file.
/// </param>
/// <param name="importOptions">
/// Options controlling glTF importer behaviour (e.g. should
/// the imported model be automatically scaled to a certain size?).
/// </param>
/// <returns>
/// an asyncronous glTF import task (GltfImportTask)
/// </returns>
static public GltfImportTask GetImportTask(Uri uri,
byte[] data, GltfImportOptions importOptions = null)
{
GltfImportTask importTask = new GltfImportTask();
if (importOptions == null)
{
importOptions = new GltfImportOptions();
}
RuntimeGltfImporter importer
= new RuntimeGltfImporter(uri, data, importOptions,
(step, completed, total) =>
importTask.OnProgress?.Invoke(step, completed, total));
importTask.AddTask(importer.ReadUri());
importTask.AddTask(importer.ParseFile());
importTask.AddTask(importer.LoadBuffers());
importTask.AddTask(importer.LoadTextures());
importTask.AddTask(importer.LoadMaterials());
importTask.AddTask(importer.LoadMeshes());
importTask.AddTask(importer.LoadScene());
importTask.AddTask(importer.LoadMorphTargets());
importTask.AddTask(importer.LoadSkins());
importTask.AddTask(importer.ScaleModel());
importTask.AddTask(importer.LoadAnimations());
importTask.AddTask(importer.ShowModel());
// note: the final subtask must return the
// root GameObject for the imported model.
importTask.AddTask(importer.GetSceneObjectEnum());
// callbacks to clean up any imported game objects
// when the user aborts the import or an exception
// occurs
importTask.OnAborted += importer.Clear;
importTask.OnException += _ => importer.Clear();
return(importTask);
}
/// <summary>
/// Coroutine-style implementation of GLTF import.
/// </summary>
/// <param name="gltfPath">
/// Absolute path to .gltf/.glb file.
/// </param>
/// <param name="importPath">
/// Absolute path of folder where prefab and
/// associated assets will be created. Must be located under
/// the "Assets" folder for the current Unity project.
/// </param>
/// <param name="importOptions">
/// Options controlling glTF importer behaviour (e.g. should
/// the imported model be automatically scaled to a certain size?).
/// </param>
public static GltfImportTask GetImportTask(string gltfPath,
string importPath, GltfImportOptions importOptions = null)
{
GltfImportTask importTask = new GltfImportTask();
if (importOptions == null)
{
importOptions = new GltfImportOptions();
}
EditorGltfImporter importer = new EditorGltfImporter(
gltfPath, importPath, importOptions,
(step, completed, total) =>
importTask.OnProgress?.Invoke(step, completed, total));
importTask.AddTask(importer.ReadUri());
importTask.AddTask(importer.ParseFile());
importTask.AddTask(importer.LoadBuffers());
importTask.AddTask(importer.LoadTextures());
importTask.AddTask(importer.LoadMaterials());
importTask.AddTask(importer.LoadMeshes());
importTask.AddTask(importer.LoadScene());
importTask.AddTask(importer.LoadMorphTargets());
importTask.AddTask(importer.LoadSkins());
importTask.AddTask(importer.ScaleModel());
importTask.AddTask(importer.LoadAnimations());
// note: the final subtask must return the
// root GameObject for the imported model.
importTask.AddTask(importer.CreatePrefabEnum());
// callbacks to clean up any imported game objects / files
// when the user aborts the import or an exception
// occurs
importTask.OnAborted += importer.Clear;
importTask.OnException += _ => importer.Clear();
return(importTask);
}
/// <summary>
/// Returns an asynchronous glTF import task. The import task is
/// advanced by calling MoveNext(), typically from the
/// Update() callback of a MonoBehaviour.
/// </summary>
/// <param name="data">
/// the raw bytes of the input .gltf/.glb/.zip file
/// </param>
/// <param name="importOptions">
/// Options controlling glTF importer behaviour (e.g. should
/// the imported model be automatically scaled to a certain size?).
/// </param>
/// <returns>
/// an asyncronous glTF import task (GltfImportTask)
/// </returns>
public static GltfImportTask GetImportTask(
byte[] data, GltfImportOptions importOptions = null)
{
return(GetImportTask(null, data, importOptions));
}
/// <summary>
/// Constructor
/// </summary>
public RuntimeGltfImporter(Uri uri, byte[] data,
GltfImportOptions importOptions,
ProgressCallback progressCallback)
: base(uri, data, importOptions, new RuntimeGltfImportCache(), progressCallback)
{
}
/// <summary>
/// Returns an asynchronous glTF import task. The import task is
/// advanced by calling MoveNext(), typically from the
/// Update() callback of a MonoBehaviour.
/// </summary>
/// <param name="uri">
/// The absolute URI for the input .gltf/.glb/.zip file,
/// which may be an HTTP(S) URL or an absolute file path
/// (e.g. "C:/Users/Joe/Desktop/model.glb").
/// </param>
/// <param name="importOptions">
/// Options controlling glTF importer behaviour (e.g. should
/// the imported model be automatically scaled to a certain size?).
/// </param>
/// <returns>
/// an asyncronous glTF import task (GltfImportTask)
/// </returns>
public static GltfImportTask GetImportTask(
string uri, GltfImportOptions importOptions = null)
{
return(GetImportTask(new Uri(uri), null, importOptions));
}
/// <summary>
/// Returns an asynchronous glTF import task. The import task is
/// advanced by calling MoveNext(), typically from the
/// Update() callback of a MonoBehaviour.
/// </summary>
/// <param name="uri">
/// The URI for the input .gltf/.glb/.zip file, which
/// may be an HTTP(S) URL or a file URI
/// (e.g. "file:///C:/Users/Joe/Desktop/model.glb").
/// </param>
/// <param name="importOptions">
/// Options controlling glTF importer behaviour (e.g. should
/// the imported model be automatically scaled to a certain size?).
/// </param>
/// <returns>
/// an asyncronous glTF import task (GltfImportTask)
/// </returns>
public static GltfImportTask GetImportTask(
Uri uri, GltfImportOptions importOptions = null)
{
return(GetImportTask(uri, null, importOptions));
}
