/***

  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