feat: Add support for base64 encoded images to be manually added to I…

…mages cache. (#3008)

Adds a method so base64 encoded images can be manually added to the
Images cache.

packages/flame/lib/src/cache/images.dart

@@ -49,6 +49,14 @@ class Images {
  _assets[name] = _ImageAsset.fromImage(image);
  }
 
+ /// Transform the base64 encoded image into an [Image] and adds it into the
+ /// cache.
+ Future<void> addFromBase64Data(String name, String base64Data) async {
+ _assets[name]?.dispose();
+ final image = await _fetchFromBase64(base64Data);
+ _assets[name] = _ImageAsset.fromImage(image);
+ }
+
  /// If the image with [name] exists in the cache that is returned, otherwise
  /// the image generated by [imageGenerator] is returned.
  ///

packages/flame/test/cache/images_test.dart

@@ -20,6 +20,13 @@ void main() {
  'AAAAXNSR0IArs4c6QAAAA1JREFUGFdjWP33/n8ACGUDhwieHSEAAAAASUVORK5CYII=';
 
  group('Images', () {
+ test('can add a base64 image to the cache', () async {
+ final cache = Images();
+ await cache.addFromBase64Data('img', pixel);
+
+ expect(cache.fromCache('img'), isA<Image>());
+ });
+
  test('load image', () async {
  final cache = Images();
  final image = await cache.fromBase64('img', pixel);