# Merge-Image

Merges two images and saves the result. 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`

Merges two images and saves the result.

## Syntax

```
Merge-Image
[-FilePath] <String>
[-FilePathOutput] <String>
[-FilePathToMerge] <String>
[-Placement <Bottom|Right|Top|Left>]
[-ResizeToFit]
[<CommonParameters>]
```

[#](#method-merge-image-string-string-string-imageplacement-switchparameter)

Parameter set: `All Parameter Sets`

## Examples

### Merge vertically

```powershell
Merge-Image -FilePath img1.png -FilePathToMerge img2.png -FilePathOutput out.png
```

## Parameters

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

Must exist.

**-FilePathOutput String requiredposition: 2**

Output file path.

**-FilePathToMerge String requiredposition: 1**

Must exist.

**-Placement ImagePlacement optional**

Placement of the second image.

Possible values: `Bottom`, `Right`, `Top`, `Left`

**-ResizeToFit SwitchParameter optional**

Resize images to fit before merging.

## 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:983312E5EC249B273E02133AC15B285457AE0CA1C42B8275601C1225376707E9 -->
