AgsPiano: Advanced Gtk+ Sequencer UI Reference Manual

Functions

gchar *	ags_piano_key_code_to_note ()
void	ags_piano_key_pressed ()
void	ags_piano_key_released ()
void	ags_piano_key_clicked ()
gint *	ags_piano_get_active_key ()
AgsPiano *	ags_piano_new ()
#define	AGS_IS_PIANO()
#define	AGS_PIANO()
#define	AGS_PIANO_CLASS()
#define	AGS_PIANO_GET_CLASS()
GType	ags_piano_get_type ()

Properties

guint	base-key-code	Read / Write
gchar *	base-note	Read / Write
guint	key-count	Read / Write
guint	key-height	Read / Write
guint	key-width	Read / Write

Signals

void	key-clicked	Run Last
void	key-pressed	Run Last
void	key-released	Run Last

Types and Values

#define	AGS_PIANO_DEFAULT_BASE_NOTE
#define	AGS_PIANO_DEFAULT_BASE_KEY_CODE
#define	AGS_PIANO_DEFAULT_KEY_WIDTH
#define	AGS_PIANO_DEFAULT_KEY_HEIGHT
#define	AGS_PIANO_DEFAULT_KEY_COUNT
enum	AgsPianoFlags
enum	AgsPianoButtonState
enum	AgsPianoLayout
enum	AgsPianoAction
enum	AgsPianoOctave
#define	AGS_TYPE_PIANO
struct	AgsPiano
struct	AgsPianoClass

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── AgsPiano

Implemented Interfaces

AgsPiano implements AtkImplementorIface and GtkBuildable.

Includes

#include <ags/widget/ags_piano.h>

Description

AgsPiano is a widget representing a clavier.

Functions

ags_piano_key_code_to_note ()

gchar *
ags_piano_key_code_to_note (gint key_code);

Get note from key code.

Parameters

key_code

the key code

Returns

the note as string

Since: 1.2.0

ags_piano_key_pressed ()

void
ags_piano_key_pressed (AgsPiano *piano,
                       gchar *note,
                       gint key_code);

Emits ::key-pressed event.

Parameters

piano	the AgsPiano
note	the string representation of key
key_code	the key code

Since: 1.2.0

ags_piano_key_released ()

void
ags_piano_key_released (AgsPiano *piano,
                        gchar *note,
                        gint key_code);

Emits ::key-released event.

Parameters

piano	the AgsPiano
note	the string representation of key
key_code	the key code

Since: 1.2.0

ags_piano_key_clicked ()

void
ags_piano_key_clicked (AgsPiano *piano,
                       gchar *note,
                       gint key_code);

Emits ::key-clicked event.

Parameters

piano	the AgsPiano
note	the string representation of key
key_code	the key code

Since: 1.2.0

ags_piano_get_active_key ()

gint *
ags_piano_get_active_key (AgsPiano *piano,
                          guint *active_key_count);

Get active keys.

Parameters

piano	the AgsPiano
active_key_count	return location of count of active keys

Returns

the active keys as gint array

Since: 1.2.0

ags_piano_new ()

AgsPiano *
ags_piano_new ();

Create a new instance of AgsPiano.

Returns

the new AgsPiano instance

Since: 1.2.0

AGS_IS_PIANO()

#define AGS_IS_PIANO(obj)             (G_TYPE_CHECK_INSTANCE_TYPE((obj), AGS_TYPE_PIANO))

AGS_PIANO()

#define AGS_PIANO(obj)                (G_TYPE_CHECK_INSTANCE_CAST((obj), AGS_TYPE_PIANO, AgsPiano))

AGS_PIANO_CLASS()

#define AGS_PIANO_CLASS(class)        (G_TYPE_CHECK_CLASS_CAST((class), AGS_TYPE_PIANO, AgsPianoClass))

AGS_PIANO_GET_CLASS()

#define AGS_PIANO_GET_CLASS(obj)      (G_TYPE_INSTANCE_GET_CLASS((obj), AGS_TYPE_PIANO, AgsPianoClass))

ags_piano_get_type ()

GType
ags_piano_get_type (void);

Types and Values

AGS_PIANO_DEFAULT_BASE_NOTE

#define AGS_PIANO_DEFAULT_BASE_NOTE AGS_PIANO_KEYS_OCTAVE_0_C

AGS_PIANO_DEFAULT_BASE_KEY_CODE

#define AGS_PIANO_DEFAULT_BASE_KEY_CODE (0)

AGS_PIANO_DEFAULT_KEY_WIDTH

#define AGS_PIANO_DEFAULT_KEY_WIDTH (60)

AGS_PIANO_DEFAULT_KEY_HEIGHT

#define AGS_PIANO_DEFAULT_KEY_HEIGHT (14)

AGS_PIANO_DEFAULT_KEY_COUNT

#define AGS_PIANO_DEFAULT_KEY_COUNT (128)

enum AgsPianoFlags

Members

