/* Copyright (c) 2003-2012, John Hurst All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /*! \file asdcp-info.cpp \version $Id: asdcp-info.cpp,v 1.1 2012/02/03 19:49:56 jhurst Exp $ \brief AS-DCP file metadata utility This program provides metadata information about an AS-DCP file. For more information about asdcplib, please refer to the header file AS_DCP.h */ #include #include #include #include #include using namespace Kumu; using namespace ASDCP; const ui32_t FRAME_BUFFER_SIZE = 4 * Kumu::Megabyte; //------------------------------------------------------------------------------------------ // // command line option parser class static const char* PROGRAM_NAME = "asdcp-info"; // program name for messages // Increment the iterator, test for an additional non-option command line argument. // Causes the caller to return if there are no remaining arguments or if the next // argument begins with '-'. #define TEST_EXTRA_ARG(i,c) \ if ( ++i >= argc || argv[(i)][0] == '-' ) { \ fprintf(stderr, "Argument not found for option -%c.\n", (c)); \ return; \ } // void banner(FILE* stream = stdout) { fprintf(stream, "\n\ %s (asdcplib %s)\n\n\ Copyright (c) 2003-2012 John Hurst\n\n\ asdcplib may be copied only under the terms of the license found at\n\ the top of every file in the asdcplib distribution kit.\n\n\ Specify the -h (help) option for further information about %s\n\n", PROGRAM_NAME, ASDCP::Version(), PROGRAM_NAME); } // void usage(FILE* stream = stdout) { fprintf(stream, "\ USAGE:%s [-h|-help] [-V]\n\ \n\ %s [-3] [-H] [-n] +\n\ \n\ Options:\n\ -3 - Force stereoscopic interpretation of a JP2K file\n\ -h | -help - Show help\n\ -H - Show MXF header metadata\n\ -n - Show index\n\ -V - Show version information\n\ \n\ NOTES: o There is no option grouping, all options must be distinct arguments.\n\ o All option arguments must be separated from the option by whitespace.\n\n", PROGRAM_NAME, PROGRAM_NAME); } // class CommandOptions { CommandOptions(); public: bool error_flag; // true if the given options are in error or not complete bool version_flag; // true if the version display option was selected bool help_flag; // true if the help display option was selected PathList_t filenames; // list of filenames to be processed bool showindex_flag; // true if index is to be displayed bool showheader_flag; // true if MXF file header is to be displayed bool stereo_image_flag; // if true, expect stereoscopic JP2K input (left eye first) // CommandOptions(int argc, const char** argv) : error_flag(true), version_flag(false), help_flag(false), showindex_flag(), showheader_flag(), stereo_image_flag(false) { for ( int i = 1; i < argc; ++i ) { if ( (strcmp( argv[i], "-help") == 0) ) { help_flag = true; continue; } if ( argv[i][0] == '-' && ( isalpha(argv[i][1]) || isdigit(argv[i][1]) ) && argv[i][2] == 0 ) { switch ( argv[i][1] ) { case '3': stereo_image_flag = true; break; case 'H': showheader_flag = true; break; case 'h': help_flag = true; break; case 'n': showindex_flag = true; break; case 'V': version_flag = true; break; default: fprintf(stderr, "Unrecognized option: %s\n", argv[i]); return; } } else { if ( argv[i][0] != '-' ) { filenames.push_back(argv[i]); } else { fprintf(stderr, "Unrecognized argument: %s\n", argv[i]); return; } } } if ( help_flag || version_flag ) return; if ( filenames.empty() ) { fputs("Option requires at least one filename argument.\n", stderr); return; } error_flag = false; } }; //------------------------------------------------------------------------------------------ // // // These classes wrap the irregular names in the asdcplib API // so that I can use a template to simplify the implementation // of show_file_info() class MyVideoDescriptor : public MPEG2::VideoDescriptor { public: void FillDescriptor(MPEG2::MXFReader& Reader) { Reader.FillVideoDescriptor(*this); } void Dump(FILE* stream) { MPEG2::VideoDescriptorDump(*this, stream); } }; class MyPictureDescriptor : public JP2K::PictureDescriptor { public: void FillDescriptor(JP2K::MXFReader& Reader) { Reader.FillPictureDescriptor(*this); } void Dump(FILE* stream) { JP2K::PictureDescriptorDump(*this, stream); } }; class MyStereoPictureDescriptor : public JP2K::PictureDescriptor { public: void FillDescriptor(JP2K::MXFSReader& Reader) { Reader.FillPictureDescriptor(*this); } void Dump(FILE* stream) { JP2K::PictureDescriptorDump(*this, stream); } }; class MyAudioDescriptor : public PCM::AudioDescriptor { public: void FillDescriptor(PCM::MXFReader& Reader) { Reader.FillAudioDescriptor(*this); } void Dump(FILE* stream) { PCM::AudioDescriptorDump(*this, stream); } }; class MyTextDescriptor : public TimedText::TimedTextDescriptor { public: void FillDescriptor(TimedText::MXFReader& Reader) { Reader.FillTimedTextDescriptor(*this); } void Dump(FILE* stream) { TimedText::DescriptorDump(*this, stream); } }; // MSVC didn't like the function template, so now it's a static class method template class FileInfoWrapper { public: static Result_t file_info(CommandOptions& Options, const char* type_string, FILE* stream = 0) { assert(type_string); if ( stream == 0 ) stream = stdout; Result_t result = RESULT_OK; ReaderT Reader; result = Reader.OpenRead(Options.filenames.front().c_str()); if ( ASDCP_SUCCESS(result) ) { fprintf(stdout, "File essence type is %s.\n", type_string); if ( Options.showheader_flag ) Reader.DumpHeaderMetadata(stream); WriterInfo WI; Reader.FillWriterInfo(WI); WriterInfoDump(WI, stream); DescriptorT Desc; Desc.FillDescriptor(Reader); Desc.Dump(stream); if ( Options.showindex_flag ) Reader.DumpIndex(stream); } else if ( result == RESULT_FORMAT && Options.showheader_flag ) { Reader.DumpHeaderMetadata(stream); } return result; } }; // Read header metadata from an ASDCP file // Result_t show_file_info(CommandOptions& Options) { EssenceType_t EssenceType; Result_t result = ASDCP::EssenceType(Options.filenames.front().c_str(), EssenceType); if ( ASDCP_FAILURE(result) ) return result; if ( EssenceType == ESS_MPEG2_VES ) { result = FileInfoWrapper::file_info(Options, "MPEG2 video"); } else if ( EssenceType == ESS_PCM_24b_48k || EssenceType == ESS_PCM_24b_96k ) { result = FileInfoWrapper::file_info(Options, "PCM audio"); if ( ASDCP_SUCCESS(result) ) { const Dictionary* Dict = &DefaultCompositeDict(); PCM::MXFReader Reader; MXF::OPAtomHeader OPAtomHeader(Dict); MXF::WaveAudioDescriptor *descriptor = 0; result = Reader.OpenRead(Options.filenames.front().c_str()); if ( ASDCP_SUCCESS(result) ) result = Reader.OPAtomHeader().GetMDObjectByType(Dict->ul(MDD_WaveAudioDescriptor), reinterpret_cast(&descriptor)); if ( ASDCP_SUCCESS(result) ) { char buf[64]; fprintf(stdout, " ChannelAssignment: %s\n", descriptor->ChannelAssignment.EncodeString(buf, 64)); } } } else if ( EssenceType == ESS_JPEG_2000 ) { if ( Options.stereo_image_flag ) { result = FileInfoWrapper::file_info(Options, "JPEG 2000 stereoscopic pictures"); } else { result = FileInfoWrapper::file_info(Options, "JPEG 2000 pictures"); } } else if ( EssenceType == ESS_JPEG_2000_S ) { result = FileInfoWrapper::file_info(Options, "JPEG 2000 stereoscopic pictures"); } else if ( EssenceType == ESS_TIMED_TEXT ) { result = FileInfoWrapper::file_info(Options, "Timed Text"); } else { fprintf(stderr, "File is not AS-DCP: %s\n", Options.filenames.front().c_str()); Kumu::FileReader Reader; const Dictionary* Dict = &DefaultCompositeDict(); MXF::OPAtomHeader TestHeader(Dict); result = Reader.OpenRead(Options.filenames.front().c_str()); if ( ASDCP_SUCCESS(result) ) result = TestHeader.InitFromFile(Reader); // test UL and OP if ( ASDCP_SUCCESS(result) ) { TestHeader.Partition::Dump(stdout); if ( MXF::Identification* ID = TestHeader.GetIdentification() ) ID->Dump(stdout); else fputs("File contains no Identification object.\n", stdout); if ( MXF::SourcePackage* SP = TestHeader.GetSourcePackage() ) SP->Dump(stdout); else fputs("File contains no SourcePackage object.\n", stdout); } else { fputs("File is not MXF.\n", stdout); } } return result; } // int main(int argc, const char** argv) { Result_t result = RESULT_OK; char str_buf[64]; CommandOptions Options(argc, argv); if ( Options.version_flag ) banner(); if ( Options.help_flag ) usage(); if ( Options.version_flag || Options.help_flag ) return 0; if ( Options.error_flag ) { fprintf(stderr, "There was a problem. Type %s -h for help.\n", PROGRAM_NAME); return 3; } while ( ! Options.filenames.empty() && ASDCP_SUCCESS(result) ) { result = show_file_info(Options); Options.filenames.pop_front(); } if ( ASDCP_FAILURE(result) ) { fputs("Program stopped on error.\n", stderr); if ( result == RESULT_SFORMAT ) { fputs("Use option '-3' to force stereoscopic mode.\n", stderr); } else if ( result != RESULT_FAIL ) { fputs(result, stderr); fputc('\n', stderr); } return 1; } return 0; } // // end asdcp-info.cpp //