AgsEffectPad: Advanced Gtk+ Sequencer Application Reference Manual

AgsEffectPad

AgsEffectPad — A composite widget to visualize a bunch of AgsChannel

Stability Level

Stable, unless otherwise indicated

Functions

void	ags_effect_pad_samplerate_changed ()
void	ags_effect_pad_buffer_size_changed ()
void	ags_effect_pad_format_changed ()
void	ags_effect_pad_set_channel ()
void	ags_effect_pad_resize_lines ()
GList *	ags_effect_pad_get_effect_line ()
void	ags_effect_pad_add_effect_line ()
void	ags_effect_pad_remove_effect_line ()
void	ags_effect_pad_map_recall ()
GList *	ags_effect_pad_find_port ()
AgsEffectPad *	ags_effect_pad_new ()
#define	AGS_EFFECT_PAD()
#define	AGS_EFFECT_PAD_CLASS()
#define	AGS_EFFECT_PAD_GET_CLASS()
#define	AGS_IS_EFFECT_PAD()
#define	AGS_IS_EFFECT_PAD_CLASS()
GType	ags_effect_pad_get_type ()

Properties

guint	buffer-size	Read / Write
AgsChannel *	channel	Read / Write
guint	format	Read / Write
guint	samplerate	Read / Write

Signals

void	buffer-size-changed	Run Last
gpointer	find-port	Run Last
void	format-changed	Run Last
void	map-recall	Run Last
void	refresh-port	Run Last
void	resize-lines	Run Last
void	samplerate-changed	Run Last
void	set-channel	Run Last

Types and Values

#define	AGS_EFFECT_PAD_DEFAULT_VERSION
#define	AGS_EFFECT_PAD_DEFAULT_BUILD_ID
#define	AGS_EFFECT_PAD_COLUMNS_COUNT
enum	AgsEffectPadFlags
#define	AGS_TYPE_EFFECT_PAD
struct	AgsEffectPad
struct	AgsEffectPadClass

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkBox
                ╰── AgsEffectPad
                    ╰── AgsFFPlayerInputPad

Implemented Interfaces

AgsEffectPad implements GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkOrientable and AgsConnectable.

Includes

#include <ags/app/ags_effect_pad.h>

Description

AgsEffectPad is a composite widget to visualize a bunch of AgsChannel. It should be packed by an AgsEffectBridge.

Functions

ags_effect_pad_samplerate_changed ()

void
ags_effect_pad_samplerate_changed (AgsEffectPad *effect_pad,
                                   guint samplerate,
                                   guint old_samplerate);

Notify about samplerate changed.

Parameters

effect_pad	the AgsEffectPad
samplerate	the samplerate
old_samplerate	the old samplerate

Since: 3.0.0

ags_effect_pad_buffer_size_changed ()

void
ags_effect_pad_buffer_size_changed (AgsEffectPad *effect_pad,
                                    guint buffer_size,
                                    guint old_buffer_size);

Notify about buffer_size changed.

Parameters

effect_pad	the AgsEffectPad
buffer_size	the buffer_size
old_buffer_size	the old buffer_size

Since: 3.0.0

ags_effect_pad_format_changed ()

void
ags_effect_pad_format_changed (AgsEffectPad *effect_pad,
                               guint format,
                               guint old_format);

Notify about format changed.

Parameters

effect_pad	the AgsEffectPad
format	the format
old_format	the old format

Since: 3.0.0

ags_effect_pad_set_channel ()

void
ags_effect_pad_set_channel (AgsEffectPad *effect_pad,
                            AgsChannel *channel);

Is emitted as channel gets modified.

Parameters

effect_pad	the AgsEffectPad
channel	the AgsChannel to set

Since: 3.0.0

ags_effect_pad_resize_lines ()

void
ags_effect_pad_resize_lines (AgsEffectPad *effect_pad,
                             GType line_type,
                             guint audio_channels,
                             guint audio_channels_old);

Resize the count of AgsEffectLine packe by AgsEffectPad.

Parameters

effect_pad	the AgsEffectPad to resize
line_type	channel type, either `AGS_TYPE_INPUT` or `AGS_TYPE_OUTPUT`
audio_channels	count of lines
audio_channels_old	old count of lines

Since: 3.0.0

ags_effect_pad_get_effect_line ()

GList *
ags_effect_pad_get_effect_line (AgsEffectPad *effect_pad);

Get effect line of effect_pad .

Parameters

effect_pad

the AgsEffectPad

Returns

the GList containing AgsEffectLine

Since: 4.0.0

ags_effect_pad_add_effect_line ()

void
ags_effect_pad_add_effect_line (AgsEffectPad *effect_pad,
                                AgsEffectLine *effect_line,
                                guint x,
                                guint y,
                                guint width,
                                guint height);

Add effect_line to effect_pad .

Parameters

effect_pad	the AgsEffectPad
effect_line	the AgsEffectLine
x	the x position
y	the y position
width	the width
height	the height

