/*
 *      Copyright (C) 2003-2006 Gabest
 *      Copyright (C) 2010-2021 Hendrik Leppkes
 *      http://www.1f0.de
 *
 *  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; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#pragma once

typedef enum TrackType {
	TypeVideo    = 1,
	TypeAudio    = 2,
	TypeComplex  = 3,
	TypeLogo     = 0x10,
	TypeSubtitle = 0x11,
	TypeControl  = 0x20
} TrackType;

#pragma pack(push, 1)

struct TrackElement {
	WORD Size;        // Size of this structure
	BYTE Type;        // See TrackType
	BOOL FlagDefault; // Set if the track is the default for its TrackType.
	BOOL FlagForced;  // Set if that track MUST be used during playback.
	BOOL FlagLacing;  // Set if the track may contain blocks using lacing.
	UINT MinCache;    // The minimum number of frames a player should be able to cache during playback.
	UINT MaxCache;    // The maximum cache size required to store referenced frames in and the current frame. 0 means no cache is needed.
	CHAR Language[4]; // Specifies the language of the track, in the ISO-639-2 form. (end with '\0')
};

struct TrackExtendedInfoVideo {
	WORD Size;            // Size of this structure
	BOOL Interlaced;      // Set if the video is interlaced.
	UINT PixelWidth;      // Width of the encoded video frames in pixels.
	UINT PixelHeight;     // Height of the encoded video frames in pixels.
	UINT DisplayWidth;    // Width of the video frames to display.
	UINT DisplayHeight;   // Height of the video frames to display.
	BYTE DisplayUnit;     // Type of the unit for DisplayWidth/Height (0: pixels, 1: centimeters, 2: inches).
	BYTE AspectRatioType; // Specify the possible modifications to the aspect ratio (0: free resizing, 1: keep aspect ratio, 2: fixed).
};

struct TrackExtendedInfoAudio {
	WORD Size;                     // Size of this structure
	FLOAT SamplingFreq;            // Sampling frequency in Hz.
	FLOAT OutputSamplingFrequency; // Real output sampling frequency in Hz (used for SBR techniques).
	UINT Channels;                 // Numbers of channels in the track.
	UINT BitDepth;                 // Bits per sample, mostly used for PCM.
};

#pragma pack(pop)

interface __declspec(uuid("03E98D51-DDE7-43aa-B70C-42EF84A3A23D"))
ITrackInfo :
public IUnknown {
	STDMETHOD_(UINT, GetTrackCount) () = 0;

	// \param aTrackIdx the track index (from 0 to GetTrackCount()-1)
	STDMETHOD_(BOOL, GetTrackInfo) (UINT aTrackIdx, struct TrackElement* pStructureToFill) = 0;

	// Get an extended information struct relative to the track type
	STDMETHOD_(BOOL, GetTrackExtendedInfo) (UINT aTrackIdx, void* pStructureToFill) = 0;

	STDMETHOD_(BSTR, GetTrackCodecID) (UINT aTrackIdx) = 0;
	STDMETHOD_(BSTR, GetTrackName) (UINT aTrackIdx) = 0;
	STDMETHOD_(BSTR, GetTrackCodecName) (UINT aTrackIdx) = 0;
	STDMETHOD_(BSTR, GetTrackCodecInfoURL) (UINT aTrackIdx) = 0;
	STDMETHOD_(BSTR, GetTrackCodecDownloadURL) (UINT aTrackIdx) = 0;
};
