Class SoMPEGRenderer
- java.lang.Object
-
- com.openinventor.inventor.Inventor
-
- com.openinventor.inventor.mpeg.SoMPEGRenderer
-
- Direct Known Subclasses:
SoMPEGFrameRenderer
,SoMPEGNavRenderer
public class SoMPEGRenderer extends Inventor
Base class for generating MPEG output from a scene graph. This class is the base class for creating MPEG video output from a scene graph. Two specialized classesSoMPEGFrameRenderer
andSoMPEGNavRenderer
are provided to give applications more control over video generation.Warning : Writing in multiple streams at the same time is not possible.
This class is used by the viewer classes to record MPEG video (see for example the
SoWinRenderArea
method setMPEGRecorder ). The default right-mouse popup menu in the viewer classes provides an option to display a video recording dialog box. This dialog allows the user to conveniently start and stop recording the scene in the viewer window.The
setShareContext
method allows you to share an existing OpenGL context with the MPEG renderer. This avoids the necessity to re-generate textures and display lists if they are already available in another OpenGL context (the viewer context, for instance). This can dramatically reduce offscreen rendering time, depending on your scene graph.Here's how you might use these methods to share OpenGL contexts:
SoMPEGRenderer renderer = new SoMPEGRenderer(); renderer.setShareContext( viewer.getArea().getGLSharedContext() ); openFile
is called before the end of this task, two scenarios can occur. If the filename is the same file as the one currently in use by the encoding task, this task is stopped. The behavior is the same ifrecord
is called afterstop
. If the filename is different, the file is not opened and encoding continues.It is important to note that the MPEGRenderer can only generate raw MPEG-1 video streams. In order for the generated video to be played correctly by any video player, it needs to be embedded into a container. This operation can be easily performed by the multimedia tool
FFmpeg . For example, the following command allows you to embed the generated raw video stream into an MP4 container format:ffmpeg -i input_raw_stream.mpg -codec copy output_video.mp4 The -codec copy argument is important because it allows ffmpeg to only copy the input stream inside the container instead of doing a real re-encoding.
Different container formats can also be used, like AVI or MKV.
- See Also:
SoMPEGNavRenderer
,SoMPEGFrameRenderer
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SoMPEGRenderer.Components
Components.-
Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand
-
-
Field Summary
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoMPEGRenderer()
Constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addFrame(byte[] frame)
Low level method to add a new frame to the MPEG output from a buffer of unsigned characters.void
closeFile()
Closes the MPEG file previously opened with theopenFile()
method.SbColor
getBackgroundColor()
Gets the background color for rendering each frame.SoMPEGRenderer.Components
getComponents()
Returns the number of color components of the frames recorded.float
getCompressionRate()
Returns the compression rate.SoGLRenderAction
getGLRenderAction()
Gets the GL Render action used to generate each frame.int
getNumFramesPerSecond()
Gets the number of frames per second to be encoded in the MPEG output.SoNode
getSceneGraph()
Gets the scene graph used for generating frames in the MPEG output.SbGLShareContext
getShareContext()
Gets the OpenGL context shared by this object.SbVec2s
getSize()
Gets the frame pixel size.boolean
isRecording()
Returns true if this renderer is recording.boolean
isViewerIdle()
boolean
openFile(java.lang.String filename)
Calls openFile(filename, (int)10000).boolean
openFile(java.lang.String filename, int numFrames)
Specifies the MPEG output file name.void
pause()
Pauses the recording.void
record()
Starts the recording.void
setBackgroundColor(SbColor c)
Sets the background color for rendering each frame.void
setBitPerSec(float mbps)
This method allows the user to specify a fixed bit rate.void
setComponents(SoMPEGRenderer.Components components)
Set the number of color components of the frames recorded.void
setCompressionRate(float value)
Compression rate of the MPEG output.void
setGLRenderAction(SoGLRenderAction ra)
Sets the GL Render action used to generate each frame.void
setNumFramesPerSecond(float num)
Sets the number of frames per second encoded in the MPEG output.void
setSceneGraph(SoNode node)
Sets the scene graph used for generating frames in the MPEG output.void
setShareContext(SbGLShareContext shareCxt)
Sets the OpenGL context to be shared by theSoMPEGRenderer
.void
setSize(SbVec2s size)
Sets the frame pixel size.void
setViewerIsIdle(boolean isIdle)
Tells the recorder that the viewer is idle.void
stop()
Stops the recording and closes the opened file.-
Methods inherited from class com.openinventor.inventor.Inventor
dispose, getNativeResourceHandle
-
-
-
-
Method Detail
-
openFile
public boolean openFile(java.lang.String filename)
Calls openFile(filename, (int)10000).
-
isRecording
public boolean isRecording()
Returns true if this renderer is recording.
-
pause
public void pause()
Pauses the recording.
-
stop
public void stop()
Stops the recording and closes the opened file.
-
closeFile
public void closeFile()
Closes the MPEG file previously opened with theopenFile()
method.
-
getCompressionRate
public float getCompressionRate()
Returns the compression rate.
-
isViewerIdle
public boolean isViewerIdle()
-
setViewerIsIdle
public void setViewerIsIdle(boolean isIdle)
Tells the recorder that the viewer is idle.
-
openFile
public boolean openFile(java.lang.String filename, int numFrames)
Specifies the MPEG output file name. numFrames gives an estimate of the number of frames that the MPEG output will contain.If filename is the same as the one currently in use by the encoding task (if there is one), the encoding task is stopped. If the filename is different, the file is not opened and the current encoding task continues.
Returns false if the file cannot be opened, true otherwise.
-
setNumFramesPerSecond
public void setNumFramesPerSecond(float num)
Sets the number of frames per second encoded in the MPEG output. It has nothing to do with the speed of playback. The default value is 30.NOTE: This method must be called before
openFile
or setFilePointer in order to have an effect. Calling it after callingopenFile
or setFilePointer may cause undesirable results.
-
setBackgroundColor
public void setBackgroundColor(SbColor c)
Sets the background color for rendering each frame. The default background color is 0 0 0 (black).The default value can be set using the environment variable OIV_BACKGROUND_COLOR. Specify three floats (R, G, B) in the range 0. to 1., separated by spaces.
-
getNumFramesPerSecond
public int getNumFramesPerSecond()
Gets the number of frames per second to be encoded in the MPEG output.
-
getSceneGraph
public SoNode getSceneGraph()
Gets the scene graph used for generating frames in the MPEG output.
-
setBitPerSec
public void setBitPerSec(float mbps)
This method allows the user to specify a fixed bit rate. This is useful when the MPEG output is to be put on a video CD, for example. If you do not know what this rate means, you can use the default value (-1) which indicates that the bit rate is variable. The standards bit rates for VCD are 1205862 bps and 2726300 bps. (It is the speed the MPEG stream is read by VCD players)The default value is 1205862. The maximum value is 104857600. NOTE: This method must be called before
openFile
or setFilePointer in order to have an effect. Calling it after callingopenFile
or setFilePointer may cause undesirable results.
-
getGLRenderAction
public SoGLRenderAction getGLRenderAction()
Gets the GL Render action used to generate each frame.
-
setCompressionRate
public void setCompressionRate(float value)
Compression rate of the MPEG output. Values are between 0 and 1. 0=no compression, 1=maximum compression.The default value is 0.3.
NOTE: This method must be called before
openFile
or setFilePointer in order to have an effect. Calling it after callingopenFile
or setFilePointer may cause undesirable results.
-
getBackgroundColor
public SbColor getBackgroundColor()
Gets the background color for rendering each frame.
-
setGLRenderAction
public void setGLRenderAction(SoGLRenderAction ra)
Sets the GL Render action used to generate each frame. If no render action is specified, an internal instance of anSoGLRenderAction
will be maintained with a viewport region set to the size given with the methodsetSize()
.
-
getSize
public SbVec2s getSize()
Gets the frame pixel size. These values may be different from those given by thesetSize()
method.
-
getShareContext
public SbGLShareContext getShareContext()
Gets the OpenGL context shared by this object.
-
setSize
public void setSize(SbVec2s size)
Sets the frame pixel size. The width and height of the frame must be a multiple of 16. If they are not, they are reduced to the next lower multiple of 16.By default, width and height values are 96.
NOTE: This method must be called before
openFile
or setFilePointer in order to have an effect. Calling it after callingopenFile
or setFilePointer may cause undesirable results.
-
record
public void record()
Starts the recording. If called directly afterstop
method, the current encoding task (if one) is stopped.Note: A file must have been opened or a file pointer set.
-
setComponents
public void setComponents(SoMPEGRenderer.Components components)
Set the number of color components of the frames recorded.
-
addFrame
public void addFrame(byte[] frame)
Low level method to add a new frame to the MPEG output from a buffer of unsigned characters. Each pixel is stored sequentially by scanline, starting with the lower left corner. The data stored for each pixel is determined by the components set before rendering (3 by default). Pixels are stored in RGBA order and are packed without any padding between pixels or scanlines.
-
setSceneGraph
public void setSceneGraph(SoNode node)
Sets the scene graph used for generating frames in the MPEG output.
-
setShareContext
public void setShareContext(SbGLShareContext shareCxt)
Sets the OpenGL context to be shared by theSoMPEGRenderer
. Its use is strongly recommended, because it can improve performance when switching between on-screen and off-screen rendering. This is because it allows the display lists and texture objects to be shared between the on-screen and off-screen render context. The shared context info is normally obtained by calling the viewer's getShareContext method.NOTE: It has no effect when the hardware (or driver) does not allow sharing with the off-screen context, for example if Pbuffers are not supported.
-
getComponents
public SoMPEGRenderer.Components getComponents()
Returns the number of color components of the frames recorded.
-
-