1/**************************************************************************
2 copyright : (C) 2007 by Lukáš Lalinský
3 email : lalinsky@gmail.com
4 **************************************************************************/
5
6/***************************************************************************
7 * This library is free software; you can redistribute it and/or modify *
8 * it under the terms of the GNU Lesser General Public License version *
9 * 2.1 as published by the Free Software Foundation. *
10 * *
11 * This library is distributed in the hope that it will be useful, but *
12 * WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
14 * Lesser General Public License for more details. *
15 * *
16 * You should have received a copy of the GNU Lesser General Public *
17 * License along with this library; if not, write to the Free Software *
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA *
19 * 02110-1301 USA *
20 * *
21 * Alternatively, this file is available under the Mozilla Public *
22 * License Version 1.1. You may obtain a copy of the License at *
23 * http://www.mozilla.org/MPL/ *
24 ***************************************************************************/
25
26#ifndef TAGLIB_MP4PROPERTIES_H
27#define TAGLIB_MP4PROPERTIES_H
28
29#include "taglib_export.h"
30#include "audioproperties.h"
31
32namespace TagLib {
33
34 namespace MP4 {
35
36 class Atoms;
37 class File;
38
39 //! An implementation of MP4 audio properties
40 class TAGLIB_EXPORT Properties : public AudioProperties
41 {
42 public:
43 enum Codec {
44 Unknown = 0,
45 AAC,
46 ALAC
47 };
48
49 Properties(File *file, Atoms *atoms, ReadStyle style = Average);
50 virtual ~Properties();
51
52 /*!
53 * Returns the length of the file in seconds. The length is rounded down to
54 * the nearest whole second.
55 *
56 * \note This method is just an alias of lengthInSeconds().
57 *
58 * \deprecated
59 */
60 virtual int length() const;
61
62 /*!
63 * Returns the length of the file in seconds. The length is rounded down to
64 * the nearest whole second.
65 *
66 * \see lengthInMilliseconds()
67 */
68 // BIC: make virtual
69 int lengthInSeconds() const;
70
71 /*!
72 * Returns the length of the file in milliseconds.
73 *
74 * \see lengthInSeconds()
75 */
76 // BIC: make virtual
77 int lengthInMilliseconds() const;
78
79 /*!
80 * Returns the average bit rate of the file in kb/s.
81 */
82 virtual int bitrate() const;
83
84 /*!
85 * Returns the sample rate in Hz.
86 */
87 virtual int sampleRate() const;
88
89 /*!
90 * Returns the number of audio channels.
91 */
92 virtual int channels() const;
93
94 /*!
95 * Returns the number of bits per audio sample.
96 */
97 virtual int bitsPerSample() const;
98
99 /*!
100 * Returns whether or not the file is encrypted.
101 */
102 bool isEncrypted() const;
103
104 /*!
105 * Returns the codec used in the file.
106 */
107 Codec codec() const;
108
109 private:
110 void read(File *file, Atoms *atoms);
111
112 class PropertiesPrivate;
113 PropertiesPrivate *d;
114 };
115
116 }
117
118}
119
120#endif
121