loadSystemFonts method

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

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