GltfSaveOptions

Inheritance: java.lang.Object, com.aspose.threed.IOConfig, com.aspose.threed.SaveOptions

public class GltfSaveOptions extends SaveOptions

Параметры сохранения для формата glTF.

Конструкторы

Конструктор	Описание
GltfSaveOptions(FileContentType contentType)	Конструктор GltfSaveOptions
GltfSaveOptions(FileFormat format)	Конструктор GltfSaveOptions

Методы

Метод	Описание
equals(Object arg0)
getApplyUnitScale()	Применить AssetInfo.getUnitScaleFactor к сетке.
getBufferFile()	Имя внешнего буферного файла, используемого для хранения двоичных данных.
getClass()
getDracoCompression()	Получает, включено ли сжатие draco
getEmbedAssets()	Встраивает все внешние ресурсы в виде base64 в один файл в режиме ASCII, значение по умолчанию — false.
getEncoding()	Получает кодировку по умолчанию для текстовых файлов.
getExportTextures()	Пытается скопировать текстуры, используемые в сцене, в выходной каталог.
getExternalDracoEncoder()	Использовать внешний кодировщик draco для ускорения скорости сжатия draco.
getFallbackNormal()	Когда экспортёр GLTF2 обнаруживает недопустимую нормаль, вместо её исходного значения будет использовано это значение, чтобы обойти проверку.
getFileFormat()	Получает формат файла, указанный в текущей опции сохранения/загрузки.
getFileName()	Имя файла экспортируемой/импортируемой сцены.
getFileSystem()	Позволяет пользователю управлять внешними зависимостями во время загрузки/сохранения.
getFileSystemFactory()	Получает класс фабрики для FileSystem.
getFlipTexCoordV()	Отразить компонент текстурной координаты v(t), значение по умолчанию — true.
getImageFormat()	Стандартный glTF поддерживает только PNG/JPG в качестве формата текстур, эта опция определит, как Aspose.3D будет конвертировать нестандартные изображения в поддерживаемый формат во время экспорта.
getLookupPaths()	Некоторые файлы, такие как OBJ, зависят от внешних файлов; пути поиска позволяют Aspose.3D находить внешние файлы для загрузки.
getMaterialConverter()	Пользовательский конвертер для преобразования материала геометрии в PBR‑материал. Если он не задан, экспортер glTF 2.0 автоматически преобразует стандартный материал в PBR‑материал.
getPrettyPrint()	Содержимое JSON файла GLTF отступает для удобства чтения человеком, значение по умолчанию — false.
getSaveExtras()	Сохранить динамические свойства объектов сцены в поля ’extra’ в сгенерированном файле glTF.
getUseCommonMaterials()	Сериализовать материалы с использованием общих расширений KHR, значение по умолчанию — false.
hashCode()
notify()
notifyAll()
setApplyUnitScale(boolean value)	Применить AssetInfo.getUnitScaleFactor к сетке.
setBufferFile(String value)	Имя внешнего буферного файла, используемого для хранения двоичных данных.
setDracoCompression(boolean value)	Устанавливает, включать ли сжатие Draco.
setEmbedAssets(boolean value)	Встраивает все внешние ресурсы в виде base64 в один файл в режиме ASCII, значение по умолчанию — false.
setEncoding(Charset value)	Устанавливает кодировку по умолчанию для текстовых файлов.
setExportTextures(boolean value)	Пытается скопировать текстуры, используемые в сцене, в выходной каталог.
setExternalDracoEncoder(String value)	Использовать внешний кодировщик draco для ускорения скорости сжатия draco.
setFallbackNormal(Vector3 value)	Когда экспортёр GLTF2 обнаруживает недопустимую нормаль, вместо её исходного значения будет использовано это значение, чтобы обойти проверку.
setFileName(String value)	Имя файла экспортируемой/импортируемой сцены.
setFileSystem(FileSystem value)	Позволяет пользователю управлять внешними зависимостями во время загрузки/сохранения.
setFileSystemFactory(FileSystemFactory value)	Устанавливает класс фабрики для FileSystem.
setFlipTexCoordV(boolean value)	Отразить компонент текстурной координаты v(t), значение по умолчанию — true.
setImageFormat(GltfEmbeddedImageFormat value)	Стандартный glTF поддерживает только PNG/JPG в качестве формата текстур, эта опция определит, как Aspose.3D будет конвертировать нестандартные изображения в поддерживаемый формат во время экспорта.
setLookupPaths(ArrayList value)	Некоторые файлы, такие как OBJ, зависят от внешних файлов; пути поиска позволяют Aspose.3D находить внешние файлы для загрузки.
setMaterialConverter(MaterialConverter value)	Пользовательский конвертер для преобразования материала геометрии в PBR‑материал. Если он не задан, экспортер glTF 2.0 автоматически преобразует стандартный материал в PBR‑материал.
setPrettyPrint(boolean value)	Содержимое JSON файла GLTF отступает для удобства чтения человеком, значение по умолчанию — false.
setSaveExtras(boolean value)	Сохранить динамические свойства объектов сцены в поля ’extra’ в сгенерированном файле glTF.
setUseCommonMaterials(boolean value)	Сериализовать материалы с использованием общих расширений KHR, значение по умолчанию — false.
toString()
wait()
wait(long arg0)
wait(long arg0, int arg1)

