Disclaimer
This software is still in very early stages of development, so don't expect
much. It's also unstable, and experimental, and might trash your system
and/or data. Use at your own risk.
Other than that, you should have some understanding of programming with
GStreamer at the application level, or at least how to use the
command-line tools such as gst-launch, or at the very very least you
should understand the difference between an element, a pad, and a pad
template, and have some idea of how to connect them together. The more you
know about GStreamer, the more sense this application will make.
This is a low-level visualization tool, not a high-level synthesizer/video
effect processor. If that's what you want, it's already been done. Go
check out PureData or the various GUIs that exist for csound. While it is
in theory possible to construct such things with this application, doing
so is likely to be painful and not very functional. One day, perhaps.
Installing:
* run chmod +x gst-editor
* there is currently no installation proceedure
Running:
run ./gst-editor from this directory
Manual
This application allows you to construct gstreamer pipeliens in an interactive
manner.
The editor window is divided into several parts:
-----------------------------------------------------------------------
| |
-----------------------------------------------------------------------
| pipeline toolbar |
-----------------------------------------------------------------------
| | |
| | |
| | Pipeline Editor |
| | |
| Property | |
| Editor | |
| | |
| | |
| | |
| | |
| | |
| -----------------| |
| | |
| | |
| Element | |
| Browser | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
-----------------------------------------------------------------------
To add elements to the pipeline you simply drag them from the element browser
and onto the pipeline editor.
*HINT* You can add files more easily by choosing "add filesrc" from the
toolbar, or by dragging and dropping files from nautilus, etc. Note that
just becuause they appear in the pipeline editor doesn't mean they're
going to work with gstreamer. GSTEditor assumes nothing about the files
you add.
You can link elements together by connecting their pads together. To remove
objects, whether they be links or elements, you select them and choose
"Delete" from the tool bar.
When you are satisfied with your pipelien and want to test it, press play. If
the pipeline is able to play, this will happen right away. If not, you'll see
the pipeline stuck in either the "Paused" or "Ready" state. Examine the
console output to determine why the pipeline is not playing, and try again.
The pipeline can be stoped by pressing the "Null" button.
Elements have propertys which can be changed at any time. Selecting an element
will make its properties available in the Property Editor. You simply change
them as you see fit, the changes will take effect immediately.
What Works
* Adding and removing elements from the timeline,
* linking arbitrary pads.
* selection
* deletion
What Doesn't
* Property Editor
* No support for saving or loading pipelines
* Undo/Redo haven't been implemented
* linking pad templates
* no way to view or manipulate pad caps