This is a port of Theora Library 1.1.1 to MSDOS/DJGPP.


Theora is Xiph.Org's first publicly released video codec, intended
for use within the Foundation's Ogg multimedia streaming system.
Theora is derived directly from On2's VP3 codec, adds new features
while allow it a longer useful lifetime as an competitive codec.
The code is publish under a BSD-style license.



DJGPP specific changes.
=======================

- The port does not support being compiled with assembler optimized
code.

- The port also does not support being compiled neither with OSS audio
support nor with SDL (Simple Direct media Layer).

- The reading/writing stream is switched into O_BINARY mode. If the
stream is connected to stdin/stdout/TTY, then Ctrl-C and Ctrl-Break
are re-enabled so the user can interrupt the program.

- Apart from those changes there are no other user visible ones. Only
some small changes have been done to get the library configured and
compiled.

- To build and use this port the latest DJGPP ports of libogg and
libvorbis:
http://ftp.delorie.com/pub/djgpp/current/v2tk/logg135b.zip
http://ftp.delorie.com/pub/djgpp/current/v2tk/lvbs137b.zip
must be installed.

- No one of the tests from the test suit shall fail.

- Because the name of the three libraries: libtheoradec, libtheoraenc
and libtheora map all to the same SFN, the original LFNs have been
renamed to SFNs like this:
libtheora -> libtheora
libtheoradec -> libthadec
libtheoraenc -> libthaenc
To avoid any inconveniences, a new version of libnames.tab with that
mapping has been included in this port. It is stored in the "djgpp"
directory and needs to be moved into the "lib" directory of the DJGPP
installation. With this new version of libnames.tab the linker will
know how to map the expected LFN to the corresponding SFN.

- To configure and compile this port at least the following version of
Bash, Make and pkg-config are required:
http://ftp.delorie.com/pub/djgpp/current/v2gnu/bsh4253b.zip
http://ftp.delorie.com/pub/djgpp/current/v2gnu/mak43br2.zip
http://ftp.delorie.com/pub/djgpp/current/v2tk/pkc023b.zip
No previous versions will work nor are supported. Any future version
should work.

- The port has been configured and compiled on WinXP SP3, Win98SE and
MSDOS 6.22 with DOSLFN v0.41f. There is no guarantee that this may
be possible with any other DOS-like OS. Due to the use of long file
names it will not be possible to configure and compile without LFN
support. The port has been compiled using gcc346 and bnu2351b.

As usual, all djgpp specific files (diffs, README files, etc.) are stored
in the "djgpp" directory. The sources have been configured to be build
in the "0build" directory. If for some reason it does not work for you,
delete its contents and configure from scratch again.

Please read the docs to become familiar with this product.


Here is an extract of the CHANGES file showing the user visible changes
from the last port (Theora Library 0.0.0) to this one:

-------------------------------------------------------------------------------

This is the first port. Read the documentation.


-------------------------------------------------------------------------------




The port consists of the usual two packages that have been produced using
djdev20X (CVS repository code) and can be downloaded from ftp.delorie.com
and mirrors as (time stamp 2022-10-23):


Theora Library 1.1.1 headers, library and html format documentation:
http://ftp.delorie.com/pub/djgpp/current/v2tk/ltha111b.zip

Theora Library 1.1.1 source:
http://ftp.delorie.com/pub/djgpp/current/v2tk/ltha111s.zip



Send Theora Library specific bug reports to
<https://lists.xiph.org/pipermail/theora-dev/>.
Send suggestions and bug reports concerning the DJGPP port
to comp.os.msdos.djgpp or <djgpp@delorie.com>.


Enjoy.

Guerrero, Juan Manuel <juan.guerrero@gmx.de>

--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)