62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
# Image Speech Bubble Transformer
|
|
|
|
A TypeScript library for applying speech bubble effects to images with various transformation options.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install image-speech-bubble-transformer
|
|
```
|
|
|
|
## Usage
|
|
|
|
```typescript
|
|
import {
|
|
createSpeechBubbleTransformer,
|
|
Orientation,
|
|
} from "image-speech-bubble-transformer";
|
|
import fs from "fs/promises";
|
|
|
|
async function example() {
|
|
// Create transformer instance
|
|
const transformer = createSpeechBubbleTransformer();
|
|
|
|
// Read image buffer
|
|
const inputBuffer = await fs.readFile("input.png");
|
|
|
|
// Process image with options
|
|
const processedBuffer = await transformer.processSpeechBubble(inputBuffer, {
|
|
mirror: true,
|
|
orientation: Orientation.LEFT,
|
|
});
|
|
|
|
// Save processed image
|
|
await transformer.processAndSave(inputBuffer, "output.png", {
|
|
mirror: true,
|
|
orientation: Orientation.LEFT,
|
|
});
|
|
}
|
|
```
|
|
|
|
## API
|
|
|
|
### `createSpeechBubbleTransformer(assetsDir?: string)`
|
|
|
|
- Creates a transformer instance
|
|
- `assetsDir`: Optional path to custom assets directory
|
|
|
|
### `processSpeechBubble(inputBuffer, options)`
|
|
|
|
- Applies speech bubble effect to image
|
|
- Options:
|
|
- `mirror`: Flip horizontally
|
|
- `orientation`: Rotate speech bubble
|
|
- `speechBubblePath`: Custom speech bubble image
|
|
|
|
### `processAndSave(inputBuffer, outputPath, options)`
|
|
|
|
- Processes and saves image in one step
|
|
|
|
## Supported Formats
|
|
|
|
- .png, .jpg, .jpeg, .gif, .bmp, .webp, .tiff
|