Skip to content

armgit / nota

Public Imported from GitHub
0

Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.

6.2 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using Avalonia;
using Avalonia.Controls;
using Avalonia.Controls.Primitives;
using Avalonia.Input;
using Avalonia.Layout;
using Avalonia.Media;
using Avalonia.Threading;
using Nota.Application;
using Nota.Presentation;
using Nota.Application.Localization;

namespace Nota.App;

public sealed partial class ArrangementView
{
    // ---- model ------------------------------------------------------------
    internal sealed class TrackVM
    {
        public int Id;
        public bool IsInstrument;
        public bool IsReturn;
        public bool IsGroup;     // a group (submix) track — has children, no clips
        public int GroupId = -1; // parent group track id, or -1 (top-level)
        public bool EditLink;    // a group's Link (specs/076): its tracks arm and edit together
        public int Depth;        // hierarchy indent level (0 = top-level) for the header/lane row
        public int ColorIndex;   // index into the track palette (returns → 8/9)
        public bool Muted;
        public bool Soloed;
        public bool Armed;
        public bool Frozen;      // M7: playing a captured buffer instead of the live chain
        public string? Player;   // Nota Remote: the phone(s) playing this track
        public int LiveRole;     // live-freeze (v1.1): 0 none, 1 sleeping source, 2 linked frozen
        public string Name = "";
        public List<ClipVM> Clips = new();
        public List<TakeVM> Takes = new();   // loop-recording take lanes (specs/067), audio tracks only
        // Automation (M9-A3): current target + its live-editable envelope.
        public float Volume = 1f;
        public float Pan;
        public AutomationTarget AutoTarget = AutomationTarget.Volume;
        public int AutoDeviceIndex = -1;
        public int AutoParamIndex = -1;
        public string AutoParamId = "";      // PluginParam target (M9-B3)
        // A device grouped into a rack (specs/044): AutoDeviceIndex is the rack's address and
        // these the chain index and slot of the child the lane drives; -1 = track level.
        public int AutoChain = -1, AutoSlot = -1;
        public int AutoLane = -1;   // the nested lane itself: rack edits move its (chain, slot)
        public string AutoLabel = Loc.T("arrangement.vol");
        public List<AutoPt> AutoPoints = new();
        // Group lane summary (M-groups): descendant clips aggregated for the lane preview —
        // a stacked mini-clip per child sub-lane when collapsed, a thin span strip when
        // expanded. Empty for non-group tracks. Computed in ApplyHierarchy.
        public List<GroupMiniClip> GroupMini = new();
        public int GroupSlotCount;   // number of clip-bearing descendant sub-lanes (stack height)
    }

    /// <summary>One descendant clip projected onto a collapsed group's lane: its beat span,
    /// the child track's colour, and which stacked sub-lane it sits in.</summary>
    internal struct GroupMiniClip
    {
        public double Start;
        public double Length;
        public int ColorIndex;
        public int Slot;
    }

    /// <summary>A mutable automation breakpoint used during editing (struct AutomationPoint
    /// can't be held by reference while dragging). Committed back as AutomationPoint[].</summary>
    internal sealed class AutoPt { public double Beat; public float Value; public float Curve; }

    /// <summary>Everything an unwarped audio clip's peaks depend on except its position (specs/073).
    /// Warped clips have no key: their warp markers shape the peaks too.</summary>
    internal readonly record struct PeakSourceKey(long SampleId, double SourceOffsetFrames, long LengthFrames, float Gain,
        float PitchSemitones, int WarpEnabled, int WarpMode, double WarpBeats, double WarpPlayStart, double WarpPlayEnd, int Reversed)
    {
        public static PeakSourceKey Of(in NotaAudioClipInfo a) => new(a.SampleId, a.SourceOffsetFrames, a.LengthFrames, a.Gain,
            a.PitchSemitones, a.WarpEnabled, a.WarpMode, a.WarpBeats, a.WarpPlayStart, a.WarpPlayEnd, a.Reversed);
    }

    internal sealed class ClipVM
    {
        public int ClipIndex;
        public double StartBeat;
        public double LengthBeats;
        public bool IsMidi;
        public bool Active = true;   // false = deactivated (key 0): stays but silent + greyed
        public int TakeId;           // the take this comp section came from (specs/067), 0 = none
        public double SourceOffsetFrames; // where in the take that section starts; the lane highlight uses it
        /// <summary>What the audio clip's peaks were drawn from (everything but where it sits), so a
        /// refresh after a clip only moved can keep them (specs/073). Null for MIDI.</summary>
        public PeakSourceKey? PeakSource;
        public float[]? Peaks;
        public int PeakCount;
        /// <summary>RMS level per bucket of <see cref="Peaks"/> (null when unknown — an import placeholder).</summary>
        public float[]? Rms;
        /// <summary>Peaks over just the visible slice [DetailF0, DetailF1] of the clip (fractions
        /// of its played length), at one bucket per pixel — fetched when the clip is drawn wider
        /// than <see cref="Peaks"/> has buckets, so a long or zoomed-in clip doesn't draw as
        /// blocks (#299).</summary>
        public float[]? DetailPeaks;
        public float[]? DetailRms;
        public int DetailCount;
        public double DetailF0, DetailF1;
        /// <summary>Clip gain (linear) — peaks are raw material, the lane scales them by this.</summary>
        public float Gain = 1f;
        /// <summary>Audio clip ADSR amplitude shape (identity = full length, full level).</summary>
        public ClipAdsr Adsr = ClipAdsr.Identity;
        public NotaNote[]? Notes;
        public string Name = "";
        /// <summary>True when no clip on the same track ends where this one begins — the head
        /// of a run. Only these carry a name on the lane (design 1a), so a repeated pattern
        /// reads as one block. Computed in <c>Refresh</c>.</summary>
        public bool RunStart = true;
    }
}