Since: 4.0.0

ags_effect_pad_remove_effect_line ()

void
ags_effect_pad_remove_effect_line (AgsEffectPad *effect_pad,
                                   AgsEffectLine *effect_line);

Remove effect_line to effect_pad .

Parameters

effect_pad	the AgsEffectPad
effect_line	the AgsEffectLine

Since: 4.0.0

ags_effect_pad_map_recall ()

void
ags_effect_pad_map_recall (AgsEffectPad *effect_pad);

You may want the effect_pad to add its default recall.

Parameters

effect_pad

the AgsEffectPad to add its default recall.

Since: 3.0.0

ags_effect_pad_find_port ()

GList *
ags_effect_pad_find_port (AgsEffectPad *effect_pad);

Lookup ports of associated recalls.

Parameters

effect_pad

the AgsEffectPad

Returns

an GList containing all related AgsPort

Since: 3.0.0

ags_effect_pad_new ()

AgsEffectPad *
ags_effect_pad_new (AgsChannel *channel);

Create a new instance of AgsEffectPad

Parameters

channel

the AgsChannel to visualize

Returns

the new AgsEffectPad

Since: 3.0.0

AGS_EFFECT_PAD()

#define AGS_EFFECT_PAD(obj)                (G_TYPE_CHECK_INSTANCE_CAST((obj), AGS_TYPE_EFFECT_PAD, AgsEffectPad))

AGS_EFFECT_PAD_CLASS()

#define AGS_EFFECT_PAD_CLASS(class)        (G_TYPE_CHECK_CLASS_CAST((class), AGS_TYPE_EFFECT_PAD, AgsEffectPadClass))

AGS_EFFECT_PAD_GET_CLASS()

#define AGS_EFFECT_PAD_GET_CLASS(obj)      (G_TYPE_INSTANCE_GET_CLASS((obj), AGS_TYPE_EFFECT_PAD, AgsEffectPadClass))

AGS_IS_EFFECT_PAD()

#define AGS_IS_EFFECT_PAD(obj)             (G_TYPE_CHECK_INSTANCE_TYPE((obj), AGS_TYPE_EFFECT_PAD))

AGS_IS_EFFECT_PAD_CLASS()

#define AGS_IS_EFFECT_PAD_CLASS(class)     (G_TYPE_CHECK_CLASS_TYPE((class), AGS_TYPE_EFFECT_PAD))

ags_effect_pad_get_type ()

GType
ags_effect_pad_get_type (void);

Types and Values

AGS_EFFECT_PAD_DEFAULT_VERSION

#define AGS_EFFECT_PAD_DEFAULT_VERSION "4.5.0"

AGS_EFFECT_PAD_DEFAULT_BUILD_ID

#define AGS_EFFECT_PAD_DEFAULT_BUILD_ID "Tue Mar 28 06:49:41 UTC 2023"

AGS_EFFECT_PAD_COLUMNS_COUNT

#define AGS_EFFECT_PAD_COLUMNS_COUNT (2)

enum AgsEffectPadFlags

Members

AGS_EFFECT_PAD_MAPPED_RECALL
AGS_EFFECT_PAD_PREMAPPED_RECALL
AGS_EFFECT_PAD_SHOW_GROUPING
AGS_EFFECT_PAD_GROUP_ALL
AGS_EFFECT_PAD_GROUP_LINE

AGS_TYPE_EFFECT_PAD

#define AGS_TYPE_EFFECT_PAD                (ags_effect_pad_get_type())

struct AgsEffectPad

struct AgsEffectPad;

struct AgsEffectPadClass

struct AgsEffectPadClass {
  GtkBoxClass box;

  void (*samplerate_changed)(AgsEffectPad *effect_pad,
			     guint samplerate, guint old_samplerate);
  void (*buffer_size_changed)(AgsEffectPad *effect_pad,
			      guint buffer_size, guint old_buffer_size);
  void (*format_changed)(AgsEffectPad *effect_pad,
			 guint format, guint old_format);

  void (*set_channel)(AgsEffectPad *effect_pad, AgsChannel *channel);

  void (*resize_lines)(AgsEffectPad *effect_pad, GType line_type,
		       guint audio_channels, guint audio_channels_old);

  void (*map_recall)(AgsEffectPad *effect_pad);
  GList* (*find_port)(AgsEffectPad *effect_pad);

  void (*refresh_port)(AgsEffectPad *effect_pad);
};

Property Details

The `“buffer-size”` property

  “buffer-size”              guint

The buffer length.

Owner: AgsEffectPad

Flags: Read / Write

Default value: 1024

Since: 3.0.0

The `“channel”` property

  “channel”                  AgsChannel *

The start of a bunch of AgsChannel to visualize.

Owner: AgsEffectPad

Flags: Read / Write

Since: 3.0.0

The `“format”` property

  “format”                   guint

The format.

