Files
oak-editor/app/widget/timeruler/markerhandle.h
T
Mike-Solar 0aa5879f35 app: migrate all engine access to the C ABI facade (nm U _ZN5olive = 0)
Every app module now reaches liboakengine exclusively through
oakengine_* C calls, EngineEventBridge subscriptions and app-side
handle headers (cliphandle/keyframehandle/nodevaluehandle/oakvaluehelper).
Direct C++ command construction, engine signal connect()s, and engine
type usage in MOC-visible signatures are gone: 557 -> 0 undefined
olive:: symbols in oak-editor.
2026-07-26 22:43:21 +08:00

155 lines
4.4 KiB
C++

/***
Oak - Non-Linear Video Editor
Copyright (C) 2026 Oak Team
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 3 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. If not, see <http://www.gnu.org/licenses/>.
***/
#ifndef OAK_MARKERHANDLE_H
#define OAK_MARKERHANDLE_H
#include <olive/core/core.h>
#include <QByteArray>
#include <QString>
#include "oakengine/timeline.h"
namespace olive
{
class TimelineMarker;
class TimelineMarkerList;
using olive::core::Rational;
using olive::core::TimeRange;
/**
* @brief Facade accessors for marker pointers held by the ruler/scrollbar
* widgets.
*
* The widgets keep olive::TimelineMarker* / olive::TimelineMarkerList* as
* opaque identity pointers (selection, drawing, hit-testing). All engine
* data and mutations go through the liboakengine C ABI
* (oakengine/timeline.h); the pointer itself is only a handle. Marker
* times are rational seconds (num/den pairs), not frame timestamps.
*/
inline OakEngineMarker *markerhandle(TimelineMarker *marker)
{
return reinterpret_cast<OakEngineMarker *>(marker);
}
inline const OakEngineMarker *markerhandle(const TimelineMarker *marker)
{
return reinterpret_cast<const OakEngineMarker *>(marker);
}
inline TimelineMarker *markerhandle(OakEngineMarker *marker)
{
return reinterpret_cast<TimelineMarker *>(marker);
}
inline OakEngineMarkerList *markerlisthandle(TimelineMarkerList *list)
{
return reinterpret_cast<OakEngineMarkerList *>(list);
}
inline const OakEngineMarkerList *markerlisthandle(
const TimelineMarkerList *list)
{
return reinterpret_cast<const OakEngineMarkerList *>(list);
}
inline TimeRange marker_time(const TimelineMarker *marker)
{
int64_t in_num = 0, in_den = 1, out_num = 0, out_den = 1;
oakengine_marker_get_time(markerhandle(marker), &in_num, &in_den,
&out_num, &out_den);
return TimeRange(Rational(int(in_num), int(in_den)),
Rational(int(out_num), int(out_den)));
}
inline QString marker_name(const TimelineMarker *marker)
{
const int size =
oakengine_marker_get_name(markerhandle(marker), nullptr, 0);
QByteArray buf(size + 1, '\0');
oakengine_marker_get_name(markerhandle(marker), buf.data(),
int(buf.size()));
return QString::fromUtf8(buf.constData());
}
inline int marker_color(const TimelineMarker *marker)
{
return oakengine_marker_get_color(markerhandle(marker));
}
inline bool marker_has_sibling_at_time(const TimelineMarker *marker,
const Rational &time)
{
return oakengine_marker_has_sibling_at_time(
markerhandle(marker), time.numerator(), time.denominator()) != 0;
}
inline void marker_set_time_live(TimelineMarker *marker,
const TimeRange &range)
{
oakengine_marker_set_time_live(
markerhandle(marker), range.in().numerator(), range.in().denominator(),
range.out().numerator(), range.out().denominator());
}
/**
* @brief ADL customization points for
* TimeBasedViewSelectionManager<TimelineMarker>.
*
* The selection manager template calls these unqualified; these overloads
* route marker access through the facade (see
* widget/keyframeview/keyframehandle.h for the NodeKeyframe equivalent).
* selection_time_target_parent() is intentionally not overloaded: the
* generic template in timebasedviewselectionmanager.h works for markers
* and marker drags never pass a time target.
*/
inline Rational selection_time(TimelineMarker *marker)
{
return marker_time(marker).in();
}
inline Rational selection_time_end(TimelineMarker *marker)
{
return marker_time(marker).out();
}
inline void selection_set_time(TimelineMarker *marker, const Rational &time)
{
// Move the in-point keeping the range length (was
// TimelineMarker::set_time(const Rational &))
const TimeRange range = marker_time(marker);
const Rational length = range.out() - range.in();
marker_set_time_live(marker, TimeRange(time, time + length));
}
inline bool selection_has_sibling_at_time(TimelineMarker *marker,
const Rational &time)
{
return marker_has_sibling_at_time(marker, time);
}
} // namespace olive
#endif // OAK_MARKERHANDLE_H