1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/*****************************************************************
|
| AP4 - Track Objects
|
| Copyright 2002-2008 Axiomatic Systems, LLC
|
|
| This file is part of Bento4/AP4 (MP4 Atom Processing Library).
|
| Unless you have obtained Bento4 under a difference license,
| this version of Bento4 is Bento4|GPL.
| Bento4|GPL 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, or (at your option)
| any later version.
|
| Bento4|GPL 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 Bento4|GPL; see the file COPYING. If not, write to the
| Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
| 02111-1307, USA.
|
****************************************************************/
#ifndef _AP4_TRAK_H_
#define _AP4_TRAK_H_
/*----------------------------------------------------------------------
| includes
+---------------------------------------------------------------------*/
#include "Ap4Types.h"
#include "Ap4Array.h"
/*----------------------------------------------------------------------
| forward declarations
+---------------------------------------------------------------------*/
class AP4_StblAtom;
class AP4_ByteStream;
class AP4_Sample;
class AP4_DataBuffer;
class AP4_TrakAtom;
class AP4_MoovAtom;
class AP4_SampleDescription;
class AP4_SampleTable;
/*----------------------------------------------------------------------
| constants
+---------------------------------------------------------------------*/
const AP4_UI32 AP4_TRACK_DEFAULT_MOVIE_TIMESCALE = 1000;
const AP4_UI32 AP4_TRACK_FLAG_ENABLED = 0x0001;
const AP4_UI32 AP4_TRACK_FLAG_IN_MOVIE = 0x0002;
const AP4_UI32 AP4_TRACK_FLAG_IN_PREVIEW = 0x0004;
/*----------------------------------------------------------------------
| AP4_Track
+---------------------------------------------------------------------*/
class AP4_Track {
public:
// types
typedef enum {
TYPE_UNKNOWN = 0,
TYPE_AUDIO = 1,
TYPE_VIDEO = 2,
TYPE_SYSTEM = 3,
TYPE_HINT = 4,
TYPE_TEXT = 5,
TYPE_JPEG = 6,
TYPE_RTP = 7,
TYPE_SUBTITLES = 8
} Type;
// methods
AP4_Track(Type type,
AP4_SampleTable* sample_table, // ownership is transfered to the AP4_Track object
AP4_UI32 track_id,
AP4_UI32 movie_time_scale, // 0 = use default
AP4_UI64 track_duration, // in the movie timescale
AP4_UI32 media_time_scale,
AP4_UI64 media_duration, // in the media timescale
const char* language,
AP4_UI32 width, // in 16.16 fixed point
AP4_UI32 height); // in 16.16 fixed point
AP4_Track(AP4_SampleTable* sample_table, // ownership is transfered to the AP4_Track object
AP4_UI32 track_id,
AP4_UI32 movie_time_scale, // 0 = use default
AP4_UI64 track_duration, // in the movie timescale
AP4_UI32 media_time_scale,
AP4_UI64 media_duration, // in the media timescale
const AP4_Track* track_prototype); // prototype for the type and other track fields
AP4_Track(AP4_TrakAtom& atom,
AP4_ByteStream& sample_stream,
AP4_UI32 movie_time_scale);
virtual ~AP4_Track();
/**
* Clone a track. This is useful if you want to create a track from
* a non-synthetic track (parsed from a file for example) and
* write it out
*/
AP4_Track* Clone(AP4_Result* result = NULL);
AP4_UI32 GetFlags() const;
AP4_Result SetFlags(AP4_UI32 flags);
AP4_Track::Type GetType() const { return m_Type; }
AP4_UI32 GetHandlerType() const;
AP4_UI64 GetDuration() const; // in the timescale of the movie
AP4_UI32 GetDurationMs() const; // in milliseconds
AP4_UI32 GetWidth() const; // in 16.16 fixed point
AP4_UI32 GetHeight() const; // in 16.16 fixed point
AP4_Cardinal GetSampleCount() const;
AP4_Result GetSample(AP4_Ordinal index, AP4_Sample& sample);
AP4_Result ReadSample(AP4_Ordinal index,
AP4_Sample& sample,
AP4_DataBuffer& data);
AP4_Result GetSampleIndexForTimeStampMs(AP4_UI32 ts_ms,
AP4_Ordinal& index);
AP4_Ordinal GetNearestSyncSampleIndex(AP4_Ordinal index, bool before=true);
AP4_SampleDescription* GetSampleDescription(AP4_Ordinal index);
AP4_Cardinal GetSampleDescriptionCount();
AP4_SampleTable* GetSampleTable() { return m_SampleTable; }
AP4_UI32 GetId() const;
AP4_Result SetId(AP4_UI32 track_id);
const AP4_TrakAtom* GetTrakAtom() const { return m_TrakAtom; }
AP4_TrakAtom* UseTrakAtom() { return m_TrakAtom; }
AP4_Result SetMovieTimeScale(AP4_UI32 time_scale);
AP4_UI32 GetMovieTimeScale() const { return m_MovieTimeScale; }
AP4_UI32 GetMediaTimeScale() const;
AP4_UI64 GetMediaDuration() const; // in the timescale of the media
const char* GetTrackName() const;
const char* GetTrackLanguage() const;
AP4_Result Attach(AP4_MoovAtom* moov);
protected:
// members
AP4_TrakAtom* m_TrakAtom;
bool m_TrakAtomIsOwned;
Type m_Type;
AP4_SampleTable* m_SampleTable;
bool m_SampleTableIsOwned;
AP4_UI32 m_MovieTimeScale;
};
#endif // _AP4_TRAK_H_
|
