| Index: libvpx/source/libvpx/examples/decode_with_partial_drops.txt
|
| diff --git a/libvpx/source/libvpx/examples/decode_with_partial_drops.txt b/libvpx/source/libvpx/examples/decode_with_partial_drops.txt
|
| deleted file mode 100644
|
| index 7b0d3d2ca8e1b1f9b9f03f901cfb367c6a830fe5..0000000000000000000000000000000000000000
|
| --- a/libvpx/source/libvpx/examples/decode_with_partial_drops.txt
|
| +++ /dev/null
|
| @@ -1,238 +0,0 @@
|
| -@TEMPLATE decoder_tmpl.c
|
| -Decode With Partial Drops Example
|
| -=========================
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTRODUCTION
|
| -This is an example utility which drops a series of frames (or parts of frames),
|
| -as specified on the command line. This is useful for observing the error
|
| -recovery features of the codec.
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTRODUCTION
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXTRA_INCLUDES
|
| -#include <time.h>
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXTRA_INCLUDES
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ HELPERS
|
| -struct parsed_header
|
| -{
|
| - char key_frame;
|
| - int version;
|
| - char show_frame;
|
| - int first_part_size;
|
| -};
|
| -
|
| -int next_packet(struct parsed_header* hdr, int pos, int length, int mtu)
|
| -{
|
| - int size = 0;
|
| - int remaining = length - pos;
|
| - /* Uncompressed part is 3 bytes for P frames and 10 bytes for I frames */
|
| - int uncomp_part_size = (hdr->key_frame ? 10 : 3);
|
| - /* number of bytes yet to send from header and the first partition */
|
| - int remainFirst = uncomp_part_size + hdr->first_part_size - pos;
|
| - if (remainFirst > 0)
|
| - {
|
| - if (remainFirst <= mtu)
|
| - {
|
| - size = remainFirst;
|
| - }
|
| - else
|
| - {
|
| - size = mtu;
|
| - }
|
| -
|
| - return size;
|
| - }
|
| -
|
| - /* second partition; just slot it up according to MTU */
|
| - if (remaining <= mtu)
|
| - {
|
| - size = remaining;
|
| - return size;
|
| - }
|
| - return mtu;
|
| -}
|
| -
|
| -void throw_packets(unsigned char* frame, int* size, int loss_rate,
|
| - int* thrown, int* kept)
|
| -{
|
| - unsigned char loss_frame[256*1024];
|
| - int pkg_size = 1;
|
| - int pos = 0;
|
| - int loss_pos = 0;
|
| - struct parsed_header hdr;
|
| - unsigned int tmp;
|
| - int mtu = 1500;
|
| -
|
| - if (*size < 3)
|
| - {
|
| - return;
|
| - }
|
| - putc('|', stdout);
|
| - /* parse uncompressed 3 bytes */
|
| - tmp = (frame[2] << 16) | (frame[1] << 8) | frame[0];
|
| - hdr.key_frame = !(tmp & 0x1); /* inverse logic */
|
| - hdr.version = (tmp >> 1) & 0x7;
|
| - hdr.show_frame = (tmp >> 4) & 0x1;
|
| - hdr.first_part_size = (tmp >> 5) & 0x7FFFF;
|
| -
|
| - /* don't drop key frames */
|
| - if (hdr.key_frame)
|
| - {
|
| - int i;
|
| - *kept = *size/mtu + ((*size % mtu > 0) ? 1 : 0); /* approximate */
|
| - for (i=0; i < *kept; i++)
|
| - putc('.', stdout);
|
| - return;
|
| - }
|
| -
|
| - while ((pkg_size = next_packet(&hdr, pos, *size, mtu)) > 0)
|
| - {
|
| - int loss_event = ((rand() + 1.0)/(RAND_MAX + 1.0) < loss_rate/100.0);
|
| - if (*thrown == 0 && !loss_event)
|
| - {
|
| - memcpy(loss_frame + loss_pos, frame + pos, pkg_size);
|
| - loss_pos += pkg_size;
|
| - (*kept)++;
|
| - putc('.', stdout);
|
| - }
|
| - else
|
| - {
|
| - (*thrown)++;
|
| - putc('X', stdout);
|
| - }
|
| - pos += pkg_size;
|
| - }
|
| - memcpy(frame, loss_frame, loss_pos);
|
| - memset(frame + loss_pos, 0, *size - loss_pos);
|
| - *size = loss_pos;
|
| -}
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ HELPERS
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DEC_INIT
|
| -/* Initialize codec */
|
| -flags = VPX_CODEC_USE_ERROR_CONCEALMENT;
|
| -res = vpx_codec_dec_init(&codec, interface, &dec_cfg, flags);
|
| -if(res)
|
| - die_codec(&codec, "Failed to initialize decoder");
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DEC_INIT
|
| -
|
| -Usage
|
| ------
|
| -This example adds a single argument to the `simple_decoder` example,
|
| -which specifies the range or pattern of frames to drop. The parameter is
|
| -parsed as follows:
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USAGE
|
| -if(argc < 4 || argc > 6)
|
| - die("Usage: %s <infile> <outfile> [-t <num threads>] <N-M|N/M|L,S>\n",
|
| - argv[0]);
|
| -{
|
| - char *nptr;
|
| - int arg_num = 3;
|
| - if (argc == 6 && strncmp(argv[arg_num++], "-t", 2) == 0)
|
| - dec_cfg.threads = strtol(argv[arg_num++], NULL, 0);
|
| - n = strtol(argv[arg_num], &nptr, 0);
|
| - mode = (*nptr == '\0' || *nptr == ',') ? 2 : (*nptr == '-') ? 1 : 0;
|
| -
|
| - m = strtol(nptr+1, NULL, 0);
|
| - if((!n && !m) || (*nptr != '-' && *nptr != '/' &&
|
| - *nptr != '\0' && *nptr != ','))
|
| - die("Couldn't parse pattern %s\n", argv[3]);
|
| -}
|
| -seed = (m > 0) ? m : (unsigned int)time(NULL);
|
| -srand(seed);thrown_frame = 0;
|
| -printf("Seed: %u\n", seed);
|
| -printf("Threads: %d\n", dec_cfg.threads);
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USAGE
|
| -
|
| -
|
| -Dropping A Range Of Frames
|
| ---------------------------
|
| -To drop a range of frames, specify the starting frame and the ending
|
| -frame to drop, separated by a dash. The following command will drop
|
| -frames 5 through 10 (base 1).
|
| -
|
| - $ ./decode_with_partial_drops in.ivf out.i420 5-10
|
| -
|
| -
|
| -Dropping A Pattern Of Frames
|
| -----------------------------
|
| -To drop a pattern of frames, specify the number of frames to drop and
|
| -the number of frames after which to repeat the pattern, separated by
|
| -a forward-slash. The following command will drop 3 of 7 frames.
|
| -Specifically, it will decode 4 frames, then drop 3 frames, and then
|
| -repeat.
|
| -
|
| - $ ./decode_with_partial_drops in.ivf out.i420 3/7
|
| -
|
| -Dropping Random Parts Of Frames
|
| --------------------------------
|
| -A third argument tuple is available to split the frame into 1500 bytes pieces
|
| -and randomly drop pieces rather than frames. The frame will be split at
|
| -partition boundaries where possible. The following example will seed the RNG
|
| -with the seed 123 and drop approximately 5% of the pieces. Pieces which
|
| -are depending on an already dropped piece will also be dropped.
|
| -
|
| - $ ./decode_with_partial_drops in.ivf out.i420 5,123
|
| -
|
| -
|
| -Extra Variables
|
| ----------------
|
| -This example maintains the pattern passed on the command line in the
|
| -`n`, `m`, and `is_range` variables:
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXTRA_VARS
|
| -int n, m, mode;
|
| -unsigned int seed;
|
| -int thrown=0, kept=0;
|
| -int thrown_frame=0, kept_frame=0;
|
| -vpx_codec_dec_cfg_t dec_cfg = {0};
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ EXTRA_VARS
|
| -
|
| -
|
| -Making The Drop Decision
|
| -------------------------
|
| -The example decides whether to drop the frame based on the current
|
| -frame number, immediately before decoding the frame.
|
| -
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PRE_DECODE
|
| -/* Decide whether to throw parts of the frame or the whole frame
|
| - depending on the drop mode */
|
| -thrown_frame = 0;
|
| -kept_frame = 0;
|
| -switch (mode)
|
| -{
|
| -case 0:
|
| - if (m - (frame_cnt-1)%m <= n)
|
| - {
|
| - frame_sz = 0;
|
| - }
|
| - break;
|
| -case 1:
|
| - if (frame_cnt >= n && frame_cnt <= m)
|
| - {
|
| - frame_sz = 0;
|
| - }
|
| - break;
|
| -case 2:
|
| - throw_packets(frame, &frame_sz, n, &thrown_frame, &kept_frame);
|
| - break;
|
| -default: break;
|
| -}
|
| -if (mode < 2)
|
| -{
|
| - if (frame_sz == 0)
|
| - {
|
| - putc('X', stdout);
|
| - thrown_frame++;
|
| - }
|
| - else
|
| - {
|
| - putc('.', stdout);
|
| - kept_frame++;
|
| - }
|
| -}
|
| -thrown += thrown_frame;
|
| -kept += kept_frame;
|
| -fflush(stdout);
|
| -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PRE_DECODE
|
|
|