gpac头文件阅读记录

最新推荐文章于 2020-02-10 18:20:17 发布

claider

最新推荐文章于 2020-02-10 18:20:17 发布

阅读量2.5k

点赞数

分类专栏：其他技术类文章文章标签： buffer extension stream file header command

本文链接：https://blog.csdn.net/claider/article/details/725749

版权

其他技术类文章专栏收录该内容

13 篇文章 0 订阅

订阅专栏

依目录察看头文件： GPAC/GPAC4_0/gpac/include/gpac/

avparse.h

对象：

u GF_AC3Header

u GF_M4AdecSpecInfo

u GF_M4VdecSpecInfo

u GF_M4Vparser

struct __tag_m4v_parser

{

GF_BitStream *bs;

u32 current_object_type;

u32 current_object_start;

u32 tc_dec, prev_tc_dec, tc_disp, prev_tc_disp;

};

u GF_VorbisParser

方法：

¨ GF_M4VParser *gf_m4v_parser_new(unsigned char *data, u32 data_size);

tmp = malloc(sizeof(GF_M4VParser));

tmp->bs = gf_bs_new(data, data_size, GF_BITSTREAM_READ);

//gf_bs_new 无甚花头，仅为开辟 GF_BitStream 型内存，设置读写模式和缓冲区之类操作

¨ void gf_m4v_parser_del(GF_M4VParser *m4v);

¨ GF_Err gf_m4v_parse_config(GF_M4VParser *m4v, GF_M4VDecSpecInfo *dsi);

// 由参数 GF_M4VParser *m4v 的 bs 字段，读取相关设置

¨ GF_Err gf_m4v_parse_frame(GF_M4VParser *m4v, GF_M4VDecSpecInfo dsi, u8 *frame_type, u32 *time_inc, u32 *size, u32 *start, Bool *is_coded);

自第 00342 行起：

while (gf_bs_read_int(m4v->bs, 1) != 0)

secs ++;

/*no support for B frames in parsing*/

secs += (dsi.enh_layer || *frame_type!=2) ? m4v->tc_dec : m4v->tc_disp;

/*marker*/

gf_bs_read_int(m4v->bs, 1);

/*vop_time_inc*/

if (dsi.NumBitsTimeIncrement)

vop_inc = gf_bs_read_int(m4v->bs, dsi.NumBitsTimeIncrement);

m4v->prev_tc_dec = m4v->tc_dec;

m4v->prev_tc_disp = m4v->tc_disp;

if (dsi.enh_layer || *frame_type!=2) {

m4v->tc_disp = m4v->tc_dec;

m4v->tc_dec = secs;

}

*time_inc = secs * dsi.clock_rate + vop_inc;

到第 00358 行止。

以上 m4v 各个字段的属性尚不熟悉，有待进一步察看

¨ Bool gf_ac3_parser(u8 *buffer, u32 buffer_size, u32 *pos, GF_AC3Header *out_hdr);

Base_coding.h

¨ u32 gf_base64_encode(unsigned char *in_buffer, u32 in_buffer_size, unsigned char *out_buffer, u32 out_buffer_size);

//Base64 编码， MIME 相关

¨ u32 gf_base64_decode(unsigned char *in_buffer, u32 in_buffer_size, unsigned char *out_buffer, u32 out_buffer_size);

¨ u32 gf_base16_encode(unsigned char *in_buffer, u32 in_buffer_size, unsigned char *out_buffer, u32 out_buffer_size);

¨ u32 gf_base16_decode(unsigned char *in_buffer, u32 in_buffer_size, unsigned char *out_buffer, u32 out_buffer_size);

Bifs.h

对象：

u typedef struct __tag_bifs_enc GF_BifsEncoder;

/*BIFS encoding*/

u typedef struct __tag_bifs_dec GF_BifsDecoder;

定义于 bifs_dev.h 中

// 开始自 00070 行

// 结束于 00114 行

相关方法：

¨ GF_BitStream *gf_bs_new(unsigned char *buffer, u64 size, u32 mode);

//New 一个 GF_BitStream ，设置相关字段

¨ GF_BitStream *gf_bs_from_file(FILE *f, u32 mode);

由文件创建一个 GF_BitStream ，并且读取文件的 size ，填入返回参数的相关字段

¨ void gf_bs_del(GF_BitStream *bs);

¨ u32 gf_bs_read_data(GF_BitStream *bs, unsigned char *data, u32 nbBytes);