AGS_PIANO_DRAW_FULL_SCALE
AGS_PIANO_DRAW_OCTAVE_SCALE

enum AgsPianoButtonState

Members

AGS_PIANO_BUTTON_1_PRESSED

enum AgsPianoLayout

Members

AGS_PIANO_LAYOUT_VERTICAL
AGS_PIANO_LAYOUT_HORIZONTAL

enum AgsPianoAction

Members

AGS_PIANO_MOVE_CURSOR_UP
AGS_PIANO_MOVE_CURSOR_DOWN
AGS_PIANO_HIT_KEY

enum AgsPianoOctave

Members

AGS_PIANO_NOTE_C
AGS_PIANO_NOTE_CIS
AGS_PIANO_NOTE_D
AGS_PIANO_NOTE_DIS
AGS_PIANO_NOTE_E
AGS_PIANO_NOTE_F
AGS_PIANO_NOTE_FIS
AGS_PIANO_NOTE_G
AGS_PIANO_NOTE_GIS
AGS_PIANO_NOTE_A
AGS_PIANO_NOTE_AIS
AGS_PIANO_NOTE_H

AGS_TYPE_PIANO

#define AGS_TYPE_PIANO                (ags_piano_get_type())

struct AgsPiano

struct AgsPiano;

struct AgsPianoClass

struct AgsPianoClass {
  GtkWidgetClass widget;

  void (*key_pressed)(AgsPiano *piano,
		      gchar *note, gint key_code);
  void (*key_released)(AgsPiano *piano,
		       gchar *note, gint key_code);

  void (*key_clicked)(AgsPiano *piano,
		      gchar *note, gint key_code);
};

Property Details

The `“base-key-code”` property

  “base-key-code”            guint

The base key code.

Flags: Read / Write

Default value: 0

Since: 1.2.0

The `“base-note”` property

  “base-note”                gchar *

The base note to use as lower.

Flags: Read / Write

Default value: "C,,"

Since: 1.2.0

The `“key-count”` property

  “key-count”                guint

The count of keys to be drawn.

Flags: Read / Write

Default value: 128

Since: 1.2.0

The `“key-height”` property

  “key-height”               guint

The key height to use for drawing a key.

Flags: Read / Write

Default value: 14

Since: 1.2.0

The `“key-width”` property

  “key-width”                guint

The key width to use for drawing a key.

Flags: Read / Write

Default value: 60

Since: 1.2.0

Signal Details

The `“key-clicked”` signal

void
user_function (AgsPiano *piano,
               gchar    *note,
               gint      key_code,
               gpointer  user_data)

The ::key-clicked signal notifies about key clicked.

Parameters

piano	the AgsPiano
note	the note as string
key_code	the numeric representation of the note
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.2.0

The `“key-pressed”` signal

void
user_function (AgsPiano *piano,
               gchar    *note,
               gint      key_code,
               gpointer  user_data)

The ::key-pressed signal notifies about key pressed.

Parameters

piano	the AgsPiano
note	the note as string
key_code	the numeric representation of the note
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.2.0

The `“key-released”` signal

void
user_function (AgsPiano *piano,
               gchar    *note,
               gint      key_code,
               gpointer  user_data)

The ::key-released signal notifies about key released.

Parameters

piano	the AgsPiano
note	the note as string
key_code	the numeric representation of the note
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.2.0

AgsPiano

Functions

Properties

Signals

Types and Values

Object Hierarchy

Implemented Interfaces

Includes

Description

Functions

ags_piano_key_code_to_note ()

Parameters

Returns

ags_piano_key_pressed ()

Parameters

ags_piano_key_released ()

Parameters

ags_piano_key_clicked ()

Parameters

ags_piano_get_active_key ()

Parameters

Returns

ags_piano_new ()

Returns

AGS_IS_PIANO()

AGS_PIANO()

AGS_PIANO_CLASS()

AGS_PIANO_GET_CLASS()

ags_piano_get_type ()

Types and Values

AGS_PIANO_DEFAULT_BASE_NOTE

AGS_PIANO_DEFAULT_BASE_KEY_CODE

AGS_PIANO_DEFAULT_KEY_WIDTH

AGS_PIANO_DEFAULT_KEY_HEIGHT

AGS_PIANO_DEFAULT_KEY_COUNT

enum AgsPianoFlags

Members

enum AgsPianoButtonState

Members

enum AgsPianoLayout

Members

enum AgsPianoAction

Members

enum AgsPianoOctave

Members

AGS_TYPE_PIANO

struct AgsPiano

struct AgsPianoClass

Property Details

The “base-key-code” property

The “base-note” property

The “key-count” property

The “key-height” property

The “key-width” property

Signal Details

The “key-clicked” signal

Parameters

The “key-pressed” signal

Parameters

The “key-released” signal

Parameters

The `“base-key-code”` property

The `“base-note”` property

The `“key-count”` property

The `“key-height”` property

The `“key-width”` property

The `“key-clicked”` signal

The `“key-pressed”` signal

The `“key-released”` signal