# Example Usage
This document shows examples of how to use the `generate-placeholder-image` tool.
## Basic Usage
### Example 1: Simple red placeholder
```json
{
"filename": "red-placeholder.png",
"width": 800,
"height": 600,
"color": "#FF0000",
"text": "Sample Image"
}
```
### Example 2: Blue placeholder with RGB color
```json
{
"filename": "blue-placeholder.jpg",
"width": 1200,
"height": 800,
"color": "rgb(52, 152, 219)",
"text": "Product Placeholder"
}
```
### Example 3: Large banner with named color
```json
{
"filename": "banner.png",
"width": 1920,
"height": 400,
"color": "purple",
"text": "Website Banner Placeholder"
}
```
### Example 4: Square thumbnail
```json
{
"filename": "thumbnail.png",
"width": 300,
"height": 300,
"color": "#2ECC71",
"text": "Profile Picture"
}
```
### Example 5: Long text with wrapping
```json
{
"filename": "description.png",
"width": 600,
"height": 400,
"color": "lightgray",
"text": "This is a longer text that will automatically wrap to multiple lines based on the image width"
}
```
## Features Demonstrated
- **Automatic text sizing**: Font size adjusts to image dimensions
- **Text wrapping**: Long text automatically wraps to fit
- **Contrast detection**: Text color automatically contrasts with background
- **Multiple formats**: Supports both PNG and JPEG output
- **Flexible dimensions**: Any size from 1x1 to 4096x4096 pixels
## Supported Color Formats
- Hex: `#FF0000`, `#f00`
- RGB: `rgb(255, 0, 0)`
- RGBA: `rgba(255, 0, 0, 0.5)`
- Named: `red`, `blue`, `green`, `yellow`, `orange`, `purple`, `pink`, `brown`, `black`, `white`, `gray`