¨ u8 gf_bs_align(GF_BitStream *bs);

利用读写 int 型（ gf_bs_read_int/gf_bs_write_int ）的函数，处理 bs 数据掉多出一个字节的部分

对象：

typedef struct __tag_bifs_engine GF_BifsEngine;

定义于 Encode_cbk.c

有关方法：

GF_BifsEngine *gf_beng_init(void *calling_object, char *inputContext, void *extension);

……

00347 行起：

e = gf_sm_load_init(&(codec->load));

if (!e) e = gf_sm_load_run(&(codec->load));

gf_sm_load_done(&(codec->load));

以上三个函数分别针对 BT/XMT/SWF/QT/MP4 ，调用相关的 gf_sm_load_init_**,gf_sm_load_run_**,gf_sm_load_done_** ，若对 mp4 文件的读写进行最终时，可重点察看这里！

00349 行止。

……

void gf_beng_get_stream_config(GF_BifsEngine *beng, char **config, u32 *config_len);

// 以后面两个参数返回第一个参数结构体的相关字段

GF_Err gf_beng_encode_context(GF_BifsEngine *beng, GF_Err (*AUCallback)(void *, char *data, u32 size, u32 ts), void *extension);

调用 gf_sm_live_encode_bifs_au(codec, 0, AUCallback);

后者遍历 codec->sc->Aus 下的各个 Au 并调用相关函数 encode 之

e = gf_bifs_encode_au(codec->bifsenc, codec->sc->ESID, au->commands, &data, &size);

AUCallback(codec->calling_object, data, size, au->timing);

GF_Err gf_beng_encode_from_file(GF_BifsEngine *beng, char *auFile, GF_Err (*AUCallback)(void *, char *data, u32 size, u32 ts), void *extension);

遍历当前 GF_BifsEngine 的 ctx （即 context ）下所有 Stream ，并且找出其下唯一的 BIFS （假设有且只有一个）

以下面的三行函数调用处理之：

e = gf_sm_load_init(&codec->load);

if (!e) e = gf_sm_load_run(&codec->load);

gf_sm_load_done(&codec->load);

GF_Err gf_beng_encode_from_string(GF_BifsEngine *beng, char *auString, GF_Err (*AUCallback)(void *, char *data, u32 size, u32 ts), void *extension);

类似上面的函数，区别仅在以如下函数处理之：

e = gf_sm_load_from_string(&codec->load, auString);

GF_Err gf_beng_save_context(GF_BifsEngine *beng, char *ctxFileName, void *extension);

xmt 或者 xmta 格式可直接 dump ：

e = gf_sm_dump(codec->ctx, szF, d_mode);

mp4 格式需要 encode ：

e = gf_sm_encode_to_file(codec->ctx, mp4, NULL, NULL, 0, 0);

GF_Err gf_beng_aggregate_context(GF_BifsEngine *beng, void *extension);

/*make random access for storage*/

e = gf_sm_make_random_access(codec->ctx);

上面这个函数，执行 codec->ctx 即 context 中所有 stream 的所有 AU 的 commands ，

并且把 commands 都去掉

重新创建 Scene replace

void gf_beng_terminate(GF_BifsEngine *beng);

config.h

对象：

u typedef struct __tag_config GF_Config;

与其相关的方法：

插入命名创建修改删除等

constants.h

诸多常量的定义

crypt.h

对象：

GF_Crypt

方法：

对 algorithm 的一系列设置

形如 gf_crypt_**

download.h

对象：

u GF_DownloadManager

u GF_DownloadSession

相关方法：

对 download manager 的管理，形如： gf_dm_**

对 download session 的管理，形如： gf_dm_sess_**

ietf.h

对象：

u 定义了 RTSP NOTIF CODES ， enum 类型，形如： NC_RTSP_**

u GF_RTSPRange;

¨ 相关方法：该结构体的创建、解析、删除

u GF_RTSPTransport;

记录相关的 multi-cast 信息，如：端口范围， server/client 的端口范围，以及传输协议

¨ 相关方法：该结构体的 Clone 和 delete 。

u GF_RTSPCommand;

大量 char* 及其他类型变量定义 RTSP 内置属性（ interleaved ）。

Char* 型的 body of the command 、 control string 、 userdata

Char* servicenane;//full URL of the command

相关方法：

¨ 该结构体的 new 、 del 以及 reset

