# Add-ImageTextBox

Adds wrapped text to an image within a box. Review available syntax, parameters, pipeline guidance, and reference details in ImagePlayground API Reference.

Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

[View on GitHub](https://github.com/EvotecIT/ImagePlayground) [Visit Website](#) [Releases](https://github.com/EvotecIT/ImagePlayground/releases) [Changelog](#) [Get package](https://www.powershellgallery.com/packages/ImagePlayground)

Stars **102**

Forks **7**

Open issues 

Total downloads **708,853**

Release **ImagePlayground-PowerShellModule.v3.2.7**

Language: C# Updated: 2026-11-18

Command 

**Module**

`ImagePlayground`

**Inputs**

`System.String`

Adds wrapped text to an image within a box.

## Syntax

```
Add-ImageTextBox
[-Color <Color>]
[-FilePath] <String>
[-FontFamily <String>]
[-FontSize <Single>]
[[-Height] <Single>]
[-HorizontalAlignment <Left|Right|Center>]
[-OutlineColor <Color>]
[-OutlineWidth <Single>]
[-OutputPath] <String>
[-ShadowColor <Color>]
[-ShadowOffsetX <Single>]
[-ShadowOffsetY <Single>]
[-Text] <String>
[-VerticalAlignment <Top|Center|Bottom>]
[-Width] <Single>
[-X] <Single>
[-Y] <Single>
[<CommonParameters>]
```

[#](#method-add-imagetextbox-color-string-string-single-single-horizontalalignment-color-single-string-color-single-single-string-verticalalignment-single-single-single)

Parameter set: `All Parameter Sets`

## Examples

### Add text inside a box

```powershell
Add-ImageTextBox -FilePath in.png -OutputPath out.png -Text "Sample text" -X 10 -Y 10 -Width 100
```

## Parameters

**-Color Color optional**

Text color.

**-FilePath String requiredposition: 0pipeline: True (ByValue)**

Source image path.

**-FontFamily String optional**

Font family.

**-FontSize Single optional**

Font size.

**-Height Single optionalposition: 6**

Height of the text box.

**-HorizontalAlignment HorizontalAlignment optional**

Horizontal alignment.

Possible values: `Left`, `Right`, `Center`

**-OutlineColor Color optional**

Outline color.

**-OutlineWidth Single optional**

Outline width.

**-OutputPath String requiredposition: 1**

Destination image path.

**-ShadowColor Color optional**

Color of shadow.

**-ShadowOffsetX Single optional**

X offset for shadow.

**-ShadowOffsetY Single optional**

Y offset for shadow.

**-Text String requiredposition: 2**

Text to add.

**-VerticalAlignment VerticalAlignment optional**

Vertical alignment.

Possible values: `Top`, `Center`, `Bottom`

**-Width Single requiredposition: 5**

Width of the text box.

**-X Single requiredposition: 3**

X coordinate.

**-Y Single requiredposition: 4**

Y coordinate.

## Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see [about_CommonParameters](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:A90A7743CAB79348DDFDEED9D2256FF248B04130FD076B77B7C83B5512CFEF4C -->
