Table of Contents

Class SpacescopeBlock

Namespace
VisioForge.Core.MediaBlocks.AudioVisualizers
Assembly
VisioForge.Core.dll

Spacescope audio visualizer block that creates a stereo spatial visualization of audio.

public class SpacescopeBlock : MediaBlock, IMediaBlock, IDisposable, IMediaBlockInternals

Inheritance

Implements

Inherited Members

Extension Methods

Remarks

The Spacescope visualizer displays audio as a two-dimensional plot where:

  • X-axis represents the left channel
  • Y-axis represents the right channel
  • The resulting pattern shows the stereo field and phase relationships This visualization is particularly useful for analyzing stereo imaging, phase issues, and mono compatibility.

Constructors

SpacescopeBlock(SpacescopeSettings)

Initializes a new instance of the VisioForge.Core.MediaBlocks.AudioVisualizers.SpacescopeBlock class.

public SpacescopeBlock(SpacescopeSettings settings)

Parameters

settings SpacescopeSettings

The settings to configure the spacescope visualization appearance and behavior.

Properties

Input

Gets the primary input pad for audio data.

public override MediaBlockPad Input { get; }

Property Value

MediaBlockPad

Inputs

Gets all input pads available on this block.

public override MediaBlockPad[] Inputs { get; }

Property Value

MediaBlockPad[]

Output

Gets the primary output pad for video data.

public override MediaBlockPad Output { get; }

Property Value

MediaBlockPad

Outputs

Gets all output pads available on this block.

public override MediaBlockPad[] Outputs { get; }

Property Value

MediaBlockPad[]

Settings

Gets or sets the settings that configure the spacescope visualization appearance and behavior.

public SpacescopeSettings Settings { get; set; }

Property Value

SpacescopeSettings

Type

Gets the media block type.

public override MediaBlockType Type { get; }

Property Value

MediaBlockType

Methods

Build()

Builds and initializes the spacescope visualization block.

public override bool Build()

Returns

bool

true if the block was successfully built and configured; false if an error occurred.

Remarks

This method creates the underlying GStreamer elements, configures the visualization settings, and establishes the input/output pads for audio/video data flow.

CleanUp()

Cleans up and releases all resources used by the spacescope block.

public void CleanUp()

Remarks

This method disposes of the underlying GStreamer elements and resets the build state.

Dispose(bool)

Releases unmanaged and - optionally - managed resources.

protected override void Dispose(bool disposing)

Parameters

disposing bool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

GetCore()

Gets the core GStreamer base element wrapped by this block.

public BaseElement GetCore()

Returns

BaseElement

The underlying VisioForge.Core.GStreamer.Base.BaseElement instance.

GetElement()

Gets the raw GStreamer element for advanced manipulation.

public Element GetElement()

Returns

Element

The native GStreamer Gst.Element instance.

IsAvailable()

Determines whether this media block is available. Correct NuGet SDK redist should be included into your project.

public static bool IsAvailable()

Returns

bool

true if this media block is available; otherwise, false.

IMediaBlockInternals.SetContext(MediaBlocksPipeline)

Sets the media pipeline context for this block.

void IMediaBlockInternals.SetContext(MediaBlocksPipeline pipeline)

Parameters

pipeline MediaBlocksPipeline

The parent media pipeline that will contain this block.

See Also