timeline__arranger_8h_source.html

// SPDX-FileCopyrightText: © 2018-2022, 2024 Alexandros Theodotou <alex@zrythm.org>

// SPDX-License-Identifier: LicenseRef-ZrythmLicense


#ifndef __GUI_WIDGETS_TIMELINE_ARRANGER_H__

#define __GUI_WIDGETS_TIMELINE_ARRANGER_H__


#include "gui/backend/gtk_widgets/arranger.h"


#define MW_TIMELINE (MW_TIMELINE_PANEL->timeline)

#define MW_PINNED_TIMELINE (MW_TIMELINE_PANEL->pinned_timeline)


ArrangerCursor

timeline_arranger_widget_get_cursor (ArrangerWidget * self, Tool tool);


void

timeline_arranger_widget_snap_range_r (ArrangerWidget * self, Position * pos);


TrackLane *

timeline_arranger_widget_get_track_lane_at_y (ArrangerWidget * self, double y);


Track *

timeline_arranger_widget_get_track_at_y (ArrangerWidget * self, double y);


AutomationTrack *

timeline_arranger_widget_get_at_at_y (ArrangerWidget * self, double y);


void

timeline_arranger_widget_set_select_type (ArrangerWidget * self, double y);


template <FinalRegionSubclass RegionT>

void

timeline_arranger_widget_create_region (

  ArrangerWidget * self,

  Track *          track,

  std::conditional_t<

    LaneOwnedRegionSubclass<RegionT>,

    TrackLaneImpl<RegionT> *,

    std::nullptr_t> lane,

  AutomationTrack * at,

  const Position *  pos);


void

timeline_arranger_widget_create_chord_or_scale (

  ArrangerWidget * self,

  Track *          track,

  double           y,

  const Position * pos);


void

timeline_arranger_widget_create_scale (

  ArrangerWidget * self,

  Track *          track,

  const Position * pos);


void

timeline_arranger_widget_create_marker (

  ArrangerWidget * self,

  Track *          track,

  const Position * pos);


void

timeline_arranger_widget_scroll_to (ArrangerWidget * self, Position * pos);


int

timeline_arranger_move_regions_to_new_tracks (

  ArrangerWidget * self,

  const int        vis_track_diff);


int

timeline_arranger_move_regions_to_new_lanes (

  ArrangerWidget * self,

  const int        diff);


void

timeline_arranger_widget_set_cut_lines_visible (ArrangerWidget * self);


void

timeline_arranger_widget_remove_children (ArrangerWidget * self);


GMenu *

timeline_arranger_widget_gen_context_menu (

  ArrangerWidget * self,

  double           x,

  double           y);


void

timeline_arranger_widget_fade_up (

  ArrangerWidget * self,

  double           offset_y,

  bool             fade_in);


void

timeline_arranger_setup_drag_dest (ArrangerWidget * self);


void

timeline_arranger_on_drag_end (ArrangerWidget * self);


extern template void

timeline_arranger_widget_create_region<MidiRegion> (

  ArrangerWidget *,

  Track *,

  TrackLaneImpl<MidiRegion> *,

  AutomationTrack *,

  const Position *);

extern template void

timeline_arranger_widget_create_region<AudioRegion> (

  ArrangerWidget *,

  Track *,

  TrackLaneImpl<AudioRegion> *,

  AutomationTrack *,

  const Position *);

extern template void

timeline_arranger_widget_create_region<ChordRegion> (

  ArrangerWidget *,

  Track *,

  std::nullptr_t,

  AutomationTrack *,

  const Position *);

extern template void

timeline_arranger_widget_create_region<AutomationRegion> (

  ArrangerWidget *,

  Track *,

  std::nullptr_t,

  AutomationTrack *,

  const Position *);


#endif

ArrangerCursor
ArrangerCursor
Definition arranger.h:30

timeline_arranger_widget_create_region
void timeline_arranger_widget_create_region(ArrangerWidget *self, Track *track, std::conditional_t< LaneOwnedRegionSubclass< RegionT >, TrackLaneImpl< RegionT > *, std::nullptr_t > lane, AutomationTrack *at, const Position *pos)
Create a Region at the given Position in the given Track's given TrackLane.

timeline_arranger_widget_set_select_type
void timeline_arranger_widget_set_select_type(ArrangerWidget *self, double y)
Determines the selection time (objects/range) and sets it.

timeline_arranger_widget_gen_context_menu
GMenu * timeline_arranger_widget_gen_context_menu(ArrangerWidget *self, double x, double y)
Generate a context menu at x, y.

timeline_arranger_widget_get_track_lane_at_y
TrackLane * timeline_arranger_widget_get_track_lane_at_y(ArrangerWidget *self, double y)
Gets hit TrackLane at y.

timeline_arranger_widget_create_marker
void timeline_arranger_widget_create_marker(ArrangerWidget *self, Track *track, const Position *pos)
Create a Marker at the given Position in the given Track.