GltfSaveOptions(FileContentType contentType)

public GltfSaveOptions(FileContentType contentType)

Конструктор GltfSaveOptions

Parameters:

Параметр	Тип	Описание
contentType	FileContentType

GltfSaveOptions(FileFormat format)

public GltfSaveOptions(FileFormat format)

Конструктор GltfSaveOptions

Parameters:

Параметр	Тип	Описание
format	FileFormat

equals(Object arg0)

public boolean equals(Object arg0)

Parameters:

Параметр	Тип	Описание
arg0	java.lang.Object

Returns: boolean

getApplyUnitScale()

public boolean getApplyUnitScale()

Применить AssetInfo.getUnitScaleFactor к сетке. Значение по умолчанию — false.

Returns: boolean — Применить AssetInfo.getUnitScaleFactor к сетке. Значение по умолчанию — false.

getBufferFile()

public String getBufferFile()

Имя внешнего буферного файла, используемого для хранения бинарных данных. Если файл не указан, Aspose.3D сгенерирует имя автоматически. Игнорируется при экспорте glTF в бинарном режиме.

Returns: java.lang.String — Имя внешнего буферного файла, используемого для хранения бинарных данных. Если файл не указан, Aspose.3D сгенерирует имя автоматически. Игнорируется при экспорте glTF в бинарном режиме.

getClass()

public final native Class<?> getClass()

Returns: java.lang.Class

getDracoCompression()

public boolean getDracoCompression()

Получает, включено ли сжатие draco

Returns: boolean — включать ли сжатие Draco.

getEmbedAssets()

public boolean getEmbedAssets()

Встраивает все внешние ресурсы в виде base64 в один файл в режиме ASCII, значение по умолчанию — false.

Returns: boolean — Встраивать все внешние ресурсы в виде base64 в один файл в ASCII‑режиме, значение по умолчанию — false.

getEncoding()

public Charset getEncoding()

Получает кодировку по умолчанию для текстовых файлов. Значение по умолчанию — null, что означает, что импортёр/экспортёр определит, какую кодировку использовать.

Returns: java.nio.charset.Charset - кодировка по умолчанию для текстовых файлов. Значение по умолчанию — null, что означает, что импортёр/экспортёр определит, какую кодировку использовать.

getExportTextures()

public boolean getExportTextures()

Пытается скопировать текстуры, используемые в сцене, в выходной каталог.

Returns: boolean — Пытаться копировать текстуры, используемые в сцене, в выходной каталог.

getExternalDracoEncoder()

public String getExternalDracoEncoder()

