AgsNote: Advanced Gtk+ Sequencer Audio Reference Manual

Functions

GList *	ags_note_find_prev ()
GList *	ags_note_find_next ()
unsigned char *	ags_note_to_raw_midi ()
snd_seq_event_t *	ags_note_to_seq_event ()
GList *	ags_note_from_raw_midi ()
GList *	ags_note_from_seq_event ()
AgsNote *	ags_note_duplicate ()
AgsNote *	ags_note_new ()
AgsNote *	ags_note_new_with_offset ()
#define	AGS_IS_NOTE()
#define	AGS_IS_NOTE_CLASS()
#define	AGS_NOTE()
#define	AGS_NOTE_CLASS()
#define	AGS_NOTE_GET_CLASS()
GType	ags_note_get_type ()

Properties

AgsComplex *	attack	Read / Write
AgsComplex *	decay	Read / Write
gchar *	note-name	Read / Write
AgsComplex *	ratio	Read / Write
AgsComplex *	release	Read / Write
guint	stream-attack	Read / Write
gdouble	stream-delay	Read / Write
AgsComplex *	sustain	Read / Write
guint	x0	Read / Write
guint	x1	Read / Write
guint	y	Read / Write

Types and Values

enum	AgsNoteFlags
#define	AGS_NOTE_DEFAULT_TICKS_PER_QUARTER_NOTE
#define	AGS_TYPE_NOTE
struct	AgsNote
struct	AgsNoteClass

Object Hierarchy

    GObject
    ╰── AgsNote

Implemented Interfaces

AgsNote implements AgsConnectable.

Includes

#include <ags/audio/ags_note.h>

Description

AgsNote represents a tone.

Functions

ags_note_find_prev ()

GList *
ags_note_find_prev (GList *note,
                    guint x0,
                    guint y);

Find prev note having the same y offset.

Parameters

note	a GList containing AgsNote
x0	x offset
y	y offset

Returns

the matching entry as GList if first entry's x offset bigger than x0 , else NULL

Since: 0.7.2

ags_note_find_next ()

GList *
ags_note_find_next (GList *note,
                    guint x0,
                    guint y);

Find next note having the same y offset.

Parameters

note	a GList containing AgsNote
x0	x offset
y	y offset

Returns

the matching entry as GList if last entry's x offset smaller than x0 , else NULL

Since: 0.7.2

ags_note_to_raw_midi ()

unsigned char *
ags_note_to_raw_midi (AgsNote *note,
                      gdouble bpm,
                      gdouble delay_factor,
                      guint *buffer_length);

ags_note_to_seq_event ()

snd_seq_event_t *
ags_note_to_seq_event (AgsNote *note,
                       gdouble bpm,
                       gdouble delay_factor,
                       guint *n_events);

Convert note to ALSA sequencer events and set the number of events in the array as n_events .

Parameters

note	the AgsNote
bpm	the bpm to use
delay_factor	the segmentation delay factor
n_events	the count of events

Returns

The sequencer events as array.

Since: 0.7.1

ags_note_from_raw_midi ()

GList *
ags_note_from_raw_midi (unsigned char *raw_midi,
                        gdouble bpm,
                        gdouble delay_factor,
                        guint length);

Parse raw_midi data and convert to AgsNote.

Parameters

event	the snd_seq_event_t struct array
nn	numerator
dd	denominator
cc	clocks
bb	beats
tempo	tempo
bpm	the bpm to use
delay_factor	the segmentation delay factor
n_events	the count snd_seq_event_t structs

Returns

a GList containing the notes

Since: 0.9.0

ags_note_from_seq_event ()

GList *
ags_note_from_seq_event (snd_seq_event_t *event,
                         gdouble bpm,
                         gdouble delay_factor,
                         guint n_events);

Convert ALSA sequencer data event to AgsNote.

Parameters

event	ALSA sequencer events as array
bpm	the bpm to use
delay_factor	the segmentation delay factor
n_events	the arrays length

Returns

a GList containing the notes

Since: 0.7.1

ags_note_duplicate ()

AgsNote *
ags_note_duplicate (AgsNote *note);

Duplicate a note.

Parameters

note

an AgsNote

Returns

the duplicated AgsNote.

Since: 0.4

ags_note_new ()

AgsNote *
ags_note_new ();

Creates an AgsNote

Returns

a new AgsNote

Since: 0.7.2

ags_note_new_with_offset ()

AgsNote *
ags_note_new_with_offset (guint x0,
                          guint x1,
                          guint y,
                          gdouble stream_delay,
                          guint stream_attack);

AGS_IS_NOTE()

#define AGS_IS_NOTE(obj)             (G_TYPE_CHECK_INSTANCE_TYPE((obj), AGS_TYPE_NOTE))

AGS_IS_NOTE_CLASS()