u GF_RTPInfo

u GF_RTSPResponse

//response 反响，响应。

//response code

//header fields

//header extentions

//body

相关方法：

¨ 该对象 new 、 del 、 reset

u GF_RTSPSession

相关方法：

¨ new delete id port…

¨ GF_Err gf_rtsp_get_response(GF_RTSPSession *sess, GF_RTSPResponse *rsp);

/*Fetch an RTSP response from the server the GF_RTSPResponse will be reseted before fetch*/

return gf_rtsp_get_response(sess, rsp);

¨ 其他方法：发送命令、注册回调函数、注册 / 注销 interleaved 函数

¨ GF_RTSPSession *gf_rtsp_session_new_server(GF_Socket *rtsp_listener);

¨ GF_Err gf_rtsp_get_command(GF_RTSPSession *sess, GF_RTSPCommand *com);

u GF_RTPHeader

u GF_RTPMap

u GF_RTPChannel

相关方法：

¨ RTP/RTCP 的一些读写发送命令

¨ GF_Err gf_rtp_send_packet(GF_RTPChannel *ch, GF_RTPHeader *rtp_hdr, char *extra_header, u32 extra_header_size, char *pck, u32 pck_size);

/*send RTP packet*/

调用 gf_sk_send_to(…)

SDP 相关结构体以及方法：

u RTP Pakitizer(非常重要！！！！！)

¨ GF_Err gp_rtp_builder_process(GP_RTPPacketizer *builder, char *data, u32 data_size, u8 IsAUEnd, u32 FullAUSize, u32 duration, u8 descIndex)

gp_rtp_builder_do_mpeg4(builder, data, data_size, IsAUEnd, FullAUSize);

追踪至 isom_hinter.c 文件中的：第 00539 行止：

