loadSystemFont method

Future<BLFontFace?> loadSystemFont(
  1. BLFontCollection collection,
  2. BLFontQuery query, {
  3. List<String>? directories,
  4. int concurrency = 4,
  5. void onError(
    1. String path,
    2. Object error
    )?,
})

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;
}