Piano

---

Object Hierarchy:

Description:

Content:

Classes:

• MarkedNoteStyle - A style for a given marked note (currently only a color)

Enums:

• LabelPosition - Possible keys labels positions

Properties:

• public RGBA accident_key_color { get; set; }
  RGBA color used to draw accident keys
• public bool auto_update { get; set; }
  Automatically redraw the piano whenever there's a change
• public bool detailed_labels { get; set; }
  Show octaves should be added in labels (e.g. E4)
• public ushort first_note { get; set; }
  MIDI Code of the first key's note (Defaults to C2)
• public ushort key_count { get; set; }
  Number of keys
• public LabelPosition labels_position { get; set; }
  Labels position
• public RGBA nat_key_color { get; set; }
  RGBA color used to draw natural keys
• public bool show_labels { get; set; }
  Whether note names should be drawn

Creation methods:

• public Piano ()

Methods:

• public override bool button_press_event (EventButton event)
  Customized button_press_event
• public override bool button_release_event (EventButton event)
  Customized button_released_event
• public override bool draw (Context cr)
  Draw the piano widget
• public HashSet<ushort>? find_positions (string note)
  Find all MIDI codes for a given note
• public void mark_midi (ushort midi_note, RGBA color = {0.0f, 0.0f, 0.5f, 1.0f})
  Highlight a key corresponding to a MIDI code
• public void mark_note (string note, RGBA color = {0.0f, 0.0f, 0.5f, 1.0f})
  Highlight all positions corresponding to a note
• public double midi_to_x (ushort midi_code)
  Get the x coordinate of the key associated to a given MIDI code
• public ushort point_to_midi (double x, double y) throws PianoError
  Get the MIDI code corresponding to a point (x,y) in the widget
• public void redraw ()
  Force a complete redraw of the widget
• public override void size_allocate (Allocation allocation)
• public void unmark_all ()
  Remove all marked notes in the Piano view
• public void unmark_midi (ushort midi_note)
  Remove the mark of a position in the instrument
• public void unmark_note (string note)
  Remove the marks in all positions corresponding to a note

Signals:

• public signal void note_pressed (EventButton event, ushort midi_note)
  Signal emitted when a note has been pressed with the mouse
• public signal void note_released (EventButton event, ushort midi_note)
  Signal emitted when a note has been released (mouse button released)

Fields:

• public HashMap<ushort,MarkedNoteStyle> marked_notes
  Dictionary of marked notes

Inherited Members: