1 /* 2 * Copyright 2015 Rockchip Electronics Co. LTD 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef __MPP_PACKET_H__ 18 #define __MPP_PACKET_H__ 19 20 #include "mpp_meta.h" 21 22 #ifdef __cplusplus 23 extern "C" { 24 #endif 25 26 /* 27 * MppPacket interface 28 * 29 * mpp_packet_init = mpp_packet_new + mpp_packet_set_data + mpp_packet_set_size 30 * mpp_packet_copy_init = mpp_packet_init + memcpy 31 */ 32 MPP_RET mpp_packet_new(MppPacket *packet); 33 MPP_RET mpp_packet_init(MppPacket *packet, void *data, size_t size); 34 MPP_RET mpp_packet_init_with_buffer(MppPacket *packet, MppBuffer buffer); 35 MPP_RET mpp_packet_copy_init(MppPacket *packet, const MppPacket src); 36 MPP_RET mpp_packet_deinit(MppPacket *packet); 37 38 /* 39 * data : ( R/W ) start address of the whole packet memory 40 * size : ( R/W ) total size of the whole packet memory 41 * pos : ( R/W ) current access position of the whole packet memory, used for buffer read/write 42 * length : ( R/W ) the rest length from current position to end of buffer 43 * NOTE: normally length is updated only by set_pos, 44 * so set length must be used carefully for special usage 45 */ 46 void mpp_packet_set_data(MppPacket packet, void *data); 47 void mpp_packet_set_size(MppPacket packet, size_t size); 48 void mpp_packet_set_pos(MppPacket packet, void *pos); 49 void mpp_packet_set_length(MppPacket packet, size_t size); 50 51 void* mpp_packet_get_data(const MppPacket packet); 52 void* mpp_packet_get_pos(const MppPacket packet); 53 size_t mpp_packet_get_size(const MppPacket packet); 54 size_t mpp_packet_get_length(const MppPacket packet); 55 56 57 void mpp_packet_set_pts(MppPacket packet, RK_S64 pts); 58 RK_S64 mpp_packet_get_pts(const MppPacket packet); 59 void mpp_packet_set_dts(MppPacket packet, RK_S64 dts); 60 RK_S64 mpp_packet_get_dts(const MppPacket packet); 61 62 void mpp_packet_set_flag(MppPacket packet, RK_U32 flag); 63 RK_U32 mpp_packet_get_flag(const MppPacket packet); 64 65 MPP_RET mpp_packet_set_eos(MppPacket packet); 66 MPP_RET mpp_packet_clr_eos(MppPacket packet); 67 RK_U32 mpp_packet_get_eos(MppPacket packet); 68 MPP_RET mpp_packet_set_extra_data(MppPacket packet); 69 70 void mpp_packet_set_buffer(MppPacket packet, MppBuffer buffer); 71 MppBuffer mpp_packet_get_buffer(const MppPacket packet); 72 73 /* 74 * data access interface 75 */ 76 MPP_RET mpp_packet_read(MppPacket packet, size_t offset, void *data, size_t size); 77 MPP_RET mpp_packet_write(MppPacket packet, size_t offset, void *data, size_t size); 78 79 /* 80 * meta data access interface 81 */ 82 RK_S32 mpp_packet_has_meta(const MppPacket packet); 83 MppMeta mpp_packet_get_meta(const MppPacket packet); 84 85 /* 86 * multi packet sequence interface for slice/split encoding/decoding 87 * partition - the packet is a part of a while image 88 * soi - Start Of Image 89 * eoi - End Of Image 90 */ 91 RK_U32 mpp_packet_is_partition(const MppPacket packet); 92 RK_U32 mpp_packet_is_soi(const MppPacket packet); 93 RK_U32 mpp_packet_is_eoi(const MppPacket packet); 94 95 /* 96 * packet segement pack info for 97 * segment number - number of segment 98 * segment info - base address of segment info 99 */ 100 typedef struct MppPktSeg_t MppPktSeg; 101 102 struct MppPktSeg_t { 103 RK_S32 index; 104 RK_S32 type; 105 RK_U32 offset; 106 RK_U32 len; 107 const MppPktSeg *next; 108 }; 109 110 RK_U32 mpp_packet_get_segment_nb(const MppPacket packet); 111 const MppPktSeg *mpp_packet_get_segment_info(const MppPacket packet); 112 113 #ifdef __cplusplus 114 } 115 #endif 116 117 #endif /*__MPP_PACKET_H__*/ 118