load_mesh()

std::vector< std::shared_ptr< Buffers::MeshBuffer > > MayaFlux::IO::IOManager::load_mesh	(	const std::string &	filepath,
		TextureResolver	resolver = nullptr
	)

Load all meshes from a 3D model file into MeshBuffer instances.

Opens the file via ModelReader, extracts all aiMesh entries as MeshData, constructs one MeshBuffer per mesh, calls setup_processors() on each, and returns them. setup_rendering() is left to the caller.

If resolver is null, the default resolver is used: paths resolved relative to the model file's directory via ImageReader::load_texture. Unresolvable textures are logged and skipped.

Parameters

filepath	Path to the model file (glTF, FBX, OBJ, PLY, etc.).
resolver	Optional texture resolver.

Returns

One MeshBuffer per mesh in scene order, or empty on failure.

Definition at line 381 of file IOManager.cpp.

{
    auto reader = std::make_shared<ModelReader>();
 
    if (!reader->can_read(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::load_mesh: unsupported format '{}'", filepath);
        return {};
    }
 
    if (!reader->open(filepath)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::load_mesh: failed to open '{}' — {}",
            filepath, reader->get_last_error());
        return {};
    }
 
    if (!resolver)
        resolver = make_default_resolver(filepath);
 
    auto buffers = reader->create_mesh_buffers(resolver);
    reader->close();
 
    if (buffers.empty()) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "IOManager::load_mesh: no meshes in '{}'", filepath);
        return {};
    }
 
    MF_INFO(Journal::Component::API, Journal::Context::FileIO,
        "IOManager::load_mesh: {} mesh(es) from '{}'",
        buffers.size(),
        std::filesystem::path(filepath).filename().string());
 
    return buffers;
}

References MayaFlux::Journal::API, MayaFlux::Journal::FileIO, MF_ERROR, and MF_INFO.