cue_parser.h

// SPDX-FileCopyrightText: 2019-2024 Connor McLaughlin <[email protected]>
// SPDX-License-Identifier: CC-BY-NC-ND-4.0

#pragma once
#include "cd_image.h"
#include "common/types.h"
#include <optional>
#include <string_view>
#include <utility>
#include <vector>

namespace Common {
class Error;
}

namespace CueParser {

using TrackMode = CDImage::TrackMode;
using MSF = CDImage::Position;

enum : s32
{
  MIN_TRACK_NUMBER = 1,
  MAX_TRACK_NUMBER = 99,
  MIN_INDEX_NUMBER = 0,
  MAX_INDEX_NUMBER = 99
};

enum class TrackFlag : u8
{
  PreEmphasis = (1 << 0),
  CopyPermitted = (1 << 1),
  FourChannelAudio = (1 << 2),
  SerialCopyManagement = (1 << 3),
};

enum class FileFormat : u8
{
  Binary,
  Wave,
  MaxCount
};

struct Track
{
  u8 number;
  u8 flags;
  TrackMode mode;
  FileFormat file_format;
  std::string file;
  std::vector<std::pair<u32, MSF>> indices;
  MSF start;
  std::optional<MSF> length;
  std::optional<MSF> zero_pregap;

  const MSF* GetIndex(u32 n) const;

  ALWAYS_INLINE bool HasFlag(TrackFlag flag) const { return (flags & static_cast<u32>(flag)) != 0; }
  ALWAYS_INLINE void SetFlag(TrackFlag flag) { flags |= static_cast<u32>(flag); }
  ALWAYS_INLINE void RemoveFlag(TrackFlag flag) { flags &= ~static_cast<u32>(flag); }
};

class File
{
public:
  File();
  ~File();

  const Track* GetTrack(u32 n) const;

  bool Parse(std::FILE* fp, Error* error);

private:
  Track* GetMutableTrack(u32 n);

  void SetError(u32 line_number, Error* error, const char* format, ...);

  static std::string_view GetToken(const char*& line);
  static std::optional<MSF> GetMSF(std::string_view token);

  bool ParseLine(const char* line, u32 line_number, Error* error);

  bool HandleFileCommand(const char* line, u32 line_number, Error* error);
  bool HandleTrackCommand(const char* line, u32 line_number, Error* error);
  bool HandleIndexCommand(const char* line, u32 line_number, Error* error);
  bool HandlePregapCommand(const char* line, u32 line_number, Error* error);
  bool HandleFlagCommand(const char* line, u32 line_number, Error* error);

  bool CompleteLastTrack(u32 line_number, Error* error);
  bool SetTrackLengths(u32 line_number, Error* error);

  std::vector<Track> m_tracks;
  std::optional<std::pair<std::string, FileFormat>> m_current_file;
  std::optional<Track> m_current_track;
};

} // namespace CueParser