loadSystemFonts method
Descobre, valida e adiciona fontes nativas a collection.
Arquivos ilegíveis ou formatos ainda não suportados são ignorados para
que uma fonte defeituosa do sistema não invalide o catálogo inteiro.
onError permite registrar esses casos. maxFonts limita o consumo de
memória em dispositivos móveis; null tenta carregar todas as faces.
concurrency controla quantos arquivos são lidos em paralelo. O parsing
continua determinístico e as faces são adicionadas na ordem dos caminhos.
Implementation
Future<int> loadSystemFonts(
BLFontCollection collection, {
List<String>? directories,
int? maxFonts,
int concurrency = 8,
void Function(String path, Object error)? onError,
}) async {
if (maxFonts != null && maxFonts < 0) {
throw ArgumentError.value(maxFonts, 'maxFonts', 'deve ser nulo ou >= 0');
}
if (concurrency < 1) {
throw ArgumentError.value(concurrency, 'concurrency', 'deve ser >= 1');
}
if (maxFonts == 0) return 0;
final files = await discoverSystemFontFiles(directories: directories);
var loaded = 0;
var cursor = 0;
while (cursor < files.length && (maxFonts == null || loaded < maxFonts)) {
final remaining = maxFonts == null ? concurrency : maxFonts - loaded;
final count = remaining < concurrency ? remaining : concurrency;
final end = (cursor + count).clamp(0, files.length);
final reads = await Future.wait([
for (final path in files.sublist(cursor, end)) _readFont(path),
]);
cursor = end;
for (final read in reads) {
if (maxFonts != null && loaded >= maxFonts) break;
if (read.error != null) {
onError?.call(read.path, read.error!);
continue;
}
try {
final faces = loadFaces(read.data!);
for (final face in faces) {
if (maxFonts != null && loaded >= maxFonts) break;
collection.addFace(face);
loaded++;
}
} on Object catch (error) {
onError?.call(read.path, error);
}
}
}
return loaded;
}