| OLD | NEW |
| 1 /* | 1 /* |
| 2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved. |
| 3 * | 3 * |
| 4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
| 5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
| 6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
| 7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
| 8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
| 9 */ | 9 */ |
| 10 | 10 |
| 11 #ifndef WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ | 11 #ifndef WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ |
| 12 #define WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ | 12 #define WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ |
| 13 | 13 |
| 14 #include <map> | 14 #include "webrtc/media/base/h264_profile_level_id.h" |
| 15 #include <string> | |
| 16 | 15 |
| 17 #include "webrtc/base/optional.h" | 16 // TODO(zhihuang): Delete this file once dependent applications switch to |
| 18 #include "webrtc/common_types.h" | 17 // including "webrtc/media/base/h264_profile_level_id.h" directly. |
| 19 | |
| 20 namespace webrtc { | |
| 21 namespace H264 { | |
| 22 | |
| 23 // Map containting SDP codec parameters. | |
| 24 typedef std::map<std::string, std::string> CodecParameterMap; | |
| 25 | |
| 26 // All values are equal to ten times the level number, except level 1b which is | |
| 27 // special. | |
| 28 enum Level { | |
| 29 kLevel1_b = 0, | |
| 30 kLevel1 = 10, | |
| 31 kLevel1_1 = 11, | |
| 32 kLevel1_2 = 12, | |
| 33 kLevel1_3 = 13, | |
| 34 kLevel2 = 20, | |
| 35 kLevel2_1 = 21, | |
| 36 kLevel2_2 = 22, | |
| 37 kLevel3 = 30, | |
| 38 kLevel3_1 = 31, | |
| 39 kLevel3_2 = 32, | |
| 40 kLevel4 = 40, | |
| 41 kLevel4_1 = 41, | |
| 42 kLevel4_2 = 42, | |
| 43 kLevel5 = 50, | |
| 44 kLevel5_1 = 51, | |
| 45 kLevel5_2 = 52 | |
| 46 }; | |
| 47 | |
| 48 struct ProfileLevelId { | |
| 49 ProfileLevelId(Profile profile, Level level) | |
| 50 : profile(profile), level(level) {} | |
| 51 Profile profile; | |
| 52 Level level; | |
| 53 }; | |
| 54 | |
| 55 // Parse profile level id that is represented as a string of 3 hex bytes. | |
| 56 // Nothing will be returned if the string is not a recognized H264 | |
| 57 // profile level id. | |
| 58 rtc::Optional<ProfileLevelId> ParseProfileLevelId(const char* str); | |
| 59 | |
| 60 // Parse profile level id that is represented as a string of 3 hex bytes | |
| 61 // contained in an SDP key-value map. A default profile level id will be | |
| 62 // returned if the profile-level-id key is missing. Nothing will be returned if | |
| 63 // the key is present but the string is invalid. | |
| 64 rtc::Optional<ProfileLevelId> ParseSdpProfileLevelId( | |
| 65 const CodecParameterMap& params); | |
| 66 | |
| 67 // Given that a decoder supports up to a given frame size (in pixels) at up to a | |
| 68 // given number of frames per second, return the highest H.264 level where it | |
| 69 // can guarantee that it will be able to support all valid encoded streams that | |
| 70 // are within that level. | |
| 71 rtc::Optional<Level> SupportedLevel(int max_frame_pixel_count, float max_fps); | |
| 72 | |
| 73 // Returns canonical string representation as three hex bytes of the profile | |
| 74 // level id, or returns nothing for invalid profile level ids. | |
| 75 rtc::Optional<std::string> ProfileLevelIdToString( | |
| 76 const ProfileLevelId& profile_level_id); | |
| 77 | |
| 78 // Generate codec parameters that will be used as answer in an SDP negotiation | |
| 79 // based on local supported parameters and remote offered parameters. Both | |
| 80 // |local_supported_params|, |remote_offered_params|, and |answer_params| | |
| 81 // represent sendrecv media descriptions, i.e they are a mix of both encode and | |
| 82 // decode capabilities. In theory, when the profile in |local_supported_params| | |
| 83 // represent a strict superset of the profile in |remote_offered_params|, we | |
| 84 // could limit the profile in |answer_params| to the profile in | |
| 85 // |remote_offered_params|. However, to simplify the code, each supported H264 | |
| 86 // profile should be listed explicitly in the list of local supported codecs, | |
| 87 // even if they are redundant. Then each local codec in the list should be | |
| 88 // tested one at a time against the remote codec, and only when the profiles are | |
| 89 // equal should this function be called. Therefore, this function does not need | |
| 90 // to handle profile intersection, and the profile of |local_supported_params| | |
| 91 // and |remote_offered_params| must be equal before calling this function. The | |
| 92 // parameters that are used when negotiating are the level part of | |
| 93 // profile-level-id and level-asymmetry-allowed. | |
| 94 void GenerateProfileLevelIdForAnswer( | |
| 95 const CodecParameterMap& local_supported_params, | |
| 96 const CodecParameterMap& remote_offered_params, | |
| 97 CodecParameterMap* answer_params); | |
| 98 | |
| 99 } // namespace H264 | |
| 100 } // namespace webrtc | |
| 101 | 18 |
| 102 #endif // WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ | 19 #endif // WEBRTC_COMMON_VIDEO_H264_PROFILE_LEVEL_ID_H_ |
| OLD | NEW |