Использовать внешний кодировщик draco для ускорения скорости сжатия draco.

Returns: java.lang.String — Использовать внешний кодировщик Draco для ускорения скорости сжатия Draco. Remarks: Aspose.3D создаст новый подпроцесс для кодирования сетки в формат Draco, используйте его на свой страх и риск.

getFallbackNormal()

public Vector3 getFallbackNormal()

Когда экспортер GLTF2 обнаруживает недопустимую нормаль, вместо её оригинального значения будет использовано это значение, чтобы обойти проверку. Значение по умолчанию — (0, 1, 0).

Returns: Vector3 - When GLTF2 exporter detected an invalid normal, this will be used instead of its original value to bypass the validation. Default value is (0, 1, 0)

getFileFormat()

public FileFormat getFileFormat()

Получает формат файла, указанный в текущей опции сохранения/загрузки.

Returns: FileFormat - the file format that specified in current Save/Load option.

getFileName()

public String getFileName()

Имя файла экспортируемой/импортируемой сцены. Это необязательно, но полезно при сериализации внешних ресурсов, таких как материал OBJ.

Returns: java.lang.String - Имя файла экспортируемой/импортируемой сцены. Это необязательно, но полезно при сериализации внешних ресурсов, таких как материал OBJ.

getFileSystem()

public FileSystem getFileSystem()

Позволяет пользователю управлять внешними зависимостями во время загрузки/сохранения.

Returns: FileSystem - Allow user to handle how to manage the external dependencies during load/save. Example: The default FileSystem is LocalFileSystem, it is not safe in environment like server side, But you can override the file system access by specifying a different implementation. Aspose.3D provides different FileSystem implementation like:

• Memory-based file system
• Directory-based file system
• Dummy file system
• Zip file system

И вы также можете использовать свою собственную реализацию.

Scene scene = new Scene();
             var material = new PhongMaterial();
             var boxNode = scene.getRootNode().createChildNode(new Box());
             boxNode.setMaterial(material);
 
             var opt = new ObjSaveOptions();
             var memFs = new HashMap<string, MemoryStream>();
             opt.setFileSystem(FileSystem.createMemoryFileSystem(memFs));
 			opt.setFileName("output.obj");
             try(var output = new ByteArrayOutputStream()) {
 				scene.save(output, opt);
 				//The material will be written to variable memFs named output.mtl
 				var materialInBytes = memFs["output.mtl"].toArray();
             }

getFileSystemFactory()

public static FileSystemFactory getFileSystemFactory()

Получает класс фабрики для FileSystem. Фабрика по умолчанию создаст com.aspose.threed.LocalFileSystem, который не подходит для серверной среды.

Returns: FileSystemFactory - the factory class for FileSystem. The default factory will create com.aspose.threed.LocalFileSystem which is not suitable for server environment. Example: The default FileSystem in SaveOptions/LoadOptions is directory-based file system, You can override the default implementation by specify it through IOConfig.FileSystemFactory:

IOConfig.setFileSystemFactory(new FileSystemFactory() {
 				@Override
 				public FileSystem call() {
 					return FileSystem.createDummyFileSystem();
 				}
 			});
 
             Scene scene = new Scene();
             var material = new PhongMaterial();
             var boxNode = scene.getRootNode().createChildNode(new Box());
             boxNode.setMaterial(material);
 
             //opt.FileSystem would be dummy file system now
             var opt = new ObjSaveOptions();
             scene.Save("output.obj", opt);
             //the material file output.mtl will not be written to any places because we've configured a dummy file system as default implementation.

getFlipTexCoordV()

public boolean getFlipTexCoordV()

Отразить компонент текстурной координаты v(t), значение по умолчанию — true.

Returns: boolean — Инвертировать компонент v(t) текстурных координат, значение по умолчанию — true.

getImageFormat()

public GltfEmbeddedImageFormat getImageFormat()