timeline_arranger_widget_set_cut_lines_visible
void timeline_arranger_widget_set_cut_lines_visible(ArrangerWidget *self)
Hides the cut dashed line from hovered regions and redraws them.

timeline_arranger_widget_get_at_at_y
AutomationTrack * timeline_arranger_widget_get_at_at_y(ArrangerWidget *self, double y)
Returns the hit AutomationTrack at y.

timeline_arranger_setup_drag_dest
void timeline_arranger_setup_drag_dest(ArrangerWidget *self)
Sets up the timeline arranger as a drag dest.

ArrangerWidget
struct _ArrangerWidget { GtkWidget parent_instance; ArrangerWidgetType type; GtkGestureDrag * drag; GtkGestureClick * click; GtkGestureClick * right_click; GtkEventControllerMotion *motion_controller; double last_offset_x; double last_offset_y; double offset_x_from_scroll; double offset_y_from_scroll; UiOverlayAction action; double start_x; double start_y; double start_pos_px; bool drag_update_started; std::unique_ptr< Position > earliest_obj_start_pos; Position fade_pos_at_start; std::unique_ptr< ArrangerObject > start_object; std::weak_ptr< ArrangerObject > prj_start_object; std::weak_ptr< ArrangerObject > hovered_object; bool start_object_was_selected; std::unique_ptr< ArrangerSelections > sel_at_start; std::unique_ptr< Region > region_at_start; std::unique_ptr< ArrangerSelections > sel_to_delete; Position start_pos; bool was_paused; Position playhead_pos_at_start; double curr_ticks_diff_from_start; double adj_ticks_diff; double last_adj_ticks_diff; Position curr_pos; Position end_pos; gboolean key_is_pressed; double hover_x; double hover_y; bool hovered; int n_press; std::shared_ptr< SnapGrid > snap_grid; int shift_held; int ctrl_held; int alt_held; gint64 last_frame_time; int visible_track_diff; int lane_diff; int visible_at_diff; int is_pinned; int resizing_range; int resizing_range_start; AutomationTrack *hovered_at; TrackLane * hovered_lane; Track * hovered_track; GdkTexture *symbolic_link_texture; GdkTexture *music_note_16th_texture; GdkTexture *fork_awesome_snowflake_texture; GdkTexture *media_playlist_repeat_texture; int region_icon_texture_size; GskRenderNode *loop_line_node; GskRenderNode *clip_start_line_node; GskRenderNode *cut_line_node; int hovered_note; int start_vel_val; int vel_diff; int hovered_chord_index; float fval_at_start; double dval_at_start; int last_playhead_px; bool redraw; graphene_rect_t last_rect; bool can_link; bool is_highlighted; GdkRectangle highlight_rect; GdkRectangle last_selection_rect; guint drag_start_btn; bool first_draw; double new_hadj_val; Transport::Display ruler_display; PangoLayoutUniquePtr vel_layout; PangoLayoutUniquePtr ap_layout; PangoLayoutUniquePtr audio_layout; PangoLayoutUniquePtr debug_layout; int queued_playhead_px; GtkPopoverMenu *popover_menu; guint unlisten_notes_timeout_id;} ArrangerWidget
A canvas widget for drawing and interacting with arranger objects.
Definition arranger.h:95

timeline_arranger_move_regions_to_new_tracks
int timeline_arranger_move_regions_to_new_tracks(ArrangerWidget *self, const int vis_track_diff)
Move the selected Regions to the new Track.

timeline_arranger_widget_create_chord_or_scale
void timeline_arranger_widget_create_chord_or_scale(ArrangerWidget *self, Track *track, double y, const Position *pos)
Wrapper for timeline_arranger_widget_create_chord() or timeline_arranger_widget_create_scale().

timeline_arranger_widget_scroll_to
void timeline_arranger_widget_scroll_to(ArrangerWidget *self, Position *pos)
Scroll to the given position.

timeline_arranger_widget_fade_up
void timeline_arranger_widget_fade_up(ArrangerWidget *self, double offset_y, bool fade_in)
Fade up/down.

timeline_arranger_widget_create_scale
void timeline_arranger_widget_create_scale(ArrangerWidget *self, Track *track, const Position *pos)
Create a ScaleObject at the given Position in the given Track.

timeline_arranger_widget_get_track_at_y
Track * timeline_arranger_widget_get_track_at_y(ArrangerWidget *self, double y)
Gets the Track at y.

timeline_arranger_widget_remove_children
void timeline_arranger_widget_remove_children(ArrangerWidget *self)
To be called when pinning/unpinning.

timeline_arranger_move_regions_to_new_lanes
int timeline_arranger_move_regions_to_new_lanes(ArrangerWidget *self, const int diff)
Move the selected Regions to new Lanes.