[Theora-dev] theora-exp namespacing
giles at xiph.org
Tue Mar 28 17:45:11 PST 2006
There was a discussion on IRC yesterday about cleaning up Derf's
theora-exp implementation so it can be used in frameworks that
also link to libtheora. The encoder doesn't work at the moment,
but the decoder is faster and implements more of the spec than
libtheora, so this would be a useful option for people trying
to deploy players.
The main thing that needs to be done is to namespace everything
separately. Currently there's some overlap, in part because we'd
intended to converge the APIs before the 1.0 release. I now think
that libtheora 1.0 should keep backward compatibility with the late
alpha API since it's so widely deployed, so that's not going to happen.
There was some discussion of what to use for a prefix. I suggest th_*
or symbols, TH_* for defines, and possibly retaining oc_ and OC_* for
internal names. Better suggestions welcome.
The other part is having separate names for the library binaries. This
had already been done, with the code split into libtheoradec,
libtheoraenc, and libtheorabase for shared and utility routines.
However, I've now merged libtheorabase into libtheoradec, so you only
have to link to one library to get a working decoder. Encoders now link
to libtheoraenc and libtheoradec instead of *enc and *base as before.
So in analog to tremor, you -ltheoradec instead of -ltheora now. :)
More information about the Theora-dev