Стандартный glTF поддерживает только PNG/JPG в качестве формата текстур, эта опция определит, как Aspose.3D будет конвертировать нестандартные изображения в поддерживаемый формат во время экспорта. Значение по умолчанию — GltfEmbeddedImageFormat.PNG

Returns: GltfEmbeddedImageFormat - Standard glTF only supports PNG/JPG as its texture format, this option will guide how Aspose.3D convert the non-standard images to supported format during the exporting. Default value is GltfEmbeddedImageFormat.PNG

getLookupPaths()

public ArrayList<String> getLookupPaths()

Некоторые файлы, такие как OBJ, зависят от внешних файлов; пути поиска позволяют Aspose.3D находить внешние файлы для загрузки.

Returns: java.util.ArrayList<java.lang.String> - Некоторые файлы, такие как OBJ, зависят от внешних файлов; пути поиска позволяют Aspose.3D искать внешние файлы для загрузки. Example: Следующий код показывает, как вручную указать пути поиска текстур, чтобы импортёр мог их найти

var opt = new ObjLoadOptions();
             //Specify the lookup paths, so the textures can be located.
             opt.getLookupPaths().add("textures");
             var scene = Scene.fromFile("input.obj", opt);
             scene.save("output.glb");

getMaterialConverter()

public MaterialConverter getMaterialConverter()

Пользовательский конвертер для преобразования материала геометрии в PBR‑материал. Если он не задан, экспортер glTF 2.0 автоматически преобразует стандартный материал в PBR‑материал. Значение по умолчанию — null. Это свойство используется при экспорте сцены в файл glTF 2.0.

Returns: MaterialConverter - Custom converter to convert the geometry’s material to PBR material If this is unassigned, glTF 2.0 exporter will automatically convert the standard material to PBR material. Default value is null This property is used when exporting a scene to a glTF 2.0 file.

getPrettyPrint()

public boolean getPrettyPrint()

Содержимое JSON файла GLTF отступает для удобства чтения человеком, значение по умолчанию — false.

Returns: boolean — Содержимое JSON файла GLTF отступает для удобства чтения человеком, значение по умолчанию — false.

getSaveExtras()

public boolean getSaveExtras()

Сохранить динамические свойства объектов сцены в поля ’extra’ в сгенерированном файле glTF. Это полезно для предоставления данных, специфичных для приложения. Значение по умолчанию — false.

Returns: boolean — Сохранить динамические свойства объектов сцены в поля ’extra’ в сгенерированном файле glTF. Это полезно для предоставления данных, специфичных для приложения. Значение по умолчанию — false.

getUseCommonMaterials()

public boolean getUseCommonMaterials()

Сериализовать материалы с использованием общих расширений KHR, значение по умолчанию — false. Установка этого параметра в false заставит Aspose.3D экспортировать набор вершинных/фрагментных шейдеров, если getExportShaders.

Returns: boolean — Сериализовать материалы с использованием общих расширений KHR, значение по умолчанию — false. Установка этого параметра в false заставит Aspose.3D экспортировать набор вершинных/фрагментных шейдеров, если getExportShaders Remarks: Это свойство работает только с glTF 1.0.

hashCode()

public native int hashCode()

Returns: int

notify()

public final native void notify()

notifyAll()

public final native void notifyAll()

setApplyUnitScale(boolean value)

public void setApplyUnitScale(boolean value)

Применить AssetInfo.getUnitScaleFactor к сетке. Значение по умолчанию — false.

Parameters:

Параметр	Тип	Описание
значение	boolean	Новое значение

setBufferFile(String value)

public void setBufferFile(String value)

Имя внешнего буферного файла, используемого для хранения бинарных данных. Если файл не указан, Aspose.3D сгенерирует имя автоматически. Игнорируется при экспорте glTF в бинарном режиме.

Parameters:

Параметр	Тип	Описание
значение	java.lang.String	Новое значение

setDracoCompression(boolean value)

public void setDracoCompression(boolean value)

Устанавливает, включать ли сжатие Draco.

Parameters:

Параметр	Тип	Описание
значение	boolean	Новое значение

