1MP4(3)                      MP4 File Format Library                     MP4(3)
2
3
4

NAME

6       MP4GetSampleIdFromEditTime  -  Get the sample id of a specified time in
7       the edit list timeline
8

SYNTAX

10       #include <mp4.h>
11
12       MP4SampleId MP4GetSampleIdFromEditTime(
13            MP4FileHandle hFile,
14            MP4TrackId trackId,
15            MP4Timestamp when,
16            MP4Timestamp* pStartTime = NULL,
17            MP4Duration* pDuration = NULL
18       );
19

ARGUMENTS

21       hFile  Specifies the mp4 file to which the operation applies.
22
23       trackId
24              Specifies the track to which the operation applies.
25
26       when   Specifies the time in the track time scale that is desired.
27
28       pStartTime
29              If non-NULL, pointer to variable that will receive the  starting
30              timestamp for this sample. Caveat: The timestamp is in the track
31              edit list timescale.
32
33       pDuration
34              If non-NULL, pointer to variable that will receive the  duration
35              for  this sample in the edit list timeline. Caveat: The duration
36              is in the track timescale units.
37
38

RETURN VALUES

40       Upon success, the sample id that occurs at the specified time. Upon  an
41       error, MP4_INVALID_SAMPLE_ID.
42

DESCRIPTION

44       MP4GetSampleIdFromEditTime returns the sample id of the track sample in
45       which the specified time occurs in the edit list timeline.
46
47       The specified time should be in the track time scale. See MP4ConvertTo‐
48       TrackTimestamp() for how to map a time value to this time scale.
49
50       Since  the edit list can cause the sample start time and duration to be
51       different that it in  the  standard  track  timeline,  it  is  strongly
52       advised that the caller retrieve the new sample start time and duration
53       via this function.
54

SEE ALSO

56       MP4(3) MP4GetSampleIdFromTime(3)
57
58
59
60Cisco Systems Inc.                Version 0.9                           MP4(3)
Impressum