mirror of
https://github.com/LMMS/lmms.git
synced 2025-12-30 10:08:00 -05:00
120 lines
3.4 KiB
C++
120 lines
3.4 KiB
C++
/*
|
|
* TimePos.h - declaration of class TimePos which provides data type for
|
|
* position- and length-variables
|
|
*
|
|
* Copyright (c) 2004-2014 Tobias Doerffel <tobydox/at/users.sourceforge.net
|
|
*
|
|
* This file is part of LMMS - https://lmms.io
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public
|
|
* License along with this program (see COPYING); if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
*/
|
|
|
|
#ifndef LMMS_TIME_POS_H
|
|
#define LMMS_TIME_POS_H
|
|
|
|
#include "lmms_export.h"
|
|
#include "lmms_basics.h"
|
|
|
|
namespace lmms
|
|
{
|
|
|
|
// note: a bar was erroneously called "tact" in older versions of LMMS
|
|
const int DefaultTicksPerBar = 192;
|
|
const int DefaultStepsPerBar = 16;
|
|
const int DefaultBeatsPerBar = DefaultTicksPerBar / DefaultStepsPerBar;
|
|
|
|
|
|
class MeterModel;
|
|
|
|
/**
|
|
Represents a time signature, in which the numerator is the number of beats
|
|
in a bar, while the denominator is the type of note representing a beat.
|
|
|
|
Example: 6/8 means 6 beats in a bar with each beat having a duration of one 8th-note.
|
|
*/
|
|
class LMMS_EXPORT TimeSig
|
|
{
|
|
public:
|
|
TimeSig( int num, int denom );
|
|
TimeSig( const MeterModel &model );
|
|
int numerator() const;
|
|
int denominator() const;
|
|
private:
|
|
int m_num;
|
|
int m_denom;
|
|
};
|
|
|
|
|
|
/**
|
|
Represents a position in time or length of a note or event, in ticks, beats, and bars
|
|
*/
|
|
class LMMS_EXPORT TimePos
|
|
{
|
|
public:
|
|
TimePos( const bar_t bar, const tick_t ticks );
|
|
TimePos( const tick_t ticks = 0 );
|
|
|
|
TimePos quantize(float) const;
|
|
TimePos toAbsoluteBar() const;
|
|
|
|
TimePos& operator+=( const TimePos& time );
|
|
TimePos& operator-=( const TimePos& time );
|
|
|
|
// return the bar, rounded down and 0-based
|
|
bar_t getBar() const;
|
|
// return the bar, rounded up and 0-based
|
|
bar_t nextFullBar() const;
|
|
|
|
void setTicks( tick_t ticks );
|
|
tick_t getTicks() const;
|
|
|
|
operator int() const;
|
|
|
|
tick_t ticksPerBeat( const TimeSig &sig ) const;
|
|
// Remainder ticks after bar is removed
|
|
tick_t getTickWithinBar( const TimeSig &sig ) const;
|
|
// Returns the beat position inside the bar, 0-based
|
|
tick_t getBeatWithinBar( const TimeSig &sig ) const;
|
|
// Remainder ticks after bar and beat are removed
|
|
tick_t getTickWithinBeat( const TimeSig &sig ) const;
|
|
|
|
// calculate number of frame that are needed this time
|
|
f_cnt_t frames( const float framesPerTick ) const;
|
|
|
|
double getTimeInMilliseconds( bpm_t beatsPerMinute ) const;
|
|
|
|
static TimePos fromFrames( const f_cnt_t frames, const float framesPerTick );
|
|
static tick_t ticksPerBar();
|
|
static tick_t ticksPerBar( const TimeSig &sig );
|
|
static int stepsPerBar();
|
|
static void setTicksPerBar( tick_t tpt );
|
|
static TimePos stepPosition( int step );
|
|
static double ticksToMilliseconds( tick_t ticks, bpm_t beatsPerMinute );
|
|
static double ticksToMilliseconds( double ticks, bpm_t beatsPerMinute );
|
|
|
|
private:
|
|
tick_t m_ticks;
|
|
|
|
static tick_t s_ticksPerBar;
|
|
|
|
} ;
|
|
|
|
|
|
} // namespace lmms
|
|
|
|
#endif // LMMS_TIME_POS_H
|