setEmbedAssets(boolean value)

public void setEmbedAssets(boolean value)

Встраивает все внешние ресурсы в виде base64 в один файл в режиме ASCII, значение по умолчанию — false.

Parameters:

Параметр	Тип	Описание
значение	boolean	Новое значение

setEncoding(Charset value)

public void setEncoding(Charset value)

Устанавливает кодировку по умолчанию для текстовых файлов. Значение по умолчанию — null, что означает, что импортёр/экспортёр определит, какую кодировку использовать.

Parameters:

Параметр	Тип	Описание
значение	java.nio.charset.Charset	Новое значение

setExportTextures(boolean value)

public void setExportTextures(boolean value)

Пытается скопировать текстуры, используемые в сцене, в выходной каталог.

Parameters:

Параметр	Тип	Описание
значение	boolean	Новое значение

setExternalDracoEncoder(String value)

public void setExternalDracoEncoder(String value)

Использовать внешний кодировщик draco для ускорения скорости сжатия draco.

Parameters:

Параметр	Тип	Описание
значение	java.lang.String	Новое значение Remarks: Aspose.3D создаст новый подпроцесс для кодирования сетки в формат Draco, используйте его на свой страх и риск.

setFallbackNormal(Vector3 value)

public void setFallbackNormal(Vector3 value)

Когда экспортер GLTF2 обнаруживает недопустимую нормаль, вместо её оригинального значения будет использовано это значение, чтобы обойти проверку. Значение по умолчанию — (0, 1, 0).

Parameters:

Параметр	Тип	Описание
value	Vector3	Новое значение

setFileName(String value)

public void setFileName(String value)

Имя файла экспортируемой/импортируемой сцены. Это необязательно, но полезно при сериализации внешних ресурсов, таких как материал OBJ.

Parameters:

Параметр	Тип	Описание
значение	java.lang.String	Новое значение

setFileSystem(FileSystem value)

public void setFileSystem(FileSystem value)

Позволяет пользователю управлять внешними зависимостями во время загрузки/сохранения.

Parameters:

Параметр	Тип	Описание
	value	FileSystem

• Memory-based file system
• Directory-based file system
• Dummy file system
• Zip file system

И вы также можете использовать свою собственную реализацию.

Scene scene = new Scene();
             var material = new PhongMaterial();
             var boxNode = scene.getRootNode().createChildNode(new Box());
             boxNode.setMaterial(material);
 
             var opt = new ObjSaveOptions();
             var memFs = new HashMap<string, MemoryStream>();
             opt.setFileSystem(FileSystem.createMemoryFileSystem(memFs));
 			opt.setFileName("output.obj");
             try(var output = new ByteArrayOutputStream()) {
 				scene.save(output, opt);
 				//The material will be written to variable memFs named output.mtl
 				var materialInBytes = memFs["output.mtl"].toArray();
             }
