something with it and something else comes out at the other side. For a
decoder element, for example, you'd put in encoded data, and the element
would output decoded data. In the next chapter (see [Pads and
-capabilities](manual-pads.md)), you will learn more about data input
+capabilities](manual/building/pads.md)), you will learn more about data input
and output in elements, and how you can set that up in your application.
### Source elements
unique, default name.
When you don't need the element anymore, you need to unref it using
-[`gst_object_unref
+[`gst_object_unref
()`](http://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/GstObject.html#gst-object-unref).
This decreases the reference count for the element by 1. An element has
a refcount of 1 when it gets created. An element gets destroyed
return 0;
}
-
+
```
`gst_element_factory_make` is actually a shorthand for a combination of
return 0;
}
-
+
```
## Using an element as a `GObject`
return 0;
}
-
+
```
Most plugins provide additional properties to provide more information
a useful tool to query the properties of a particular element, it will
also use property introspection to give a short explanation about the
function of the property and about the parameter types and ranges it
-supports. See [gst-inspect](manual-checklist-element.md#gst-inspect) in
+supports. See [gst-inspect](manual/appendix/checklist-element.md#gst-inspect) in
the appendix for details about `gst-inspect`.
For more information about `GObject` properties we recommend you read
return 0;
}
-
+
```
You can use `gst_registry_pool_feature_list (GST_TYPE_ELEMENT_FACTORY)`
players. All current GStreamer-based media players and autopluggers work
this way. We'll look closer at these features as we learn about `GstPad`
and `GstCaps` in the next chapter: [Pads and
-capabilities](manual-pads.md)
+capabilities](manual/building/pads.md)
## Linking elements
[..]
}
-
+
```
For more specific behaviour, there are also the functions
existing links. Also, you cannot directly link elements that are not in
the same bin or pipeline; if you want to link elements or pads at
different hierarchy levels, you will need to use ghost pads (more about
-ghost pads later, see [Ghost pads](manual-pads.md#ghost-pads)).
+ghost pads later, see [Ghost pads](manual/building/pads.md#ghost-pads)).
## Element States
playback as soon as state is changed to PLAYING, but it is *not*
allowed to play the data which would make the clock run. In summary,
PAUSED is the same as PLAYING but without a running clock.
-
+
Elements going into the PAUSED state should prepare themselves for
moving over to the PLAYING state as soon as possible. Video or audio
outputs would, for example, wait for data to arrive and queue it so
will also take care of switching messages from the pipeline's thread
into the application's own thread, by using a
[`GstBus`](http://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/GstBus.html).
-See [Bus](manual-bus.md) for details.
+See [Bus](manual/building/bus.md) for details.
When you set a bin or pipeline to a certain target state, it will
usually propagate the state change to all elements within the bin or
1. The code for this example is automatically extracted from the
documentation and built under `tests/examples/manual` in the
GStreamer tarball.
-