KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #open-source #agent-skills #ai #dsh-plugin #llm #windows

sevenup

★ 61 Open GitHub ↗

Tool for making and loading sprites

// 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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README