``` |

### setFileSystemFactory(FileSystemFactory value) {#setFileSystemFactory-com.aspose.threed.FileSystemFactory-}

public static void setFileSystemFactory(FileSystemFactory value)

Устанавливает класс фабрики для FileSystem. Фабрика по умолчанию создаст com.aspose.threed.LocalFileSystem, который не подходит для серверной среды.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
|  | value | [FileSystemFactory](../../com.aspose.threed/filesystemfactory) | Новое значение **Example:** Файловая система по умолчанию в SaveOptions/LoadOptions — файловая система, основанная на каталогах. Вы можете переопределить реализацию по умолчанию, указав её через IOConfig.FileSystemFactory: |

IOConfig.setFileSystemFactory(new FileSystemFactory() { @Override public FileSystem call() { return FileSystem.createDummyFileSystem(); } });

         Scene scene = new Scene();
         var material = new PhongMaterial();
         var boxNode = scene.getRootNode().createChildNode(new Box());
         boxNode.setMaterial(material);

         //opt.FileSystem would be dummy file system now
         var opt = new ObjSaveOptions();
         scene.Save("output.obj", opt);
         //the material file output.mtl will not be written to any places because we've configured a dummy file system as default implementation.

### setFlipTexCoordV(boolean value) {#setFlipTexCoordV-boolean-}

public void setFlipTexCoordV(boolean value)

Отразить компонент текстурной координаты v(t), значение по умолчанию — true.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| значение | boolean | Новое значение |

### setImageFormat(GltfEmbeddedImageFormat value) {#setImageFormat-com.aspose.threed.GltfEmbeddedImageFormat-}

public void setImageFormat(GltfEmbeddedImageFormat value)

Стандартный glTF поддерживает только PNG/JPG в качестве формата текстур, эта опция определит, как Aspose.3D будет конвертировать нестандартные изображения в поддерживаемый формат во время экспорта. Значение по умолчанию — [GltfEmbeddedImageFormat.PNG](../../com.aspose.threed/gltfembeddedimageformat\\#PNG)

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| value | [GltfEmbeddedImageFormat](../../com.aspose.threed/gltfembeddedimageformat) | Новое значение |

### setLookupPaths(ArrayList<String> value) {#setLookupPaths-java.util.ArrayList-java.lang.String--}

public void setLookupPaths(ArrayList value)

Некоторые файлы, такие как OBJ, зависят от внешних файлов; пути поиска позволяют Aspose.3D находить внешние файлы для загрузки.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
|  | значение | java.util.ArrayList<java.lang.String> | Новое значение **Example:** Следующий код показывает, как вручную указать пути поиска текстур, чтобы импортёр мог их найти |

var opt = new ObjLoadOptions(); //Specify the lookup paths, so the textures can be located. opt.getLookupPaths().add(“textures”); var scene = Scene.fromFile(“input.obj”, opt); scene.save(“output.glb”);

### setMaterialConverter(MaterialConverter value) {#setMaterialConverter-com.aspose.threed.MaterialConverter-}

public void setMaterialConverter(MaterialConverter value)

Пользовательский конвертер для преобразования материала геометрии в PBR‑материал. Если он не задан, экспортер glTF 2.0 автоматически преобразует стандартный материал в PBR‑материал. Значение по умолчанию — null. Это свойство используется при экспорте сцены в файл glTF 2.0.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| value | [MaterialConverter](../../com.aspose.threed/materialconverter) | Новое значение |

### setPrettyPrint(boolean value) {#setPrettyPrint-boolean-}

public void setPrettyPrint(boolean value)

Содержимое JSON файла GLTF отступает для удобства чтения человеком, значение по умолчанию — false.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| значение | boolean | Новое значение |

### setSaveExtras(boolean value) {#setSaveExtras-boolean-}

public void setSaveExtras(boolean value)

Сохранить динамические свойства объектов сцены в поля 'extra' в сгенерированном файле glTF. Это полезно для предоставления данных, специфичных для приложения. Значение по умолчанию — false.

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| значение | boolean | Новое значение |

### setUseCommonMaterials(boolean value) {#setUseCommonMaterials-boolean-}

public void setUseCommonMaterials(boolean value)

Сериализовать материалы с использованием общих расширений KHR, значение по умолчанию — false. Установка этого параметра в false заставит Aspose.3D экспортировать набор вершинных/фрагментных шейдеров, если [getExportShaders](../../com.aspose.threed/gltfsaveoptions\\#getExportShaders).

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| значение | boolean | Новое значение **Remarks:** Это свойство работает только с glTF 1.0. |

### toString() {#toString--}

public String toString()

**Returns:**
java.lang.String
### wait() {#wait--}

public final void wait()

### wait(long arg0) {#wait-long-}

public final void wait(long arg0)

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| arg0 | long |  |

### wait(long arg0, int arg1) {#wait-long-int-}

public final void wait(long arg0, int arg1)

**Parameters:**
| Параметр | Тип | Описание |
| --- | --- | --- |
| arg0 | long |  |
| arg1 | int |  |