Owner: AgsEffectPad

Flags: Read / Write

Default value: 16

Since: 3.0.0

The `“samplerate”` property

  “samplerate”               guint

The samplerate.

Owner: AgsEffectPad

Flags: Read / Write

Default value: 48000

Since: 3.0.0

Signal Details

The `“buffer-size-changed”` signal

void
user_function (AgsEffectPad *effect_pad,
               guint         buffer_size,
               guint         old_buffer_size,
               gpointer      user_data)

The ::buffer-size-changed signal notifies about changed buffer size.

Parameters

effect_pad	the AgsEffectPad
buffer_size	the buffer size
old_buffer_size	the old buffer size
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 3.0.0

The `“find-port”` signal

gpointer
user_function (AgsEffectPad *effect_pad,
               gpointer      user_data)

The ::find-port as recall should be mapped

Parameters

effect_pad	the AgsEffectPad to resize
user_data	user data set when the signal handler was connected.

Returns

a GList with associated ports

Flags: Run Last

Since: 3.0.0

The `“format-changed”` signal

void
user_function (AgsEffectPad *effect_pad,
               guint         format,
               guint         old_format,
               gpointer      user_data)

The ::format-changed signal notifies about changed format.

Parameters

effect_pad	the AgsEffectPad
format	the format
old_format	the old format
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 3.0.0

The `“map-recall”` signal

void
user_function (AgsEffectPad *effect_pad,
               gpointer      user_data)

The ::map-recall should be used to add the effect_pad's default recall.

Parameters

effect_pad	the AgsEffectPad
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 3.0.0

The `“refresh-port”` signal

void
user_function (AgsEffectPad *effect_pad,
               gpointer      user_data)

The ::refresh-port signal.

Parameters

effect_pad	the AgsEffectPad
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 4.2.2

The `“resize-lines”` signal

void
user_function (AgsEffectPad *agseffectpad,
               gpointer      arg1,
               guint         arg2,
               guint         arg3,
               gpointer      user_data)

Flags: Run Last

The `“samplerate-changed”` signal

void
user_function (AgsEffectPad *effect_pad,
               guint         samplerate,
               guint         old_samplerate,
               gpointer      user_data)

The ::samplerate-changed signal notifies about changed samplerate.

Parameters

effect_pad	the AgsEffectPad
samplerate	the samplerate
old_samplerate	the old samplerate
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 3.0.0

The `“set-channel”` signal

void
user_function (AgsEffectPad *effect_pad,
               GObject      *channel,
               gpointer      user_data)

The ::set-channel signal notifies about changed channel.

Parameters

effect_pad	the AgsEffectPad to modify
channel	the AgsChannel to set
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 3.0.0

AgsEffectPad

Stability Level

Functions

Properties

Signals

Types and Values

Object Hierarchy

Implemented Interfaces

Includes

Description

Functions

ags_effect_pad_samplerate_changed ()

Parameters

ags_effect_pad_buffer_size_changed ()

Parameters

ags_effect_pad_format_changed ()

Parameters

ags_effect_pad_set_channel ()

Parameters

ags_effect_pad_resize_lines ()

Parameters

ags_effect_pad_get_effect_line ()

Parameters

Returns

ags_effect_pad_add_effect_line ()

Parameters

ags_effect_pad_remove_effect_line ()

Parameters

ags_effect_pad_map_recall ()

Parameters

ags_effect_pad_find_port ()

Parameters

Returns

ags_effect_pad_new ()

Parameters

Returns

AGS_EFFECT_PAD()

AGS_EFFECT_PAD_CLASS()

AGS_EFFECT_PAD_GET_CLASS()

AGS_IS_EFFECT_PAD()

AGS_IS_EFFECT_PAD_CLASS()

ags_effect_pad_get_type ()

Types and Values

AGS_EFFECT_PAD_DEFAULT_VERSION

AGS_EFFECT_PAD_DEFAULT_BUILD_ID

AGS_EFFECT_PAD_COLUMNS_COUNT

enum AgsEffectPadFlags

Members

AGS_TYPE_EFFECT_PAD

struct AgsEffectPad

struct AgsEffectPadClass

Property Details

The “buffer-size” property

The “channel” property

The “format” property

The “samplerate” property

Signal Details

The “buffer-size-changed” signal

Parameters

The “find-port” signal

Parameters

Returns

The “format-changed” signal

Parameters

The “map-recall” signal

Parameters

The “refresh-port” signal

Parameters

The “resize-lines” signal

The “samplerate-changed” signal

Parameters

The “set-channel” signal

Parameters

The `“buffer-size”` property

The `“channel”` property

The `“format”` property

The `“samplerate”` property

The `“buffer-size-changed”` signal

The `“find-port”` signal

The `“format-changed”` signal

The `“map-recall”` signal

The `“refresh-port”` signal

The `“resize-lines”` signal

The `“samplerate-changed”` signal

The `“set-channel”` signal