#define AGS_IS_NOTE_CLASS(class)     (G_TYPE_CHECK_CLASS_TYPE((class), AGS_TYPE_NOTE))

AGS_NOTE()

#define AGS_NOTE(obj)                (G_TYPE_CHECK_INSTANCE_CAST((obj), AGS_TYPE_NOTE, AgsNote))

AGS_NOTE_CLASS()

#define AGS_NOTE_CLASS(class)        (G_TYPE_CHECK_CLASS_CAST((class), AGS_TYPE_NOTE, AgsNoteClass))

AGS_NOTE_GET_CLASS()

#define AGS_NOTE_GET_CLASS(obj)      (G_TYPE_INSTANCE_GET_CLASS((obj), AGS_TYPE_NOTE, AgsNoteClass))

ags_note_get_type ()

GType
ags_note_get_type ();

Types and Values

enum AgsNoteFlags

Members

AGS_NOTE_CONNECTED
AGS_NOTE_GUI
AGS_NOTE_RUNTIME
AGS_NOTE_HUMAN_READABLE
AGS_NOTE_DEFAULT_LENGTH
AGS_NOTE_IS_SELECTED
AGS_NOTE_FEED
AGS_NOTE_ENVELOPE

AGS_NOTE_DEFAULT_TICKS_PER_QUARTER_NOTE

#define AGS_NOTE_DEFAULT_TICKS_PER_QUARTER_NOTE (16.0)

AGS_TYPE_NOTE

#define AGS_TYPE_NOTE                (ags_note_get_type())

struct AgsNote

struct AgsNote;

struct AgsNoteClass

struct AgsNoteClass {
  GObjectClass object;
};

Property Details

The `“attack”` property

  “attack”                   AgsComplex *

Envelope attack.

Flags: Read / Write

Since: 0.7.2

The `“decay”` property

  “decay”                    AgsComplex *

Envelope decay.

Flags: Read / Write

Since: 0.7.2

The `“note-name”` property

  “note-name”                gchar *

The note's name.

Flags: Read / Write

Default value: NULL

Since: 0.9.0

The `“ratio”` property

  “ratio”                    AgsComplex *

Envelope ratio.

Flags: Read / Write

Since: 0.7.42

The `“release”` property

  “release”                  AgsComplex *

Envelope release.

Flags: Read / Write

Since: 0.7.2

The `“stream-attack”` property

  “stream-attack”            guint

The stream's attack.

Flags: Read / Write

Allowed values: <= 65535

Default value: 0

Since: 0.7.2

The `“stream-delay”` property

  “stream-delay”             gdouble

The stream's delay.

Flags: Read / Write

Allowed values: [0,65535]

Default value: 0

Since: 0.7.2

The `“sustain”` property

  “sustain”                  AgsComplex *

Envelope sustain.

Flags: Read / Write

Since: 0.7.2

The `“x0”` property

  “x0”                       guint

Note offset x0.

Flags: Read / Write

Allowed values: <= 65535

Default value: 0

Since: 0.7.2

The `“x1”` property

  “x1”                       guint

Note offset x1.

Flags: Read / Write

Allowed values: <= 65535

Default value: 0

Since: 0.7.2

The `“y”` property

  “y”                        guint

Note offset y.

Flags: Read / Write

Allowed values: <= 65535

Default value: 0

Since: 0.7.2

AgsNote

Functions

Properties

Types and Values

Object Hierarchy

Implemented Interfaces

Includes

Description

Functions

ags_note_find_prev ()

Parameters

Returns

ags_note_find_next ()

Parameters

Returns

ags_note_to_raw_midi ()

ags_note_to_seq_event ()

Parameters

Returns

ags_note_from_raw_midi ()

Parameters

Returns

ags_note_from_seq_event ()

Parameters

Returns

ags_note_duplicate ()

Parameters

Returns

ags_note_new ()

Returns

ags_note_new_with_offset ()

AGS_IS_NOTE()

AGS_IS_NOTE_CLASS()

AGS_NOTE()

AGS_NOTE_CLASS()

AGS_NOTE_GET_CLASS()

ags_note_get_type ()

Types and Values

enum AgsNoteFlags

Members

AGS_NOTE_DEFAULT_TICKS_PER_QUARTER_NOTE

AGS_TYPE_NOTE

struct AgsNote

struct AgsNoteClass

Property Details

The “attack” property

The “decay” property

The “note-name” property

The “ratio” property

The “release” property

The “stream-attack” property

The “stream-delay” property

The “sustain” property

The “x0” property

The “x1” property

The “y” property

The `“attack”` property

The `“decay”` property

The `“note-name”` property

The `“ratio”` property

The `“release”` property

The `“stream-attack”` property

The `“stream-delay”` property

The `“sustain”` property

The `“x0”` property

The `“x1”` property

The `“y”` property