SpriteView Extension from Smartface

An extension to make sprite animations with Smartface Native Framework.

Installation

SpriteView can be installed via npm easily from our public npm repository. Execute this command on the script folder:

npm i @smartface/extension-spriteview

How to use

SpriteView is nothing but an ImageView with additional methods. Since it extends ImageView, you can add it inside layouts.

1. Put the sprite sheet under the folder images on the Cloud IDE.
2. Set the sheet to the SpriteView object as:

import SpriteView from "sf-extension-spriteview";

const spriteView = new SpriteView();

spriteView.setSprite({
	sheet: Image.createFromFile("images://braid.png"), // Image for the frame
	frameX: 7, // Distinct image count on X axis
	frameY: 4, // Distinct image count on Y axis
	frameCount: 27 // Frame count of the image
});

3. Set the optional fields to the SpriteView as:

import ImageView from "@smartface/native/ui/imageview";

spriteView.width = 100; // Width of the frame
spriteView.height = 125; // Height of the frame
spriteView.imageFillType = ImageView.FillType.ASPECTFIT; // Fill type of the frame

4. Finally you must make the sprite play by using:

spriteView.play(1000); // Transition speed of frames

Sample

The folder sample holds the example codes and the sprite sheet. You can put them into your workspace and start using it.

Need Help?

Please submit an issue on GitHub and provide information about your problem.

Support & Documentation & Useful Links

• Guides
• API Docs

Code of Conduct

We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file. Within the scope of this license, all modifications to the source code, regardless of the fact that it is used commercially or not, shall be committed as a contribution back to this repository.