Add initial video playback support for Ogg Theora videos (resolves issue #66.)

The basic APIs are:

video = love.graphics.newVideo("myvideo.ogv")

love.graphics.draw(video, ...) -- Video objects are Drawables.

video:play(), video:pause()

video:getDuration(), video:tell(), video:rewind(), video:seek(seconds)

video:getSource()

video:getWidth(), video:getHeight(), video:setFilter(min, mag)

More advanced APIs include video:setSource(source), video:getStream(), and videostream:setSync.

To use a custom pixel shader when drawing a Video, call the new TexelVideo(texcoords) function instead of Texel(texture, texcoords) in order to get the pixel colors of a video frame.

src/modules/graphics/opengl/wrap_Video.cpp

@@ -0,0 +1,157 @@
+/**
+ * Copyright (c) 2006-2015 LOVE Development Team
+ *
+ * This software is provided 'as-is', without any express or implied
+ * warranty.  In no event will the authors be held liable for any damages
+ * arising from the use of this software.
+ *
+ * Permission is granted to anyone to use this software for any purpose,
+ * including commercial applications, and to alter it and redistribute it
+ * freely, subject to the following restrictions:
+ *
+ * 1. The origin of this software must not be misrepresented; you must not
+ *    claim that you wrote the original software. If you use this software
+ *    in a product, an acknowledgment in the product documentation would be
+ *    appreciated but is not required.
+ * 2. Altered source versions must be plainly marked as such, and must not be
+ *    misrepresented as being the original software.
+ * 3. This notice may not be removed or altered from any source distribution.
+ **/
+
+#include "wrap_Video.h"
+
+// Shove the wrap_Video.lua code directly into a raw string literal.
+static const char video_lua[] =
+#include "wrap_Video.lua"
+;
+
+namespace love
+{
+namespace graphics
+{
+namespace opengl
+{
+
+Video *luax_checkvideo(lua_State *L, int idx)
+{
+	return luax_checktype<Video>(L, idx, GRAPHICS_VIDEO_ID);
+}
+
+int w_Video_getStream(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	luax_pushtype(L, VIDEO_VIDEO_STREAM_ID, video->getStream());
+	return 1;
+}
+
+int w_Video_getSource(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	auto source = video->getSource();
+	if (source)
+		luax_pushtype(L, AUDIO_SOURCE_ID, video->getSource());
+	else
+		lua_pushnil(L);
+	return 1;
+}
+
+int w_Video_setSource(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	if (lua_isnoneornil(L, 2))
+		video->setSource(nullptr);
+	else
+	{
+		auto source = luax_checktype<love::audio::Source>(L, 2, AUDIO_SOURCE_ID);
+		video->setSource(source);
+	}
+	return 0;
+}
+
+int w_Video_getWidth(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	lua_pushnumber(L, video->getWidth());
+	return 1;
+}
+
+int w_Video_getHeight(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	lua_pushnumber(L, video->getHeight());
+	return 1;
+}
+
+int w_Video_getDimensions(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	lua_pushnumber(L, video->getWidth());
+	lua_pushnumber(L, video->getHeight());
+	return 2;
+}
+
+int w_Video_setFilter(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	Texture::Filter f = video->getFilter();
+
+	const char *minstr = luaL_checkstring(L, 2);
+	const char *magstr = luaL_optstring(L, 3, minstr);
+
+	if (!Texture::getConstant(minstr, f.min))
+		return luaL_error(L, "Invalid filter mode: %s", minstr);
+	if (!Texture::getConstant(magstr, f.mag))
+		return luaL_error(L, "Invalid filter mode: %s", magstr);
+
+	f.anisotropy = (float) luaL_optnumber(L, 4, 1.0);
+
+	luax_catchexcept(L, [&](){ video->setFilter(f); });
+	return 0;
+}
+
+int w_Video_getFilter(lua_State *L)
+{
+	Video *video = luax_checkvideo(L, 1);
+	const Texture::Filter f = video->getFilter();
+
+	const char *minstr = nullptr;
+	const char *magstr = nullptr;
+
+	if (!Texture::getConstant(f.min, minstr))
+		return luaL_error(L, "Unknown filter mode.");
+	if (!Texture::getConstant(f.mag, magstr))
+		return luaL_error(L, "Unknown filter mode.");
+
+	lua_pushstring(L, minstr);
+	lua_pushstring(L, magstr);
+	lua_pushnumber(L, f.anisotropy);
+	return 3;
+}
+
+static const luaL_Reg functions[] =
+{
+	{ "getStream", w_Video_getStream },
+	{ "getSource", w_Video_getSource },
+	{ "_setSource", w_Video_setSource },
+	{ "getWidth", w_Video_getWidth },
+	{ "getHeight", w_Video_getHeight },
+	{ "getDimensions", w_Video_getDimensions },
+	{ "setFilter", w_Video_setFilter },
+	{ "getFilter", w_Video_getFilter },
+	{ 0, 0 }
+};
+
+int luaopen_video(lua_State *L)
+{
+	int ret = luax_register_type(L, GRAPHICS_VIDEO_ID, "Video", functions, nullptr);
+
+	luaL_loadbuffer(L, video_lua, sizeof(video_lua), "Video.lua");
+	luax_gettypemetatable(L, GRAPHICS_VIDEO_ID);
+	lua_call(L, 1, 0);
+
+	return ret;
+}
+
+} // opengl
+} // graphics
+} // love