Standardization [flame_texturepacker], flame aseprite package imports style , fix index fail

[s1r1m1r1]

Problem to solve

I noticed some discrepancies in the way packages for aseprite and flame_texturepacker are included.

Proposal

Standardizing package imports with priority support for aseprite

More information

No response

Other

• Are you interested in working on a PR for this?

[ufrshubham]

@s1r1m1r1 can you add more details about the discrepancies and proposed solution?

[s1r1m1r1]

flame_texturepacker

 final atlas = await TexturePackerAtlas.load(
        'packages/my_assets/assets/images/my_atlas.atlas',
         assetsPrefix: '',
      );

    var animation = atlas.getAnimation(
       'knight_idle',
        stepTime: 0.1,
        loop: true,
    );

flame , asseprite

final image = await Flame.images.load(
         'assets/images/knight.png',
          key: 'knight.png',
         package: 'my_assets',
      );


final jsonData = Flame.assets.readJson(
        'images/knight.json',
         package: 'my_assets'
);

// or manual handle for multi tags
final animation = SpriteAnimation.fromAsepriteData(image, jsonData);

it's so different

Perhaps after successful testing of aseprite assets, it will be necessary to pack assets using flame_texturepacker .
It might be a good practice to have a common style.

[s1r1m1r1]

I also found a bug where exporting single PNG files using aseprite.
they aren't readable by flame_texturepacker.

Single exports are necessary to crop empty pixels using GDX texture packer.

aseprite png export

image1.png,
image2.png,
image3.png
.....

It would be good to read all the indexing patterns

name_01.png
name1.png
name_1.png
name01.png

[s1r1m1r1]

Path processing isn't always obvious, so I'll write the full path.

new example

// 'my_assetspackage/assets/images/atlas_map.atlas'
// 'my_assetspackage/assets/images/atlas_map.png'
final atlas =  await TexturePackerAtlas.load(
      'atlas_map.atlas', 
       package: 'my_assetspackage',
);

final animation = atlas.getAnimation(
       'knight',  // findSpritesByName
       steptime: 0.1,
       loop: true
);

[spydon]

Sounds good, will there be any breaking changes?

[s1r1m1r1]

spydon

• Nothing has changed globally, only new methods and helpers have been added.

• Fixed documentation that incorrectly stated that strict whitespace does not work;

in fact, strict whitespace does work.
I used GDX texture packer with a set of indexed png images to trim empty pixels to packed an atlas .
flame_texturepacker correctly restored the position and margins in the animation.