# New-ImageVisualMotionCue

Creates one named motion cue for an animated ChartForgeX visual story.

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

`None`

**Outputs**

`ChartForgeX.Motion.VisualMotionCue`

Creates one named motion cue for an animated ChartForgeX visual story.

## Syntax

```
New-ImageVisualMotionCue
[-DelaySeconds <Double>]
[-DistancePixels <Double>]
[-DurationSeconds <Double>]
[-Easing <Linear|EaseOut|EaseInOut|Emphasized>]
[-Effect] <Fade|Rise|Reveal|Scale|Pulse>
[-TargetId] <String>
[<CommonParameters>]
```

[#](#method-new-imagevisualmotioncue-double-double-double-visualmotioneasing-visualmotioneffect-string)

Parameter set: `All Parameter Sets`

## Description

Use this cmdlet inside the MotionDefinition block of New-ImageVisualStory. Each cue targets the stable id assigned to a visual-grid panel or the built-in title and subtitle targets.

## Examples

### Reveal the story title

```powershell
New-ImageVisualMotionCue -TargetId title -Effect Reveal -DurationSeconds 0.9
```

Creates a restrained left-to-right title reveal with the default emphasized easing.

## Parameters

**-DelaySeconds Double optional**

Delay before the cue starts, in seconds.

**-DistancePixels Double optional**

Travel distance used by positional effects, in pixels.

**-DurationSeconds Double optional**

Cue duration, in seconds.

**-Easing VisualMotionEasing optional**

Timing curve used by the cue.

Possible values: `Linear`, `EaseOut`, `EaseInOut`, `Emphasized`

**-Effect VisualMotionEffect requiredposition: 1**

Entrance or emphasis effect.

Possible values: `Fade`, `Rise`, `Reveal`, `Scale`, `Pulse`

**-TargetId String requiredposition: 0**

Stable panel id, or the built-in title or subtitle target.

## 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:0F0AF1275169625F75D1E9AE4F8224276B9E1C66946FAB05E5AC004670CB5487 -->
