loadSystemFont method
Future<BLFontFace?>
loadSystemFont(
- BLFontCollection collection,
- BLFontQuery query, {
- List<
String> ? directories, - int concurrency = 4,
- void onError()?,
Carrega arquivos do catálogo nativo até encontrar uma face para query.
É o caminho indicado para fallback sob demanda: evita analisar centenas
de fontes quando o documento precisa de apenas uma família. As faces já
examinadas permanecem em collection e podem atender consultas futuras.
Implementation
Future<BLFontFace?> loadSystemFont(
BLFontCollection collection,
BLFontQuery query, {
List<String>? directories,
int concurrency = 4,
void Function(String path, Object error)? onError,
}) async {
if (concurrency < 1) {
throw ArgumentError.value(concurrency, 'concurrency', 'deve ser >= 1');
}
final existing = collection.resolveLocal(query);
if (existing != null) return existing;
final files = await discoverSystemFontFiles(directories: directories);
for (var cursor = 0; cursor < files.length; cursor += concurrency) {
final end = (cursor + concurrency).clamp(0, files.length);
final reads = await Future.wait([
for (final path in files.sublist(cursor, end)) _readFont(path),
]);
for (final read in reads) {
if (read.error != null) {
onError?.call(read.path, read.error!);
continue;
}
try {
for (final face in loadFaces(read.data!)) {
collection.addFace(face);
}
} on Object catch (error) {
onError?.call(read.path, error);
}
}
final match = collection.resolveLocal(query);
if (match != null) return match;
}
return null;
}