Changes between Version 4 and Version 5 of RelNotes-2.0_GDS

Timestamp:

May 22, 2012 5:47:39 AM (12 years ago)

Author:

nanang

Comment:

--

RelNotes-2.0_GDS

@@ -1 @@
-=== General Data Structure starting with 2.0 ===
+=== General Data Structure changes in 2.0 ===
 
 ==== Media Format ====
-
-Defined as all information needed to completely describe a media:
+ - [http://www.pjsip.org/docs/latest/pjmedia/docs/html/structpjmedia__format.htm pjmedia_format] — Defined as all information needed to completely describe a media, which containing:
+   - Format ID — Specifies the audio sample or video pixel format. Enumeration of some well known formats IDs is defined in [http://www.pjsip.org/docs/latest/pjmedia/docs/html/group__PJMEDIA__FORMAT.htm#ga7a0830cb291693cabb364a3403777bda pjmedia_format_id].
+   - Media type — The top-most type of the media, as an information.
+   - Format detail — Detail section to describe the media. As the details are different among media types, this field is declared as union and [http://www.pjsip.org/docs/latest/pjmedia/docs/html/group__PJMEDIA__FORMAT.htm#ga3272e8f9dc6d369dc9fe5dcb67408fc5 pjmedia_format_detail_type] is introduced to recognize the content. Currently there are two predefined structures:
+     - [http://www.pjsip.org/docs/latest/pjmedia/docs/html/structpjmedia__audio__format__detail.htm pjmedia_audio_format_detail] for audio format detail
+     - [http://www.pjsip.org/docs/latest/pjmedia/docs/html/structpjmedia__video__format__detail.htm pjmedia_video_format_detail] for video format detail.
+
+ - Video format helper:
+   - [http://www.pjsip.org/docs/latest/pjmedia/docs/html/structpjmedia__video__format__info.htm pjmedia_video_format_info] — Information to describe a raw video format, such as RGB/YUV color model, number of bits per pixel, planar/packed data representation, and pointer to function to get ''real-time'' information of a raw video format (such as buffer size needed for a picture, byte size of a picture line, pointer and buffer size of each plane).
+   - [http://www.pjsip.org/docs/latest/pjmedia/docs/html/structpjmedia__video__apply__fmt__param.htm pjmedia_video_apply_fmt_param] — Information to apply a raw video format against size and buffer information, and get additional information from it. To do that, application fills up the input fields of this structure, and give this structure to {{{apply_fmt()}}} function of {{{pjmedia_video_format_info}}} structure.
+
+
 {{{
 /**