Documentation
¶
Index ¶
- Constants
- Variables
- func CodecString(sampleEntry string, sps *SPS) string
- func ContainsNaluType(sample []byte, specificNalType NaluType) bool
- func ConvertByteStreamToNaluSample(stream []byte) []byte
- func ConvertSampleToByteStream(sample []byte) []byte
- func ExtractNalusFromByteStream(data []byte) [][]byte
- func GetNalusFromSample(sample []byte) ([][]byte, error)
- func GetParameterSets(sample []byte) (sps [][]byte, pps [][]byte)
- func GetSARfromIDC(index uint) (uint, uint, error)
- func HasParameterSets(b []byte) bool
- func IsIDRSample(sample []byte) bool
- type CEA608sei
- type CpbEntry
- type DecConfRec
- type HrdParameters
- type ITUData
- type NaluType
- type PPS
- type RegisteredSEI
- type SEI
- type SEIData
- type SEIMessage
- type SPS
- type ScalingList
- type SliceType
- type UnregisteredSEI
- type VUIParameters
Constants ¶
const ( // NALU_NON_IDR - Non-IDR Slice NAL unit NALU_NON_IDR = NaluType(1) // NALU_IDR - IDR Random Access Slice NAL Unit NALU_IDR = NaluType(5) // NALU_SEI - Supplementary Enhancement Information NAL Unit NALU_SEI = NaluType(6) // NALU_SPS - SequenceParameterSet NAL Unit NALU_SPS = NaluType(7) // NALU_PPS - PictureParameterSet NAL Unit NALU_PPS = NaluType(8) // NALU_AUD - AccessUnitDelimiter NAL Unit NALU_AUD = NaluType(9) // NALU_EO_SEQ - End of Sequence NAL Unit NALU_EO_SEQ = NaluType(10) // NALU_EO_STREAM - End of Stream NAL Unit NALU_EO_STREAM = NaluType(11) // NALU_FILL - Filler NAL Unit NALU_FILL = NaluType(12) )
const ( SEIPicTimingType = 1 SEIRegisteredType = 4 SEIUnregisteredType = 5 )
const ( SLICE_P = SliceType(0) SLICE_B = SliceType(1) SLICE_I = SliceType(2) SLICE_SP = SliceType(3) SLICE_SI = SliceType(4) )
AVC slice types
const ExtendedSAR = 255
ExtendedSAR - Extended Sample Aspect Ratio Code
Variables ¶
var ( ErrCannotParseAVCExtension = errors.New("cannot parse SPS extensions") ErrLengthSize = errors.New("can only handle 4byte NAL length size") )
AVC parsing errors
var ( ErrNoSliceHeader = errors.New("no slice header") ErrInvalidSliceType = errors.New("invalid slice type") ErrTooFewBytesToParse = errors.New("too few bytes to parse symbol") )
Errors for parsing and handling AVC slices
var ErrNotPPS = errors.New("not an PPS NAL unit")
AVC PPS errors
var ErrNotSPS = errors.New("not an SPS NAL unit")
SPS errors
Functions ¶
func CodecString ¶
CodecString - sub-parameter for MIME type "codecs" parameter like avc1.42E00C where avc1 is sampleEntry. Defined in ISO/IEC 14496-15 2017.
func ContainsNaluType ¶
ContainsNaluType - is specific NaluType present in sample
func ConvertByteStreamToNaluSample ¶
ConvertByteStreamToNaluSample - Change start codes to 4-byte length fields
func ConvertSampleToByteStream ¶
ConvertSampleToByteStream - Replace 4-byte NALU lengths with start codes
func ExtractNalusFromByteStream ¶
ExtractNalusFromByteStream - extract NALUs without startcode from ByteStream
func GetNalusFromSample ¶
GetNalusFromSample - get nalus by following 4 byte length fields
func GetParameterSets ¶
GetParameterSets - get (multiple) SPS and PPS from a sample
func GetSARfromIDC ¶
GetSARfromIDC - get Sample Aspect Ratio from IDC index
func HasParameterSets ¶
HasParameterSets - Check if H.264 SPS and PPS are present
Types ¶
type CEA608sei ¶
CEA608sei message according to
func NewCEA608sei ¶
NewCEA608sei - new CEA 608 SEI message including parsing of CEA-608 fields
type DecConfRec ¶
type DecConfRec struct {
AVCProfileIndication byte
ProfileCompatibility byte
AVCLevelIndication byte
SPSnalus [][]byte
PPSnalus [][]byte
ChromaFormat byte
BitDepthLumaMinus1 byte
BitDepthChromaMinus1 byte
NumSPSExt byte
NoTrailingInfo bool // To handle strange cases where trailing info is missing
}
DecConfRec - AVCDecoderConfigurationRecord
func CreateAVCDecConfRec ¶
func CreateAVCDecConfRec(spsNalus [][]byte, ppsNalus [][]byte, includePS bool) (*DecConfRec, error)
CreateAVCDecConfRec - extract information from sps and insert sps, pps if includePS set
func DecodeAVCDecConfRec ¶
func DecodeAVCDecConfRec(data []byte) (DecConfRec, error)
DecodeAVCDecConfRec - decode an AVCDecConfRec
func (*DecConfRec) EncodeSW ¶
func (a *DecConfRec) EncodeSW(sw bits.SliceWriter) error
Encode - write an AVCDecConfRec to w
type HrdParameters ¶
type HrdParameters struct {
CpbCountMinus1 uint
BitRateScale uint
CpbSizeScale uint
CpbEntries []CpbEntry
InitialCpbRemovalDelayLengthMinus1 uint
CpbRemovalDelayLengthMinus1 uint
DpbOutpuDelayLengthMinus1 uint
TimeOffsetLength uint
}
HrdParameters inside VUI
type ITUData ¶
type ITUData struct {
CountryCode byte
UserDataTypeCode byte
ProviderCode uint16
UserIdentifier uint32
}
ITUData - first 8 bytes of payload for CEA-608 in type 4 (User data registered by ITU-T Rec T 35)
type NaluType ¶
type NaluType uint16
NaluType - AVC NAL unit type
func FindNaluTypes ¶
FindNaluTypes - find list of NAL unit types in sample
func FindNaluTypesUpToFirstVideoNALU ¶
FindNaluTypesUpToFirstVideoNALU - find list of NAL unit types in sample
func GetNaluType ¶
GetNaluType - get NALU type from NALU Header byte
type PPS ¶
type PPS struct {
PicParameterSetID uint
SeqParameterSetID uint
EntropyCodingModeFlag bool
BottomFieldPicOrderInFramePresentFlag bool
NumSliceGroupsMinus1 uint
SliceGroupMapType uint
RunLengthMinus1 []uint
TopLeft []uint
BottomRight []uint
SliceGroupChangeDirectionFlag bool
SliceGroupChangeRateMinus1 uint
PicSizeInMapUnitsMinus1 uint
SliceGroupID []uint
NumRefIdxI0DefaultActiveMinus1 uint
NumRefIdxI1DefaultActiveMinus1 uint
WeightedPredFlag bool
WeightedBipredIDC uint
PicInitQpMinus26 int
PicInitQsMinus26 int
ChromaQpIndexOffset int
DeblockingFilterControlPresentFlag bool
ConstrainedIntraPredFlag bool
RedundantPicCntPresentFlag bool
Transform8x8ModeFlag bool
PicScalingMatrixPresentFlag bool
PicScalingLists []ScalingList
SecondChromaQpIndexOffset int
}
PPS - Picture Parameter Set
type RegisteredSEI ¶
type RegisteredSEI struct {
ITUTData ITUData
// contains filtered or unexported fields
}
RegisteredSEI - user_data_registered_itu_t_t35 SEI message
func NewRegisteredSEI ¶
func NewRegisteredSEI(sd *SEIData, ituData ITUData) *RegisteredSEI
NewRegisteredSEI - create an ITU-T registered SEI message (type 4)
func (*RegisteredSEI) Payload ¶
func (s *RegisteredSEI) Payload() []byte
Payload - SEI raw rbsp payload
func (*RegisteredSEI) Size ¶
func (s *RegisteredSEI) Size() uint
Size - size in bytes of raw SEI message rbsp payload
func (*RegisteredSEI) String ¶
func (s *RegisteredSEI) String() string
type SEI ¶
type SEI struct {
SEIMessages []SEIMessage
}
SEI - Supplementary Enhancement Information as defined in ISO/IEC 14496-10 High level syntax in Section 7.3.2.3 The actual types are listed in Annex D
type SEIData ¶
type SEIData struct {
// contains filtered or unexported fields
}
SEIData - raw parsed SEI message with rbsp data
func ExtractSEIData ¶
func ExtractSEIData(r io.ReadSeeker) (seiData []SEIData, err error)
ExtractSEIData - parse ebsp and return SEIData in rbsp format
type SEIMessage ¶
SEIMessage is common part of any SEI message
func DecodeSEIMessage ¶
func DecodeSEIMessage(sd *SEIData) (SEIMessage, error)
DecodeSEIMessage decodes an SEIMessage
func DecodeUserDataRegisteredSEI ¶
func DecodeUserDataRegisteredSEI(sd *SEIData) (SEIMessage, error)
DecodeUserDataRegisteredSEI - decode a SEI message of byte 4
func DecodeUserDataUnregisteredSEI ¶
func DecodeUserDataUnregisteredSEI(sd *SEIData) (SEIMessage, error)
DecodeUserDataUnregisteredSEI - Decode an unregistered SEI message (type 5)
type SPS ¶
type SPS struct {
Profile uint
ProfileCompatibility uint
Level uint
ParameterID uint
ChromaFormatIDC uint
SeparateColourPlaneFlag bool
BitDepthLumaMinus8 uint
BitDepthChromaMinus8 uint
QPPrimeYZeroTransformBypassFlag bool
SeqScalingMatrixPresentFlag bool
SeqScalingLists []ScalingList
Log2MaxFrameNumMinus4 uint
PicOrderCntType uint
Log2MaxPicOrderCntLsbMinus4 uint
DeltaPicOrderAlwaysZeroFlag bool
OffsetForNonRefPic uint
OffsetForTopToBottomField uint
RefFramesInPicOrderCntCycle []uint
NumRefFrames uint
GapsInFrameNumValueAllowedFlag bool
FrameMbsOnlyFlag bool
MbAdaptiveFrameFieldFlag bool
Direct8x8InferenceFlag bool
FrameCroppingFlag bool
FrameCropLeftOffset uint
FrameCropRightOffset uint
FrameCropTopOffset uint
FrameCropBottomOffset uint
Width uint
Height uint
NrBytesBeforeVUI int
NrBytesRead int
VUI *VUIParameters
}
SPS - AVC SPS parameters
func ParseSPSNALUnit ¶
ParseSPSNALUnit - Parse AVC SPS NAL unit starting with NAL header
func (*SPS) ConstraintFlags ¶
ConstraintFlags - return the four ConstraintFlag bits
func (*SPS) CpbDpbDelaysPresent ¶
CpbDbpDelaysPresent signals if Cpb and Dbp can be found in Picture Timing SEI
func (*SPS) PicStructPresent ¶
PicStructPresent signals if pic struct can be found in Picture Timing SEI
type ScalingList ¶
type ScalingList []int
ScalingList - 4x4 or 8x8 Scaling lists. Nil if not present
type SliceType ¶
type SliceType uint
SliceType - AVC slice type
func GetSliceTypeFromNALU ¶
GetSliceTypeFromNALU - parse slice header to get slice type in interval 0 to 4
type UnregisteredSEI ¶
type UnregisteredSEI struct {
UUID []byte
// contains filtered or unexported fields
}
UnregisteredSEI - SEI message of type 5
func NewUnregisteredSEI ¶
func NewUnregisteredSEI(sd *SEIData, uuid []byte) *UnregisteredSEI
NewUnregisteredSEI - Create an unregistered SEI message (type 5)
func (*UnregisteredSEI) Payload ¶
func (s *UnregisteredSEI) Payload() []byte
Payload - SEI raw rbsp payload
func (*UnregisteredSEI) Size ¶
func (s *UnregisteredSEI) Size() uint
Size - size in bytes of raw SEI message rbsp payload
func (*UnregisteredSEI) String ¶
func (s *UnregisteredSEI) String() string
type VUIParameters ¶
type VUIParameters struct {
SampleAspectRatioWidth uint
SampleAspectRatioHeight uint
OverscanInfoPresentFlag bool
OverscanAppropriateFlag bool
VideoSignalTypePresentFlag bool
VideoFormat uint
VideoFullRangeFlag bool
ColourDescriptionFlag bool
ColourPrimaries uint
TransferCharacteristics uint
MatrixCoefficients uint
ChromaLocInfoPresentFlag bool
ChromaSampleLocTypeTopField uint
ChromaSampleLocTypeBottomField uint
TimingInfoPresentFlag bool
NumUnitsInTick uint
TimeScale uint
FixedFrameRateFlag bool
NalHrdParametersPresentFlag bool
NalHrdParameters *HrdParameters
VclHrdParametersPresentFlag bool
VclHrdParameters *HrdParameters
LowDelayHrdFlag bool // Only present with HrdParameters
PicStructPresentFlag bool
BitstreamRestrictionFlag bool
MotionVectorsOverPicBoundariesFlag bool
MaxBytesPerPicDenom uint
MaxBitsPerMbDenom uint
Log2MaxMvLengthHorizontal uint
Log2MaxMvLengthVertical uint
MaxNumReorderFrames uint
MaxDecFrameBuffering uint
}
VUIParameters - extra parameters according to 14496-10, E.1
Source Files