tmp->rtp_p = gp_rtp_builder_new(hintType, &my_sl, flags, tmp,

Ismacryp.h

u gf_ismacryp_encrypt_track

u gf_ismacryp_Decrypt_trach

其他方法：

Isomedia.h

结构体：

u GF_ISOSample （注意这个 sample 和 directshow 中的有什么关系）

相关方法：

¨ GF_ISOSample *gf_isom_sample_new();

¨ void gf_isom_sample_del(GF_ISOSample **samp);

enume 类型的诸多常量： FILE FORMAT CONSTANTS

GENERAL API FUNCTIONS：

¨ GF_ISOFile *gf_isom_open(const char *fileName, u8 OpenMode)

调用 e = gf_isom_datamap_new(fileName, NULL, GF_ISOM_DATA_MAP_READ_ONLY, &mov->movieFileMap);

STREAMING API FUNCTIONS：

/*open a movie that can be uncomplete in READ_ONLY mode

to use for http streaming & co

NOTE: you must buffer the data to a local file, this mode DOES NOT handle

http/ftp/... streaming

这很可能就是流媒体昭示如下几点：

1、流媒体的特性——下载部分就可以播放

2、远端流媒体下载后需要在本地 buffer ，是否就意味着 media map 的作用

3、破损或者不完全的媒体也能够被播放

¨ GF_Err gf_isom_open_progressive(const char *fileName, GF_ISOFile **the_file, u64 *BytesMissing);

调用了： e = gf_isom_datamap_new(fileName, NULL, GF_ISOM_DATA_MAP_READ, &movie->movieFileMap);

而后者调用了： *outDataMap = gf_isom_fdm_new_temp(parentPath);

¨ GF_ISOSample *gf_isom_get_sample(GF_ISOFile *the_file, u32 trackNumber, u32 sampleNumber, u32 *StreamDescriptionIndex);

/*return a sample given its number, and set the StreamDescIndex of this sample

this index allows to retrieve the stream description if needed (2 media in 1 track)

return NULL if error*/

依次调用：

trak = gf_isom_get_track_from_file(the_file, trackNumber);

e = Media_GetSample(trak->Media, sampleNumber, &samp, &descIndex, 0, NULL);

¨ GF_Err gf_isom_get_sample_for_media_time(GF_ISOFile *the_file, u32 trackNumber, u32 desiredTime, u32 *StreamDescriptionIndex, u8 SearchMode, GF_ISOSample **sample, u32 *SampleNum);

/*gets a sample given a desired decoding time IN MEDIA TIME SCALE

and set the StreamDescIndex of this sample

this index allows to retrieve the stream description if needed (2 media in 1 track)

return GF_EOS if the desired time exceeds the media duration

WARNING: the sample may not be sync even though the sync was requested (depends on the media and the editList)

the SampleNum is optional. If non-NULL, will contain the sampleNumber*/

依次调用：

trak = gf_isom_get_track_from_file(the_file, trackNumber);

e = findEntryForTime(stbl, desiredTime, 1, &sampleNumber, &prevSampleNumber);

e = Media_FindSyncSample(trak->Media->information->sampleTable,

sampleNumber, &syncNum, GF_ISOM_SEARCH_SYNC_BACKWARD);

// 多个分支，具体参数略有不同

¨ GF_Err gf_isom_get_sample_for_movie_time(GF_ISOFile *the_file, u32 trackNumber, u32 movieTime, u32 *StreamDescriptionIndex, u8 SearchMode, GF_ISOSample **sample, u32 *sampleNumber);

/*return a sample given a desired time in the movie. MovieTime is IN MEDIA TIME SCALE , handles edit list.

and set the StreamDescIndex of this sample

this index allows to retrieve the stream description if needed (2 media in 1 track)

sample must be set to NULL before calling.

result Sample is NULL if an error occured

if no sample is playing, an empty sample is returned with no data and a DTS set to MovieTime when serching in sync modes

if no sample is playing, the closest sample in the edit time-line is returned when serching in regular modes

WARNING: the sample may not be sync even though the sync was requested (depends on the media and the editList)

Note: this function will handle re-timestamping the sample according to the mapping of the media time-line

on the track time-line. The sample TSs (DTS / CTS offset) are expressed in MEDIA TIME SCALE

(to match the media stream TS resolution as indicated in media header / SLConfig)

sampleNumber is optional and gives the number of the sample in the media

递归调用如下函数，具体参数可能有所不同：

return gf_isom_get_sample_for_movie_time(the_file, trackNumber, (u32) mediaTime, StreamDescriptionIndex, GF_ISOM_SEARCH_SYNC_FORWARD, sample, sampleNumber);

或者调用：

e = gf_isom_get_sample_for_media_time(the_file, trackNumber, (u32) mediaTime, StreamDescriptionIndex, SearchMode, sample, &sampNum);

MPEG-4 Systems extensions

GENERIC HINTING WRITING API

¨ GF_Err gf_isom_setup_hint_track(GF_ISOFile *the_file, u32 trackNumber, u32 HintType);

调用了：

e = udta_AddBox(udta, gf_isom_box_new(GF_ISOM_BOX_TYPE_HNTI));

¨ GF_Err gf_isom_hint_sample_data(GF_ISOFile *the_file, u32 trackNumber, u32 SourceTrackID, u32 SampleNumber, u16 DataLength, u32 offsetInSample, char *extra_data, u8 AtBegin);

调用了：

return gf_isom_hint_pck_add_dte(entry->hint_sample->HintType, pck, (GF_GenericDTE *)dte, AtBegin);

¨ GF_Err gf_isom_hint_sample_description_data(GF_ISOFile *the_file, u32 trackNumber, u32 SourceTrackID, u32 StreamDescriptionIndex, u16 DataLength, u32 offsetInDescription, u8 AtBegin);

所调用函数同上

RTP SPECIFIC WRITING API

¨ GF_Err gf_isom_rtp_packet_begin(GF_ISOFile *the_file, u32 trackNumber, s32 relativeTime, u8 PackingBit, u8 eXtensionBit, u8 MarkerBit, u8 PayloadType, u8 B_frame, u8 IsRepeatedPacket, u16 SequenceNumber);

/*Creates a new RTP packet in the HintSample. If a previous packet was created,

it is stored in the hint sample and a new packet is created.

- relativeTime: RTP time offset of this packet in the HintSample if any - in hint track

time scale. Used for data smoothing by servers.

- PackingBit: the 'P' bit of the RTP packet header

- eXtensionBit: the'X' bit of the RTP packet header

- MarkerBit: the 'M' bit of the RTP packet header

- PayloadType: the payload type, on 7 bits, format 0x0XXXXXXX

- B_frame: indicates if this is a B-frame packet. Can be skipped by a server

- IsRepeatedPacket: indicates if this is a duplicate packet of a previous one.

Can be skipped by a server

- SequenceNumber: the RTP base sequence number of the packet. Because of support for repeated