64 lines
2.6 KiB
Go
64 lines
2.6 KiB
Go
// Copyright 2024 Martin Riedl
|
||
//
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
package gomp4
|
||
|
||
// SampleTableBox sample table box struct
|
||
//
|
||
// 8.5.1 Sample Table Box
|
||
//
|
||
// Box Type: ‘stbl’
|
||
// Container: Media Information Box (‘minf’)
|
||
// Mandatory: Yes
|
||
// Quantity: Exactly one
|
||
//
|
||
// The sample table contains all the time and data indexing of the media samples in a track. Using the
|
||
// tables here, it is possible to locate samples in time, determine their type (e.g. I‐frame or not), and
|
||
// determine their size, container, and offset into that container.
|
||
//
|
||
// If the track that contains the Sample Table Box references no data, then the Sample Table Box does not
|
||
// need to contain any sub‐boxes (this is not a very useful media track).
|
||
//
|
||
// If the track that the Sample Table Box is contained in does reference data, then the following sub‐boxes
|
||
// are required: Sample Description, Sample Size, Sample To Chunk, and Chunk Offset. Further, the Sample
|
||
// Description Box shall contain at least one entry. A Sample Description Box is required because it
|
||
// contains the data reference index field which indicates which Data Reference Box to use to retrieve the
|
||
// media samples. Without the Sample Description, it is not possible to determine where the media
|
||
// samples are stored. The Sync Sample Box is optional. If the Sync Sample Box is not present, all samples
|
||
// are sync samples.
|
||
type SampleTableBox struct {
|
||
*Box
|
||
ChildBoxes []any
|
||
}
|
||
|
||
// BoxTypeSampleTable Sample Table Box
|
||
const BoxTypeSampleTable = "stbl"
|
||
|
||
func init() {
|
||
BoxDefinitions = append(BoxDefinitions, BoxDefinition{
|
||
Type: BoxTypeSampleTable,
|
||
ParentTypes: []string{BoxTypeMediaInformation},
|
||
Parser: ParseSampleTableBox,
|
||
})
|
||
}
|
||
|
||
// ParseSampleTableBox creates a new sample table box struct based on bytes
|
||
func ParseSampleTableBox(parser *Parser, filePosition uint64, headerSize uint32, content []byte) (any, error) {
|
||
box := &SampleTableBox{Box: &Box{filePosition, headerSize}}
|
||
|
||
// parse child boxes
|
||
var err error
|
||
box.ChildBoxes, err = box.parseChildBoxes(parser, BoxTypeSampleTable, filePosition, content)
|
||
return box, err
|
||
}
|