blurhash_dart

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

BlurHash Dart é uma implementação pura em Dart do algoritmo BlurHash, permitindo a geração e decodificação eficientes de placeholders de imagem compactos. Ele fornece funcionalidades de codificador e decodificador, além de extensões úteis para integração perfeita em aplicativos Flutter. Ideal para exibir prévias de baixa largura de banda de imagens durante o carregamento, suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. O pacote é leve e projetado para desempenho sem dependências externas.

Casos de uso

Gerando espaços reservados de imagem durante o carregamento
Criando visualizações em baixa resolução para imagens grandes
Melhorando o desempenho percebido do aplicativo com visualizações de espaço reservado
Integrando efeitos de desfoque em miniaturas de imagem
Otimizando o carregamento de imagens em aplicativos com alta carga de rede

Principais recursos

Implementação pura em Dart
Codificador e decodificador incluídos
Extensões úteis para facilitar o uso
Compatibilidade multiplataforma
Leve e rápido
Sem dependências nativas

Indicado para

Desenvolvedores Flutter que precisam de espaços reservados de imagem
Aplicativos com condições de rede lentas ou variáveis
Implementações de UI voltadas para desempenho
Desenvolvedores evitando código específico de plataforma
Projetos que exigem bibliotecas de terceiros mínimas

Considerações

Não adequado para representação de imagem de alta fidelidade
Requer conhecimento sobre o conceito de BlurHash
Limitado a casos de uso de espaço reservado
Pode não suportar recursos avançados de processamento de imagem
Melhor usado como aprimoramento visual, não como substituto de imagens reais

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

BlurHash Dart

A pure dart implementation of BlurHash. Supports both encoding and decoding. Runs on every supported Dart platform. See the BlurHash website or GitHub repository for more information.

The encoder of this dart implementation produces slightly different hashes than the TypeScript implementation but matches the official C and Python implementation. In practice this should not be relevant.

Basic usage

Decoding a BlurHash

import 'package:blurhash_dart/blurhash_dart.dart';
import 'package:image/image.dart' as img;

const hash = 'LEHV6nWB2yk8pyo0adR*.7kCMdnj';
BlurHash blurHash = BlurHash.decode(hash);
img.Image image = blurHash.toImage(35, 20);

// Display image...

Note: Usage with Flutter

Flutter does not expect raw bytes for its Image.memory widget, but fully encoded images with their corresponding headers (e.g. bitmap, jpg, png). The easiest way to accomplish this, is to use, for example, encodeJpg from package:image:

Widget build(BuildContext context) {
  final image = BlurHash.decode('LEHV6nWB2yk8pyo0adR*.7kCMdnj').toImage(35, 20);
  return Image.memory(Uint8List.fromList(encodeJpg(image)));
}

It is recommended to cache the resulting image in a stateful widget, such that it does not need to be recomputed on every build call.

Encoding an Image

import 'dart:io';

import 'package:blurhash_dart/blurhash_dart.dart';
import 'package:image/image.dart' as img;

final data = File('path/to/image.png').readAsBytesSync();
final image = img.decodeImage(data.toList());
final blurHash = BlurHash.encode(image!, numCompX: 4, numCompY: 3);

print(blurHash.hash);

Extension Methods

Additional extension methods to compute, for example color averages, are available when importing package:blurhash_dart/blurhash_extensions.dart. See example for basic usage.