Ogg: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
Line 3: Line 3:
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]]<br/>
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]]<br/>
'''Available since:''' Gideros 2017.10<br/>
'''Available since:''' Gideros 2017.10<br/>
'''TODO: rename this wiki page to Theora?'''


=== Description ===
=== Description ===
Line 18: Line 20:
</syntaxhighlight>
</syntaxhighlight>


=== Example ===
=== Examples ===
'''Recording your mic and camera to an .ogg video file'''
'''Recording your mic and camera to an .ogg video file'''
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 81: Line 83:
f:close()
f:close()
print("Ended",#ct)  
print("Ended",#ct)  
end)
</syntaxhighlight>
'''Example 2'''
<syntaxhighlight lang="lua">
local theora = require "theora.core"
require "microphone"
local texw, texh = 120*16, 68*16
local tex = RenderTarget.new(texw, texh)
local dot = Pixel.new(0xFF0000, 16, 16)
dot:setAnchorPoint(.5,.5)
local microphone = Microphone.new(8000, 1, 16)
microphone:setOutputFile("|D|test.ogg")
Core.asyncCall(function()
microphone:start()
theora.beginVideo(microphone:getStreamId(),"theora",30,texw,texh,3,0.6)
for i = 1, 360, 2 do
tex:clear(0x303030)
tex:draw(dot, math.cos(^<i)*texh*.4+texw/2, math.sin(^<i)*texh*.4+texh/2)
theora.encodeVideoFrame(microphone:getStreamId(), (i-1), tex, (i==360))
end
microphone:stop()
print("Finished")
end)
end)
</syntaxhighlight>
</syntaxhighlight>

Revision as of 22:09, 11 October 2026

Supported platforms:
Available since: Gideros 2017.10

TODO: rename this wiki page to Theora?

Description

Adds support for Ogg audio and video (Theora).

There are two ways to use the Ogg plugin:

  • to read Ogg files use:
local theora = require "Theora"
  • to encode/decode Ogg files use:
-- Theora system
local theora = require "theora.core"

Examples

Recording your mic and camera to an .ogg video file

-- Microphone plugin, for recording in gideros
require "microphone"
-- Camera plugin, to get images from
require "camera"
-- Theora system (from ogg plugin)
local theora = require "theora.core"

--Locate available cameras
lst=Camera.availableDevices()
for k,cam in ipairs(lst) do
	print("#"..k.." Desc:"..cam.description.." Pos:"..cam.position.." Dev:"..cam.name)
end
-- Pick the first available
local cname=lst[1].name

cw,ch=640,480
--Theora needs full 16x16 blocks
ch=(ch+15)&~15
cw=(cw+15)&~15
--Create texture and start camera
Camera.texture=RenderTarget.new(cw,ch)
Camera.start(Camera.texture,cname)

--Set our stage size
application:setLogicalDimensions(cw,ch)
--Show our live video
local b=Bitmap.new(Camera.texture)
stage:addChild(b)

--Prepare for recording
local mic=Microphone.new("",24000,2,16)
mic:setOutputFile("|T|mic.ogg")

--Launch recording process
Core.asyncCall(function()
	--Wait a frame and disable auto yield
	Core.yield(true)
	--Start recording and get recording stream id
	mic:start()
	local id=mic:getStreamId()
	--Encode video header immediately, before audio data gets encoded
	--Parameters are:
	-- stream id, codec name, frame rate, image width, image height,
	-- image format (use 3 for now, nothing else is supported), image quality
	theora.beginVideo(id,"theora",30,cw,ch,3,0.6)
	-- Now encode 120 video frames, every other gideros frame (60fps->30fps)
	for i=1,120 do
		--Parameters:
		-- stream id, frame id (zero based), image texture, end of stream indicator
		theora.encodeVideoFrame(id,(i-1),Camera.texture,(i==120))
		Core.yield(true)
		Core.yield(true)
	end
	-- Stop recording
	mic:stop()
	-- For testing, read encoded file and print its size
	local f=io.open("|T|mic.ogg","rb")
	local ct=f:read("*all")
	f:close()
	print("Ended",#ct) 
end)

Example 2

local theora = require "theora.core"
require "microphone"
 
local texw, texh = 120*16, 68*16
local tex = RenderTarget.new(texw, texh)
local dot = Pixel.new(0xFF0000, 16, 16)
dot:setAnchorPoint(.5,.5)

local microphone = Microphone.new(8000, 1, 16)
microphone:setOutputFile("|D|test.ogg")

Core.asyncCall(function()
	microphone:start()
	theora.beginVideo(microphone:getStreamId(),"theora",30,texw,texh,3,0.6)

	for i = 1, 360, 2 do
		tex:clear(0x303030)
		tex:draw(dot, math.cos(^<i)*texh*.4+texw/2, math.sin(^<i)*texh*.4+texh/2)
		theora.encodeVideoFrame(microphone:getStreamId(), (i-1), tex, (i==360))
	end

	microphone:stop()
	print("Finished")

end)

Methods

Theora.new creates a new Ogg/Theora object
Theora:getVideo reads video from an Ogg/Theora stream object
Theora:play creates a new Ogg/Theora stream object

Events

Constants