FileFormat — Aspose.3D FOSS for Java
Methods
FileFormat serve tanto como descritor de formato quanto como um registro de todos os formatos de arquivo 3D suportados. Cada formato é representado como um FileFormat instância acessível como um atributo de classe ou via métodos de fábrica estáticos. Você passa FileFormat instâncias para Scene.save() para forçar um formato específico, ou usar FileFormat.detect() para identificar o formato de um arquivo desconhecido.
Methods: com.aspose.threed
import com.aspose.threed.FileFormat;Constantes de Formato Suportadas
Constantes de formato que são ativamente suportadas (importadores e/ou exportadores registrados) na versão FOSS são mostradas abaixo.
Suportados Ativamente (versão FOSS)
| Methods | Methods | Methods |
|---|---|---|
FileFormat.WAVEFRONTOBJ | .obj | Campo público estático final (instância ObjFormat) |
FileFormat.GLTF2 | .gltf / .glb | glTF 2.0 e GLB; campo público estático final (instância GltfFormat). Use GltfSaveOptions com setContentType(FileContentType.BINARY) para saída GLB. |
FileFormat.FBX7400ASCII | .fbx | FBX 7.4 ASCII; apenas importação (sem exportação) |
FileFormat.STL_BINARY | .stl | STL binário (definido no carregamento da classe) |
FileFormat.STLASCII | .stl | STL ASCII |
Methods
FBX versions 6100-7700 (binary), Maya ASCII/Binary, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF binary, PDF, Blender, DXF, PLY, X (binary/text), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD binary.
Métodos Estáticos
| Methods | Tipo de Retorno | Methods |
|---|---|---|
FileFormat.detect(InputStream stream, String fileName) | FileFormat | Detecta o formato a partir de um fluxo de arquivo; fileName é usado como uma dica |
FileFormat.getFormatByExtension(String ext) | FileFormat | Retorna o formato que corresponde a uma string de extensão, como ".obj", ".glb", ".fbx", ".stl" |
Propriedades da Instância
| Methods | Methods | Methods | Methods |
|---|---|---|---|
extension | String | getExtension() | Extensão de arquivo principal (sem ponto inicial) |
extensions | List<String> | getExtensions() | Todas as extensões suportadas por este formato |
contentType | String | getContentType() | String de tipo MIME |
canExport | boolean | getCanExport() | Se a exportação para este formato é suportada |
canImport | boolean | getCanImport() | Se a importação a partir deste formato é suportada |
version | String | getVersion() | String de versão do formato |
Métodos da Instância
| Methods | Tipo de Retorno | Methods |
|---|---|---|
createLoadOptions() | LoadOptions | Cria o apropriado específico ao formato LoadOptions subclasse |
createSaveOptions() | SaveOptions | Cria o apropriado específico ao formato SaveOptions subclasse |
Methods
import com.aspose.threed.Scene;
import com.aspose.threed.FileFormat;
import com.aspose.threed.*;
// Auto-detect and load
Scene scene = Scene.fromFile("model.obj");
// Save with explicit format (force GLB binary)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setContentType(FileContentType.BINARY);
scene.save("output.glb", opts);
// Get format by extension
FileFormat fmt = FileFormat.getFormatByExtension(".fbx");
if (fmt != null) {
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // false (FBX export not available)
}
// Create options from a format instance
FileFormat fmtObj = FileFormat.getFormatByExtension(".obj");
LoadOptions loadOpts = fmtObj.createLoadOptions(); // ObjLoadOptions
SaveOptions saveOpts = fmtObj.createSaveOptions(); // ObjSaveOptions
// Detect format from file stream
try (FileInputStream fis = new FileInputStream("unknown_file.bin")) {
FileFormat detected = FileFormat.detect(fis, "unknown_file.bin");
if (detected != null) {
System.out.println(detected.getClass().getSimpleName());
}
}