Both POSIX, the Linux documentation and UNIX Network Programming volume 1
by Stephens state that NULL is accepted.

This avoid the following compiler message:

../../examples/player_example.c: In function ‘main’:
../../examples/player_example.c:839:22: warning: passing argument 2 to ‘restrict’-qualified parameter aliases with argument 4 [-Werror=restrict]
  839 |           n=select(n,&empty,&writefs,&empty,&timeout);
      |                      ^~~~~~          ~~~~~~
../../examples/player_example.c:843:18: warning: passing argument 2 to ‘restrict’-qualified parameter aliases with argument 4 [-Werror=restrict]
  843 |         select(n,&empty,&writefs,&empty,NULL);
      |                  ^~~~~~          ~~~~~~

Conform to local style, use shorter variable names, and add
some comments so the intent of the flow is more clear.

Also propagate the check to the transcoder example which
duplicates the same code.

Guido Günther authored 7 years ago and Ralph Giles committed 5 years ago

Abort on error from `vorbis_analysis_headerout`.

Signed-off-by: Ralph Giles <giles@thaumas.net>

Global pointers are initialized to zero in C, but not in C++.

Add an explicit initializer to reduce confusion and avoid
bugs when the example code is copied into C++ applications.

Based on a patch by Alex Houghton <houghton1411@aol.com>.

Patch by valtri.
https://trac.xiph.org/ticket/2032

svn path=/trunk/theora/; revision=19181

Correct Cb plane bug in conversion from RGB->YCbCr; the upper-right pixel was ignored by mistake and the upper-left pixel used twice.


svn path=/trunk/theora/; revision=19154

svn path=/trunk/theora/; revision=19094

svn path=/trunk/theora/; revision=19088

svn path=/trunk/theora/; revision=19087

svn path=/trunk/theora/; revision=19086

This allows it to be used from dump_video without having to disable
 striped decoding there.

svn path=/trunk/theora/; revision=18218

svn path=/trunk/theora/; revision=17995

It wrongly claimed the returned buffer was owned by libtheora, when
 in reality libtheora was creating a temporary buffer and not
 storing the pointer to the returned packet anywhere.
Since there's no encoder parameter passed to this function, it
 doesn't even have a place to store it.
This situation is sub-optimal, but can be solved by migrating to
 the 1.0 API, which does require an encoder instance to encode a
 comment, and thus does not have this problem.

Fixes #726.

svn path=/trunk/theora/; revision=17994

It's the only example that needs it.
Patch by 0brad0.
Fixes #1587.

svn path=/trunk/theora/; revision=17993

The final argument to TIFFReadRGBAImage is 'stopOnError'. That is,
if it's not true then the function will return success even if
loading the actual image data failed. As such, copying the example
code out of the documentation wasn't really what we wanted.

svn path=/trunk/theora/; revision=17856

This is a modified version of png2theora, using libtiff
instead of libpng to read a sequence of tiff image files
and convert them to an Ogg Theora video.

Originally added because the Sintel film project was
giving us tiff frames and waiting for conversion to
png before encoding was tedious. In fact, it nearly
took longer than creating this program.

svn path=/trunk/theora/; revision=17844

svn path=/trunk/theora/; revision=17843

This is helpful for casual benchmarking and performance comparision.
We use the very portable time.h clock() call and the beginning and
end of the main function and calculate the average rate in millions
of pixels per second and fraction of realtime. Unfortunately clock()
isn't accurate enough to be useful for per-frame statistics.

svn path=/trunk/theora/; revision=17820

This example program allocates a minimal encoder context so
it can query settings through th_encode_ctl(). As of r17760
setting the framerate to a non-zero/zero value is required.

svn path=/trunk/theora/; revision=17761

The specification says that the frame rate numerator and
denominator MUST both be greater than zero. This wasn't
checked as part of the structure validation code, and in
fact passing a zero value here caused a segfault.

The code now checks for this in oc_state_init() and returns
TH_EINVAL, which is causes th_encode_alloc() and oc_decode_alloc()
to return NULL.

A check for that NULL return is also added to encoder_example.c
to show that it may fail when an invalid th_info parameter is
passed.

svn path=/trunk/theora/; revision=17760

I'd found these helpful for script debugging, but really it's
better for scripts to print their own version of this information.
The -q option should really mean no non-error output.

svn path=/trunk/theora/; revision=17744

This program shows how to query a few version-dependent library
paramenters, such as the vendor string and maximum speed level,
and prints a summary to stdout in 'header: value' format.

I mostly wanted this as a utility to get the maximum speed level
for benchmark scripts, but thought it structuring it as an example
was better than stuffing it in tools.

It would be reasonable to extend this to return decoder parameters
like the maximum preprocessing level.

svn path=/trunk/theora/; revision=17709

svn path=/trunk/theora/; revision=17708

svn path=/trunk/theora/; revision=17707

This makes it a little nice to call from a batch job with parallel
executation. The messages indentifying the input file parameters
and error messages are still printed.

svn path=/trunk/theora/; revision=17660

Thanks to Basil Gohar for pointing this out.

svn path=/trunk/theora/; revision=17632

svn path=/trunk/theora/; revision=17495

svn path=/trunk/theora/; revision=17494

This will be the basis of the 1.2.x releases.

svn path=/trunk/theora/; revision=17445