Command

New-ImageVisualGrid

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>]

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>]

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

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.