image-speech-bubble-transformer/README.md

TypeScript library for applying speech bubble effects to images

# 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