sevenup

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 61)

Tool for making and loading sprites

sevenup Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# sevenup

Utility for making and loading spritesheets.

## CLI

```
npx sevenup sourcedir destdir
```

This will read all the `.png` and `.jpg` images in `sourcedir` and create three files:

* `destdir/sprites.png`
* `destdir/sprites.json`
* `destdir/sprites.css`

To create a `sprites.png` with power-of-two dimensions — useful for WebGL apps, where appropriately-sized textures can have mipmaps generated — use the `--pad` or `-p` flag:

```
npx sevenup sourcedir destdir -p
```

## In browser

```js
import { load } from 'sevenup';

(async function() {
  const spritesheet = await load('destdir');

// we have a reference to the image
  console.log(spritesheet.image.width, spritesheet.image.height);

// get a Blob URL
  const url = await spritesheet.url('somefile.png');

// get a <canvas>
  const canvas = spritesheet.canvas('somefile.png');

// get a set of UV coordinates, for use in a WebGL shader
  const [u1, v1, u2, v2] = spritesheet.uv('somefile.png');

// get the bounds of an image
  const { left, top, right, bottom, width, height } = spritesheet.box('somefile.png');
}());
```

A lower-level `spritesheet = create(img, manifest)` API also exists.

Alternatively, use CSS:

```html
<div role="img" aria-label="Some alt text" data-sevenup="srcdir/somefile.png"></div>
```

## License

[MIT](LICENSE)

sevenup

sevenup Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

sevenup

sevenup Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README