Get the #GstColorBalanceType of this implementation. A the #GstColorBalanceType. Retrieve the current value of the indicated channel, between min_value and max_value. #GstColorBalanceChannel::max_value members of the #GstColorBalanceChannel object. The current value of the channel. A #GstColorBalanceChannel instance Retrieve a list of the available channels. The list is owned by the #GstColorBalance instance and must not be freed. A GList containing pointers to #GstColorBalanceChannel objects. Sets the current value of the channel to the passed value, which must be between min_value and max_value. #GstColorBalanceChannel::max_value members of the #GstColorBalanceChannel object. A #GstColorBalanceChannel instance The new value for the channel. A helper function called by implementations of the GstColorBalance interface. It fires the #GstColorBalance::value-changed signal on the instance, and the #GstColorBalanceChannel::value-changed signal on the channel object. A #GstColorBalanceChannel whose value has changed The new value of the channel Fired when the value of the indicated channel has changed. The #GstColorBalanceChannel The new value Fired when the value of the indicated channel has changed. The new value An enumeration indicating whether an element implements color balancing operations in software or in dedicated hardware. In general, dedicated hardware implementations (such as those provided by xvimagesink) are preferred. Get the set of supported flags for this mixer implementation. A set of or-ed GstMixerFlags for supported features. Get the #GstMixerType of this mixer implementation. A the #GstMixerType. Get the current value of a name/value option in the mixer. current value of the name/value option. The #GstMixerOptions that we operate on. Get the current volume(s) on the given track. the GstMixerTrack to get the volume from. a pre-allocated array of integers (of size track->num_channels) to store the current volume of each channel in the given track in. Returns a list of available tracks for this mixer/element. Note that it is allowed for sink (output) elements to only provide the output tracks in this list. Likewise, for sources (inputs), it is allowed to only provide input elements in this list. The list is owned by the #GstMixer instance and must not be freed or modified. A #GList consisting of zero or more #GstMixerTracks. This function is called by the mixer implementation to produce a notification message on the bus indicating that the list of available mixer tracks for a given mixer object has changed. Applications should rebuild their interface when they receive this message. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus. This function is called by the mixer implementation to produce a notification message on the bus indicating that the given track has changed mute state. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus. the GstMixerTrack that has change mute state. the new state of the mute flag on the track This function is called by the mixer implementation to produce a notification message on the bus indicating that the given options object has changed state. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus. the GstMixerOptions that has changed value. the new value of the GstMixerOptions. This function is called by the mixer implementation to produce a notification message on the bus indicating that the list of possible options of a given options object has changed. The new options are not contained in the message on purpose. Applications should call gst_mixer_option_get_values() on @opts to make @opts update its internal state and obtain the new list of values. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus for this to work. the GstMixerOptions whose list of values has changed This function is called by the mixer implementation to produce a notification message on the bus indicating that the given track has changed recording state. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus. the GstMixerTrack that has changed recording state. the new state of the record flag on the track Mutes or unmutes the given channel. To find out whether a track is currently muted, use GST_MIXER_TRACK_HAS_FLAG (). the #GstMixerTrack to operate on. a boolean value indicating whether to turn on or off muting. Sets a name/value option in the mixer to the requested value. The #GstMixerOptions that we operate on. The requested new option value. Enables or disables recording on the given track. Note that this is only possible on input tracks, not on output tracks (see GST_MIXER_TRACK_HAS_FLAG () and the GST_MIXER_TRACK_INPUT flag). the #GstMixerTrack to operate on. a boolean value that indicates whether to turn on or off recording. Sets the volume on each channel in a track. Short note about the mixer/element, such as 'Line-in' or 'Microphone'. A channel is said to be a mono-stream inside this track. A stereo track thus contains two channels. The #GstMixerTrack to set the volume on. an array of integers (of size track->num_channels) that gives the wanted volume for each channel in this track. This function is called by the mixer implementation to produce a notification message on the bus indicating that the volume(s) for the given track have changed. This function only works for GstElements that are implementing the GstMixer interface, and the element needs to have been provided a bus. the GstMixerTrack that has changed. Array of volume values, one per channel on the mixer track. Flags indicating which optional features are supported by a mixer implementation. An enumeration for the type of a GstMixer message received on the bus Get the values for the mixer option. option. You must not free or modify the list or its contents, it belongs to the @mixer_options object. A list of strings with all the possible values for the mixer Get the values for the mixer option. option. You must not free or modify the list or its contents, it belongs to the @mixer_options object. A list of strings with all the possible values for the mixer A list of strings with all the possible values for the mixer Mixer track flags. Sends the indicated command to the navigation interface. The command to issue The type of the key event. Recognised values are "key-press" and "key-release" Character representation of the key. This is typically as produced by XKeysymToString. Sends a mouse event to the navigation interface. Mouse event coordinates are sent relative to the display space of the related output area. This is usually the size in pixels of the window associated with the element implementing the #GstNavigation interface. The type of mouse event, as a text string. Recognised values are "mouse-button-press", "mouse-button-release" and "mouse-move". The button number of the button being pressed or released. Pass 0 for mouse-move events. The x coordinate of the mouse event. The y coordinate of the mouse event. A set of commands that may be issued to an element providing the #GstNavigation interface. The available commands can be queried via the gst_navigation_query_new_commands() query. For convenience in handling DVD navigation, the MENU commands are aliased as: GST_NAVIGATION_COMMAND_DVD_MENU = @GST_NAVIGATION_COMMAND_MENU1 GST_NAVIGATION_COMMAND_DVD_TITLE_MENU = @GST_NAVIGATION_COMMAND_MENU2 GST_NAVIGATION_COMMAND_DVD_ROOT_MENU = @GST_NAVIGATION_COMMAND_MENU3 GST_NAVIGATION_COMMAND_DVD_SUBPICTURE_MENU = @GST_NAVIGATION_COMMAND_MENU4 GST_NAVIGATION_COMMAND_DVD_AUDIO_MENU = @GST_NAVIGATION_COMMAND_MENU5 GST_NAVIGATION_COMMAND_DVD_ANGLE_MENU = @GST_NAVIGATION_COMMAND_MENU6 GST_NAVIGATION_COMMAND_DVD_CHAPTER_MENU = @GST_NAVIGATION_COMMAND_MENU7 Enum values for the various events that an element implementing the GstNavigation interface might send up the pipeline. A set of notifications that may be received on the bus when navigation related status changes. Opaque #GstPropertyProbe data structure. Get a list of properties for which probing is supported. by this element. the list of properties for which probing is supported Get a list of properties for which probing is supported. by this element. the list of properties for which probing is supported Get #GParamSpec for a property for which probing is supported. the #GParamSpec of %NULL. name of the property. Gets the possible (probed) values for the given property, requires the property to have been probed before. A list of valid values for the given property. the #GParamSpec property identifier. Same as gst_property_probe_get_values (). A list of valid values for the given property. the name of the property to get values for. Checks whether a property needs a probe. This might be because the property wasn't initialized before, or because host setup changed. This might be, for example, because a new device was added, and thus device probing needs to be refreshed to display the new device. TRUE if the property needs a new probe, FALSE if not. a #GParamSpec that identifies the property to check. Same as gst_property_probe_needs_probe (). TRUE if the property needs a new probe, FALSE if not. the name of the property to check. Check whether the given property requires a new probe. If so, fo the probe. After that, retrieve a value list. Meant as a utility function that wraps the above functions. the list of valid values for this property. The #GParamSpec property identifier. Same as gst_property_probe_probe_and_get_values (). the list of valid values for this property. the name of the property to get values for. Runs a probe on the property specified by @pspec #GParamSpec of the property. Runs a probe on the property specified by @name. name of the property. #GstPropertyProbe interface. the list of properties for which probing is supported Returns %TRUE if the stream is muted The current stream volume as linear factor #GstStreamVolumeFormat which should be returned Mute state that should be set #GstStreamVolumeFormat of @val Linear volume factor that should be set Different representations of a stream volume. gst_stream_volume_convert() allows to convert between the different representations. Formulas to convert from a linear to a cubic or dB volume are cbrt(val) and 20 * log10 (val). Called by elements implementing the #GstTuner interface when the current channel changes. Fires the #GstTuner::channel-changed signal. A #GstTunerChannel instance Look up a #GstTunerChannel by name. is available. A #GstTunerChannel, or NULL if no channel with the provided name A string containing the name of a #GstTunerChannel Look up a #GstTunerNorm by name. is available. A #GstTunerNorm, or NULL if no norm with the provided name A string containing the name of a #GstTunerNorm Called by elements implementing the #GstTuner interface when the configured frequency changes. Fires the #GstTuner::frequency-changed signal on the tuner, and the #GstTunerChannel::frequency-changed signal on the channel. The current #GstTunerChannel The new frequency setting Retrieve the current channel from the tuner. the current channel of the tuner object. Retrieve the current frequency from the given channel. As for gst_tuner_set_frequency(), the #GstTunerChannel must support frequency operations, as indicated by the GST_TUNER_CHANNEL_FREQUENCY flag. The current frequency, or 0 on error. The #GstTunerChannel to retrieve the frequency from. Get the current video norm from the given tuner object for the currently selected channel. the current norm. Retrieve a #GList of #GstTunerChannels available (e.g. 'composite', 's-video', ...) from the given tuner object. owned by the GstTuner and must not be freed. A list of channels available on this tuner. The list is Retrieve a GList of available #GstTunerNorm settings for the currently tuned channel on the given tuner object. tuner object. The list is owned by the GstTuner and must not be freed. A list of norms available on the current channel for this Called by elements implementing the #GstTuner interface when the current norm changes. Fires the #GstTuner::norm-changed signal. A #GstTunerNorm instance Tunes the object to the given channel, which should be one of the channels returned by gst_tuner_list_channels(). the channel to tune to. Sets a tuning frequency on the given tuner/channel. Note that this requires the given channel to be a "tuning" channel, which can be checked using GST_TUNER_CHANNEL_HAS_FLAG (), with the proper flag being GST_TUNER_CHANNEL_FREQUENCY. The frequency is in Hz, with minimum steps indicated by the frequency_multiplicator provided in the #GstTunerChannel. The valid range is provided in the min_frequency and max_frequency properties of the #GstTunerChannel. The #GstTunerChannel to set the frequency on. The frequency to tune in to. Changes the video norm on this tuner to the given norm, which should be one of the norms returned by gst_tuner_list_norms(). the norm to use for the current channel. Called by elements implementing the #GstTuner interface when the incoming signal strength changes. Fires the #GstTuner::signal-changed signal on the tuner and the #GstTunerChannel::signal-changed signal on the channel. The current #GstTunerChannel The new signal strength Get the strength of the signal on this channel. Note that this requires the current channel to be a "tuning" channel, i.e. a channel on which frequency can be set. This can be checked using GST_TUNER_CHANNEL_HAS_FLAG (), and the appropriate flag to check for is GST_TUNER_CHANNEL_FREQUENCY. The valid range of the signal strength is indicated in the min_signal and max_signal properties of the #GstTunerChannel. Signal strength, or 0 on error. the #GstTunerChannel to get the signal strength from. Reports that the current #GstTunerChannel has changed. The new configured channel. Reports that the current frequency has changed. Reports that the current #GstTunerNorm has changed. The new configured norm. Reports that the signal strength has changed. The current #GstTunerChannel The new signal strength (an integer) Reports that the current frequency has changed. The new frequency (an unsigned long) Reports that the signal strength has changed. The new signal strength (an integer) An enumeration for flags indicating the available capabilities of a #GstTunerChannel. Opaque #GstVideoOrientation data structure. Get the horizontal centering offset from the given object. %TRUE in case the element supports centering return location for the result Get the horizontal flipping state (%TRUE for flipped) from the given object. %TRUE in case the element supports flipping return location for the result Get the vertical centering offset from the given object. %TRUE in case the element supports centering return location for the result Get the vertical flipping state (%TRUE for flipped) from the given object. %TRUE in case the element supports flipping return location for the result Set the horizontal centering offset for the given object. %TRUE in case the element supports centering centering offset Set the horizontal flipping state (%TRUE for flipped) for the given object. %TRUE in case the element supports flipping use flipping Set the vertical centering offset for the given object. %TRUE in case the element supports centering centering offset Set the vertical flipping state (%TRUE for flipped) for the given object. %TRUE in case the element supports flipping use flipping Get the horizontal centering offset from the given object. %TRUE in case the element supports centering return location for the result Get the horizontal flipping state (%TRUE for flipped) from the given object. %TRUE in case the element supports flipping return location for the result Get the vertical centering offset from the given object. %TRUE in case the element supports centering return location for the result Get the vertical flipping state (%TRUE for flipped) from the given object. %TRUE in case the element supports flipping return location for the result Set the horizontal centering offset for the given object. %TRUE in case the element supports centering centering offset Set the horizontal flipping state (%TRUE for flipped) for the given object. %TRUE in case the element supports flipping use flipping Set the vertical centering offset for the given object. %TRUE in case the element supports centering centering offset Set the vertical flipping state (%TRUE for flipped) for the given object. %TRUE in case the element supports flipping use flipping #GstVideoOrientationInterface interface. %TRUE in case the element supports flipping return location for the result %TRUE in case the element supports flipping return location for the result %TRUE in case the element supports centering return location for the result %TRUE in case the element supports centering return location for the result %TRUE in case the element supports flipping use flipping %TRUE in case the element supports flipping use flipping %TRUE in case the element supports centering centering offset %TRUE in case the element supports centering centering offset Opaque #GstXOverlay data structure. #GstXOverlay interface Check a bus message to see if it is a GstMixer notification message and return the GstMixerMessageType identifying which type of notification it is. if the message is not a GstMixer notification. The type of the GstMixerMessage, or GST_MIXER_MESSAGE_INVALID A GstMessage to inspect. Extracts the contents of a mute-toggled bus message. Reads the GstMixerTrack that has changed, and the new value of the mute flag. The GstMixerTrack remains valid until the message is freed. A mute-toggled change notification message. Pointer to hold a GstMixerTrack object, or NULL. A pointer to a gboolean variable, or NULL. Extracts the GstMixerOptions and new value from a option-changed bus notification message. The options and value returned remain valid until the message is freed. A volume-changed change notification message. Pointer to hold a GstMixerOptions object, or NULL. Result location to receive the new options value, or NULL. Extracts the GstMixerOptions whose value list has changed from an options-list-changed bus notification message. The options object returned remains valid until the message is freed. You do not need to unref it. A volume-changed change notification message. Pointer to hold a GstMixerOptions object, or NULL. Extracts the contents of a record-toggled bus message. Reads the GstMixerTrack that has changed, and the new value of the recording flag. The GstMixerTrack remains valid until the message is freed. A record-toggled change notification message. Pointer to hold a GstMixerTrack object, or NULL. A pointer to a gboolean variable, or NULL. Parses a volume-changed notification message and extracts the track object it refers to, as well as an array of volumes and the size of the volumes array. The track object remains valid until the message is freed. The caller must free the array returned in the volumes parameter using g_free when they are done with it. A volume-changed change notification message. Pointer to hold a GstMixerTrack object, or NULL. A pointer to receive an array of gint values, or NULL. Result location to receive the number of channels, or NULL. Inspect a #GstEvent and return the #GstNavigationEventType of the event, or #GST_NAVIGATION_EVENT_INVALID if the event is not a #GstNavigation event. A #GstEvent to inspect. Inspect a #GstNavigation command event and retrieve the enum value of the associated command. TRUE if the navigation command could be extracted, otherwise FALSE. A #GstEvent to inspect. Pointer to GstNavigationCommand to receive the type of the navigation event. A #GstEvent to inspect. A pointer to a location to receive the string identifying the key press. The returned string is owned by the event, and valid only until the event is unreffed. Retrieve the details of either a #GstNavigation mouse button press event or a mouse button release event. Determine which type the event is using gst_navigation_event_get_type() to retrieve the #GstNavigationEventType. otherwise FALSE. TRUE if the button number and both coordinates could be extracted, A #GstEvent to inspect. Pointer to a gint that will receive the button number associated with the event. Pointer to a gdouble to receive the x coordinate of the mouse button event. Pointer to a gdouble to receive the y coordinate of the mouse button event. Inspect a #GstNavigation mouse movement event and extract the coordinates of the event. TRUE if both coordinates could be extracted, otherwise FALSE. A #GstEvent to inspect. Pointer to a gdouble to receive the x coordinate of the mouse movement. Pointer to a gdouble to receive the y coordinate of the mouse movement. Check a bus message to see if it is a #GstNavigation event, and return the #GstNavigationMessageType identifying the type of the message if so. #GST_NAVIGATION_MESSAGE_INVALID if the message is not a #GstNavigation notification. The type of the #GstNavigationMessage, or A #GstMessage to inspect. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_ANGLES_CHANGED for notifying an application that the current angle, or current number of angles available in a multiangle video has changed. The new #GstMessage. A #GstObject to set as source of the new message. The currently selected angle. The number of viewing angles now available. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_COMMANDS_CHANGED The new #GstMessage. A #GstObject to set as source of the new message. Creates a new #GstNavigation message with type #GST_NAVIGATION_MESSAGE_MOUSE_OVER. The new #GstMessage. A #GstObject to set as source of the new message. %TRUE if the mouse has entered a clickable area of the display. %FALSE if it over a non-clickable area. Parse a #GstNavigation message of type GST_NAVIGATION_MESSAGE_ANGLES_CHANGED and extract the @cur_angle and @n_angles parameters. %TRUE if the message could be successfully parsed. %FALSE if not. A #GstMessage to inspect. A pointer to a #guint to receive the new current angle number, or NULL A pointer to a #guint to receive the new angle count, or NULL. Parse a #GstNavigation message of type #GST_NAVIGATION_MESSAGE_MOUSE_OVER and extract the active/inactive flag. If the mouse over event is marked active, it indicates that the mouse is over a clickable area. %TRUE if the message could be successfully parsed. %FALSE if not. A #GstMessage to inspect. A pointer to a gboolean to receive the active/inactive state, or NULL. Inspect a #GstQuery and return the #GstNavigationQueryType associated with it if it is a #GstNavigation query. #GST_NAVIGATION_QUERY_INVALID The #GstNavigationQueryType of the query, or The query to inspect Create a new #GstNavigation angles query. When executed, it will query the pipeline for the set of currently available angles, which may be greater than one in a multiangle video. The new query. Create a new #GstNavigation commands query. When executed, it will query the pipeline for the set of currently available commands. The new query. Parse the current angle number in the #GstNavigation angles @query into the #guint pointed to by the @cur_angle variable, and the number of available angles into the #guint pointed to by the @n_angles variable. %TRUE if the query could be successfully parsed. %FALSE if not. a #GstQuery Pointer to a #guint into which to store the currently selected angle value from the query, or NULL Pointer to a #guint into which to store the number of angles value from the query, or NULL Parse the number of commands in the #GstNavigation commands @query. %TRUE if the query could be successfully parsed. %FALSE if not. a #GstQuery the number of commands in this query. Parse the #GstNavigation command query and retrieve the @nth command from it into @cmd. If the list contains less elements than @nth, @cmd will be set to #GST_NAVIGATION_COMMAND_INVALID. %TRUE if the query could be successfully parsed. %FALSE if not. a #GstQuery the nth command to retrieve. a pointer to store the nth command into. Set the #GstNavigation angles query result field in @query. a #GstQuery the current viewing angle to set. the number of viewing angles to set. Set the #GstNavigation command query result fields in @query. The number of commands passed must be equal to @n_commands. a #GstQuery the number of commands to set. Set the #GstNavigation command query result fields in @query. The number of commands passed must be equal to @n_commands. a #GstQuery the number of commands to set. An array containing @n_cmds @GstNavigationCommand values. the converted volume #GstStreamVolumeFormat to convert from #GstStreamVolumeFormat to convert to Volume in @from format that should be converted Tell an overlay that it has been exposed. This will redraw the current frame in the drawable even if the pipeline is PAUSED. a #GstXOverlay to expose. This will post a "have-xwindow-id" element message on the bus. This function should only be used by video overlay plugin developers. a #GstXOverlay which got a window a platform-specific handle referencing the window This will post a "have-xwindow-id" element message on the bus. This function should only be used by video overlay plugin developers. a #GstXOverlay which got a XWindow. a #XID referencing the XWindow. Tell an overlay that it should handle events from the window system. These events are forwared upstream as navigation events. In some window system, events are not propagated in the window hierarchy if a client is listening for them. This method allows you to disable events handling completely from the XOverlay. a #GstXOverlay to expose. a #gboolean indicating if events should be handled or not. This will post a "prepare-xwindow-id" element message on the bus to give applications an opportunity to call gst_x_overlay_set_xwindow_id() before a plugin creates its own window. This function should only be used by video overlay plugin developers. a #GstXOverlay which does not yet have an XWindow. Configure a subregion as a video target within the window set by gst_x_overlay_set_window_handle(). If this is not used or not supported the video will fill the area of the window set as the overlay to 100%. By specifying the rectangle, the video can be overlayed to a specific region of that window only. After setting the new rectangle one should call gst_x_overlay_expose() to force a redraw. To unset the region pass -1 for the @width and @height parameters. This method is needed for non fullscreen video overlay in UI toolkits that do not support subwindows. %FALSE if not supported by the sink. a #GstXOverlay the horizontal offset of the render area inside the window the vertical offset of the render area inside the window the width of the render area inside the window the height of the render area inside the window This will call the video overlay's set_window_handle method. You should use this method to tell to a XOverlay to display video output to a specific XWindow. Passing 0 as the xwindow_id will tell the overlay to stop using that window and create an internal one. a #GstXOverlay to set the XWindow on. This will call the video overlay's set_xwindow_id method. You should use this method to tell to a XOverlay to display video output to a specific XWindow. Passing 0 as the xwindow_id will tell the overlay to stop using that window and create an internal one. a #GstXOverlay to set the XWindow on. a #XID referencing the XWindow.