mirror of
https://github.com/aaru-dps/Aaru.Decoders.git
synced 2025-12-16 19:24:32 +00:00
236 lines
9.6 KiB
C#
236 lines
9.6 KiB
C#
// /***************************************************************************
|
|
// Aaru Data Preservation Suite
|
|
// ----------------------------------------------------------------------------
|
|
//
|
|
// Filename : TOC.cs
|
|
// Author(s) : Natalia Portillo <claunia@claunia.com>
|
|
//
|
|
// Component : Device structures decoders.
|
|
//
|
|
// --[ Description ] ----------------------------------------------------------
|
|
//
|
|
// Decodes CD Table of Contents.
|
|
//
|
|
// --[ License ] --------------------------------------------------------------
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify
|
|
// it under the terms of the GNU Lesser General Public License as
|
|
// published by the Free Software Foundation; either version 2.1 of the
|
|
// License, or (at your option) any later version.
|
|
//
|
|
// This library 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
|
|
// Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public
|
|
// License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
//
|
|
// ----------------------------------------------------------------------------
|
|
// Copyright © 2011-2021 Natalia Portillo
|
|
// ****************************************************************************/
|
|
|
|
using System.Diagnostics.CodeAnalysis;
|
|
using System.Text;
|
|
using Aaru.Console;
|
|
using Aaru.Helpers;
|
|
|
|
namespace Aaru.Decoders.CD
|
|
{
|
|
// Information from the following standards:
|
|
// ANSI X3.304-1997
|
|
// T10/1048-D revision 9.0
|
|
// T10/1048-D revision 10a
|
|
// T10/1228-D revision 7.0c
|
|
// T10/1228-D revision 11a
|
|
// T10/1363-D revision 10g
|
|
// T10/1545-D revision 1d
|
|
// T10/1545-D revision 5
|
|
// T10/1545-D revision 5a
|
|
// T10/1675-D revision 2c
|
|
// T10/1675-D revision 4
|
|
// T10/1836-D revision 2g
|
|
// ISO/IEC 61104: Compact disc video system - 12 cm CD-V
|
|
// ISO/IEC 60908: Audio recording - Compact disc digital audio system
|
|
[SuppressMessage("ReSharper", "InconsistentNaming"), SuppressMessage("ReSharper", "MemberCanBeInternal"),
|
|
SuppressMessage("ReSharper", "MemberCanBePrivate.Global")]
|
|
public static class TOC
|
|
{
|
|
public static CDTOC? Decode(byte[] CDTOCResponse)
|
|
{
|
|
if(CDTOCResponse == null ||
|
|
CDTOCResponse.Length <= 4)
|
|
return null;
|
|
|
|
var decoded = new CDTOC
|
|
{
|
|
DataLength = BigEndianBitConverter.ToUInt16(CDTOCResponse, 0),
|
|
FirstTrack = CDTOCResponse[2],
|
|
LastTrack = CDTOCResponse[3]
|
|
};
|
|
|
|
decoded.TrackDescriptors = new CDTOCTrackDataDescriptor[(decoded.DataLength - 2) / 8];
|
|
|
|
if(decoded.DataLength + 2 != CDTOCResponse.Length)
|
|
{
|
|
AaruConsole.DebugWriteLine("CD TOC decoder",
|
|
"Expected CDTOC size ({0} bytes) is not received size ({1} bytes), not decoding",
|
|
decoded.DataLength + 2, CDTOCResponse.Length);
|
|
|
|
return null;
|
|
}
|
|
|
|
for(int i = 0; i < (decoded.DataLength - 2) / 8; i++)
|
|
{
|
|
decoded.TrackDescriptors[i].Reserved1 = CDTOCResponse[0 + (i * 8) + 4];
|
|
decoded.TrackDescriptors[i].ADR = (byte)((CDTOCResponse[1 + (i * 8) + 4] & 0xF0) >> 4);
|
|
decoded.TrackDescriptors[i].CONTROL = (byte)(CDTOCResponse[1 + (i * 8) + 4] & 0x0F);
|
|
decoded.TrackDescriptors[i].TrackNumber = CDTOCResponse[2 + (i * 8) + 4];
|
|
decoded.TrackDescriptors[i].Reserved2 = CDTOCResponse[3 + (i * 8) + 4];
|
|
|
|
decoded.TrackDescriptors[i].TrackStartAddress =
|
|
BigEndianBitConverter.ToUInt32(CDTOCResponse, 4 + (i * 8) + 4);
|
|
}
|
|
|
|
return decoded;
|
|
}
|
|
|
|
public static string Prettify(CDTOC? CDTOCResponse)
|
|
{
|
|
if(CDTOCResponse == null)
|
|
return null;
|
|
|
|
CDTOC response = CDTOCResponse.Value;
|
|
|
|
var sb = new StringBuilder();
|
|
|
|
sb.AppendFormat("First track number in first complete session: {0}", response.FirstTrack).AppendLine();
|
|
sb.AppendFormat("Last track number in last complete session: {0}", response.LastTrack).AppendLine();
|
|
|
|
foreach(CDTOCTrackDataDescriptor descriptor in response.TrackDescriptors)
|
|
{
|
|
if(descriptor.TrackNumber == 0xAA)
|
|
sb.AppendLine("Track number: Lead-Out");
|
|
else
|
|
sb.AppendFormat("Track number: {0}", descriptor.TrackNumber).AppendLine();
|
|
|
|
sb.AppendFormat("Track starts at LBA {0}, or MSF {1:X2}:{2:X2}:{3:X2}", descriptor.TrackStartAddress,
|
|
(descriptor.TrackStartAddress & 0x0000FF00) >> 8,
|
|
(descriptor.TrackStartAddress & 0x00FF0000) >> 16,
|
|
(descriptor.TrackStartAddress & 0xFF000000) >> 24).AppendLine();
|
|
|
|
switch((TocAdr)descriptor.ADR)
|
|
{
|
|
case TocAdr.NoInformation:
|
|
sb.AppendLine("Q subchannel mode not given");
|
|
|
|
break;
|
|
case TocAdr.TrackPointer:
|
|
sb.AppendLine("Q subchannel stores track pointer");
|
|
|
|
break;
|
|
case TocAdr.VideoTrackPointer:
|
|
sb.AppendLine("Q subchannel stores video track pointer");
|
|
|
|
break;
|
|
case TocAdr.ISRC:
|
|
sb.AppendLine("Q subchannel stores ISRC");
|
|
|
|
break;
|
|
case TocAdr.MediaCatalogNumber:
|
|
sb.AppendLine("Q subchannel stores media catalog number");
|
|
|
|
break;
|
|
default:
|
|
sb.AppendFormat("Q subchannel mode {0}", descriptor.ADR).AppendLine();
|
|
|
|
break;
|
|
}
|
|
|
|
if((descriptor.CONTROL & (byte)TocControl.ReservedMask) == (byte)TocControl.ReservedMask)
|
|
sb.AppendFormat("Reserved flags 0x{0:X2} set", descriptor.CONTROL).AppendLine();
|
|
else
|
|
{
|
|
switch((TocControl)(descriptor.CONTROL & 0x0D))
|
|
{
|
|
case TocControl.TwoChanNoPreEmph:
|
|
sb.AppendLine("Stereo audio track with no pre-emphasis");
|
|
|
|
break;
|
|
case TocControl.TwoChanPreEmph:
|
|
sb.AppendLine("Stereo audio track with 50/15 μs pre-emphasis");
|
|
|
|
break;
|
|
case TocControl.FourChanNoPreEmph:
|
|
sb.AppendLine("Quadraphonic audio track with no pre-emphasis");
|
|
|
|
break;
|
|
case TocControl.FourChanPreEmph:
|
|
sb.AppendLine("Quadraphonic audio track with 50/15 μs pre-emphasis");
|
|
|
|
break;
|
|
case TocControl.DataTrack:
|
|
sb.AppendLine("Data track, recorded uninterrupted");
|
|
|
|
break;
|
|
case TocControl.DataTrackIncremental:
|
|
sb.AppendLine("Data track, recorded incrementally");
|
|
|
|
break;
|
|
}
|
|
|
|
sb.AppendLine((descriptor.CONTROL & (byte)TocControl.CopyPermissionMask) ==
|
|
(byte)TocControl.CopyPermissionMask ? "Digital copy of track is permitted"
|
|
: "Digital copy of track is prohibited");
|
|
|
|
#if DEBUG
|
|
if(descriptor.Reserved1 != 0)
|
|
sb.AppendFormat("Reserved1 = 0x{0:X2}", descriptor.Reserved1).AppendLine();
|
|
|
|
if(descriptor.Reserved2 != 0)
|
|
sb.AppendFormat("Reserved2 = 0x{0:X2}", descriptor.Reserved2).AppendLine();
|
|
#endif
|
|
|
|
sb.AppendLine();
|
|
}
|
|
}
|
|
|
|
return sb.ToString();
|
|
}
|
|
|
|
public static string Prettify(byte[] CDTOCResponse)
|
|
{
|
|
CDTOC? decoded = Decode(CDTOCResponse);
|
|
|
|
return Prettify(decoded);
|
|
}
|
|
|
|
public struct CDTOC
|
|
{
|
|
/// <summary>Total size of returned TOC minus this field</summary>
|
|
public ushort DataLength;
|
|
/// <summary>First track number in hex</summary>
|
|
public byte FirstTrack;
|
|
/// <summary>Last track number in hex</summary>
|
|
public byte LastTrack;
|
|
/// <summary>Track descriptors</summary>
|
|
public CDTOCTrackDataDescriptor[] TrackDescriptors;
|
|
}
|
|
|
|
public struct CDTOCTrackDataDescriptor
|
|
{
|
|
/// <summary>Byte 0 Reserved</summary>
|
|
public byte Reserved1;
|
|
/// <summary>Byte 1, bits 7 to 4 Type of information in Q subchannel of block where this TOC entry was found</summary>
|
|
public byte ADR;
|
|
/// <summary>Byte 1, bits 3 to 0 Track attributes</summary>
|
|
public byte CONTROL;
|
|
/// <summary>Byte 2 Track number</summary>
|
|
public byte TrackNumber;
|
|
/// <summary>Byte 3 Reserved</summary>
|
|
public byte Reserved2;
|
|
/// <summary>Bytes 4 to 7 The track start address in LBA or in MSF</summary>
|
|
public uint TrackStartAddress;
|
|
}
|
|
}
|
|
} |