Library

https://morgondag.io/pages/bit-library

The library is where all the reusable parts are configured. From here they can be added to the scene.

Bit Animation Editor Library

Library preview

On-top of the library is an asset preview window. The currently selected asset will be visible here. Use this window to configure the assets tile-size and sprite sheet animations.

See https://morgondag.io/pages/bit-configure-a-scene-asset#new-asset-spritesheet

Library list

The library contains a list of categories and the different assets available. When you import a new asset into the editor this is where it shows up. When starting the editor and when reloading imported assets, the editor will check the file-system for the library folder and go through all the assets saved there. Manually importing assets into the library is supported but would require that the assets data(JSON) file have unique names and ids.

There is support for categories and subcategories of assets. 

Import: The import button opens up the dialog to import art into the editor.


See https://morgondag.io/pages/bit-create-new-asset

Library asset

After you select an asset from the list you can edit its properties and if the asset is part of a sprite sheet you can author new sprite sheet animations here.

 

Add to scene: This button adds the selected asset as a new entity to the scene.


See https://morgondag.io/pages/bit-create-new-asset#new-asset-add

Library asset configuration

The asset's configuration is displayed on the currently selected library asset. Below the add to scene button, there are a couple of options.

 

Save: Save the asset's current settings.

Clone: Create a copy of this asset and add it to the library.

Remove: Remove this asset from the library. Projects using removed assets will not be able to render the assets in the scene but can be replaced. 

 

Library asset Sprite

Name: Set a unique name for the asset.

SubCategory: Change or create a new subcategory for the asset in the library list.

Id: The asset's id that is located in the file-system.

New Sprite: Select a new sprite to replace the current one, this will reset tiles and sprite sheets.

Sprite Size: The total size in pixels of the asset.

 

Library asset Tile

Tile Size: The size in pixels of the currently configured tile size. When you set up a sprite sheet you want to have exact tile sizes that are part of the sprite's total size.

By Tile: Configure the size of the tiles by calculating how many frames there are in the sprite sheet.

Manual (Deprecated): Manually set the tile size (this feature might be removed).

Tile Count: Configure the size of the tiles by calculating how many frames there are in the sprite sheet. Set the X and Y amount of tiles in the image.

Tiles: Lists how many tiles there are in the sprite sheet based on the tile count.

Default Tile: Set what tile to use as the default when importing the asset.


Library asset Animations

Sprite sheet animations are configured per library asset. If you've imported a sprite and set the tile size to smaller then the total sprite size you can animate between the tiles of the sprite to create sprite sheet animations.

Add animation: Adds a new animation configuration. An asset can have multiple sprite sheet animations.

Play: Play the current sprite sheet animation in the library preview window.

Stop: Stop the current animating animation in the preview window.

Remove: Remove the animation.

SpriteSheet: Set the number of frames that should be part of the animations. The animation will loop through these sequentially. 

Frames list: This is where you configure the sprite sheet animation tile index; what frame to show in what step of the animation. 

Frameskip: How many frames should the rendering pause between updating to the next frame in the animation.

For more information about library assets, see
https://morgondag.io/pages/bit-create-new-asset