# New-ImageVisualGrid

Creates a reusable dashboard grid from charts and visual blocks.

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.Object[]`

**Outputs**

`ChartForgeX.VisualBlocks.VisualGrid`

Creates a reusable dashboard grid from charts and visual blocks.

## Syntax

```
New-ImageVisualGrid
[-AdaptiveRowHeights]
[-Columns <Int32>]
[-ContentDefinition] <ScriptBlock>
[-FilePath <String>]
[-Frame]
[-Gap <Int32>]
[-Motion <VisualMotionTimeline>]
[-Padding <Int32>]
[-PanelFit <Contain|Stretch>]
[-PanelHeight <Int32>]
[-PanelWidth <Int32>]
[-PassThru]
[-Show]
[-Subtitle <String>]
[-Theme <ChartTheme>]
[-Title <String>]
[<CommonParameters>]
```

[#](#method-new-imagevisualgrid-switchparameter-int32-scriptblock-string-switchparameter-int32-visualmotiontimeline-int32-visualpanelfit-int32-int32-switchparameter-switchparameter-string-charttheme-string)

Parameter set: `Definition`

```
New-ImageVisualGrid
[-AdaptiveRowHeights]
[-Columns <Int32>]
-Content <Object[]>
[-FilePath <String>]
[-Frame]
[-Gap <Int32>]
[-Motion <VisualMotionTimeline>]
[-Padding <Int32>]
[-PanelFit <Contain|Stretch>]
[-PanelHeight <Int32>]
[-PanelWidth <Int32>]
[-PassThru]
[-Show]
[-Subtitle <String>]
[-Theme <ChartTheme>]
[-Title <String>]
[<CommonParameters>]
```

[#](#method-new-imagevisualgrid-switchparameter-int32-object-string-switchparameter-int32-visualmotiontimeline-int32-visualpanelfit-int32-int32-switchparameter-switchparameter-string-charttheme-string)

Parameter set: `Content`

## Description

Render the grid directly, pass it to New-ImageVisualStory, or compose it inside a ChartForgeX visual canvas.

## Examples

### Create a status dashboard

```powershell
New-ImageVisualGrid -Title 'Service health' -Columns 2 -ContentDefinition { New-ImageMetricCard -Label 'Requests' -Value 12840 -Status Positive; New-ImageListBlock -Title 'Checks' -Item API,Database -Status Positive,Warning } -FilePath dashboard.svg
```

## Parameters

**-AdaptiveRowHeights SwitchParameter optional**

Use each row's natural item height.

**-Columns Int32 optional**

Preferred column count.

**-ContentDefinition ScriptBlock requiredposition: 0sets: Definition**

Script block that emits charts, visual blocks, or New-ImageVisualGridItem results.

**-FilePath String optional**

Optional output path. Omit it to return the grid without rendering.

**-Frame SwitchParameter optional**

Render a subtle outer frame.

**-Gap Int32 optional**

Gap between panels in pixels.

**-Motion VisualMotionTimeline optional**

Optional script-free SVG and HTML motion timeline.

**-Padding Int32 optional**

Outer grid padding in pixels.

**-PanelFit VisualPanelFit optional**

How child content fits fixed panels.

Possible values: `Contain`, `Stretch`

**-PanelHeight Int32 optional**

Optional fixed panel height.

**-PanelWidth Int32 optional**

Optional fixed panel width.

**-PassThru SwitchParameter optional**

Return the grid when an output file is also written.

**-Show SwitchParameter optional**

Open the rendered dashboard.

**-Subtitle String optional**

Optional dashboard subtitle.

**-Theme ChartTheme optional**

ChartForgeX theme.

Possible values: `Default`, `Dark`, `Light`, `Colorblind`, `Aurora`, `Editorial`, `Candy`, `PeopleInfographic`, `Terminal`, `TransparentOverlayDark`, `Minimal`, `DashboardLight`, `SaasDashboardLight`, `RestaurantDashboardLight`

**-Title String optional**

Optional dashboard title.

**-Content Object[] requiredpipeline: True (ByValue)sets: Content**

Charts, visual blocks, or grid items supplied directly or through the pipeline.

## 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:3F5DE0B457CE9DE65D7489A18675FC4DD2A65ADDE67EF3FD428208265FD0964C -->
