Top | ![]() |
![]() |
![]() |
![]() |
CinnamonRecorder * | cinnamon_recorder_new () |
void | cinnamon_recorder_set_framerate () |
void | cinnamon_recorder_set_filename () |
void | cinnamon_recorder_set_pipeline () |
gboolean | cinnamon_recorder_record () |
void | cinnamon_recorder_close () |
void | cinnamon_recorder_pause () |
gboolean | cinnamon_recorder_is_recording () |
CinnamonRecorder *
cinnamon_recorder_new (ClutterStage *stage
);
Create a new CinnamonRecorder to record movies of a ClutterStage
void cinnamon_recorder_set_framerate (CinnamonRecorder *recorder
,int framerate
);
Sets the number of frames per second we configure for the GStreamer pipeline.
The default value is 15.
recorder |
the CinnamonRecorder |
|
framerate |
Framerate used for resulting video in frames-per-second. |
void cinnamon_recorder_set_filename (CinnamonRecorder *recorder
,const char *filename
);
Sets the filename that will be used when creating output files. This is only used if the configured pipeline has an unconnected source pad (as the default pipeline does). If the pipeline is complete, then the filename is unused. The provided string is used as a template.It can contain the following escapes:
d
: The current date as YYYYYMMDD
u
: A string added to make the filename unique.
'', 'a', 'b', ... 'aa', 'ab', ..
c
: A counter that is updated (opening a new file) each
time the recording stream is paused.
%%: A literal percent
The default value is 'cinnamon-d
u
-c
.ogg'.
recorder |
the CinnamonRecorder |
|
filename |
the filename template to use for output files,
or |
void cinnamon_recorder_set_pipeline (CinnamonRecorder *recorder
,const char *pipeline
);
Sets the GStreamer pipeline used to encode recordings.
It follows the syntax used for gst-launch. The pipeline
should have an unconnected sink pad where the recorded
video is recorded. It will normally have a unconnected
source pad; output from that pad will be written into the
output file. (See cinnamon_recorder_set_filename()
.) However
the pipeline can also take care of its own output - this
might be used to send the output to an icecast server
via shout2send or similar.
The default value is 'vp8enc min_quantizer=13 max_quantizer=13 cpu-used=5 deadline=1000000 threads=T
! queue ! webmmux'
recorder |
the CinnamonRecorder |
|
pipeline |
the GStreamer pipeline used to encode recordings
or |
[allow-none] |
gboolean
cinnamon_recorder_record (CinnamonRecorder *recorder
);
Starts recording, or continues a recording that was previously paused. Starting the recording may fail if the output file cannot be opened, or if the output stream cannot be created for other reasons. In that case a warning is printed to stderr. There is no way currently to get details on how recording failed to start.
An extra reference count is added to the recorder if recording is successfully started; the recording object will not be freed until recording is stopped even if the creator no longer holds a reference. Recording is automatically stopped if the stage is destroyed.
void
cinnamon_recorder_close (CinnamonRecorder *recorder
);
Stops recording. It's possible to call cinnamon_recorder_record()
again to reopen a new recording stream, but unless change the
recording filename, this may result in the old recording being
overwritten.
void
cinnamon_recorder_pause (CinnamonRecorder *recorder
);
Temporarily stop recording. If the specified filename includes
the c
escape, then the stream is closed and a new stream with
an incremented counter will be created. Otherwise the stream
is paused and will be continued when cinnamon_recorder_record()
is next called.
gboolean
cinnamon_recorder_is_recording (CinnamonRecorder *recorder
);
Determine if recording is currently in progress. (The recorder is not paused or closed.)
“filename”
property“filename” gchar *
The filename template to use for output files.
Flags: Read / Write
Default value: NULL
“framerate”
property“framerate” gint
Framerate used for resulting video in frames-per-second.
Flags: Read / Write
Allowed values: >= 0
Default value: 15
“pipeline”
property“pipeline” gchar *
GStreamer pipeline description to encode recordings.
Flags: Read / Write
Default value: NULL